Google Ads Customer Match アクションを Google Data Manager API に移行する

変更点

Google Ads Customer Match コネクタに、Google Data Manager API を使用する2つの新しいアクションを導入します：

• リストにユーザーを追加（Data Manager API）
• リストからユーザーを削除（Data Manager API）

これらのアクションは、コネクタUIの既存のリストにユーザーを追加およびリストからユーザーを削除するアクションを密接に反映して設計されており、GoogleのData Manager APIを通じてオーディエンスの更新を送信します。

さらに、コネクタの構成には、Google Ads アカウントとTealium間の製品リンクを確立するリンクステップが含まれるようになりました。このリンクは、新しい Data Manager API アクションを使用する前に必要です。

Data Manager API アクションを導入する理由

Google Data Manager API は、Customer Match データの取り込みにおける戦略的な進路です。

このAPIにコネクタを移行することで、以下の利点があります：

• Tealiumがあなたの代理として承認されたデータパートナーとして機能できるように、Google Ads顧客アカウントとTealium間の正式な製品リンクを使用します。
• ユーザーレベルのOAuthトークンに依存しないため、製品リンクが確立されると、Tealiumがデータパートナー統合を使用して取り込みを管理できます。
• 同意、利用規約、データのフォーマット（識別子の正規化およびハッシュ化を含む）に関するGoogleのCustomer Match要件と一致します。
• GoogleがGoogle AdsおよびData Manager APIを進化させるにつれて、構成の長期的な安定性が向上します。

既存のGoogle Ads API アクションの廃止

Google Ads Customer Match コネクタの既存のGoogle Ads API Customer Match アクションは、将来のリリースで廃止されます。

その間、以下の点に注意してください：

• 既存のアクションは引き続き機能します。
• 将来の変更を最小限に抑えるために、できるだけ早く新しい Data Manager API アクションに移行することを強くお勧めします。
• レガシーアクションを削除する前に、標準リリースチャネルを通じてタイムラインと重大な変更を通知します。

新しい Data Manager API アクションについて

新しいアクションは、Google Ads Customer Match コネクタの既存のGoogle Ads Customer Match アクションと一緒に表示されます：

• リストにユーザーを追加（Data Manager API）
• リストからユーザーを削除（Data Manager API）

主なポイント：

• UIレイアウト：これらのアクションの構成画面は、既存のGoogle Ads Customer Match アクションに密接に従っているため、ほとんどのマッピングと構成が馴染みのあるものになります。
• 同意と利用規約：Data Managerは、各取り込みコールに明示的な同意とCustomer Matchの利用規約を要求します。コネクタは、ペイロードに必要な同意と利用規約のフィールドが含まれていることを保証します。
• 識別子のフォーマット：プレーンテキストまたは事前にハッシュ化された識別子（メール、電話、郵便住所など）をマップします。SHA256ハッシュを適用とラベル付けされたフィールドを選択すると、TealiumがGoogleが要求する正規化（トリム、小文字化、ハッシュ化）を実行します。既にSHA256ハッシュ化されているとラベル付けされたフィールドを選択する場合、Googleのフォーマット要件をすでに満たしているデータを提供する責任があります。住所情報を提供する場合、国コード、名、姓、郵便番号のすべての4つのフィールドが必要です。住所フィールドが欠落している場合、コネクタはリクエストから住所オブジェクト全体を削除します。
• リストキータイプ：Data Manager APIを使用して作成および管理されるリストは、CONTACT_ID（メール/電話/住所）、USER_ID（ファーストパーティID）、またはMOBILE_ID（デバイスID）などのリストキータイプを使用します。アクション構成では、リストのキータイプと互換性のある識別子をマップする必要があります。

Manager Customer ID オーバーライドおよびその他のAds API固有のセクションは、Data Manager API アクションでは使用されません。Data Managerに関連する構成は、製品リンクと選択されたリストおよび識別子を通じて処理されます。

移行する前に

アクションを切り替える前に、これらの前提条件を確認して完了してください。

ステップ1: Data Manager API アクセスを含めてコネクタを再認証する

すでにTealiumにGoogle Ads Customer Match コネクタを構成している場合、Google OAuthトークンにData Manager APIスコープが含まれるようにコネクタを再認証する必要があります。

再認証するには：

1. 既存のGoogle Ads Customer Match コネクタを開きます。
2. 認証コントロール（Googleでサインインボタン）を使用して、Googleアカウントで再度サインインします。
3. このプロセス中に、コネクタは既存のGoogle Ads権限に加えてhttps://www.googleapis.com/auth/datamanagerを含むアクセスを要求します。

このステップは、製品リンクを作成し、Google Data Manager API アクションを使用する前に必要です。

ステップ2: Google Ads顧客IDをTealiumにリンクする（製品リンク）

再認証後、Google Ads顧客アカウントとTealium間に製品リンクを作成する必要があります。

製品リンクは、Google Ads顧客アカウントレベル（ユーザーリストの所有アカウント）で作成され、すべてのGoogle Data Manager API アクションを使用するための前提条件です。

製品リンクの作成に失敗した場合（たとえば、リンクがすでに存在するか、ユーザーに権限がない場合など）、UIのエラーメッセージを確認し、Google Adsの権限またはアカウント選択を適切に調整してください。

Google Ads顧客IDをTealiumにリンクするには：

1. コネクタ構成で、Tealiumに顧客IDをリンクするとラベル付けされたセクションを探します。
2. このコネクタでCustomer Matchに使用するGoogle Ads顧客IDを入力します。
3. 製品リンクを作成（または同等のもの）とラベル付けされたボタンをクリックします。
4. Tealium UIでリンクが正常に作成されたことを示す確認メッセージが表示されるのを待ちます。

