---
title: Zeta Globalイベントコネクタ構成ガイド
description: Tealium EventStreamからZetaのTrack Event REST APIに行動イベントを送信するためのZeta Globalイベントコネクタを構成します。
url: https://docs.tealium.com/ja/server-side-connectors/zeta-global-events-connector/
---
## API情報

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

* API名：Zeta Global API
* APIバージョン：ver2
* APIエンドポイント：`https://api.zetaglobal.net/`
* ドキュメント：[Zeta Global API](https://docs.zetaglobal.com/reference/track-an-event-rest)

## 構成

コネクタマーケットプレイスにアクセスして新しいコネクタを追加します。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。

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

* **アクセストークン**：あなたの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[]`を埋めます。 |

### バッチでイベントを追跡

#### バッチ制限

このアクションはバッチリクエストを使用してベンダーへの大量データ転送をサポートします。並行処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加します。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。次のいずれかの閾値が満たされるか、プロファイルが公開されるまでリクエストはキューに入れられます：

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

このアクションのアクティビティデータ、加入者データ、およびプロパティデータの構成は[イベントを追跡](#track-event)と同一です。

このバッチアクションは`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[]`のフィールドにマッピングして、プロファイルにメールまたは電話チャネルを添付します。


<blockquote>
Zetaは新しいプロファイルにのみ連絡先を関連付けます。既存のプロファイルは連絡先データセクションを無視します。
</blockquote>


| パラメータ | 説明 |
| --- | --- |
| 連絡先の値 | （必須）連絡先のメールアドレスまたは電話番号。他の連絡先フィールドがマッピングされている場合は必須です。 |
| 連絡先の種類 | 連絡先の種類：`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[]`を埋めます。 |