Google Ads コンバージョン コネクタ構成ガイド

仕組み

Google Ads のコンバージョンは、ユーザーが広告をクリックしたり、ディスプレイネットワークの広告を表示した後に特定のアクションを実行したときに発生します。Google Ads コンバージョンコネクタは、Google Ads API を使用してオフラインコンバージョンのアップロードと、以前に取得したコンバージョン値の調整をサポートしています。このコネクタを使用して、Google Ads にオフラインクリックコンバージョンをアップロードし、電話や営業担当者を通じてオフラインの世界での販売につながった広告を追跡することができます。また、広告が電話をかけるきっかけになり、それが価値ある顧客アクションにつながったときに、オフラインの通話コンバージョンをアップロードすることもできます。

要件

• オフラインコンバージョンを送信するには、Google Ads Import コンバージョンアクションを構成し、ソースとして通話またはクリックを指定します。詳細については、Google ヘルプのオフラインコンバージョンに関するドキュメントを参照してください。
• コンバージョンを調整するには、元のコンバージョンのトランザクションIDを持っているか、gclidとコンバージョンの日時を持っていて、調整したいコンバージョンを特定する必要があります。

コネクタのアクション

アクション名	AudienceStream	EventStream
通話コンバージョンのアップロード	✓	✓
クリックコンバージョンのアップロード	✓	✓
コンバージョンの再記述	✓	✓
コンバージョンの撤回	✓	✓

API情報

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

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

バッチ制限

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

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

遅延アクション

アクションは、Googleのベストプラクティスに従って、オフラインコンバージョンのアップロードを収容するために30分遅延します。Google Campaign Manager 360 Floodlight コネクタを使用した遅延アクションについての詳細は、Googleのオフラインコンバージョンのアップロードに関するベストプラクティスのドキュメンテーションを参照してください。

EventStream または AudienceStream で trace を使用するときは、アクションは遅延しません。

同意

コネクタは、adUserDataとadPersonalizationの同意について、デフォルトでGRANTEDの値を送信します。デフォルトを上書きするには、関連するEventStream属性をAd User Data Consentおよび/またはAd Personalization Consentにマップし、値をDENIEDに構成します。

構成の構成

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

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

• 顧客ID：あなたの個々のGoogle Adsアカウントに割り当てられた一意の識別子。
• マネージャー顧客ID：管理されたアカウントにアクセスする場合は、マネージャー顧客IDと顧客IDを入力します。

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

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

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

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

アクション - 通話コンバージョンのアップロード

パラメータ

パラメータ	説明
顧客ID	必須。顧客アカウントIDを選択します。利用可能なオプションは、認証されたユーザーのアクセス可能な顧客アカウントを反映しています。
コンバージョンアクション	必須。既存のコンバージョンアクションを選択します。表示されるのは、UPLOAD_CALLSタイプのGoogle Adsコンバージョンアクションのみです。詳細については、Google Ads コンバージョントラッキングを参照してください。

コンバージョンデータパラメータ

パラメータ	説明
発信者ID	必須。この通話が発信された発信者ID。発信者IDはE.164形式で、プラス (+) 文字が先行することが期待されます。例：+16502531234。
通話開始日時	必須。通話が発生した日時。タイムゾーンを指定する必要があります。形式は yyyy-mm-dd hh:mm:ss です。例：2020-01-01 12:32:45-8:00。
コンバージョン日時	必須。コンバージョンが発生した日時。この日時は通話時間の後でなければなりません。タイムゾーンを指定する必要があります。形式は yyyy-mm-dd hh:mm:ss です。例：2020-01-01 12:32:45-8:00。
コンバージョン値	広告主にとってのコンバージョンの価値。
通貨コード	コンバージョン値に関連する通貨。これはISO 4217の3文字の通貨コードです。例：USDまたはEUR。

オプションパラメータ

パラメータ	説明
コンバージョンアクションの上書き	コンバージョンアクションパラメータを上書きするためのコンバージョンアクションIDを提供します。このフィールドを使用すると、EventStreamの変数を使用してコンバージョンアクションIDパラメータを入力することができます。
カスタム変数	このコンバージョンに関連するカスタム変数。詳細については、カスタム変数を参照してください。
Ad User Data Consent	広告ユーザーデータの同意。デフォルト値は GRANTED です。有効な値は GRANTED と DENIED です。

アクション - クリックコンバージョンのアップロード

パラメータ

パラメータ	説明
顧客ID	顧客アカウントIDを選択します。利用可能なオプションは、認証されたユーザーのアクセス可能な顧客アカウントを反映しています。
コンバージョンアクション	既存のコンバージョンアクションを選択します。詳細については、Google Ads コンバージョントラッキングを参照してください。

コンバージョンデータパラメータ

