Zeta Globalイベントコネクタ構成ガイド
Tealium EventStreamからZetaのTrack Event REST APIに行動イベントを送信するためのZeta Globalイベントコネクタを構成します。
API情報
このコネクタは以下のベンダーAPIを使用します：
- API名：Zeta Global API
- APIバージョン：ver2
- APIエンドポイント：
https://api.zetaglobal.net/ - ドキュメント：Zeta Global API
構成
コネクタマーケットプレイスにアクセスして新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します：
- アクセストークン：あなたのZMP（Zetaマーケティングプラットフォーム）アクセストークン。コネクタはこの値をHTTP Basic認証ヘッダーのパスワードとして送信します。ユーザー名は
apiに固定されています。 - サイトID：あなたのZMPサイトID。コネクタはこの値を
POSTリクエストでhttps://api.zetaglobal.net/ver2/{site_id}/activitiesに使用します。
アクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| イベントを追跡 | ✗ | ✓ |
| イベントをバッチで追跡 | ✗ | ✓ |
| 識別付きでイベントを追跡 | ✗ | ✓ |
イベントを追跡
アクティビティデータ
Tealiumの属性をactivityのトップレベルフィールドにマッピングします。
| パラメータ | 説明 |
|---|---|
| イベント | （必須）イベントの名前。イベント名はZMPで構成されたイベント命名と一致する必要があります。 |
| タイムスタンプ | ISO-8601形式でのイベントの時間、例：2026-08-07T15:56:00Z。エポックミリ秒は422無効な日付形式エラーで拒否されます。マッピングされていない場合、Zetaは自身のサーバー時間を押印します。 |
加入者データ
Tealiumの属性をイベントに関連する人物のactivity.subscriberフィールドにマッピングします。
| パラメータ | 説明 |
|---|---|
| UID | （必須）人物の一意の識別子で、activity.subscriber.uidとして送信されます。UIDはイベント間で安定している必要があり、Zetaがそれらを1つのプロファイルに解決するためです。 |
| ユニーククライアントID名 | subscriber.unique_client_idエントリの識別子タイプです。ユニーククライアントID値と一緒にマッピングします。識別子タイプはZMPでの使用前に登録されている必要があります。未登録の名前は202で受け入れられ、静かに破棄されます。 |
| ユニーククライアントID値 | subscriber.unique_client_idエントリの識別子値です。ユニーククライアントID名と一緒にマッピングします。 |
このアクションはidentify_personを構成しないため、加入者名フィールドと連絡先はここでは利用できません。加入者名フィールドと連絡先をマッピングするには、識別付きでイベントを追跡するアクションを使用してください。
プロパティデータ
オプションです。Tealiumの属性をactivity.propertiesのキーにマッピングします。
| パラメータ | 説明 |
|---|---|
| 注文ID | 注文識別子で、properties.order_idにマッピングされます。 |
| アイテムID | アイテム識別子で、properties.items[].idにマッピングされます。 |
| アイテムSKU | アイテムSKUで、properties.items[].skuにマッピングされます。 |
| アイテムリソースタイプ | アイテムリソースタイプで、properties.items[].resourceTypeにマッピングされます。デフォルトはproductです。 |
| アイテム価格 | アイテム価格で、properties.items[].priceにマッピングされます。 |
| アイテム数量 | アイテム数量で、properties.items[].quantityにマッピングされます。 |
| アイテム製品名 | 製品名で、properties.items[].productnameにマッピングされます。 |
| アイテムカテゴリ | アイテムカテゴリで、properties.items[].categoryにマッピングされます。 |
| アイテムサブカテゴリ | アイテムサブカテゴリで、properties.items[].subcategoryにマッピングされます。 |
| アイテムサイズ | アイテムサイズで、properties.items[].sizeにマッピングされます。 |
| アイテムURL | アイテムURLで、properties.items[].urlにマッピングされます。 |
| Eコマース自動マッピング無効 | デフォルトでは、Tealiumのeコマース変数（_corder, _cprod, _csku, _cprice, _cquan, _cprodname, _ccat, _ccat2, dom.url）は自動的にactivity.propertiesにマッピングされます。このチェックボックスを選択してeコマース自動マッピングを無効にします。明示的なプロパティデータマッピングは常に自動マッピングに優先します。 |
アイテムフィールド（アイテムIDからアイテムURLまで）はインデックス位置によって組み合わされ、properties.items[]内の各アイテムオブジェクトを構築します。各アイテム属性は配列に解決され、すべての配列は同じ長さでなければなりません。
コネクタはあなたが追加する任意のカスタムキーをactivity.propertiesの下に配置します。
テンプレート
フラットキーから属性へのマッピングでは表現できないネストされたJSON構造を構築するためにテンプレートを使用します。
| パラメータ | 説明 |
|---|---|
| テンプレート — ネストされた値 | テンプレートをカスタムキーにマッピングして、そのキーの下にレンダリングされたJSON（オブジェクト、配列、またはスカラー）をpropertiesにネストします。 |
| テンプレート — アイテムリスト | アイテムオブジェクトのJSON配列をレンダリングするテンプレートをアイテムオプションにマッピングして、Zetaアイテムフィールド名（id, sku, resourceType, price, quantity, productname, category, subcategory, size, url）を使用してproperties.items[]リスト全体を一度に構成します。マッピングされたアイテムリストテンプレートは個々のアイテムフィールドマッピングを置き換えます。マッピングされたアイテムリストと個々のアイテムフィールドマッピングはeコマース自動マッピングに優先します。自動マッピングは、アイテムが明示的にマッピングされていない場合にのみitems[]を埋めます。 |
バッチでイベントを追跡
バッチ制限
このアクションはバッチリクエストを使用してベンダーへの大量データ転送をサポートします。並行処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加します。詳細については、バッチアクションを参照してください。次のいずれかの閾値が満たされるか、プロファイルが公開されるまでリクエストはキューに入れられます：
- 最大リクエスト数：100
- 最古のリクエストからの最大時間：10分
- リクエストの最大サイズ：1 MB
このアクションのアクティビティデータ、加入者データ、およびプロパティデータの構成はイベントを追跡と同一です。
このバッチアクションはidentify_personを構成しないため、加入者名フィールドと連絡先はここでは利用できません。加入者名フィールドと連絡先をマッピングするには、識別付きでイベントを追跡するアクションを使用してください。
識別付きでイベントを追跡
アクティビティデータ
Tealiumの属性をactivityのトップレベルフィールドにマッピングします。
| パラメータ | 説明 |
|---|---|
| イベント | （必須）イベントの名前。イベント名はZMPで構成されたイベント命名と一致する必要があります。 |
| タイムスタンプ | ISO-8601形式でのイベントの時間、例：2026-08-07T15:56:00Z。エポックミリ秒は422無効な日付形式エラーで拒否されます。マッピングされていない場合、Zetaは自身のサーバー時間を押印します。 |
加入者データ
Tealiumの属性をイベントに関連する人物のactivity.subscriberフィールドにマッピングします。
| パラメータ | 説明 |
|---|---|
| UID | （必須）人物の一意の識別子で、activity.subscriber.uidとして送信されます。UIDはイベント間で安定している必要があり、Zetaがそれらを1つのプロファイルに解決するためです。 |
| ユニーククライアントID名 | unique_client_idsリスト内のエントリの識別子タイプです。ユニーククライアントID値と一緒にマッピングします。1回の呼び出しで最大25の識別子ペア。識別子タイプはZMPでの使用前に登録されている必要があります。未登録の名前は202で受け入れられ、静かに破棄されます。 |
| ユニーククライアントID値 | unique_client_idsリスト内のエントリの識別子値です。ユニーククライアントID名と一緒にマッピングします。 |
| 名 | 人物の名前です。このアクションがidentify_personを構成するため、プロファイルに永続化されます。 |
| 姓 | 人物の姓です。このアクションがidentify_personを構成するため、プロファイルに永続化されます。 |
| フルネーム | 人物のフルネームです。このアクションがidentify_personを構成するため、プロファイルに永続化されます。 |
連絡先データ
オプション。Tealiumの属性をsubscriber.contacts[]のフィールドにマッピングして、プロファイルにメールまたは電話チャネルを添付します。
Zetaは新しいプロファイルにのみ連絡先を関連付けます。既存のプロファイルは連絡先データセクションを無視します。
| パラメータ | 説明 |
|---|---|
| 連絡先の値 | （必須）連絡先のメールアドレスまたは電話番号。他の連絡先フィールドがマッピングされている場合は必須です。 |
| 連絡先の種類 | 連絡先の種類：emailまたはphone。デフォルトはemailです。 |
| 優先事項 | 連絡先の優先事項、例えばstandardまたはbilling。デフォルトはstandardです。追加の優先事項はZMPで構成できます。 |
| サブスクリプションの状態 | サブスクリプションの状態：new、active、inactive、または空白。デフォルトはactiveです。空白またはnull値は既存の連絡先の現在の状態を保持し、新しい連絡先にはnewを構成します。new状態は連絡先にメッセージが送信されるまで保持されます。 |
| 強制アクティブ | 連絡先を作成する際、デフォルトのnew状態をバイパスするためにこれを選択します。 |
| 非活動の理由 | 非活動の連絡先が非活動である理由、例えばunsubscribed。 |
| ダブルオプトインの状態 | ダブルオプトインの状態：singleまたはdouble。 |
| 電話の種類 | 電話の種類：mobileまたはlandline。電話連絡先にのみ適用されます。 |
| 最後にクリックされた時刻 | 最後にメッセージがクリックされた時刻、ISO-8601形式。 |
| 最後に開かれた時刻 | 最後にメッセージが開かれた時刻、ISO-8601形式。 |
| 最後に送信された時刻 | 最後にメッセージが送信された時刻、ISO-8601形式。 |
| 登録日時 | 連絡先が登録された日付、例えば2015-01-02T05:30:21ZのISO-8601形式。デフォルトは作成日です。 |
コネクタは、contact_propertiesオブジェクトの連絡先に追加するカスタムキーを書き込みます。
テンプレート
フラットなキーから属性へのマッピングでは表現できないネストされたJSON構造を構築するためにテンプレートを使用します。
| パラメータ | 説明 |
|---|---|
| テンプレート — ネストされた値 | テンプレートをカスタムキーにマッピングして、そのキーの下にcontact_propertiesでレンダリングされたJSONをネストします。 |
| テンプレート — 連絡先リスト | 連絡先オブジェクトのJSON配列をレンダリングするテンプレートをContactsオプションにマッピングして、Zetaの連絡先フィールド名を使用して一度にsubscriber.contacts[]リスト全体を構成します。マッピングされた連絡先リストテンプレートは個々の連絡先フィールドマッピングを置き換えます。 |
プロパティデータ
オプション。Tealiumの属性をactivity.propertiesのキーにマッピングします。
| パラメータ | 説明 |
|---|---|
| 注文ID | properties.order_idにマッピングされた注文識別子。 |
| アイテムID | properties.items[].idにマッピングされたアイテム識別子。 |
| アイテムSKU | properties.items[].skuにマッピングされたアイテムSKU。 |
| アイテムリソースタイプ | properties.items[].resourceTypeにマッピングされたアイテムリソースタイプ。デフォルトはproductです。 |
| アイテム価格 | properties.items[].priceにマッピングされたアイテム価格。 |
| アイテム数量 | properties.items[].quantityにマッピングされたアイテム数量。 |
| アイテム製品名 | properties.items[].productnameにマッピングされた製品名。 |
| アイテムカテゴリ | properties.items[].categoryにマッピングされたアイテムカテゴリ。 |
| アイテムサブカテゴリ | properties.items[].subcategoryにマッピングされたアイテムサブカテゴリ。 |
| アイテムサイズ | properties.items[].sizeにマッピングされたアイテムサイズ。 |
| アイテムURL | properties.items[].urlにマッピングされたアイテムURL。 |
| Eコマース自動マッピング無効 | デフォルトでは、Tealiumのeコマース変数（_corder, _cprod, _csku, _cprice, _cquan, _cprodname, _ccat, _ccat2, dom.url）は自動的にactivity.propertiesにマッピングされます。このチェックボックスを選択してeコマース自動マッピングを無効にします。明示的なプロパティデータマッピングは常に自動マッピングに優先します。 |
アイテムフィールド（アイテムIDからアイテムURLまで）はインデックス位置によって組み合わされ、properties.items[]の各アイテムオブジェクトを構築します。各アイテム属性は配列に解決され、すべての配列は同じ長さでなければなりません。
コネクタは、activity.propertiesの下に追加するカスタムキーを配置します。
テンプレート
フラットなキーから属性へのマッピングでは表現できないネストされたJSON構造を構築するためにテンプレートを使用します。
| パラメータ | 説明 |
|---|---|
| テンプレート — ネストされた値 | テンプレートをカスタムキーにマッピングして、そのキーの下にpropertiesでレンダリングされたJSON（オブジェクト、配列、またはスカラー）をネストします。 |
| テンプレート — アイテムリスト | アイテムオブジェクトのJSON配列をレンダリングするテンプレートをItemsオプションにマッピングして、Zetaアイテムフィールド名（id, sku, resourceType, price, quantity, productname, category, subcategory, size, url）を使用して一度にproperties.items[]リスト全体を構成します。マッピングされたアイテムリストテンプレートは個々のアイテムフィールドマッピングを置き換えます。マッピングされたアイテムリストと個々のアイテムフィールドマッピングはeコマース自動マッピングに優先します。自動マッピングは、明示的にアイテムがマッピングされていない場合にのみitems[]を埋めます。 |
最終更新日 :: 2026年August月26日