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

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

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

TikTok 前提条件 prerequisites

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

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

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

「Assets」タブに移動し、「イベント」を選択します。
「Web イベント」で、「管理」を選択します。
Web イベントを設定 を選択します。
接続方法として パートナー設定 を選択します。

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

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

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

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

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

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

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

ピクセルコード
アクセストークン

完了したら「保存」を選択します。

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

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

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

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

Send TikTok Web Events API Event アクションタイプが Data Collection UI の TikTok ルール用に選択されている。

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

Web イベントおよびパラメーター

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

入力

説明

イベント名

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

イベント時間

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

イベント ID

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

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

ユーザーコンテキストのパラメーター

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

入力

説明

IP アドレス

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

ユーザーエージェント

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

メール

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

Phone

電話番号は、ハッシュする前に E164 形式 [+][ 国コード ][ 市外局番 ][local phone number] である必要があります。

Cookie ID

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

外部 ID

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

TikTok クリック ID

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

ページ URL

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

ページリファラー URL

ページリファラーの URL。

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

プロパティパラメーター

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

入力

説明

価格

1 つの品目の原価。

数量

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

コンテンツタイプ

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

コンテンツ ID

商品項目の一意の ID。

コンテンツカテゴリ

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

コンテンツ名

ページ/製品の名前。

通貨

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

値

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

説明

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

クエリ

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

ステータス

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

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

イベントの重複排除 deduplication

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

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

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

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

次の手順

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

recommendation-more-help

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