TikTok Audience Report
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Audience Report | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ |
TikTok Audience Report는 Basic Report에 비해 더 많은 유저 집계 그룹 차원(오디언스 차원이라고 함)을 제공하지만, 반환되는 지표의 종류는 상대적으로 적고 6-12시간의 처리 지연이 있습니다.
통합 절차
- TikTok API Business 플랫폼에 로그인하여 개발자 계정을 등록하고, 앱을 생성한 후 인증 정보를 가져옵니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 TikTok Audience Report 계획을 추가하고 관련 설정을 완료합니다
- TikTok API 앱의 인증 주소를 수정하고 인증 작업을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 인증 정보 가져오기
-
먼저 TikTok API Business 페이지에 접속하여 TikTok 광고 계정으로 로그인하거나 새로 등록해야 합니다
-
다음으로 안내에 따라 개발자로 등록합니다
-
개발자로 등록한 후 아래 그림과 같이 앱을 생성해야 합니다. 생성 시 파라미터는 다음과 같이 설정할 수 있습니다:
- Application name: 프로젝트 이름입니다. 프로젝트에 맞게 이름을 지정합니다
- App Description: 프로젝트 설명입니다. 메모 정보를 추가할 수 있습니다
- Callback Address: 콜백 주소입니다. 생성 시에는 https://www.thinkingdata.cn/을 입력하고, 나중에 AE 시스템의 데이터 콜백 주소로 변경할 수 있습니다
- Scope of Permission: 액세스할 수 있는 데이터 권한입니다. 여기에서 반드시 Reporting 권한을 선택하고, 기타 권한은 필요에 따라 설정하십시오
- Confirm을 클릭하여 확인하면 앱은 처음에 대기 상태가 됩니다. 약 1~2일 후 앱이 심사를 통과(즉 상태가 Approved)하면 앱의 App ID와 Secret을 가져옵니다
2. 계획 설정
TikTok 플랫폼에서 준비 작업을 마친 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 다음은 TikTok Audience Report의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고, 팝업 창에 이전 단계에서 가져온 인증 정보를 입력합니다:
APP ID와 App Secret은 이전 단계에서 가져온 값이며, Account ID에는 데이터를 수집할 TikTok 광고 계정 ID를 입력합니다
2.2 동기화
동기화 모듈에서 AE 시스템이 TikTok Audience Report 데이터를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
2.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능, 문자열 타입. |
| source | report_types | 데이터의 집계 차원, 리스트 타입. 요소는 하나만 입력할 수 있으며, 즉 한 번에 하나의 집계 차원만 수집합니다. 자세한 내용은 아래를 참고 |
time_granularity | 데이터의 시간 집계 단위, 즉 수집한 데이터를 일 단위로 집계할지 시간 단위로 집계할지 여부 선택 가능한 값: day, hour | |
| metrics | 데이터의 지표, 리스트 타입 | |
| group_by | 데이터의 그룹 차원, 리스트 타입 |
- 집계 차원
Audience Report는 다음 집계 차원을 제공합니다. Audience Report에서는 오디언스 차원 하나와 광고 차원 하나만 선택할 수 있으며, 오디언스 차원은 필수이고 광고 차원은 선택 사항입니다. 일부 예외도 있으므로 아래 표의 비고 열에서 자세한 정보를 확인하십시오.
또한 국가(지역)별로 그룹화하려면 country_code 차원 하나만 사용할 수 있습니다:
| 차원 유형 | 차원 필드 | 설명 | 비고 | 기본 여부 |
|---|---|---|---|---|
광고 차원 | advertiser_id | 광고주 ID별 그룹화 | ||
| campaign_id | 캠페인 ID별 그룹화 | |||
| adgroup_id | 광고 그룹 ID별 그룹화 | |||
| ad_id | 광고 ID별 그룹화 | 예 | ||
오디언스 차원 | country_code | 게재 국가별 그룹화 | 국가별 그룹화를 선택하면 country_code 차원 하나만 사용 가능 | |
| gender | 성별로 그룹화 | age와 gender는 함께 사용 가능 | ||
| age | 연령별 그룹화 | age와 gender는 함께 사용 가능 | ||
province_id | 주/도 단위 지역별 그룹화. 지역의 선택 가능한 값은 지역 타기팅을 참고하십시오. | 시간 차원과 함께 사용 불가 | ||
| dma_id | 지정 시장 지역(DMA)별 그룹화. 이 지역 구분은 미국에만 있습니다. 선택 가능한 값은 지역 타기팅을 참고하십시오. | 시간 차원과 함께 사용 불가 | ||
| ac | 네트워크별 그룹화 | |||
| language | 오디언스 언어별 그룹화 | |||
| platform | 운영 체제별 그룹화 | 예 | ||
| interest_category | 1단계 관심사 타기팅별 그룹화 | 시간 차원과 함께 사용 불가 | ||
| interest_category_tier2 | 2단계 관심사 타기팅별 그룹화 | 시간 차원과 함께 사용 불가 | ||
| interest_category_tier3 | 3단계 관심사 타기팅별 그룹화 | 시간 차원과 함께 사용 불가 | ||
| interest_category_tier4 | 4단계 관심사 타기팅별 그룹화 | 시간 차원과 함께 사용 불가 | ||
| behavior_id | 행동별 그룹화 | 시간 차원과 함께 사용 불가 | ||
| placement | 게재 위치별 그룹화 | 시간 차원과 함께 사용 불가 | ||
| device_brand_id | 디바이스 브랜드별 그룹화 | 시간 차원과 함께 사용할 수 없으며, 이 차원을 사용할 때 lifetime을 true로 설정할 수 없음 |
Audience Report가 지원하는 필드는 매우 다양하며, 아래에는 가장 일반적인 그룹 차원과 지표 필드만 표시합니다. 전체 필드 목록은 TikTok의 지표 목록을 참고하십시오.
- 그룹 차원
아래 표는 현재 AE가 기본으로 수집하는 그룹 차원입니다(device_brand_name, behavior_name, action_category, action_scene, user_action, action_period는 제외합니다. 이 6개 필드는 기본으로 수집하지 않으며, 사용 조건은 표의 설명을 참고하십시오). 조정하려면 필드 이름을 source.group_by에 입력하십시오:
| 지표 | 간단한 설명 | 상세 설명 |
|---|---|---|
| advertiser_id | 광고 계정 ID | 항상 저장됨 |
| campaign_name | 캠페인 이름 | 캠페인 이름, CAMPAIGN, ADGROUP, AD 레벨에서만 지원 |
| campaign_id | 캠페인 ID | 캠페인 ID, ADGROUP, AD 레벨에서만 지원 |
| adgroup_name | 광고 그룹 이름 | 광고 그룹 이름, ADGROUP, AD 레벨에서만 지원 |
| placement_type | 게재 위치 | 게재 위치, ADGROUP, AD 레벨에서만 지원 |
| adgroup_id | 광고 그룹 ID | 광고 그룹 ID, AD 레벨에서만 지원 |
| aeo_type | AEO 광고 유형 | AEO(App Event Optimization) 광고 유형. 열거값은 Auto Bid Multi Bid IAEO이며, AEO가 아닌 광고 그룹은 -를 반환합니다. ADGROUP 레벨에서만 지원 |
| ad_name | 광고 이름 | 광고 이름, AD 레벨에서만 지원 |
| ad_text | 광고 제목 | 광고 제목, AD 레벨에서만 지원 |
| tt_app_id | 홍보 앱 ID | 홍보 앱 ID, ADGROUP, AD 레벨에서만 지원하며 홍보 대상이 App인 경우에만 값이 있음 |
| tt_app_name | 홍보 앱 이름 | 홍보 앱 이름, ADGROUP, AD 레벨에서만 지원하며 홍보 대상이 App인 경우에만 값이 있음 |
| mobile_app_id | Google Play 또는 Apple App Store에서의 홍보 앱 ID | Google Play 또는 Apple App Store에서의 홍보 앱 ID, ADGROUP, AD 레벨에서만 지원하며 홍보 대상이 App인 경우에만 값이 있음 |
| device_brand_name | 디바이스 브랜드 이름 | 차원에 device_brand_id가 포함된 경우 이 지표를 지원합니다. |
| behavior_name | Behavior name | 차원에 behavior_id가 포함된 경우 이 지표를 지원합니다. |
| action_category | 행동 카테고리 | 차원에 behavior_id가 포함된 경우 이 지표를 지원합니다. 실시간 리포트에서만 지원하며 비동기 리포트는 지원하지 않습니다. |
| action_scene | 행동 시나리오. 열거값: VIDEO_RELATED(동영상 행동), CREATOR_RELATED(크리에이터 행동). | 차원에 behavior_id가 포함된 경우 이 지표를 지원합니다. 실시간 리포트에서만 지원하며 비동기 리포트는 지원하지 않습니다. |
| user_action | 유저 행동 | 동영상 행동 시나리오에서 선택 가능한 값은 WATCHED_TO_END(끝까지 시청), LIKED(좋아요), COMMENTED(댓글), SHARED(공유)입니다. 크리에이터 행동 시나리오에서 선택 가능한 값은 FOLLOWING(팔로우), VIEW_HOMEPAGE(홈페이지 보기)입니다. |
| action_period | 행동 일수. 선택 가능한 값: 7, 15. | 실시간 리포트에서만 지원하며 비동기 리포트는 지원하지 않음. |
| promotion_type | Promotion type | 프로모션 유형. 선택 가능한 값은 app(앱), website(웹사이트), others(기타)입니다. ADGROUP 및 AD 레벨에서 지원합니다. 동기 리포트와 비동기 리포트 모두 이 지표를 지원합니다. |
| dpa_target_audience_type | Target audience type for DPA | DPA 광고의 타깃 오디언스 유형. ADGROUP 및 AD 레벨에서 지원합니다. 동기 리포트와 비동기 리포트 모두 이 지표를 지원합니다. |
currency | 통화 | 통화 코드(예: USD). currency를 적용하려면 요청의 dimensions 필드에 adgroup_id/ ad_id/campaign_id/advertiser_id가 있어야 합니다. |
- 지표 필드
아래 표는 현재 AE가 기본으로 수집하는 지표 필드입니다. 조정하려면 필드 이름을 source.metrics에 입력하십시오:
| 지표 | 간단한 설명 | 상세 설명 |
|---|---|---|
| spend | 총 지출 | 선택한 기간 동안 광고 게재로 발생한 비용 금액. |
| cpc | CPC | 광고 비용을 클릭 1회 기준으로 평균한 비용. |
| cpm | CPM | 1,000회 노출당 발생한 평균 비용. |
| impressions | 노출 수 | 광고 노출 횟수. |
| clicks | 클릭 수 | 광고 클릭 횟수. |
| ctr | CTR (%) | 광고 노출 중 클릭이 발생한 비율. |
| conversion | 전환 수 | 광고가 목표 전환을 달성한 횟수. 목표 전환은 생성 시의 게재 설정에 따라 다릅니다(노출 시점 기준으로 집계). |
| cost_per_conversion | 전환 비용 | 광고 비용을 전환 1회 기준으로 평균한 비용(노출 시점 기준으로 집계). |
conversion_rate | 전환율 (%) | 광고 클릭 중 전환이 발생한 비율(노출 시점 기준으로 집계). |
| real_time_conversion | 실시간 전환 | 광고가 목표 전환을 달성한 횟수. 목표 전환은 생성 시의 게재 설정에 따라 다릅니다(전환 이벤트 발생 시점 기준으로 집계) |
| real_time_cost_per_conversion | 실시간 전환당 비용 | 광고 비용을 전환 1회 기준으로 평균한 비용(전환 이벤트 발생 시점 기준으로 집계) |
| real_time_conversion_rate | 실시간 전환율 (%) | 광고 클릭 중 전환이 발생한 비율(전환 이벤트 발생 시점 기준으로 집계) |
| result | 결과 | 광고가 최종적으로 결과를 달성한 횟수로, 최적화 목표에 대응합니다.(노출 시점 기준으로 집계) |
| cost_per_result | 결과당 비용 | 결과 1회를 얻는 데 드는 비용.(노출 시점 기준으로 집계) |
| result_rate | 결과율 (%) | 광고 시청 또는 클릭 과정에서 결과를 얻은 비율.(노출 시점 기준으로 집계) |
| real_time_result | 실시간 결과 | 광고가 최종적으로 결과를 달성한 횟수로, 최적화 목표에 대응합니다.(전환 이벤트 발생 시점 기준으로 집계) |
| real_time_cost_per_result | 실시간 결과당 비용 | 결과 1회를 얻는 데 드는 비용.(전환 이벤트 발생 시점 기준으로 집계) |
| real_time_result_rate | 실시간 결과율 (%) | 광고 시청 또는 클릭 과정에서 결과를 얻은 비율.(전환 이벤트 발생 시점 기준으로 집계) |
2.5 데이터 저장 규칙
기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:
- TikTok Marketing API는 집계 데이터를 반환하므로 고정값을 이 데이터의 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결된다고 보면 됩니다
- 데이터의 stat_time_day 또는 stat_time_hour 필드를 집계 데이터의 #event_time으로 사용합니다
- 기본 이벤트 이름은 -- tiktok_audience_report입니다
2.6 표준화 필드
데이터에 다음 이벤트 속성이 있으면 자동으로 표준화 처리합니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| advertiser_id | te_ads_object.ad_account_id | 광고 계정 ID |
| campaign_name | te_ads_object.campaign_name | 캠페인 이름 |
| campaign_id | te_ads_object.campaign_id | 캠페인 ID |
| adgroup_name | te_ads_object.ad_group_name | 광고 그룹 이름 |
| adgroup_id | te_ads_object.ad_group_id | 광고 그룹 ID |
| ad_name | te_ads_object.ad_name | 광고 이름 |
| ad_id | te_ads_object.ad_id | 광고 ID |
| placement_type | te_ads_object.placement | 광고 위치 |
| mobile_app_id | te_ads_object.app_id | 앱 ID |
| tt_app_name | te_ads_object.app_name | 앱 이름 |
| country_code | te_ads_object.country | 국가/지역 코드 |
| currency | te_ads_object.currency | 비용 또는 수익의 통화 |
| impressions | te_ads_object.impressions | 노출 수 |
| clicks | te_ads_object.clicks | 클릭 수 |
| conversion | te_ads_object.installs | 전환 수 |
| spend | te_ads_object.cost | UA 비용 |
2.7 인증 완료
설정을 마친 후 오른쪽 상단의 저장 및 인증을 클릭하여 계획 설정을 저장할 수 있습니다. 이어서 마지막 인증 작업을 완료해야 합니다:
먼저 팝업된 인증 정보 페이지에서 첫 번째 단계의 주소를 복사합니다
다시 TikTok API Business 페이지로 돌아가 앞서 생성한 앱을 편집하고, Advertiser redirect URLs를 편집하여 방금 복사한 인증 주소를 붙여넣습니다.
마지막으로 AE 화면으로 돌아와 권한 설정으로 이동을 클릭하면 TikTok의 인증 페이지가 열립니다. 인증 페이지의 안내에 따라 인증을 완료합니다
인증을 완료한 후 인증 정보에서 왼쪽 하단의 위의 두 단계를 완료했습니다를 클릭한 다음 오른쪽 하단의 인증 완료를 클릭하여 설정을 마칩니다. 이로써 TikTok Audience Report 데이터 통합이 완료됩니다.