Twitter Ads 통합 계획
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Analytic API | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ |
Twitter Ads Analytic API는 Twitter에서 제공하는 집계 데이터 인터페이스로, 동기와 비동기 두 가지 데이터 인터페이스를 제공합니다. 비동기 데이터 인터페이스가 분석 기능과 데이터 기간 면에서 모두 동기 데이터 인터페이스보다 우수하므로 AE 시스템은 비동기 데이터 인터페이스 연동을 지원합니다.
통합 절차
Twitter Ads 데이터의 연동 절차는 다음과 같습니다:
-
Twitter 플랫폼에서 다음 작업을 완료해야 합니다:
- Twitter Developer 계정을 얻고 APP을 생성한 후 API Key와 API Token을 가져옵니다
- Ads API 사용 권한을 신청합니다
- 광고 계정의 Access Token과 Access Secret을 생성합니다(Ads API를 신청하기 전에 Access Token과 Access Secret을 이미 생성한 경우 다시 생성해야 합니다)
-
AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Twitter Ads 통합을 추가하고 통합 계획을 생성합니다
-
AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 통합 전 준비 작업
1.1 Twitter 개발자 계정 신청 및 APP 생성
Twitter API를 호출하여 Twitter Ads 데이터를 가져오려면 먼저 Twitter 개발자 계정을 신청해야 하며, 개발자 계정 신청은 Twitter 공식 심사를 거쳐야 합니다.
심사를 통과하면 APP을 생성하고, 이후 Ads API를 호출할 때 사용할 수 있도록 해당 APP의 API Key와 API Token을 기록해 두십시오.
1.2 Ads API 사용 권한 신청
Twitter 개발자 계정 신청과 APP 생성을 완료한 후에는 Twitter 담당자에게 연락하여 개발자 계정에 Ads API 사용 권한을 개통해야 합니다. 신청에는 며칠이 걸릴 수 있습니다.
1.3 Access Token 및 Access Secret 가져오기
Ads API 사용 권한이 개통되면 다음으로 Access Token과 Access Secret을 가져와야 합니다. 개발자 플랫폼으로 돌아가 Ads API 권한을 신청한 앱을 클릭하고 Keys and tokens 탭으로 이동한 후 Access Token and Secret 항목 아래의 Generate 버튼을 클릭하여 Access Token과 Access Secret을 생성합니다. 이후 Ads API를 호출할 때 필요하므로 계정의 Access Token과 Access Secret을 반드시 안전하게 보관하십시오.
1.4 요약
Twitter에서 다음 정보를 얻어야 합니다:
- Twitter 앱의 API Key와 API Key Secret
- 광고 계정의 Access Token과 Access Secret
- 광고 계정의 Account ID
2. 계획 설정
Twitter Ads 플랫폼에서 준비 작업을 마친 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 아래 그림은 Twitter Ads Analytic API의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고 팝업 창에 Twitter Ads 플랫폼에서 가져온 정보를 입력합니다
그중 Account ID List에는 데이터를 수집할 Twitter 광고 계정 ID를 입력하며, 여러 광고 계정 ID는 "," 기호로 구분합니다
2.2 동기화
동기화 모듈에서 AE 시스템이 Twitter Ads Analytic API 데이터를 정기적으로 수집하는 정책을 설정할 수 있으며, 매일 특정 시각 또는 매시간 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 이벤트 테이블 저장 설정
이벤트 테이블 저장 설정 스위치를 켜면 콜백 데이터가 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터 저장을 활성화할 것을 권장합니다.
2.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능, 문자열 타입. |
| source | time_granularity | 데이터 수집의 시간 단위. 다음 중에서 선택할 수 있습니다:
|
| metrics | 해당 인터페이스의 지표 필드, 리스트 타입, 커스텀 가능 | |
| transfer | double_columns | 데이터의 지표, 리스트 타입. 여기에 포함된 필드는 데이터 수신 시 수치 타입으로 저장되며, 나머지 필드는 문자열(또는 시간)로 저장됩니다 |
- 그룹 차원
Twitter Ads는 Campaign, Ad Group 등 각 수준의 광고 차원을 '엔티티(Entity)'라고 부르며, Analytic API를 호출할 때는 분석 차원을 하나만 사용할 수 있습니다. 광고 차원 정보를 최대한 가져오기 위해 AE 시스템은 데이터를 수집할 때 가장 세분화된 수준인 PROMOTED_TWEET을 분석 엔티티로 사용하고, 엔티티 연관 관계 인터페이스를 통해 Campaign ID, Line Item ID 등 상위 수준 엔티티의 정보를 가져옵니다. 다음 표는 모든 차원 필드와 그 의미를 보여 줍니다:
| 차원명 | 의미 |
|---|---|
| account_id | 광고 계정 ID |
| campaign_id | Campaign ID |
| campaign_name | Campaign 이름 |
| line_item_id | Line Item ID（Ad set ID） |
| line_item_name | Line Item Name(Ad set 이름) |
| promoted_tweet_id | Tweet ID |
| placement | 게재 위치 |
| entity_id | 엔티티 ID |
| currency | 통화 |
- 지표 필드
Analytic API는 여러 지표 그룹을 제공하며, 각 지표 그룹에는 여러 지표 필드가 포함됩니다. 수집할 지표 그룹은 직접 지정할 수 있으며, 다음 표는 각 지표 그룹의 자주 사용하는 지표를 보여 줍니다. 모든 지표 정보는 Twitter 공식 문서를 참고하십시오. 조정하려면 지표 그룹 이름을 source.metrics에, 지표 필드 이름을 transfer.double_columns에 입력하십시오
| 지표 그룹 | 지표 필드 | 의미 | 기본 여부 |
|---|---|---|---|
ENGAGEMENT | engagements | 총 인터랙션 수(자연 노출, 리트윗, 답글, 공유, 좋아요 등의 행동 포함) | 예 |
| impressions | 자연 노출 수(유료 프로모션 미포함) | 예 | |
| retweets | 리트윗 수 | 예 | |
| replies | 답글 수 | 예 | |
| likes | 좋아요 수 | 예 | |
| follows | 팔로우 수 | 예 | |
| card_engagements | 카드 총 인터랙션 수 | 예 | |
| clicks | 클릭 수 | 예 | |
| app_clicks | 클릭 후 APP 설치 수 또는 실행 수 | 예 | |
| url_clicks | 트윗 링크 또는 웹 카드를 클릭한 횟수 | 예 | |
| qualified_impressions | 완전히 표시된 노출 수 | 예 | |
| carousel_swipes | 캐러셀 이미지 또는 영상의 스와이프 횟수 | 예 | |
| BILLING | billed_engagements | 유료 인터랙션 수 | 예 |
| billed_charge_local_micro | 총 결제 금액(1000000배 확대) | 예 | |
VIDEO | video_total_views | 동영상 재생 수 | 예 |
| video_views_25 | 영상 25% 진행 재생 수 | 예 | |
| video_views_50 | 영상 50% 진행 재생 수 | 예 | |
| video_views_75 | 영상 75% 진행 재생 수 | 예 | |
| video_views_100 | 영상 완료 재생 수 | 예 | |
| video_cta_clicks | Call-to-action 클릭 수 | 예 | |
| video_content_starts | 영상 재생 시작 수 | 예 | |
| video_3s100pct_views | 영상 완료 재생 수(최소 3초 시청) | 예 | |
| video_6s_views | 영상 6초 시청 재생 수 | 예 | |
| video_15s_views | 영상 15초 또는 95% 진행 시청 재생 수 | 예 | |
| MEDIA | media_views | 멀티미디어 조회 수(자동 재생과 클릭 재생 포함) | 예 |
| media_engagements | 멀티미디어 인터랙션 수 | 예 | |
| WEB_CONVERSION | conversion_* | 타입이 PURCHASE, SIGN_UP, SITE_VISIT, DOWNLOAD, CUSTOM인 전환 이벤트 중 이후 결제 행동이 있는 전환 수 | |
| MOBILE_CONVERSION | mobile_conversion_* | ||
| LIFE_TIME_VALUE_MOBILE_CONVERSION | mobile_conversion_lifetime_value_* |
2.5 이벤트 저장 규칙
- 데이터의 day 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다
- 기본 데이터 이벤트 이름은 -- twitter_ads_data입니다
- 지표 필드는 수치 타입으로, 그 밖의 필드는 문자열 타입으로 저장됩니다
2.6 표준화 필드
Twitter Ads Analytic API 데이터의 일부 필드는 AE 시스템에서 표준화 처리합니다:
| 필드 | 표준화 필드 | 의미 |
|---|---|---|
| account_id | te_ads_object.ad_account_id | 광고 계정 ID |
| campaign_name | te_ads_object.campaign_name | 캠페인 이름 |
| campaign_id | te_ads_object.campaign_id | 캠페인 ID |
| line_item_name | te_ads_object.ad_group_name | 광고 그룹 이름 |
| line_item_id | te_ads_object.ad_group_id | 광고 그룹 ID |
| promoted_tweet_id | te_ads_object.ad_id | 광고 ID |
| placement | te_ads_object.placement | 광고 위치 |
| currency | te_ads_object.currency | 비용 또는 수익의 통화 |
| impressions | te_ads_object.impressions | 노출 수 |
| clicks | te_ads_object.clicks | 클릭 수 |
| billed_charge_local_micro(1000000으로 나눔) | te_ads_object.cost | UA 비용 |