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

コネクタのアクション

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

API情報

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

API名：Google Ads API
APIバージョン：v18
APIエンドポイント：https://googleads.googleapis.com/
ドキュメンテーション：Google Ads API: Enhanced Conversions For Leadsのアップロード

バッチ制限

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

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

同意

コネクタはデフォルトでadUserDataにGRANTEDの値を送信します。デフォルトを上書きするには、関連するEventStream属性をAd User Data Consentにマップし、値をDENIEDに構成します。

構成の構成

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

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

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

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

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

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

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

アクション - コンバージョンを送信

パラメータ

パラメータ	説明
コンバージョンアクション	UPLOAD_CLICKSタイプの既存のコンバージョンアクションを選択し、エンハンストコンバージョンを有効にします。詳細は、Google Ads Enhanced Conversion Trackingを参照してください。
メールアドレス（既にSHA256でハッシュ化済み）	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化したメールアドレスを提供します。ハッシュ化する前に、`gmail.com`および`googlemail.com`のメールアドレスでドメイン名の前にあるすべてのピリオド（`.`）を削除します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクタは`gmail.com`および`googlemail.com`のメールアドレスでドメイン名の前にあるすべてのピリオド（`.`）を削除し、空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
電話番号（既にSHA256でハッシュ化済み）	E164標準に従った電話番号を提供し、すでに空白をトリムし、SHA256でハッシュ化しています。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供し、コネクタはすべての非数字記号を削除し、番号の前にプラス記号（`+`）を付け、空白をトリムし、この値をSHA256ハッシュでハッシュ化します。
gclid	コンバージョンに関連するGoogleクリックID（gclid）。注：コンバージョンに`gclid`と`user_identifiers`（メール/電話）を提供すると、Google Adsは`user_identifiers`を無視します。
コンバージョン値	コンバージョンの金額。
コンバージョン通貨	コンバージョンの通貨コード。
コンバージョン時間	元のコンバージョンが発生した日時。タイムゾーンを指定する必要があります。形式はyyyy-mm-dd hh:mm:ss+\|-hh:mmです。例えば、2022-01-01 12:32:45-08:00。デフォルト値はnowです。
注文ID	コンバージョンに関連する注文ID。注文IDは、コンバージョンアクションごとに1つのコンバージョンに対してのみ使用できます。
カスタム変数	このコンバージョンに関連するカスタム変数。値をカスタム変数IDにマップします。コネクタは`conversion_custom_variable`フィールドを次の形式で送信します：`customers/{customer_id}/conversionCustomVariables/{custom_variable_id}`。
マーチャントID	アイテムがアップロードされるMerchant Center ID。
フィード国コード	アイテムがアップロードされるフィードに関連する国コード。
フィード言語コード	アイテムがアップロードされるフィードに関連する言語コード。
ローカルトランザクションコスト	全体のカートに対する無料配送やクーポン割引など、すべてのトランザクションレベルの割引の合計。
商品ID	アイテムのショッピングID。Merchant Centerの商品識別子と等しくなければなりません。複数のアイテムを追加するために配列タイプの属性を提供します。配列タイプの属性は等しい長さでなければなりません。単一値の属性を使用し、各アイテムに適用することもできます。
数量	売れたアイテムの数。複数のアイテムを追加するために配列タイプの属性を提供します。配列タイプの属性は等しい長さでなければなりません。単一値の属性を使用し、各アイテムに適用することもできます。
単価	税金、送料、および任意のトランザクションレベルの割引を除いた単価。複数のアイテムを追加するために配列タイプの属性を提供します。配列タイプの属性は等しい長さでなければなりません。単一値の属性を使用し、各アイテムに適用することもできます。
コンバージョンアクションオーバーライド	（オプション）コンバージョンアクションIDを提供して、必須セクションのコンバージョンアクションを上書きします。このパラメータを使用すると、EventStream変数を使用してコンバージョンアクションIDを入力できます。コンバージョンアクションIDを見つけるには、Google Adsダッシュボードに移動し、コンバージョンをクリックします。コンバージョンアクションIDは、ウェブサイトURLの`ctId`クエリパラメータの値です。例えば、URLが`https://ads.google.com/aw/conversions/detail?ctId=987654321`の場合、コンバージョンアクションIDは`987654321`です。
Ad User Data Consent	オプション。広告ユーザーデータの同意。デフォルト値は`GRANTED`です。有効な値は`GRANTED`または`DENIED`です。