Google Ads ウェブ用拡張コンバージョンコネクタ構成ガイド

Google Ads ウェブ用拡張コンバージョンコネクタを使用して、取引IDとハッシュ化されたユーザー識別子を含むコンバージョン調整をアップロードすることで、ウェブコンバージョンの測定精度を向上させます。

要件

拡張コンバージョンが有効になっているGoogle Adsアカウント。
拡張コンバージョンが有効になっているコンバージョンアカウントの読み取りと書き込みの権限。
Google Ads コンバージョン追跡およびリマーケティング (gtag.js) タグ
Google Adsアカウントの顧客ID。詳細については、Google: Google Ads顧客IDを見つけるを参照してください。
- クライアントの代わりにアカウントにアクセスする場合は、マネージャー顧客ID（MCC ID）を構成する必要があります。顧客IDは、Google Adsにログインして、構成 > アクセスとセキュリティ > マネージャーに移動することで見つけることができます。

コネクタのアクション

アクション名	AudienceStream	EventStream
コンバージョン送信	✓	✓

API情報

このコネクタは以下のベンダーAPIを使用します：

API名：Google Ads API
APIバージョン：v24
APIエンドポイント：https://googleads.googleapis.com/
ドキュメント：Google Ads API: 拡張コンバージョン

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

最大リクエスト数：2,000
最古のリクエストからの最大時間：10分
リクエストの最大サイズ：2 MB

構成の構成

コネクタマーケットプレースに移動して新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

コネクタを追加した後、次の構成を構成します：

顧客ID
(必須) 管理する広告アカウントの顧客IDを提供してください。
マネージャー顧客ID
(オプション) クライアントの代わりにアカウントにアクセスする場合は、マネージャー顧客IDを構成する必要があります。顧客IDは、Google Adsにログインして、構成 > アクセスとセキュリティ > マネージャーに移動することで見つけることができます。

Googleアカウントと規約

少なくとも読み取りと書き込みの権限を持つGoogleアカウントで接続を確立する必要があります。Googleでサインインをクリックし、画面の指示に従ってください。

Googleアカウントに接続した後、GoogleのポリシーとGoogle Adsデータ処理条件の遵守を確認する必要があります。詳細については、Google Ads: ウェブ用拡張コンバージョンを有効にするを参照してください。

コネクタの構成が完了したら、完了をクリックします。

重複排除

Googleは、クライアント側とサーバー側のコンバージョン間の重複を排除するために取引IDを使用します。このIDは、各コンバージョンイベントに固有であり、サーバー側イベントとクライアント側イベントと一致する必要があります。購入の場合はorder_idを、その他のイベントの場合はtealium_randomを使用することをお勧めします。

タグでサーバー側拡張コンバージョンのイベントマッチングを有効にするがオンになっていて、コネクタで自動取引IDが構成されている場合、コネクタのマッピングは必要ありません。

自動取引IDを構成するには、コネクタアクション構成でクライアント側タグUIDをTealium iQ Tag IDにマップします。Tealium iQ Tag IDが提供されている場合、Tealium iQから送信された取引ID値を自動的に検索します。タグテンプレートは2023年4月以降のバージョンでなければならず、この機能を活用するためにはtransaction_idまたはorder_idをマップする必要があります。

アクション構成 — パラメータとオプション

続行をクリックしてコネクタアクションを構成します。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション — コンバージョン送信

パラメータ

