설명서Experience Platform소스 커넥터 안내서

[Beta]{class="badge informative"}

TikTok Ads

마지막 업데이트: 2026년 10월 9일

작성 대상:

  • Developer
NOTE
TikTok Ads 원본이 Beta 버전입니다. 베타 레이블 커넥터 사용에 대한 자세한 내용은 소스 개요를 참조하십시오.
IMPORTANT
TikTok Ads 소스는 Customer Journey Analytics SKU의 일부로 사용할 수 있습니다.

TikTok Ads 원본은 Adobe Experience Platform 유료 미디어 커넥터입니다. TikTok 광고 계정을 연결하고 캠페인, 광고 및 성과 데이터(예: 참여 지표)를 Experience Platform에 수집하는 데 사용합니다.

커넥터는 캡처한 데이터를 유료 미디어 데이터 세트에 게시합니다. Customer Journey Analytics은 이러한 데이터 세트를 사용하여 TikTok 마케팅 캠페인에 대한 통찰력을 제공합니다.

계정에 연결하려면 TikTok에 로그인하고 Experience Platform에서 광고주 계정에 액세스할 수 있도록 승인하십시오. API 자격 증명을 수동으로 생성하거나 제공할 필요가 없습니다.

작동 방식

TikTok Ads 데이터 흐름을 만들고 타깃팅할 광고주 계정을 선택하면 Experience Platform에서 다음 작업을 자동으로 실행합니다.

  • 조직에 대한 유료 미디어 데이터 세트가 아직 없는 경우 Experience Platform에서 생성합니다.
  • 일회성 채우기 작업은 데이터 흐름을 만든 후에 실행됩니다.
  • 증분 작업은 데이터 흐름을 만든 다음 날부터 매일 한 번 실행됩니다.

사전 요구 사항

TikTok Ads을(를) Experience Platform에 연결하기 전에 다음을 확인하십시오.

  • Marketing API 제품이 추가된 기존 TikTok for Business 개발자 앱입니다.
  • TikTok의 앱 승인. 앱은 샌드박스 모드에서 시작되며 프로덕션 및 계정 데이터에 액세스하려면 TikTok이(가) 앱을 검토하고 승인해야 합니다.
  • 비즈니스 인증. 이는 앱 검토와 별도의 승인 프로세스이며 더 높은 비율 제한 계층에 필요합니다.
  • 계정을 처음 승인하기 전에 다음 앱 권한 그룹이 부여됩니다. TikTok에서는 나중에 다시 인증하지 않고 이러한 권한을 확장할 수 없습니다. 광고 관리, 보고, 광고 계정 관리 및 고객 관리.
  • 채우기 볼륨에 적합한 비율 제한 할당량입니다. 기본 샌드박스 계층은 공격적으로 조절되므로 큰 채우기를 실행하기 전에 증가를 요청하십시오.
  • TikTok 광고 계정에 캠페인 및 광고가 이미 설정되어 있습니다. 커넥터가 이 기존 광고 데이터에서 읽습니다. TikTok개의 캠페인, 광고 또는 기타 리소스를 만들거나 수정하거나 삭제하지 않습니다.

스키마 및 데이터 세트 프로비저닝

TikTok Ads 원본은 대상 데이터 집합, 스키마 및 필드 매핑을 자동으로 할당합니다. 데이터 흐름을 만들 때 타겟 데이터 세트를 선택하거나 필드를 직접 매핑하지 않습니다.

커넥터는 엔티티 유형당 계정, 캠페인, 광고 그룹, 광고, 에셋 및 요약 지표와 같은 하나의 유료 미디어 데이터 세트를 프로비저닝합니다. Meta Ads 및 Google Ads 소스가 이미 채워진 것과 동일한 표준 스키마입니다. 커넥터가 각 엔티티에 대해 매핑하는 핵심 ID 필드에 대해 다음 섹션을 참조하십시오.

TikTok Ads XDM 스키마

TikTok Ads 원본이 각 유료 미디어 스키마에 매핑하는 핵심 ID 및 상태 필드에 대한 정보는 이 섹션을 참조하십시오. 매핑된 모든 레코드에는 엔터티를 식별하는 entityType 값과 tiktok의 paidMedia.adNetwork 값도 포함됩니다.

계정 필드

계정 스키마는 TikTok 광고주 계정 세부 정보를 저장합니다.

TikTok 필드
XDM 필드
설명
advertiser_id
paidMedia.accountID
TikTok 내의 광고주 계정에 대한 고유 식별자입니다.
name
paidMedia.metadata.name
광고주 계정의 표시 이름입니다.
status
paidMedia.metadata.status
계정 상태(예: 활성)
currency
paidMedia.metadata.currency
계정이 보고하는 통화입니다.
create_time
paidMedia.metadata.createdTime
계정 생성 타임스탬프.

