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バージョン: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) 顧客の名前、姓、通りの住所、市区町村、州、国、郵便番号
必要なフィールドの値がイベントデータに存在することを確認します。
- Transaction ID cannot be empty: コンバージョンに注文IDがない場合、クライアントサイドのタグとコネクタアクション構成で
詳細については、Google Ads API Errorsを参照してください。
最終更新日 :: 2024年July月10日