TikTok web イベント API 拡張機能の概要

Last update: Thu Oct 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

TikTok events API は、Web サイト上のユーザーアクションに関する情報をと直接共有できる、セキュアな Edge Network APITikTok インターフェイスです。イベント転送ルールを活用し、Adobe Experience Platform Edge Network Web イベント API 拡張機能を使用して、TikTok から TikTok にデータを送信できます。

TikTok 前提条件 prerequisites

TikTok Web イベント API を設定して TikTok イベント API を使用するには、TikTok ピクセルコードとアクセストークンを生成する必要があります。

パートナー設定を使用して TikTok ピクセルを作成するには、ビジネスアカウントの有効な TikTok が必要です。アカウントをまだお持ちでない場合は、TikTok ビジネス登録ページ用に移動し、アカウントを登録して作成してください。

パートナー設定を使用して TikTok Pixel を設定するには、ビジネスアカウントにログインする必要があります。これを行うには、以下の手順に従います。

「Assets」タブに移動し、「Event」を選択します。
[Web イベント ] で、[Manage] を選択します。
Set Up Web Events を選択します。
接続方法として Partner Setup を選択します。

ピクセルのセットアップ方法について詳しくは、ピクセルの基本を学ぶ TikTok ガイドを参照してください。

ピクセルが正常に作成されたら、アクセストークンを生成できます。これを行うには、ピクセルに移動し、「Settings」タブを選択します。 Events API で、「Generate Access Token」を選択します。

ピクセルコードとアクセストークンの設定方法について詳しくは、TikTok はじめる前にを参照してください。

TikTok Web イベント API 拡張機能のインストールと設定 install

拡張機能をインストールするには、左側のナビゲーションで「Extensions」を選択します。「Catalog」タブで、TikTok Web Events API Extension を選択し、「Install」を選択します。

インストールを強調表示した TikTok 拡張機能カードを示す拡張機能カタログ

次の画面で、以前に TikTok Ads Manager から生成した次の設定値を入力します。

Pixel Code
Access Token

終了したら「Save」を選択します。

TikTok Web TikTok API 拡張機能の設定画面

イベント転送ルールの設定 config-rule

すべてのデータ要素を設定したら、イベントを TikTok に送信するタイミングと方法を決定するイベント転送ルールの作成を開始できます。

イベント転送プロパティに新しいルールを作成します。 Actions の下で、新しいアクションを追加し、拡張機能を TikTok Web Events API Extension に設定します。 Edge Network イベントを TikTok に送信するには、Action Type を Send TikTok Web Events API Event. に設定します

データ収集 UI で Send TikTok Web Events API Event ルールに対して選択されている TikTok アクションタイプ

選択後、以下に示すように、追加のコントロールでイベントをさらに設定できます。完了したら、「Keep Changes」を選択してルールを保存します。

Web Events and Parameters

Web イベントおよびパラメーターには、イベントに関する一般的な情報が含まれます。標準イベントは TikTok 統合ツール全体でサポートされており、レポート、コンバージョンの最適化、オーディエンスの構築に使用できます。

入力

説明

イベント名

イベントの名前。これらは、TikTok が作成した事前定義済みの名前を持つアクションで、必須フィールドです。サポートされるイベントについて詳しくは、TikTok Marketing API ドキュメントを参照してください。

イベント時間

ISO 8601 形式または yyyy-MM-dd'T'HH:mm:ss:SSSZ 形式の文字列としての日時。必須フィールドです。

イベント ID

各イベントを示すために広告主が生成した一意の ID。これはオプションのフィールドで、重複排除に使用されます。

フィールドへのデータ入力の例を示す Web Events and Parameters の節。

User Context Parameters

ユーザーコンテキストパラメーターには、web 訪問者イベントを TikTok ユーザーと照合するために使用される顧客情報が含まれています。複数のタイプのマッチングデータを含めると、ターゲティングと最適化モデルの精度を高めることができます。

入力

説明

IP アドレス

ブラウザーのハッシュ化されていないパブリック IP アドレス。 IPv4 アドレスと IPv6 アドレスのサポートが提供されます。 IPv6 アドレスの完全な形式と圧縮された形式の両方が認識されます。

ユーザーエージェント

ユーザーのデバイスからのハッシュ化されていないユーザーエージェント。

メール

コンバージョンイベントに関連付けられた連絡先のメールアドレス。

Phone

ハッシュを行う前に、電話番号を E164 形式 [+][country code][area code][local phone number] にする必要があります。

Cookie ID

Pixel SDKを使用している場合、Cookie が有効であれば、_ttp Cookie に一意の ID が自動保存されます。 _ttp の値を抽出して、このフィールドに使用できます。

外部 ID

ユーザー ID、外部 Cookie ID などの一意の ID は、SHA256 でハッシュ化する必要があります。

TikTok クリック ID

ttclid で広告が選択されるたびにランディングページの URL に追加される TikTok。

ページ URL

イベント発生時のページ URL。

ページリファラー URL

ページリファラーの URL。

フィールドへのデータ入力の例を示す User Context Parameters の節。

Properties Parameters

プロパティパラメーターを使用して、サポートされる追加のプロパティを設定します。

入力

説明

価格

1 つの品目の原価。

数量

イベントで購入されるアイテムの数。これは 0 より大きい正の数にする必要があります。

コンテンツタイプ

製品カタログを設定する際にデータフィードをどのように設定するかに応じて、product または product_group の値を content_type オブジェクトプロパティに割り当てる必要があります。

コンテンツ ID

商品項目の一意の ID。

コンテンツカテゴリ

ページ/製品のカテゴリ。

コンテンツ名

ページ/製品の名前。

通貨

イベントで購入される品目の通貨。これは ISO-4217 で表されます。

値

注文の合計価格。この値は価格*数量と等しくなります。

説明

アイテムまたはページの説明。

クエリ

商品の検索に使用されたテキスト文字列。

ステータス

注文、品目またはサービスのステータス。例えば、「submitted」とします。

フィールドへのデータ入力の例を示す Properties Parameters の節。

イベントの重複排除 deduplication

TikTok pixel SDKと TikTok web events API 拡張機能の両方を使用して同じイベントを TikTok に送信する場合、TikTok ピクセルを重複排除用に設定する必要があります。

重複せずにクライアントとサーバーから個別のイベントタイプが送信される場合は、重複排除は必要ありません。レポートに悪影響が及ばないようにするには、TikTok pixel SDKと TikTok web events API 拡張機能で共有される単一のイベントについて、重複排除が行われるようにしてください。

共有イベントを送信する場合は、すべてのイベントにピクセル ID、イベント ID および名前が含まれていることを確認してください。重複したイベントが 5 分以内に到着した場合は、結合されます。データフィールドが最初のイベントにない場合は、後続のイベントと組み合わされます。 48 時間以内に受信した重複イベントは削除されます。

このプロセスについて詳しくは、TikTok イベントの重複排除に関するのドキュメントを参照してください。

次の手順

このガイドでは、TikTok web イベント API 拡張機能を使用してサーバーサイドイベントデータを TikTok に送信する方法について説明しました。 Adobe Experience Platform のイベント転送機能について詳しくは、イベント転送の概要を参照してください。

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743