Google AdsカスタマーマッチアクションをGoogle Data Manager APIに移行する

変更点

Google Adsカスタマーマッチコネクタに、Google Data Manager APIを使用する2つの新しいアクションを導入します：

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

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

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

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

Google Data Manager APIは、カスタマーマッチデータの取り込みにおける戦略的な進路です。

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

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

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

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

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

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

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

新しいアクションは、Google Adsカスタマーマッチコネクタの既存のGoogle Adsカスタマーマッチアクションと一緒に表示されます：

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

主なポイント：

• UIレイアウト：これらのアクションの構成画面は、既存のGoogle Adsカスタマーマッチアクションに密接に従っているため、ほとんどのマッピングと構成が馴染みのあるものになります。
• 同意と利用規約：Data Managerは、各取り込みコールに明示的な同意とカスタマーマッチの利用規約を要求します。コネクタは、ペイロードに必要な同意と利用規約のフィールドが含まれていることを保証します。
• 識別子のフォーマット：プレーンテキストまたは事前にハッシュ化された識別子（メール、電話、郵便住所など）をマッピングします。SHA256ハッシュを適用とラベル付けされたフィールドを選択すると、TealiumがGoogleが要求する正規化（トリム、小文字化、ハッシュ）を実行します。既にSHA256ハッシュ化されているとラベル付けされたフィールドを選択する場合、Googleのフォーマット要件をすでに満たしているデータを提供する責任があります。
• リストキータイプ：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カスタマーマッチコネクタを構成している場合、Google OAuthトークンにData Manager APIスコープが含まれるようにコネクタを再認証する必要があります。

再認証するには：

1. 既存のGoogle Adsカスタマーマッチコネクタを開きます。
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. コネクタ構成で、Link Customer ID to Tealiumとラベル付けされたセクションを探します。
2. このコネクタでカスタマーマッチに使用するGoogle AdsカスタマーIDを入力します。
3. Create Product Link（または同等のもの）とラベル付けされたボタンをクリックします。
4. Tealium UIでリンクが正常に作成されたことを示す確認メッセージが表示されるのを待ちます。

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

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

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

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

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

1. Google Data Manager APIスコープを含むようにコネクタを再認証します。
2. Link Customer ID to Tealiumセクションを使用して、各コネクタアクションに使用される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に送信されるように、上流の同意およびオーディエンスロジックに依存します。