リンクが成功した後、Tealiumは承認されたデータパートナーとしてGoogle Data Manager APIを使用してGoogle Adsアカウントに更新を送信できます。

既存のGoogle Ads API アクションからの移行方法

目標は、各既存のGoogle Ads Customer Match アクションをそのGoogle Data Manager APIの同等物に行動の変更を最小限に抑えて移動することです。

ステップ1: 再認証およびリンク

Google Ads Customer Match コネクタを使用する各アカウントプロファイルについて：

1. Google Data Manager APIスコープを含むようにコネクタを再認証します。
2. Tealiumに顧客IDをリンクするセクションを使用して、各コネクタアクションに使用されるGoogle Ads顧客IDの製品リンクを作成します。アクションで顧客IDオーバーライド機能を使用している場合は、ここで各リスト所有顧客アカウントIDのリンクプロセスを繰り返します。

ステップ2: 既存のアクションを新しいGoogle Data Manager APIに移動する

既存のものに基づいて新しいアクションを作成する（テスト中に両方を並行して実行したい場合に推奨）、または既存のアクションをその場で切り替えます。

オプションA - 既存のアクションを新しいGoogle Data Manager APIアクションにコピー

各既存のGoogle Ads APIアクションについて:

1. コネクタのアクションタブで、既存のGoogle Ads Customer Matchアクションを見つけます。
2. 新しいアクションにコピーオプションを使用して、構成を複製します。
3. 新しいコピーで、アクションタイプをData Manager APIアクションに変更します。例えば、リストにユーザーを追加（Data Manager API）またはリストからユーザーを削除（Data Manager API）。
4. 次の点を確認します：
   • 同じユーザーリストが選択されているか、またはオーバーライドフィールドがData Manager用の正しいリストID形式を使用するように更新されているか。
   • 必要な識別子マッピングがすべて存在し、リストのキータイプと一致しているか。例えば、CONTACT_IDリストの場合はハッシュ化されたメール、ハッシュ化された電話、または住所フィールドの少なくとも1つ；USER_IDリストの場合は第一者ユーザーID；またはMOBILE_IDリストの場合はモバイルデバイスID。
5. 新しいData Manager APIアクションを保存します。

このアプローチにより、既存のトリガー条件とほとんどのフィールドマッピングを再利用しながら新しいAPIに切り替えることができます。

オプションB - アクションを新しいData Manager APIアクションタイプに切り替え

コピーを作成するのではなく、アクションを新しいAPIに切り替えたい場合:

1. コネクタアクションタブで、既存のGoogle Ads Customer Matchアクションを見つけます。
2. 右上のメニューからアクションタイプを変更オプションを使用して、アクションのタイプを切り替えます。
3. アクションのData Manager APIバリアントを選択します。
4. 選択されたユーザーリストとマッピングが保持されていることを確認します。
5. Data Manager APIアクションを保存します。

ステップ3: テストと検証

アクションをコピーした場合（オプションA）でも、その場で切り替えた場合（オプションB）でも：

1. 新しいData Manager APIアクションを発火させるイベントをトリガーします。
2. Google AdsでターゲットのCustomer Matchリストが期待通りにユーザーを受け取り始めていること（追加アクションの場合）、または期待通りにユーザーが削除されていること（削除アクションの場合）を確認します。
3. Data Managerに関連するエラー（例えば、無効な識別子、同意問題、またはリスト構成の問題など）がないかTealiumコネクタのログを確認し、必要に応じてマッピングを調整します。

ステップ4: レガシーアクションのクリーンアップ（該当する場合）

アクションのコピーを作成し、新しいData Manager APIアクションを検証した場合：

1. コネクタのアクションタブに戻ります。
2. 重複した更新を避けるために、古いGoogle Ads Customer Matchアクションを無効にするか削除します。

オプションBを使用してその場でアクションを切り替えた場合、そのアクションに対して追加のクリーンアップは必要ありません。

これらのステップを完了すると、Google Ads Customer Matchの構成はTealiumでGoogle Data Manager APIを使用するように完全に移行されます。

FAQ

Google Ads Customer Matchリストを再作成する必要がありますか？
いいえ。新しいアクションは、既存のGoogle Ads Customer Matchリストと互換性があり、リストのキータイプが送信する識別子と一致している場合に使用できます。また、コネクタのリスト管理操作（利用可能な場合）を使用して、Google Data Manager APIを通じて直接リストを作成または管理することもできます。

移行しない場合はどうなりますか？
短期的には、既存のGoogle Ads APIベースのアクションは引き続き機能します。ただし、これらのアクションは廃止予定であるため、いずれ削除されるか、Googleが基盤となるAds APIを進化させるにつれて、Google Ads Customer Matchオーディエンスの管理ができなくなる可能性があります。今すぐ移行することで、将来の混乱を最小限に抑え、Google Data Managerを使用する推奨されるパスに構成を合わせることができます。

同意とデータガバナンスはまだ管理できますか？
はい。エンドユーザーの同意の収集と管理、および適用される法律およびGoogleのポリシーに準拠してGoogleとのデータ共有を確実にする責任は引き続きあなたにあります。同意の観点から、新しいGoogle Data Manager APIアクションは既存のアクションと同じように動作します。コネクタはリクエストペイロードのGoogle同意フィールドに常にGRANTEDを送信し、適切な同意を持つユーザーのみがGoogleに送信されるように、上流の同意およびオーディエンスロジックに依存します。