Google Ads カスタマーマッチ(Tealium提供の資格情報)コネクタ構成ガイド
この記事では、Tealiumが提供する資格情報を使用するGoogle Adsカスタマーマッチコネクタの構成方法について説明します。
Google Data Manager API アクションへの移行
以下のアクションは古いGoogle Ads APIを使用しています:
- リマーケティングリストへのユーザー追加
- リマーケティングリストからのユーザー削除
以下の代替アクションを使用してください。これらはGoogle Data Manager APIに基づいています:
- リストへのユーザー追加(Data Manager API)
- リストからのユーザー削除(Data Manager API)
詳細については、Google Data Manager API 移行ガイドを参照してください。
構成
コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタの追加方法については、コネクタについての記事を参照してください。
このコネクタを追加する際には、ベンダーのデータプラットフォームポリシーを受け入れるよう求められます。
コネクタを追加した後、以下の構成を構成します:
- カスタマーID:(必須)管理する広告アカウントのカスタマーIDを提供してください。
- マネージャーカスタマーID:(オプション)クライアントのカスタマーにアクセスする場合、マネージャーカスタマーIDを構成し、広告アカウントへの完全なアクセス権を持っている必要があります。
ユーザーリストの作成
ユーザーリストを作成するには、ユーザーリストの作成をクリックし、次の情報を入力します:
| パラメータ | 説明 |
|---|---|
| リスト名 | (必須)ユーザーリストの名前。 |
| リストタイプ | (必須)リストのタイプ。これにより、このリストで使用されるユーザー識別情報のタイプが決まります:
|
| アプリID | モバイル広告リストタイプに必要です。データをGoogle Ads APIに送信するモバイルアプリケーションを一意に識別する文字列です。 |
| リストメンバーシップの寿命 | (オプション)ユーザーがリストに追加されてからリストに残る日数。0から540の間でなければなりません。デフォルトの寿命は540日です。 |
| リストの説明 | (オプション)リストの説明。 |
アクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| リストへのユーザー追加(Data Manager API) | ✓ | ✓ |
| リストからのユーザー削除(Data Manager API) | ✓ | ✓ |
| リマーケティングリストへのユーザー追加 | ✓ | ✓ |
| リマーケティングリストからのユーザー削除 | ✓ | ✓ |
ユーザー識別子
各アクションにはユーザー識別子が必要です。ベンダーはこれらの値が正規化され、SHA-256でハッシュ化されていることを要求します。マップされたユーザー識別子の値は、次の要件を満たすことが期待されます:
- 小文字
- テキストの先頭と末尾からの空白のトリミング
- SHA-256でのハッシュ化
すでに正規化されハッシュ化された属性をマッピングすることも、コネクタに正規化とハッシュ化を行わせることもできます。シナリオに適したマッピングを選択してください。
必要なユーザー識別子は、選択されたユーザーリストタイプに基づいています。ユーザーリストタイプは次のいずれかになります:
- Google Ads API:
CONTACT_INFOCRM_IDMOBILE_ADVERTISING_ID
- Google Data Manager API:
CONTACT_IDMOBILE_IDUSER_ID
次のユーザー識別子フィールドがサポートされています:
| ユーザー識別子フィールド | 説明 |
|---|---|
CONTACT_INFO (Google Ads API) |
ハッシュ化されたメール、ハッシュ化された電話番号、または住所情報を提供します。このユーザーデータタイプには、以下にリストされているすべての住所情報フィールドが必要です。
|
CRM_ID (Google Ads API) |
|
MOBILE_ADVERTISING_ID (Google Ads API) |
|
CONTACT_ID (Data Manager API) |
連絡先情報:メールアドレス、電話番号、住所。 |
MOBILE_ID (Data Manager API) |
モバイルID:モバイルデバイスID。 |
USER_ID (Data Manager API) |
ユーザーID:第一者識別子。 |
リストへのユーザー追加(Data Manager API)
API情報
このコネクタは次のベンダーAPIを使用します:
- API名:Google Data Manager API
- APIバージョン:v1
- APIエンドポイント:
https://datamanager.googleapis.com - ドキュメント:Google Data Manager API
バッチ制限
このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並行処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。次のいずれかの閾値が達成されるか、プロファイルが公開されるまでリクエストはキューに入れられます:
- 最大リクエスト数:10,000
- 最古のリクエストからの最大時間:60分
- リクエストの最大サイズ:40 MB
パラメータ
| パラメータ | 説明 |
|---|---|
| ユーザーリスト | Data Manager APIからユーザーリストを選択します。詳細については、Data Manager API: カスタマーマッチの概要を参照してください。 |
ユーザー識別子
| パラメータ | 説明 |
|---|---|
| カスタマーIDの上書き | (オプション)コネクタ構成のカスタマーIDを上書きするカスタマーIDを提供します。このオプションを使用する場合は、ユーザーリストIDの上書きも使用する必要があります。 |
| ユーザーリストIDの上書き | (オプション)必要セクションのユーザーリストを上書きするユーザーリストIDを提供します。このフィールドを使用すると、イベント属性を使用してユーザーリストIDを入力できます。カスタマーIDの上書きを使用する場合は必須です。値はリストIDでなければなりません。例:9310271231。 |
リストからのユーザー削除(Data Manager API)
マッピングオプションについては、リストへのユーザー追加(Data Manager API)を参照してください。
リマーケティングリストへのユーザー追加(非推奨)
バッチ制限
このコネクタアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用することができます。詳細については、バッチアクションを参照してください。次のいずれかの閾値が達成されるか、プロファイルが公開されるまでリクエストはキューに入れられます:
- 最大リクエスト数:33,000
- 最古のリクエストからの最大時間:60分
- リクエストの最大サイズ:40 MB
API情報
このコネクターは以下のベンダーAPIを使用しています:
- API名:Google Ads API
- APIバージョン:v18
- APIエンドポイント:
https://googleads.googleapis.com/ - ドキュメント:Google Ads API
パラメータ
| パラメータ | 説明 |
|---|---|
| リマーケティングリスト | リマーケティングユーザーリストを選択します。詳細については、Google Ads: リマーケティングとオーディエンスターゲティングを参照してください。利用可能なオプションには、ファーストパーティCRMデータタイプのユーザーリストのみが含まれます。ユーザーリストを作成するには、ユーザーリストの作成を参照してください。 |
| カスタマーIDオーバーライド | (オプション)コネクタ構成のカスタマーIDをオーバーライドするためのカスタマーIDを提供します。このオプションを使用する場合は、ユーザーリストIDオーバーライドも入力する必要があります。 |
| マネージャーカスタマーIDオーバーライド | (オプション)カスタマーIDオーバーライドを使用してクライアントカスタマーにアクセスする場合は、マネージャーカスタマーIDを提供します。 |
| ユーザーリストIDオーバーライド | (オプション)ユーザーリストのリソース名(リストIDとタイプ)をオーバーライドするために提供します。このフィールドでは、ユーザーリストIDを入力するためにEventStream変数を使用できます。カスタマーIDオーバーライドを使用する場合は必須です。値は次の形式である必要があります ID:TYPE、例えば 123456:CONTACT_INFO。 |
同意
リマーケティングリストへのユーザー追加アクションを使用する際、コネクタはadUserDataおよびadPersonalizationパラメータに対してGRANTEDの値を送信します。同意していない訪問がリストに追加されないようにするためには、訪問のプロファイル同意状態をチェックするルールを持つオーディエンスを作成し、リストから同意していない訪問を削除するためにリマーケティングリストからの削除アクションを使用します。
リマーケティングリストからユーザーを削除する(非推奨)
マッピングオプションについては、リマーケティングリストへのユーザー追加を参照してください。
最終更新日 :: 2026年April月22日