Google Ads Enhanced Conversions for Web コネクタ構成ガイド | サーバーサイドコネクタ

前提条件

Enhanced Conversionsが有効なコンバージョンを持つGoogle Adsアカウント。詳細については、Google Ads APIのウェブ向けエンリッチメントコンバージョンについてを参照してください。

コネクタのアクション

アクション名	AudienceStream	EventStream
Send Conversion	✓	✓

API情報

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

API名：Google Ads API
APIバージョン：v17
APIエンドポイント：https://googleads.googleapis.com/
ドキュメンテーション：Google Ads API: Enhanced Conversions

バッチ制限

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

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

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについての記事を参照してください。

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

Customer ID
必須。管理する広告アカウントの顧客IDを提供します。
Manager Customer ID
オプション。クライアントの顧客にアクセスする場合、Manager Customer IDを構成する必要があります。

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

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

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

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

アクション - Send Conversion

パラメータ

パラメータ	説明
Conversion Action	既存のコンバージョンアクションを選択します。コンバージョンアクションは、Google Ads UIでWEBPAGEタイプ、エンリッチメントコンバージョンが有効、およびエンリッチメントコンバージョンの実装方法がAPIに構成されている必要があります。エンリッチメントコンバージョンについての詳細は、Google Ads Enhanced Conversion Trackingを参照してください。
Transaction ID	広告主が生成する、コンバージョンイベントを一意に識別するID。このIDの値は、クライアントサイドのイベントと一致する必要があります。購入には`order_ID`、その他のイベントには`tealium_random`を使用することを推奨します。Automatic Transaction IDが提供されている場合は必要ありません。
Conversion Value	コンバージョンの金額。
Conversion Currency	コンバージョンの通貨コード。
Conversion Time	元のコンバージョンが発生した日時。タイムゾーンを指定する必要があります。形式はyyyy-mm-dd hh:mm:ss+\|-hh:mmです。例えば、2022-01-01 12:32:45-08:00。デフォルト値はnowです。
Gclid	利用可能な場合、ユーザーコンバージョンにつながるAdクリックのGoogleクリック識別子。
User Agent	広告主がそのデータを保持している場合、コンバージョンしたユーザーのユーザーエージェント。
Email Address (already SHA256 hashed)	すでに空白をトリムし、小文字にし、SHA256でハッシュ化されたメールアドレスを提供します。`gmail.com`および`googlemail.com`のメールアドレスで、ドメイン名の前にあるすべてのピリオド(.)をハッシュ化する前に削除します。
Email Address (apply SHA256 hash)	平文のメールアドレスが提供された場合、コネクタは`gmail.com`および`googlemail.com`のメールアドレスで、ドメイン名の前にあるすべてのピリオド(.)を削除し、空白をトリムし、小文字にし、この値をSHA256ハッシュでハッシュ化します。
Phone Number (already SHA256 hashed)	すでに空白をトリムし、SHA256でハッシュ化されたE164標準に従った電話番号を提供します。
Phone Number (apply SHA256 hash)	平文の電話番号が提供された場合、コネクタはすべての非数字記号を削除し、番号の前にプラス記号(`+`)を付け、空白をトリムし、この値をSHA256ハッシュでハッシュ化します。
Address Info: First Name (already SHA256 hashed)	すでに空白をトリムし、小文字にし、SHA256でハッシュ化された名前を提供します。
Address Info: First Name (apply SHA256 hash)	平文の名前が提供された場合、コネクタは空白をトリムし、小文字にし、この値をSHA256ハッシュでハッシュ化します。
Address Info: Last Name (already SHA256 hashed)	すでに空白をトリムし、小文字にし、SHA256でハッシュ化された姓を提供します。
Address Info: Last Name (apply SHA256 hash)	平文の姓が提供された場合、コネクタは空白をトリムし、小文字にし、この値をSHA256ハッシュでハッシュ化します。
Address Info: Street Address (already SHA256 hashed)	すでに空白をトリムし、小文字にし、SHA256でハッシュ化された通りの住所を提供します。
Address Info: Street Address (apply SHA256 hash)	平文の通りの住所が提供された場合、コネクタは空白をトリムし、小文字にし、この値をSHA256ハッシュでハッシュ化します。
Address Info: City	ユーザーの住所の市区町村。
Address Info: State	ユーザーの住所の州のコード。
Address Info: Postal Code	ユーザーの住所の郵便番号。
Address Info: Country Code	ユーザーの住所のISO-3166-1 alpha-2の2文字の国コード。
Automatic Transaction ID	(オプション) Tealium iQタグIDに構成すると、Tealiumは自動的にTealium iQから送信されるトランザクションIDの値を探します。この機能を使用するには、タグテンプレートが2023年4月以降のバージョンである必要があります。Transaction IDまたはAutomatic Transaction IDのいずれかを提供する必要があります。
Conversion Action Override	(オプション) Requiredセクションのコンバージョンアクションを上書きするConversion Action IDを提供します。このパラメータを使用すると、EventStream変数を使用してConversion Action IDを入力することができます。Conversion Action IDを見つけるには、Google Adsダッシュボードに移動し、コンバージョンをクリックします。Conversion Action IDは、ウェブサイトURLの`ctId`クエリパラメータの値です。例えば、URLが`https://ads.google.com/aw/conversions/detail?ctId=987654321`の場合、Conversion Action IDは`987654321`です。

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

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

EC_MODE_MISMATCH: コンバージョンアクションがGoogle Ads Platformで不正なコンバージョンタイプを持っています。Google Ads PlatformのTools > Conversions > Conversion Eventでコンバージョンタイプを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: Enhanced Conversionsに必要なPIIは以下のセットのいずれかです：
  a) 顧客のメール
  b) 顧客の名前、姓、通りの住所、市区町村、州、国、郵便番号
  必要なフィールドの値がイベントデータに存在することを確認します。

詳細については、Google Ads API Errorsを参照してください。