パラメータ	説明
変換アクション	既存の変換アクションを選択します。変換アクションは、Google Ads UIでWEBPAGEタイプで構成され、拡張変換が有効にされ、拡張変換の実装方法がAPIに構成されている必要があります。拡張変換についての詳細は、Google Ads: 拡張変換トラッキングを参照してください。
トランザクションID	広告主が生成する、変換イベントを一意に識別するID。このIDはクライアント側のイベントと一致する必要があります。購入の場合は`order_id`を、その他のイベントの場合は`tealium_random`を使用します。自動トランザクションIDが提供されている場合、このパラメータは必要ありません。
変換値	変換の金銭的価値。
変換通貨	変換の通貨コード。
変換時間	元の変換が発生した日時。タイムゾーンを指定する必要があります。形式はyyyy-mm-dd hh:mm:ss+\|-hh:mmです。例: `2022-01-01 12:32:45-08:00`。提供されない場合、デフォルト値として現在の日時が使用されます。
Gclid	ユーザーの変換につながった広告クリックのGoogleクリック識別子（利用可能な場合）。
ユーザーエージェント	変換したユーザーのユーザーエージェント（広告主がそのデータを保持している場合）。
メールアドレス（既にSHA256ハッシュ化済み）	すでに空白トリム、小文字変換、SHA256ハッシュ化されたメールアドレスを提供します。`gmail.com`および`googlemail.com`のアドレスの場合、ハッシュ化の前にローカル部分（ドメインの前）からすべてのピリオド（.）を削除します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスが提供された場合、コネクタは`gmail.com`および`googlemail.com`のメールアドレスのドメイン名の前にあるすべてのピリオド（.）を削除し、空白トリム、小文字変換を行い、この値をSHA256ハッシュでハッシュ化します。
電話番号（既にSHA256ハッシュ化済み）	E164標準に従って、すでに空白トリムおよびSHA256ハッシュ化された電話番号を提供します。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号が提供された場合、コネクタはすべての非数字文字を削除して数字のみが残るようにし、数字にプラス記号（`+`）を前置し、空白トリムを行い、この値をSHA256ハッシュでハッシュ化します。
住所情報: 名（既にSHA256ハッシュ化済み）	すでに空白トリム、小文字変換、SHA256ハッシュ化された名を提供します。
住所情報: 名（SHA256ハッシュを適用）	プレーンテキストの名が提供された場合、コネクタは空白トリム、小文字変換を行い、この値をSHA256ハッシュでハッシュ化します。
住所情報: 姓（既にSHA256ハッシュ化済み）	すでに空白トリム、小文字変換、SHA256ハッシュ化された姓を提供します。
住所情報: 姓（SHA256ハッシュを適用）	プレーンテキストの姓が提供された場合、コネクタは空白トリム、小文字変換を行い、この値をSHA256ハッシュでハッシュ化します。
住所情報: 住所（既にSHA256ハッシュ化済み）	すでに空白トリム、小文字変換、SHA256ハッシュ化された住所を提供します。
住所情報: 住所（SHA256ハッシュを適用）	プレーンテキストの住所が提供された場合、コネクタは空白トリム、小文字変換を行い、この値をSHA256ハッシュでハッシュ化します。
住所情報: 市区町村	ユーザーの住所の市区町村。
住所情報: 州	ユーザーの住所の州コード。
住所情報: 郵便番号	ユーザーの住所の郵便番号。
住所情報: 国コード	ユーザーの住所の2文字国コード（ISO 3166-1 alpha-2）。
自動トランザクションID	（オプション）Tealium iQタグIDに構成されている場合、TealiumはTealium iQから送信されるトランザクションID値を自動的に検索します。この機能を使用するには、タグテンプレートが2023年4月以降のバージョンである必要があります。トランザクションIDまたは自動トランザクションIDのいずれかが提供されている必要があります。
変換アクションの上書き	（オプション）必須セクションの変換アクションを上書きするための変換アクションIDを提供します。EventStream変数を使用して変換アクションIDを入力することができます。変換アクションIDを見つけるには、Google Adsダッシュボードにアクセスし、変換をクリックします。変換アクションIDは、ウェブサイトURLの`ctId`クエリパラメータの値です。例えば、URLが`https://ads.google.com/aw/conversions/detail?ctId=987654321`の場合、変換アクションIDは`987654321`です。

エラーのトラブルシューティング

以下は一般的なエラーコードと解決策です：

CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS: Googleのポリシーと条件を受け入れていません。この問題を解決するには、ポリシーと条件を受け入れてください。詳細については、Google Ads: ウェブ用の拡張変換を有効にするを参照してください。
EC_MODE_MISMATCH: 変換アクションがGoogle Adsプラットフォームで間違った変換タイプになっています。Google Adsプラットフォームのツール > 変換 > 変換イベントで変換タイプをAPIに変更してください。
INVALID_USER_CUSTOMER_AUTHORIZATION: Google Adsプラットフォームへの接続構成時に使用されるログインは、対象アカウントのオーディエンスリストを所有するアカウントに対して少なくとも読み取り専用アクセス権を持っている必要があります。
Invalid Parameter - Action has invalid parameter value or missing required parameter: コネクタから発生した内部検証エラーで、必要なフィールドが欠落している場合に返されるアクションエラーのいずれかが返されます：
- Transaction ID cannot be empty: 変換にオーダーIDがない場合、クライアント側のタグとコネクタアクション構成でtealium_randomをマッピングできます。
- Email or Phone Number or All Address Info need to be provided: 拡張変換に必要なPIIは、以下のいずれかのセットです： a) 顧客のメールアドレス
  b) 顧客の名、姓、住所、市区町村、州、国、郵便番号
  イベントデータに必要なフィールド値が存在することを確認してください。

詳細については、Google Ads: APIエラーを参照してください。