--- title: Google Ads コンバージョンコネクタ構成ガイド description: この記事では、Google Ads コンバージョンコネクタの構成方法について説明します。 url: https://docs.tealium.com/ja/server-side-connectors/google-ads-conversions-connector/ --- ## 動作原理 Google Ads のコンバージョンは、ユーザーが広告をクリックした後やディスプレイネットワーク広告を閲覧した後に特定のアクションを実行したときに発生します。Google Ads コンバージョンコネクタは Google Ads API を使用しており、オフラインコンバージョンのアップロードや以前に取得したコンバージョン値の調整をサポートしています。このコネクタを使用して、オフラインでのクリックコンバージョンを Google Ads にアップロードし、電話や営業担当者を通じて販売につながった広告を追跡することができます。オフラインの通話コンバージョンをアップロードして、広告が電話を引き起こし、それらの電話が価値ある顧客アクションにつながる場合を追跡できます。 ## 要件 * オフラインコンバージョンを送信するには、Google Ads インポートコンバージョンアクションを構成し、ソースとして通話またはクリックを指定します。詳細については、[Google ヘルプドキュメントのオフラインコンバージョンに関するページ](https://support.google.com/google-ads/answer/2998031?sjid=13815989904284925133-NC)を参照してください。 * コンバージョンを調整するには、元のコンバージョンのトランザクション ID を持っているか、`gclid` とコンバージョンの日時を使用して調整したいコンバージョンを特定する必要があります。 ## コネクタアクション | アクション名 | AudienceStream | EventStream | | --- | :---: | :---: | | 通話コンバージョンのアップロード - レガシー | ✓ | ✓ | | クリックコンバージョンのアップロード - レガシー | ✓ | ✓ | | コンバージョンの再声明 | ✓ | ✓ | | コンバージョンの撤回 | ✓ | ✓ | | 通話コンバージョンのアップロード | ✓ | ✓ | | クリックコンバージョンのアップロード | ✓ | ✓ | ## API 情報 このコネクタは以下のベンダー API を使用します： * API 名: Google Ads API * API バージョン: v18 * API エンドポイント: `https://googleads.googleapis.com/` * ドキュメント: [Google Ads API](https://developers.google.com/google-ads/api/docs/start) ## バッチ制限 このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[Batched Actions](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます： * 最大リクエスト数: 2000 * 最古のリクエストからの最大時間: 10分 * リクエストの最大サイズ: 2 MB ## 遅延アクション Google のベストプラクティスに従い、オフラインコンバージョンのアップロードを容易にするために、アクションは30分遅延されます。Google Campaign Manager 360 Floodlight コネクタを使用した遅延アクションについての詳細は、Google の[オフラインコンバージョンのアップロードに関するベストプラクティス](https://support.google.com/searchads/answer/6074338?hl=en)のドキュメントを参照してください。
EventStream または AudienceStream で [trace](https://docs.tealium.com/manage-traces/) を使用する場合、アクションは遅延されません。
### 同意 コネクタはデフォルトで `adUserData` および `adPersonalization` の同意に `GRANTED` の値を送信します。デフォルトを上書きするには、関連する EventStream 属性を `Ad User Data Consent` および/または `Ad Personalization Consent` にマッピングし、値を `DENIED` に構成します。 ## 構成の構成 Connector Marketplace にアクセスして新しいコネクタを追加します。コネクタを追加する一般的な手順については、[About Connectors](https://docs.tealium.com/about-connectors/) の記事を参照してください。 コネクタを追加した後、次の構成を構成します： * **Customer ID**: 管理する広告アカウントの顧客 ID を入力するか、アクション構成の動的オーバーライドフィールドを使用します。 * **Manager Customer ID**: 管理されたアカウントにアクセスする場合は、**Manager Customer ID** と **Customer ID** を入力します。 コネクタを構成した後、**Done** をクリックします。 ## アクション構成 - パラメータとオプション コネクタアクションの構成を続行するには、**Continue** をクリックします。アクションの名前を入力し、リストからアクションタイプを選択します。 次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。 ### アクション - 通話コンバージョンのアップロード - レガシー #### パラメータ |**パラメータ**| **説明**| |---| ---| |Customer ID| (必須) 顧客アカウント ID を選択します。認証されたユーザーにアクセス可能な顧客アカウントのオプションが表示されます。 | |Conversion Action| (必須) 既存のコンバージョンアクションを選択します。`UPLOAD_CALLS` タイプの Google Ads コンバージョンアクションのみが表示されます。詳細については、[Google: Google Ads コンバージョン追跡](https://support.google.com/google-ads/answer/1722022)を参照してください。 | #### コンバージョンデータパラメータ |**パラメータ**| **説明**| |---| ---| |Caller ID| (必須) この通話が発信された発信者 ID。発信者 ID は E.164 形式で、プラス (`+`) 文字が先行します。例：`+16502531234`。 | |Call Start Datetime| (必須) 通話が発生した日時。タイムゾーンを指定する必要があります。形式は **yyyy-mm-dd hh:mm:ss±hh:mm** です。例：`2020-01-01 12:32:45-8:00`。 | |Conversion Datetime| (必須) コンバージョンが発生した日時。この日時は通話時間の後でなければなりません。タイムゾーンを指定する必要があります。形式は **yyyy-mm-dd hh:mm:ss±hh:mm** です。例：`2020-01-01 12:32:45-8:00`。 | |Conversion Value| 広告主にとってのコンバージョンの価値。 | |Currency Code| コンバージョン値に関連する通貨。ISO 4217 の 3 文字の通貨コードです。例：`USD` や `EUR`。 | #### オプションパラメータ |**パラメータ**| **説明**| |---| ---| | Conversion Action Override | **Conversion Action** パラメータを上書きするためのコンバージョンアクション ID を提供します。このフィールドを使用すると、**Conversion Action ID** パラメータに EventStream 変数を入力できます。 | | Custom Variables | このコンバージョンに関連するカスタム変数。詳細については、[Google: Custom Variable](https://developers.google.com/google-ads/api/reference/rpc/v8/CustomVariable)を参照してください。 | |Ad User Data Consent | 広告ユーザーデータの同意。デフォルト値は `GRANTED` です。有効な値は `GRANTED` と `DENIED` です。 | ### アクション - クリックコンバージョンのアップロード - レガシー #### パラメータ |**パラメータ**| **説明**| |---| ---| |Customer ID| 顧客アカウント ID を選択します。認証されたユーザーにアクセス可能な顧客アカウントのオプションが表示されます。 | |Conversion Action| 既存のコンバージョンアクションを選択します。詳細については、[Google: Google Ads コンバージョン追跡](https://support.google.com/google-ads/answer/1722022)を参照してください。 | #### コンバージョンデータパラメータ |**パラメータ**| **説明**| |---| ---| |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`。 | |Conversion Value| 広告主にとってのコンバージョンの価値。 | |Currency Code| コンバージョン値に関連する通貨。ISO 4217 の 3 文字の通貨コードです。例：`USD` や `EUR`。 | |Order ID| (必須) コンバージョンに関連する注文 ID。注文 ID は、コンバージョンアクションごとに 1 回のコンバージョンにのみ使用できます。 | |External Attribution Credit| このパラメータは、Google Ads クリックに帰属するコンバージョンの割合を表します。 | |External Attribution Model| 指定された帰属モデル名。詳細については、[Google: Google Ads API Click Conversion](https://developers.google.com/google-ads/api/reference/rpc/v3/ClickConversion)を参照してください。 | | gbraid | (必須) iOS14 以降の iOS デバイスからのアプリコンバージョンに関連するクリックの識別子。値は Google Click ID、`gbraid`、または `wbraid` のいずれかです。 | | wbraid | (必須) iOS14 以降の iOS デバイスからのウェブコンバージョンに関連するクリックの識別子。値は Google Click ID、`gbraid`、または `wbraid` のいずれかです。 | #### カートデータパラメータ |**パラメータ**| **説明**| |---| ---| |マーチャントID| アイテムがアップロードされるマーチャントセンターID。 | |フィード国コード| アイテムがアップロードされるフィードの国コード。 | |フィード言語コード| アイテムがアップロードされるフィードの言語コード。 | |ローカルトランザクション| カート全体のトランザクションレベルの割引の合計（無料配送やクーポン割引など）。通貨コードは `ClickConversion` メッセージと同じです。 | |商品ID| 商品のショッピングID。この値はマーチャントセンターの商品識別子と同じでなければなりません。複数のアイテムを追加するには配列を使用します。配列型属性は長さが等しくなければなりません。 | |数量| 販売されたアイテムの数。複数のアイテムを追加するには配列を使用します。配列型属性は長さが等しくなければなりません。 | |単価| 税金、送料、およびトランザクションレベルの割引を除いた単価。通貨コードは `ClickConversion` メッセージと同じです。複数のアイテムを追加するには配列を使用します。配列型属性は長さが等しくなければなりません。 | #### オプションパラメータ |**パラメータ**| **説明**| |---| ---| | コンバージョンアクションオーバーライド | **コンバージョンアクション**パラメータをオーバーライドするためのコンバージョンアクションIDを提供します。**コンバージョンアクションID**パラメータを入力するためにEventStream変数を使用できます。 | | カスタム変数 | このコンバージョンに関連するカスタム変数。詳細については、[Google: Custom Variable](https://developers.google.com/google-ads/api/reference/rpc/v8/CustomVariable)を参照してください。 | |広告ユーザーデータの同意 | 広告ユーザーデータの同意。デフォルト値は `GRANTED` です。有効な値は `GRANTED` と `DENIED` です。 | ### アクション — コンバージョン再声明 #### パラメータ |**パラメータ**| **説明**| |---| ---| |コンバージョンアクション| 既存のコンバージョンアクションを選択します。詳細については、[Google: Google Ads Conversion Adjustments](https://support.google.com/google-ads/answer/7686447)を参照してください。 | |再声明値| (必須) 再声明後のコンバージョンの値。| |再声明日時| (必須) 調整が行われた日時。フォーマットは **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](https://support.google.com/google-ads/answer/7686447)を参照してください。| |撤回日時| (必須) 撤回が行われた日時。フォーマットは **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](https://support.google.com/google-ads/answer/1722022)を参照してください。 | #### コンバージョンデータパラメータ |**パラメータ**| **説明**| |---| ---| |発信者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](https://developers.google.com/google-ads/api/reference/rpc/v8/CustomVariable)を参照してください。 | | コンバージョンアクションオーバーライド | **コンバージョンアクション**パラメータをオーバーライドするためのコンバージョンアクションIDを提供します。このフィールドを使用して、EventStream変数で**コンバージョンアクションID**パラメータを入力できます。 | |広告ユーザーデータの同意 | 広告ユーザーデータの同意。デフォルト値は `GRANTED` です。有効な値は `GRANTED` と `DENIED` です。 | |顧客IDオーバーライド | (必須) 顧客アカウントIDを選択します。認証されたユーザーにアクセス可能な顧客アカウントのオプションが表示されます。 | | マネージャー顧客IDオーバーライド | (オプション) 顧客IDオーバーライドを使用してクライアント顧客にアクセスする場合、マネージャー顧客IDを提供します。 | ### アクション - クリックコンバージョンのアップロード #### パラメータ |**パラメータ**| **説明**| |---| ---| |コンバージョンアクション| 既存のコンバージョンアクションを選択します。詳細については、[Google: Google Ads Conversion Tracking](https://support.google.com/google-ads/answer/1722022)を参照してください。 | #### 変換データパラメータ |**パラメータ**| **説明**| |---| ---| |Google Click ID| (必須) この変換に関連付けられたGoogleクリックID (`gclid`)。Google Click ID、`gbraid`、または`wbraid`のいずれかが必要です。 | |変換日時| (必須) 変換が発生した日時。この日時は通話時間の後でなければなりません。タイムゾーンを指定する必要があります。形式は **yyyy-mm-dd hh:mm:ss±hh:mm** です。例: `2020-01-01 12:32:45-8:00`。 | |顧客タイプ| 変換に関連する顧客のタイプ。許可リストに載っている顧客のみがアクセス可能。許容値は `new` または `returning` です。 | |変換値| 広告主にとっての変換の価値。 | |通貨コード| 変換値に関連付けられたISO 4217の3文字通貨コード。例: `USD` または `EUR`。 | |注文ID| (必須) 変換に関連付けられた注文ID。注文IDは変換アクションごとに1つの変換にのみ使用できます。 | |外部帰属クレジット| Google広告クリックに帰属する変換の割合。 | |外部帰属モデル| 指定された帰属モデル名。詳細については、[Google: Google広告APIクリック変換](https://developers.google.com/google-ads/api/reference/rpc/v3/ClickConversion)を参照してください。 | | gbraid | (必須) iOS14から始まるiOSデバイスからのアプリ変換に関連するクリックの識別子。値はGoogle Click ID、`gbraid`、または`wbraid`のいずれかです。 | | wbraid | (必須) iOS14から始まるiOSデバイスからのウェブ変換に関連するクリックの識別子。値はGoogle Click ID、`gbraid`、または`wbraid`のいずれかです。 | #### カートデータパラメータ |**パラメータ**| **説明**| |---| ---| |マーチャントID| アイテムがアップロードされるマーチャントセンターID。 | |フィード国コード| アイテムがアップロードされるフィードの国コード。 | |フィード言語コード| アイテムがアップロードされるフィードの言語コード。 | |ローカルトランザクション| カート全体の送料無料やクーポン割引など、すべてのトランザクションレベルの割引の合計。通貨コードは`ClickConversion`メッセージと同じです。 | |商品ID| アイテムのショッピングID。この値はマーチャントセンターの商品識別子と同じでなければなりません。複数のアイテムを追加するには配列を使用します。配列タイプの属性は長さが等しくなければなりません。 | |数量| 販売されたアイテムの数。複数のアイテムを追加するには配列を使用します。配列タイプの属性は長さが等しくなければなりません。 | |単価| 税金、送料、およびトランザクションレベルの割引を除いた単価。通貨コードは`ClickConversion`メッセージと同じです。複数のアイテムを追加するには配列を使用します。配列タイプの属性は長さが等しくなければなりません。 | #### オプションパラメータ |**パラメータ**| **説明**| |---| ---| | カスタム変数 | この変換に関連するカスタム変数。詳細については、[Google: カスタム変数](https://developers.google.com/google-ads/api/reference/rpc/v8/CustomVariable)を参照してください。 | |広告ユーザーデータの同意 | 広告ユーザーデータの同意。デフォルト値は`GRANTED`です。有効な値は`GRANTED`と`DENIED`です。 | | 変換アクションオーバーライド | **変換アクション**パラメータをオーバーライドするための変換アクションIDを提供します。このフィールドを使用して、**変換アクションID**パラメータにEventStream変数を入力できます。 | |顧客IDオーバーライド | (必須) 顧客アカウントIDを選択します。利用可能なオプションは認証されたユーザーのアクセス可能な顧客アカウントを反映します。 | |マネージャー顧客IDオーバーライド | (オプション) 顧客IDオーバーライドを使用してクライアント顧客にアクセスする場合、マネージャー顧客IDを提供してください。 |