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