ドキュメントExperience Platformソースコネクタガイド

[Beta]{class="badge informative"}

TikTok Ads

最終更新日： 2026年10月23日

作成対象：

  • 開発者
NOTE
TikTok Ads ソースはベータ版です。 ベータ版のラベル付きコネクタの使用について詳しくは、​ ソースの概要を参照してください。
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が作成します。
  • 1回限りのバックフィルジョブは、データフローを作成した後に実行されます。
  • 増分ジョブは、データフローを作成した翌日から1日に1回実行されます。

前提条件

TikTok AdsをExperience Platformに接続する前に、次の条件を満たしていることを確認してください。

  • Marketing API製品が追加された既存のTikTok for Business開発者アプリ。
  • TikTokからのアプリ承認。 アプリはサンドボックスモードで起動し、実稼動データとアカウントデータにアクセスする前にTikTokがアプリを確認して承認する必要があります。
  • ビジネスの検証： これはアプリのレビューとは別の承認プロセスであり、レート制限の高い階層に必要です。
  • 最初にアカウントを承認する前に付与された次のアプリ権限グループ。 TikTokでは、再認証せずに後でこれらの権限を拡張することはできません：広告管理、​ レポート ​、広告アカウント管理、および​ オーディエンス管理。
  • バックフィルのボリュームに適したレート制限クォータ。 デフォルトのサンドボックス層は積極的にスロットリングするので、大きなバックフィルを実行する前に増分をリクエストします。
  • TikTok広告アカウントで既にキャンペーンと広告が設定されています。 コネクターは、この既存の広告データから読み取ります。 TikTok件のキャンペーン、広告、その他のリソースは作成、変更、削除されません。

スキーマとデータセットのプロビジョニング

TikTok Ads ソースは、ターゲットデータセット、スキーマ、フィールドマッピングを自動的に割り当てます。 データフローの作成時に、ターゲットデータセットを選択したり、自分でフィールドをマッピングしたりすることはありません。

コネクターは、エンティティタイプごとに1つの有料メディアデータセット（アカウント、キャンペーン、広告グループ、広告、アセット、概要の指標）をプロビジョニングします。 これらは、Google AdsおよびMeta Adsのソースが既に入力されているのと同じ正規スキーマです。 コネクタが各エンティティにマッピングするコア ID フィールドについては、次の節を参照してください。

TikTok Ads XDM スキーマ

この節では、TikTok Ads ソースが各有料メディアスキーマにマッピングするコア ID フィールドとステータスフィールドについて説明します。 マッピングされたすべてのレコードには、エンティティを識別するentityType値とpaidMedia.adNetwork値tiktokも含まれます。

アカウントフィールド

アカウントスキーマには、TikTok広告主アカウントの詳細が保存されます。

TikTok フィールド
XDM フィールド
説明
advertiser_id
paidMedia.accountID
TikTok内の広告主アカウントの一意のID。
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内のキャンペーンの一意のID。
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内の広告グループの一意のID。
campaign_id
paidMedia.campaignID
親キャンペーンの識別子。
adgroup_name
paidMedia.metadata.name
広告グループの表示名。
operation_status
paidMedia.metadata.status
広告グループのステータス（アクティブまたは一時停止など）。

広告フィールド

広告スキーマには、TikTok広告の詳細が保存されます。

TikTok フィールド
XDM フィールド
説明
ad_id
paidMedia.adID
TikTok内の広告の一意のID。
adgroup_id
paidMedia.adGroupID
親広告グループの識別子。
ad_name
paidMedia.metadata.name
広告の表示名。
operation_status
paidMedia.metadata.status
広告のステータス（アクティブ、一時停止など）。

アセットフィールド

アセットスキーマには、TikTokの画像とビデオのクリエイティブの詳細が保存されます。

TikTok フィールド
XDM フィールド
説明
image_id / video_id
paidMedia.assetID
TikTok内の画像またはビデオアセットの一意のID。
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 AdsをExperience Platformに接続します。

このトピックの詳細ヘルプ

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