캠페인 필드

캠페인 스키마는 TikTok 캠페인 세부 정보를 저장합니다.

TikTok 필드
XDM 필드
설명
campaign_id
paidMedia.campaignID
TikTok 내의 캠페인에 대한 고유 식별자입니다.
advertiser_id
paidMedia.accountID
상위 광고주 계정의 식별자입니다.
campaign_name
paidMedia.metadata.name
캠페인 표시 이름입니다.
operation_status
paidMedia.metadata.status
캠페인 상태(예: 활성 또는 일시 정지됨).
create_time
paidMedia.metadata.createdTime
캠페인 생성 타임스탬프.
modify_time
paidMedia.metadata.updatedTime
마지막 캠페인 수정 타임스탬프입니다.

광고 그룹 필드

광고 그룹 스키마는 TikTok 광고 그룹 세부 정보를 저장합니다.

TikTok 필드
XDM 필드
설명
adgroup_id
paidMedia.adGroupID
TikTok 내의 광고 그룹에 대한 고유 식별자입니다.
campaign_id
paidMedia.campaignID
상위 캠페인의 식별자입니다.
adgroup_name
paidMedia.metadata.name
광고 그룹 표시 이름입니다.
operation_status
paidMedia.metadata.status
광고 그룹 상태(예: 활성 또는 일시 정지됨).

광고 필드

광고 스키마는 TikTok 광고 세부 정보를 저장합니다.

TikTok 필드
XDM 필드
설명
ad_id
paidMedia.adID
TikTok 내의 광고에 대한 고유 식별자입니다.
adgroup_id
paidMedia.adGroupID
상위 광고 그룹의 식별자.
ad_name
paidMedia.metadata.name
광고 표시 이름입니다.
operation_status
paidMedia.metadata.status
광고 상태(예: 활성 또는 일시 정지됨)

에셋 필드

자산 스키마는 TikTok 이미지 및 비디오 크리에이티브 세부 정보를 저장합니다.

TikTok 필드
XDM 필드
설명
image_id / video_id
paidMedia.assetID
TikTok 내의 이미지 또는 비디오 자산에 대한 고유 식별자입니다.
advertiser_id
paidMedia.accountID
상위 광고주 계정의 식별자입니다.

요약 지표 필드

요약 지표 스키마는 TikTok 계정, 캠페인, 광고 그룹, 광고 및 자산에 대한 성능 데이터를 저장합니다.

각 지표 레코드는 측정하는 엔티티의 식별자에 매핑됩니다.

엔티티
XDM 필드에 매핑
계정
paidMedia.accountID
캠페인
paidMedia.campaignID
광고 그룹
paidMedia.adGroupID
광고
paidMedia.adID
자산
paidMedia.assetID

문제 해결

TikTok Ads 원본과 관련된 일반적인 문제를 해결하려면 다음 표를 사용하십시오.

문제
원인
연결은 성공하지만 선택할 광고주 계정이 나타나지 않습니다.
인증 TikTok 사용자에게 광고주 계정에 대한 광고 관리 액세스 권한이 없거나 앱이 비즈니스 확인을 완료하지 않았습니다. TikTok for Business Developer Portal에서 앱 상태를 확인하세요.
데이터 흐름은 실행되지만 데이터 세트에 도착하는 데이터는 없습니다.
앱이 여전히 샌드박스 검토 상태일 수 있습니다. 연결 자체가 성공하더라도 앱이 검토를 통과할 때까지 TikTok에서 프로덕션 데이터를 반환하지 않습니다.
채우기 작업이 속도 제한 오류와 함께 중간에 실패합니다.
앱의 기본 속도 제한 계층이 요청한 날짜 범위에 비해 너무 낮습니다. 큰 채우기를 실행하기 전에 TikTok에서 속도 제한을 늘리도록 요청하십시오.
에셋 성능과 같은 특정 지표 분류는 예상이나 오류보다 적은 행을 반환합니다.
모든 지표가 모든 보고 차원 조합에서 지원되는 것은 아닙니다. 프로덕션에서 사용하기 전에 테스트 광고주 계정에 대해 영향을 받는 분류의 유효성을 검사합니다.

다음 단계

기존 캠페인 및 광고에 적격한 TikTok 광고주 계정이 있음을 확인한 후 UI를 사용하여 TikTok 광고를 Experience Platform에 연결하여 계속합니다.

이 항목에 대한 추가 도움말

recommendation-more-help
experience-platform-help-sources