パラメータ	説明
Google Click ID	必須。このコンバージョンに関連するGoogleクリックID (gclid)。Google Click ID、gbraid、またはwbraidが必要です。
コンバージョン日時	必須。コンバージョンが発生した日時。この日時は通話時間の後でなければなりません。タイムゾーンを指定する必要があります。形式は yyyy-mm-dd hh:mm:ss です。例：2020-01-01 12:32:45-8:00。
コンバージョン値	広告主にとってのコンバージョンの価値。
通貨コード	コンバージョン値に関連する通貨。これはISO 4217の3文字の通貨コードです。例：USDまたはEUR。
注文ID	必須。コンバージョンに関連する注文ID。注文IDは、コンバージョンアクションごとに1つのコンバージョンにのみ使用できます。
外部帰属クレジット	このパラメータは、コンバージョンの一部がGoogle Adsクリックに帰属する割合を表します。
外部帰属モデル	指定された帰属モデル名。詳細については、Google Ads API Click Conversionを参照してください。
gbraid	必須。iOS14から始まるiOSデバイスからのアプリコンバージョンと関連するクリックの識別子。値はGoogle Click ID、gbraid、またはwbraidであることができます。
wbraid	必須。iOS14から始まるiOSデバイスからのウェブコンバージョンと関連するクリックの識別子。値はGoogle Click ID、gbraid、またはwbraidであることができます。

カートデータパラメータ

パラメータ	説明
Merchant ID	アイテムがアップロードされるMerchant CenterのID。
Feed Country Code	アイテムがアップロードされるフィードに関連する国コード。
Feed Language Code	アイテムがアップロードされるフィードに関連する言語コード。
ローカルトランザクション	すべてのトランザクションレベルの割引の合計、例えば全体のカートに対する送料無料やクーポン割引などです。通貨コードはClickConversionメッセージと同じです。
商品ID	商品のショッピングIDです。この値はMerchant Centerの商品識別子と等しくなければなりません。複数の商品を追加するには配列を使用します。配列型の属性は等しい長さでなければなりません。
数量	売れた商品の数です。複数の商品を追加するには配列を使用します。配列型の属性は等しい長さでなければなりません。
単価	税金、送料、および任意のトランザクションレベルの割引を除いた単価です。通貨コードはClickConversionメッセージと同じです。複数の商品を追加するには配列を使用します。配列型の属性は等しい長さでなければなりません。

任意のパラメータ

パラメータ	説明
Conversion Action Override	Conversion Actionパラメータを上書きするための変換アクションIDを提供します。Conversion Action IDパラメータにはEventStream変数を使用できます。
Custom Variables	この変換に関連するカスタム変数です。詳細については、Custom Variableを参照してください。
Ad User Data Consent	広告ユーザーデータの同意です。デフォルト値はGRANTEDです。有効な値はGRANTEDとDENIEDです。

アクション — 変換再声明

パラメータ

パラメータ	説明
Conversion Action	既存の変換アクションを選択します。詳細については、Google Ads Conversion Adjustmentsを参照してください。
Restatement Value	必須。再声明後の変換の値です。
Restatement Date Time	必須。調整が行われた日時です。形式はyyyy-mm-dd hh:mm:ss+|-hh:mmです。日付属性はGoogleが期待する形式に変換されます。
Order ID	Order IDまたはGoogle Click IDとConversion Date Timeのいずれかを提供する必要があります。変換が注文IDを指定して報告された場合、その注文IDを使用する必要があります。
Google Click ID	Order IDまたはGoogle Click IDとConversion Date Timeのいずれかを提供する必要があります。変換が注文IDを指定して報告された場合、その注文IDを使用する必要があります。
Conversion Date Time	変換の日時です。形式はyyyy-mm-dd hh:mm:ss+|-hh:mmです。日付属性はGoogleが期待する形式に変換されます。
Currency Code	再声明された値の通貨です。提供されない場合、変換アクションからのデフォルトの通貨が使用されます。

任意のパラメータ

パラメータ	説明
Conversion Action Override	Conversion Actionパラメータを上書きするための変換アクションIDを提供します。このフィールドでは、EventStream変数を使用してConversion Action IDパラメータを入力できます。
Customer ID Override	任意。コネクタ構成のCustomer IDを上書きするための顧客IDを提供します。このオプションを使用する場合、Conversion Action Overrideも使用する必要があります。
Manager Customer ID Override	任意。Customer ID Overrideを使用してクライアントの顧客にアクセスしている場合は、Manager Customer IDを提供します。

アクション — 変換撤回

パラメータ

パラメータ	説明
Conversion Action	既存の変換アクションを選択します。詳細については、Google Ads Conversion Adjustmentsを参照してください。
Retraction Date Time	必須。撤回が行われた日時です。形式はyyyy-mm-dd hh:mm:ss+|-hh:mmです。日付属性はGoogleが期待する形式に変換されます。
Order ID	Order IDまたはGoogle Click IDとConversion Date Timeのいずれかを提供する必要があります。変換が注文IDを指定して報告された場合、その注文IDを使用する必要があります。
Google Click ID	Order IDまたはGoogle Click IDとConversion Date Timeのいずれかを提供する必要があります。変換が注文IDを指定して報告された場合、その注文IDを使用する必要があります。
Conversion Date Time	このパラメータは形式yyyy-mm-dd hh:mm:ss+|-hh:mmでなければなりません。日付属性はGoogleが期待する形式に変換されます。
Conversion Action Override	Conversion Actionパラメータを上書きするための変換アクションIDを提供します。EventStream変数を使用してConversion Action IDパラメータを入力できます。
Customer ID Override	任意。コネクタ構成のCustomer IDを上書きするための顧客IDを提供します。このオプションを使用する場合、Conversion Action Overrideも使用する必要があります。
Manager Customer ID Override	任意。Customer ID Overrideを使用してクライアントの顧客にアクセスしている場合は、Manager Customer IDを提供します。