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

動作原理

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

要件

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

コネクタアクション

アクション名	AudienceStream	EventStream
通話コンバージョンのアップロード - レガシー	✓	✓
クリックコンバージョンのアップロード - レガシー	✓	✓
コンバージョン再声明	✓	✓
コンバージョン撤回	✓	✓
通話コンバージョンのアップロード	✓	✓
クリックコンバージョンのアップロード	✓	✓

API情報

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

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

バッチ制限

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

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

遅延アクション

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

EventStreamまたはAudienceStreamでtraceを使用する場合、アクションは遅延されません。

同意

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

構成の構成

コネクタマーケットプレースにアクセスして新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについての記事を参照してください。

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

顧客ID：管理する広告アカウントの顧客IDを入力するか、アクション構成の動的オーバーライドフィールドを使用します。
マネージャー顧客ID：管理されたアカウントにアクセスする場合は、マネージャー顧客IDと顧客IDを入力します。

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

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

コネクタアクションの構成を続行するには、続行をクリックします。アクションの名前を入力し、リストからアクションタイプを選択します。

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

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

パラメータ

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

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

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

オプションパラメータ

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

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

パラメータ

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

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

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

カートデータパラメータ

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

オプションパラメータ

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

アクション — コンバージョン再声明

パラメータ

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

オプションパラメータ

パラメータ	説明
コンバージョンアクションオーバーライド	コンバージョンアクションパラメータをオーバーライドするためのコンバージョンアクションIDを提供します。このフィールドを使用して、EventStream変数でコンバージョンアクションIDパラメータを入力できます。
顧客IDオーバーライド	(オプション) コネクタ構成の顧客IDをオーバーライドするための顧客IDを提供します。このオプションを使用する場合、コンバージョンアクションオーバーライドも使用する必要があります。
マネージャー顧客IDオーバーライド	(オプション) 顧客IDオーバーライドを使用してクライアント顧客にアクセスする場合、マネージャー顧客IDを提供します。

アクション — コンバージョン撤回

パラメータ

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

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

パラメータ

パラメータ	説明
コンバージョンアクション	(必須) 既存のコンバージョンアクションを選択します。`UPLOAD_CALLS`タイプのGoogle広告コンバージョンアクションのみが表示されます。詳細については、Google: Google Ads Conversion Trackingを参照してください。

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

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

オプションパラメータ

パラメータ	説明
カスタム変数	このコンバージョンに関連するカスタム変数。詳細については、Google: Custom Variableを参照してください。
コンバージョンアクションオーバーライド	コンバージョンアクションパラメータをオーバーライドするためのコンバージョンアクションIDを提供します。このフィールドを使用して、EventStream変数でコンバージョンアクションIDパラメータを入力できます。
広告ユーザーデータの同意	広告ユーザーデータの同意。デフォルト値は `GRANTED` です。有効な値は `GRANTED` と `DENIED` です。
顧客IDオーバーライド	(必須) 顧客アカウントIDを選択します。認証されたユーザーにアクセス可能な顧客アカウントのオプションが表示されます。
マネージャー顧客IDオーバーライド	(オプション) 顧客IDオーバーライドを使用してクライアント顧客にアクセスする場合、マネージャー顧客IDを提供します。

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

パラメータ

パラメータ	説明
コンバージョンアクション	既存のコンバージョンアクションを選択します。詳細については、Google: Google Ads Conversion Trackingを参照してください。

変換データパラメータ

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

カートデータパラメータ

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

オプションパラメータ

パラメータ	説明
Custom Variables	この変換に関連するカスタム変数。詳細については、Google: カスタム変数を参照してください。
Ad User Data Consent	広告ユーザーデータの同意。デフォルト値は `GRANTED` です。有効な値は `GRANTED` と `DENIED` です。
Conversion Action Override	Conversion Action パラメータを上書きするための変換アクションIDを提供します。このフィールドを使用して、EventStream変数で Conversion Action ID パラメータを入力します。
Customer ID Override	(必須) 顧客アカウントIDを選択します。利用可能なオプションは認証されたユーザーのアクセス可能な顧客アカウントを反映します。
Manager Customer ID Override	(オプション) Customer ID Overrideを使用してクライアント顧客にアクセスする場合、マネージャー顧客IDを提供してください。