TikTok Basic Report
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Basic Report | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ |
TikTok Basic Report는 광고 차원의 집계 그룹을 제공하며, 반환 데이터에는 노출, 클릭, 전환, UA 비용 등 일련의 지표 데이터가 포함됩니다.
통합 절차
- TikTok API Business 플랫폼에 로그인하여 개발자 계정을 등록하고, 앱을 생성한 후 인증 정보를 가져옵니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 TikTok Basic 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 Basic Report의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고, 팝업 창에 이전 단계에서 가져온 인증 정보를 입력합니다:
APP ID와 App Secret은 이전 단계에서 가져온 값이며, Account ID에는 데이터를 수집할 TikTok 광고 계정 ID를 입력합니다
2.2 동기화
동기화 모듈에서 AE 시스템이 TikTok Basic Report 데이터를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
2.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능, 문자열 타입. |
| source | report_types | 데이터의 집계 차원, 리스트 타입. 요소는 하나만 입력할 수 있으며, 즉 한 번에 하나의 집계 차원만 수집합니다. 자세한 내용은 아래를 참고 |
time_granularity | 데이터의 시간 집계 단위, 즉 수집한 데이터를 일 단위로 집계할지 시간 단위로 집계할지 여부 선택 가능한 값: day, hour | |
| metrics | 데이터의 지표, 리스트 타입 | |
| group_by | 데이터의 그룹 차원, 리스트 타입 |
- 집계 차원
Basic Report는 다음 집계 차원을 제공합니다. Basic Report에서는 차원을 하나만 선택할 수 있으며, 국가(지역)별로 그룹화하려면 country_code 차원 하나만 사용할 수 있습니다:
| 차원 유형 | 차원 필드 | 설명 | 기본 여부 |
|---|---|---|---|
광고 차원 | advertiser_id | Advertiser 레벨 | |
| campaign_id | CAMPAIGN 레벨 | ||
| adgroup_id | ADGROUP 레벨 | ||
| ad_id | AD 레벨 | 예 | |
| 국가(지역) 차원 | country_code | 국가(지역)별 그룹화 |
광고 차원에 따라 가져올 수 있는 지표 필드와 지원하는 필터 조건이 다릅니다. 반환 필드와 필터의 비고 정보를 반드시 확인하여 선택한 광고 차원에서 어떤 데이터를 가져올 수 있는지 파악하십시오.
Basic Report가 지원하는 필드는 매우 다양하며, 아래에는 가장 일반적인 그룹 차원과 지표 필드만 표시합니다. 전체 필드 목록은 TikTok의 지표 목록을 참고하십시오.
- 그룹 차원
아래 표는 현재 AE가 기본으로 수집하는 그룹 차원입니다. 조정하려면 필드 이름을 source.group_by에 입력하십시오:
| 필드 | 한국어 이름 | 설명 및 비고 |
|---|---|---|
| advertiser_id | 광고 계정 ID | 항상 저장됨 |
| campaign_name | 캠페인 이름 | CAMPAIGN, ADGROUP, AD 레벨에서만 지원 |
| campaign_id | 캠페인 ID | ADGROUP, AD 레벨에서만 지원 |
| adgroup_name | 광고 그룹 이름 | ADGROUP, AD 레벨에서만 지원 |
| adgroup_id | 광고 그룹 ID | 광고 그룹 ID, AD 레벨에서만 지원 |
| placement_type | 게재 위치 | ADGROUP, AD 레벨에서만 지원 |
aeo_type | AEO 광고 유형 | 열거값은 Auto Bid, Multi Bid, IAEO이며, AEO가 아닌 광고 그룹은 -를 반환합니다. ADGROUP 레벨에서만 지원 |
| ad_name | 광고 이름 | AD 레벨에서만 지원 |
| ad_text | 광고 제목 | AD 레벨에서만 지원 |
| tt_app_id | 홍보 앱 ID | ADGROUP, AD 레벨에서만 지원하며 홍보 대상이 App인 경우에만 값이 있음 |
| tt_app_name | 홍보 앱 이름 | ADGROUP, AD 레벨에서만 지원하며 홍보 대상이 App인 경우에만 값이 있음 |
| mobile_app_id | 앱 ID | Google Play 또는 Apple App Store에서의 앱 ID, ADGROUP, AD 레벨에서만 지원하며 홍보 대상이 App인 경우에만 값이 있음 |
| promotion_type | 프로모션 유형 | 선택 가능한 값은 app(앱), website(웹사이트), others(기타)입니다. ADGROUP 및 AD 레벨에서 지원합니다. 동기 리포트와 비동기 리포트 모두 이 지표를 지원합니다. |
| dpa_target_audience_type | DPA 광고의 타깃 오디언스 유형 | ADGROUP 및 AD 레벨에서 지원합니다. 동기 리포트와 비동기 리포트 모두 이 지표를 지원합니다. |
currency | 통화 | 통화 코드(예: USD). currency를 적용하려면 요청의 'dimensions' 필드에 adgroup_id/ ad_id/campaign_id/advertiser_id가 있어야 합니다. |
- 지표 필드
아래 표는 현재 AE가 기본으로 수집하는 지표 필드입니다. 조정하려면 필드 이름을 source.metrics에 입력하십시오:
| 필드 | 한국어 이름 | 설명 및 비고 |
|---|---|---|
| spend | 총 지출 | 선택한 기간 동안 광고 게재로 발생한 비용 금액. |
| cash_spend | 현금 지출 | 선택한 기간 동안 광고 게재로 발생한 현금 지출. Advertiser 레벨에서만 지원하며, lifetime과 시간별 조회는 지원하지 않습니다. 참고: 지표 업데이트에 24-48시간의 지연이 있을 수 있습니다 |
| voucher_spend | 바우처 지출 | 선택한 기간 동안 광고 게재로 발생한 바우처 지출. Advertiser 레벨에서만 지원하며, lifetime과 시간별 조회는 지원하지 않습니다. 참고: 지표 업데이트에 24-48시간의 지연이 있을 수 있습니다 |
| cpc | CPC | 광고 비용을 클릭 1회 기준으로 평균한 비용. |
| cpm | CPM | 1,000회 노출당 발생한 평균 비용. |
| impressions | 노출 수 | 광고 노출 횟수. |
| clicks | 클릭 수 | 광고 클릭 횟수. |
| ctr | CTR (%) | 광고 노출 중 클릭이 발생한 비율. |
| reach | 총 도달 수 | 광고를 한 번 이상 본 사람 수. 이 지표는 추정값입니다. |
| cost_per_1000_reached | 1,000명 도달당 비용 | 1,000명에게 도달하는 데 드는 평균 비용. 이 지표는 추정값입니다. |
| 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 | 실시간 결과율 (%) | 광고 시청 또는 클릭 과정에서 결과를 얻은 비율.(전환 이벤트 발생 시점 기준으로 집계) |
| secondary_goal_result | 심층 목표 결과 | 광고가 최종적으로 심층 목표를 달성한 횟수로, 설정한 심층 목표에 대응합니다. 같은 캠페인에 서로 다른 심층 목표가 대응할 수 있으므로 현재 캠페인 차원의 결과 수 합계는 제공하지 않습니다. 광고 그룹 차원에서 해당 심층 목표 결과 수를 확인하십시오. |
| cost_per_secondary_goal_result | 심층 목표 결과당 비용 | 심층 목표 결과 1회를 얻는 데 드는 비용. 같은 캠페인에 서로 다른 심층 목표가 대응할 수 있으므로 현재 캠페인 차원의 심층 목표 결과당 비용은 제공하지 않습니다. 광고 그룹 차원에서 해당 심층 목표 결과당 비용을 확인하십시오. |
| secondary_goal_result_rate | 심층 목표 결과율 (%) | 광고 노출 수 대비 심층 목표 결과 수의 비율. |
| frequency | 빈도 | 도달한 유저 1명당 평균 시청 횟수. |
| real_time_app_install | 실시간 앱 설치 | 유저가 앱을 활성화하고 해당 광고로 어트리뷰션된 횟수.(전환 이벤트 발생 시점 기준으로 집계) |
| real_time_app_install_cost | 실시간 앱 설치 비용 | 앱 설치 1회당 비용.(전환 이벤트 발생 시점 기준으로 집계) |
| app_install | 앱 설치 | 유저가 앱을 활성화하고 해당 광고로 어트리뷰션된 횟수.(노출 시점 기준으로 집계.) |
| cost_per_app_install | 앱 설치 비용 | 앱 설치 1회당 비용.(노출 시점 기준으로 집계.) |
| registration | 고유 회원가입 수 | 중복 제거 후 유저가 앱에서 회원가입하고 해당 광고로 어트리뷰션된 횟수.(노출 시점 기준으로 집계.) |
| cost_per_registration | 고유 회원가입 비용 | 중복 제거 후 회원가입 1회당 비용.(노출 시점 기준으로 집계.) |
| registration_rate | 회원가입률 (%) | 중복 제거 후 유저의 회원가입 수와 앱 활성화 수의 비율.(노출 시점 기준으로 집계.) |
2.5 데이터 저장 규칙
기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:
- TikTok Marketing API는 집계 데이터를 반환하므로 고정값을 이 데이터의 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결된다고 보면 됩니다
- 데이터의 stat_time_day 또는 stat_time_hour 필드를 집계 데이터의 #event_time으로 사용합니다
- 기본 이벤트 이름은 -- tiktok_marketing_api_data입니다
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 | 클릭 수 |
| app_install | te_ads_object.installs | 전환 수(설치) |
| spend | te_ads_object.cost | UA 비용 |
2.7 인증 완료
설정을 마친 후 오른쪽 상단의 저장 및 인증을 클릭하여 계획 설정을 저장할 수 있습니다. 이어서 마지막 인증 작업을 완료해야 합니다:
먼저 팝업된 인증 정보 페이지에서 첫 번째 단계의 주소를 복사합니다
다시 TikTok API Business 페이지로 돌아가 앞서 생성한 앱을 편집하고, Advertiser redirect URLs를 편집하여 방금 복사한 인증 주소를 붙여넣습니다.
마지막으로 AE 화면으로 돌아와 권한 설정으로 이동을 클릭하면 TikTok의 인증 페이지가 열립니다. 인증 페이지의 안내에 따라 인증을 완료합니다
인증을 완료한 후 인증 정보에서 왼쪽 하단의 위의 두 단계를 완료했습니다를 클릭한 다음 오른쪽 하단의 인증 완료를 클릭하여 설정을 마칩니다. 이로써 TikTok Basic Report 데이터 통합이 완료됩니다.