Google Display & Video 360 カスタマーマッチコネクタ構成ガイド
この記事では、Google Display & Video 360 カスタマーマッチコネクタの構成方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します:
- API名:Google Audience Partner API
- APIバージョン:v2
- APIエンドポイント:
https://audiencepartner.googleapis.com/v2 - ドキュメント:Google Audience Partner API: Customer Match audience
要件
このコネクタを構成する前に、Google Display & Video 360アカウントでTealiumをリンクアカウントとして追加してください。
詳細については、Google Display & Video 360: Sharing audience lists from external data management platforms or customer match uploader partnersを参照してください。
構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、About Connectorsを参照してください。
このコネクタを追加する際には、ベンダーのデータプラットフォームポリシーを受け入れるよう求められます。
コネクタを追加した後、以下の構成を構成します:
- Customer ID:(必須)TealiumにリンクされたあなたのGoogle DV360パートナーID。パートナーIDを見つけるには、Google DV360ダッシュボードのPartner Settings > Basic Detailsにアクセスしてください。
- Target Product:(必須)リンクされたアカウントの対象製品。
コネクタの構成が完了したら、Doneをクリックします。
カスタマーマッチリストの作成
カスタマーマッチリストを作成するには、Create Customer Match Listをクリックし、以下の情報を入力します:
| パラメータ | 説明 |
|---|---|
| List Name | (必須)カスタマーマッチリスト名。 |
| List type | (必須)リストタイプ。このタイプは、このリストで使用されるユーザー識別情報のタイプに影響します:
|
| App ID | Mobile Advertisingリストタイプに必要。データが収集されたモバイルアプリケーションを一意に識別する文字列。 |
| List Membership Lifespan | (オプション)ユーザーがリストに追加されてからリストに残る日数。数値は0から540の間でなければなりません。デフォルトの寿命は540日です。 |
| List Description | (オプション)リストの説明。 |
アクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| Add to Customer Match List (Data Manager API) | ✓ | ✓ |
| Remove from Customer Match List (Data Manager API) | ✓ | ✓ |
| Add to Customer Match List (Deprecated) | ✓ | ✓ |
| Remove from Customer Match List (Deprecated) | ✓ | ✓ |
ユーザー識別子
各アクションにはユーザー識別子が必要であり、これらの値は正規化され、SHA-256でハッシュ化する必要があります。マッピングする各ユーザー識別子値は、以下の要件を満たす必要があります:
- 小文字
- テキストの先頭と末尾から空白をトリム
- SHA-256でハッシュ化
既に正規化されハッシュ化された属性をマッピングするか、コネクタに正規化とハッシュ化を許可します。シナリオに適したマッピングを選択してください。
選択するUser Listタイプはユーザー識別子のタイプを決定します。User Listタイプは以下のいずれかです:
CONTACT_INFOMOBILE_ADVERTISING_ID
サポートされているユーザー識別子フィールドは以下の通りです:
| ユーザー識別子フィールド | 説明 |
|---|---|
CONTACT_INFO |
|
MOBILE_ADVERTISING_ID |
|
Add to Customer Match List (Data Manager API)
API情報
このコネクタは以下のベンダーAPIを使用します:
- API名:Google Data Manager API
- APIバージョン:v1
- APIエンドポイント:
https://datamanager.googleapis.com - ドキュメント:Google Data Manager API
バッチ制限
このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます:
- 最大リクエスト数:66,000
- 最古のリクエストからの最大時間:1440分
- リクエストの最大サイズ:50 MB
パラメータ
| パラメータ | 説明 |
|---|---|
| Customer Match List | カスタマーマッチリストを選択します。Tealiumコネクタを通じて作成されたリストのみが利用可能です。カスタマーマッチリストを作成するには、Create customer match listを参照してください。 |
| User Identifier | マッチするユーザー識別子。サポートされているフィールドについては、User Identifiersを参照してください。 |
同意
Add Visitor to Customer Match Listアクションを使用する場合、コネクタはデフォルトでadUserDataおよびadPersonalizationの同意にGRANTEDの値を送信します。リストに追加されないように非同意の訪問に対するオーディエンスロジックを使用してください。リストから非同意の訪問を削除するには、Remove from Customer Match Listアクションを使用してください。
Remove from Customer Match List (Data Manager API)
マッピングオプションについては、Add to Customer Match List (Data Manager API)を参照してください。
Add to Customer Match List (Deprecated)
このアクションは非推奨であり、将来のリリースで削除されます。Add to Customer Match List (Data Manager API)に移行してください。
TealiumはGoogle DV 360から直接リスト統計を取得するため、このコネクタとGoogle DV 360 Customer Match connector insightのマッチ数とコネクタリクエストの総量に差が生じる場合があります。
API情報
このコネクタは以下のベンダーAPIを使用します:
- API名:Google Ads API
- APIバージョン:v18
- APIエンドポイント:
https://googleads.googleapis.com/ - ドキュメント:Google Ads API
バッチ制限
このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます:
- リクエストの最大数:100,000
- 最古のリクエストからの最大時間:1440分
- リクエストの最大サイズ:50 MB
パラメータ
| パラメータ | 説明 |
|---|---|
| カスタマーマッチリスト | カスタマーマッチリストを選択します。Tealiumコネクタを通じて作成されたリストのみが利用可能です。カスタマーマッチリストを作成するには、カスタマーマッチリストの作成を参照してください。 |
同意
カスタマーマッチリストへの訪問追加 アクションを使用する際、コネクタはデフォルトで adUserData と adPersonalization の同意に対して GRANTED の値を送信します。同意していない訪問がリストに追加されないようにオーディエンスロジックを使用してください。同意していない訪問をリストから削除するには、カスタマーマッチリストから削除 アクションを使用してください。
カスタマーマッチリストからの削除(非推奨)
このアクションは非推奨であり、将来のリリースで削除されます。カスタマーマッチリストからの削除(データマネージャAPI)に移行してください。
API情報
このコネクタは以下のベンダーAPIを使用します:
- API名:Google Ads API
- APIバージョン:v18
- APIエンドポイント:
https://googleads.googleapis.com/ - ドキュメント:Google Ads API
バッチ制限
このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます:
- リクエストの最大数:100,000
- 最古のリクエストからの最大時間:1440分
- リクエストの最大サイズ:50 MB
パラメータ
| パラメータ | 説明 |
|---|---|
| カスタマーマッチリスト | カスタマーマッチリストを選択します。Tealiumコネクタを通じて作成されたリストのみが利用可能です。 |
最終更新日 :: 2026年September月9日