TikTokオフラインイベントコネクタ構成ガイド | サーバーサイドコネクタ

API情報

このコネクタは以下のベンダーAPIを使用します：

API名：TikTok HTTP API
APIバージョン：v1.3
APIエンドポイント：https://business-api.tiktok.com/open_api/v1.3
ドキュメンテーション：TikTokオフラインイベントAPI

コネクタアクション

アクション名	AudienceStream	EventStream
オフラインイベントを送信（リアルタイム）	✗	✓
オフラインイベントを送信（バッチ処理）	✗	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を構成します：

アクセストークン
必須。TikTokで構成したアクセストークン。
広告主ID
必須。あなたのTikTokアカウントのID値。

アクション

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

オフラインイベントを送信（リアルタイム）

メールアドレスまたは電話番号のパラメータを提供することをお勧めします。

コンテンツ名、コンテンツタイプ、コンテンツカテゴリ、コンテンツID、数量、価格のデータタイプ属性を提供して、複数のアイテムを追加します。配列データタイプの属性は、長さが等しくなければなりません。

単一値の属性を使用することもでき、それぞれのアイテムに適用されます。

Tealium iQタグIDを構成すると、コネクタはTealium iQタグ管理から送信されるイベントID値を使用します。

パラメータ

パラメータ	説明
イベント名	必須。コンバージョンイベント名。
カスタムイベント名	コンバージョンイベント名。
イベントセットID	イベントセットID。
イベントID	各イベントの一意の値。このIDはTikTokとのデータマッチングに使用できます。
タイムスタンプ	ISO-8601形式のイベントのタイムスタンプ。例えば、`2019-06-12T19:11:01:152Z`。タイムスタンプが提供されていない場合、現在のタイムスタンプが使用されます。
メール（既にSHA256でハッシュ化されている）	既にSHA256でハッシュ化されたクリアテキストのメールアドレス（`@`記号を含む必要があります）を提供します。
メール（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供します。コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
電話番号（既にSHA256でハッシュ化されている）	SHA256でハッシュ化された電話番号を提供します。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供します。コネクタはこの値を空白トリムし、SHA256ハッシュを使用してハッシュ化します。
注文ID	トランザクションの注文ID。
ショップID	トランザクションのショップID。
通貨	通貨コード、ISO-4217。
値	推奨。全コンテンツの収益。
イベントチャネル	推奨。イベントチャネル。`email`、`website`、`phone_call`、`in_store`、`crm`、`other`をサポートします。
コンテンツ名	製品またはコンテンツの名前。配列データタイプの属性を使用して複数のコンテンツを追加します。
コンテンツタイプ	製品またはコンテンツのタイプ。
コンテンツカテゴリ	製品またはコンテンツのカテゴリ。
コンテンツID	製品またはコンテンツの識別子。
数量	アイテムの数。
価格	製品またはコンテンツの価格。
Tealium iQタグID	Tealium iQからのイベントIDを使用します。

オフラインイベントを送信（バッチ処理）

メールアドレスまたは電話番号のパラメータを提供することをお勧めします。

単一値の属性を使用することもでき、それぞれのアイテムに適用されます。

Tealium iQタグIDを構成すると、コネクタはTealium iQタグ管理から送信されるイベントID値を使用します。

バッチ制限

このアクションは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、以下のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

リクエストの最大数：100
最古のリクエストからの最大時間：10分
リクエストの最大サイズ：10MB

パラメータ

パラメータ	説明
イベント名	必須。コンバージョンイベント名。
カスタムイベント名	コンバージョンイベント名。
イベントセットID	イベントセットID。
イベントID	各イベントの一意の値。このIDはTikTokとのデータマッチングに使用できます。
タイムスタンプ	ISO-8601形式のイベントのタイムスタンプ。例えば、`2019-06-12T19:11:01:152Z`。タイムスタンプが提供されていない場合、現在のタイムスタンプが使用されます。
メール（既にSHA256でハッシュ化されている）	既にSHA256でハッシュ化されたクリアテキストのメールアドレス（`@`記号を含む必要があります）を提供します。
メール（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供します。コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
電話番号（既にSHA256でハッシュ化されている）	SHA256でハッシュ化された電話番号を提供します。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供します。コネクタはこの値を空白トリムし、SHA256ハッシュを使用してハッシュ化します。
注文ID	トランザクションの注文ID。
ショップID	トランザクションのショップID。
通貨	通貨コード、ISO-4217。
値	推奨。全コンテンツの収益。
イベントチャネル	推奨。イベントチャネル。`email`、`website`、`phone_call`、`in_store`、`crm`、`other`をサポートします。
コンテンツ名	製品またはコンテンツの名前。配列データタイプの属性を使用して複数のコンテンツを追加します。
コンテンツタイプ	製品またはコンテンツのタイプ。
コンテンツカテゴリ	製品またはコンテンツのカテゴリ。
コンテンツID	製品またはコンテンツの識別子。
数量	アイテムの数。
価格	製品またはコンテンツの価格。
Tealium iQタグID	Tealium iQからのイベントIDを使用します。