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

Last update: Fri Mar 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

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

TikTok 前提条件 prerequisites

次の手順で TikTok 使用する web イベント API TikTok イベント API を使用する場合は、 TikTok ピクセルコードとアクセストークン。

有効な TikTok を作成するためにビジネスアカウント用に TikTok partner 設定を使用するピクセル。次に移動： TikTok （ビジネス登録ページ）をクリックして、アカウントを作成します（まだ持っていない場合）。

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

次に移動： Assets 「」タブで「」を選択します。 イベント.
「Web イベント」で、「管理.
選択 ウェブイベントの設定.
選択 パートナーの設定 を設定します。

詳しくは、ピクセルを使い始めるの設定方法の詳細については、ガイドを参照してください。 TikTok ピクセル。

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

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

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

拡張機能をインストールするには、「」を選択します。 拡張機能 をクリックします。 Adobe Analytics の カタログ タブで、 TikTok Web Events API 拡張機能 次に、「 インストール.

次を表示する拡張機能カタログ： TikTok 拡張機能カードのハイライト表示のインストール。

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

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

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

TikTok の設定画面 TikTok web イベント API 拡張機能。

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

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

新規作成ルールを設定します。の下 アクション、新しいアクションを追加し、拡張機能をに設定します。 TikTok Web Events API 拡張機能. Edge ネットワークイベントをに送信するには、以下を実行します。 TikTokを設定し、 アクションタイプ から TikTok Web イベント API イベントの送信.

The TikTok Web イベント API イベントの送信アクションタイプが選択されています TikTok ルールを使用して、データ収集 UI に表示されます。

選択後、次に示すように、イベントをさらに設定するための追加のコントロールが表示されます。完了したら、「」を選択します。 変更を保持 」と入力してルールを保存します。

Web イベントとパラメーター

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

入力

説明

イベント名

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

イベント時刻

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

イベント ID

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

The Web Events and Parameters セクションに、フィールドへのデータ入力例を示します。

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

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

入力

説明

IP アドレス

ブラウザーのハッシュ化されていない公開 IP アドレス。 IPv4 および IPv6 アドレスに対するサポートが提供されます。 IPv6 アドレスの完全形式と圧縮形式の両方が認識されます。

ユーザーエージェント

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

メール

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

Phone

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

Cookie ID

Pixel SDK を使用している場合、一意の ID が _ttp cookie（cookie が有効な場合） The _ttp の値を抽出して、このフィールドで使用できます。

外部 ID

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

TikTok Click ID

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

ページ URL

イベント時のページ URL。

ページリファラー URL

ページリファラーの URL。

The User Context Parameters セクションに、フィールドへのデータ入力例を示します。

プロパティパラメーター

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

入力

説明

価格

1 つの項目のコスト。

数量

イベントで購入された品目の数。 0 より大きい正の数を指定する必要があります。

コンテンツタイプ

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

コンテンツ ID

商品品目の一意の ID。

コンテンツのカテゴリ

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

コンテンツ名

ページ/製品の名前。

通貨

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

値

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

説明

項目またはページの説明。

クエリ

商品の検索に使用された文字列。

ステータス

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

The Properties Parameters セクションに、フィールドへのデータ入力例を示します。

イベントの重複排除 deduplication

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

重複のないクライアントおよびサーバーから異なるイベントタイプが送信される場合は、重複排除は必要ありません。レポートが否定的な影響を受けないようにするには、 TikTok ピクセル SDK と TikTok web イベント API 拡張機能の重複は除外されます。

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

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

次の手順

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

recommendation-more-help

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