Google Ads Enhanced Conversions for Webコネクタ構成ガイド
この記事では、Google Ads Enhanced Conversions for Webコネクタの構成方法について説明します。
前提条件
- Enhanced Conversionsが有効なGoogle Adsアカウント。詳細については、Google Ads APIのウェブ向けエンリッチメントコンバージョンについてを参照してください。
コネクタアクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| Send Conversion | ✓ | ✓ |
API情報
このコネクタは以下のベンダーAPIを使用します：
- API名：Google Ads API
- APIバージョン：v14
- 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=12345678&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) 顧客の名前、姓、通りの住所、市区町村、州、国、郵便番号
必要なフィールドの値がイベントデータに存在することを確認します。
- Transaction ID cannot be empty: コンバージョンに注文IDがない場合、
詳細については、Google Ads API Errorsを参照してください。
最終更新日 :: 2023年September月7日