Google Ads 店舗売上コネクタ構成ガイド
この記事では、Google Ads 店舗売上コネクタの構成方法について説明します。
API 情報
このコネクタは以下のベンダー API を使用します：
- API 名: Google Ads API
- API バージョン: v18
- API エンドポイント:
https://googleads.googleapis.com/ - ドキュメント: Google Ads API
コネクタのアクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| トランザクションのアップロード | ✗ | ✓ |
| 複数識別子でのトランザクションのアップロード | ✗ | ✓ |
構成の構成
コネクタマーケットプレイスに移動して、新しいコネクタを追加します。コネクタの追加方法については、コネクタについてを参照してください。
このコネクタを追加する際には、ベンダーのデータプラットフォームポリシーを受け入れるよう求められます。
コネクタを追加した後、以下の構成を構成します：
- 顧客 ID
(必須) Google Ads アカウントの顧客 ID。 - マネージャー顧客 ID
(オプション) クライアントを代表してアカウントにアクセスする場合、マネージャー顧客 ID を構成する必要があります。顧客 ID は、Google Ads にログインして 構成 > アクセスとセキュリティ > マネージャー に移動することで見つけることができます。
アクション構成 - パラメータとオプション
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション - トランザクションのアップロード
バッチ制限
このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：
- リクエストの最大数: 100000
- 最古のリクエストからの最大時間: 60分
- リクエストの最大サイズ: 40 MB
パラメータ
| パラメータ | 説明 |
|---|---|
| コンバージョンアクション | customers/{customer_id}/conversionActions/{conversion_action_id} 形式の有効な Google Ads コンバージョンアクションのリソース名。コンバージョンアクション ID は、Google Ads URL の ctId クエリパラメータです。コンバージョンアクションは STORE_SALES タイプでなければなりません。詳細については、Google Ads API: 店舗売上のコンバージョンのインポートを参照してください。 |
ユーザー識別子
| パラメータ | 説明 |
|---|---|
| 住所情報: 国コード | ユーザーの住所にある国のコードを ISO 3166-1 alpha-2 形式の2文字で指定します。 |
| 住所情報: 名 (既に SHA256 ハッシュ化済み) | ユーザーの名前を既に空白トリム、小文字化、SHA256 ハッシュ化したものを提供します。 |
| 住所情報: 名 (SHA256 ハッシュを適用) | ユーザーの名前をプレーンテキストで提供し、コネクタがこの値を空白トリム、小文字化し、SHA256 ハッシュを適用します。 |
| 住所情報: 姓 (既に SHA256 ハッシュ化済み) | ユーザーの姓を既に空白トリム、小文字化、SHA256 ハッシュ化したものを提供します。 |
| 住所情報: 姓 (SHA256 ハッシュを適用) | ユーザーの姓をプレーンテキストで提供し、コネクタがこの値を空白トリム、小文字化し、SHA256 ハッシュを適用します。 |
| 住所情報: 郵便番号 | ユーザーの住所の郵便番号。 |
| メールアドレス (既に SHA256 ハッシュ化済み) | ユーザーのメールアドレスを既に空白トリム、小文字化、SHA256 ハッシュ化したものを提供します。 |
| メールアドレス (SHA256 ハッシュを適用) | ユーザーのメールアドレスをプレーンテキストで提供し、コネクタがこの値を空白トリム、小文字化し、SHA256 ハッシュを適用します。 |
| 電話番号 (既に SHA256 ハッシュ化済み) | ユーザーの電話番号を既に空白トリム、SHA256 ハッシュ化したものを提供します。 |
| 電話番号 (SHA256 ハッシュを適用) | ユーザーの電話番号をプレーンテキストで提供し、コネクタがこの値を空白トリムし、SHA256 ハッシュを適用します。 |
| サードパーティユーザー ID | サードパーティに割り当てられたユーザー ID。 |
トランザクションデータ
| パラメータ | 説明 |
|---|---|
| トランザクション日時 | (必須) トランザクションが発生したタイムスタンプを YYYY-MM-DD HH:MM:SS[+/-HH:MM] 形式で指定します。ここで [+/-HH:MM] は UTC からのオプションのタイムゾーンオフセットです。 |
| トランザクション金額 | (必須) トランザクション金額をマイクロ単位で指定します。ここで、100万が1通貨単位に相当します。 |
| 通貨コード | (必須) トランザクションの通貨コードを ISO 4217 の3文字形式で指定します。 |
| トランザクションアップロード比率 | (必須) 顧客に関連付けられる全売上に対してアップロードされる売上の比率。この値は0から1の間でなければならず（0を除く）、例えば顧客に関連付け可能な売上の半分をアップロードする場合、この値は0.5になります。 |
| トランザクション注文 ID | トランザクションの注文 ID。 |
| カスタムキー | トランザクションに適用可能な店舗売上のカスタム変数キーの名前。後でカスタムセグメンテーションやレポーティングに使用できます。 |
| カスタム値 | 各トランザクションのカスタム変数の値。 |
| 店舗コード | Google に事前にアップロードされたユニークな店舗 ID。 |
| 商品 ID | 商品のユニークな識別子。Merchant Center 商品 ID または GTIN（グローバルトレードアイテムナンバー）のいずれかです。 |
| 数量 | 販売された商品の数。構成されていない場合、デフォルトは1です。 |
| 国コード | フィードにアップロードされた商品に関連する国の Common Locale Data Repository (CLDR) 領土コード。 |
| 言語コード | フィードにアップロードされた商品に関連する言語の ISO 639-1 コード。 |
| マーチャント ID | Merchant Center アカウントの ID。 |
同意
デフォルトでは、コネクタは adUserData および adPersonalization の同意に対して GRANTED の値を送信します。デフォルトを上書きするには、関連する EventStream 属性を Ad User Data Consent および/または Ad Personalization Consent にマッピングし、値を DENIED に構成します。
| パラメータ | 説明 |
|---|---|
| 広告ユーザーデータの同意 | 広告ユーザーデータに関する同意。デフォルト値は GRANTED です。有効な値は GRANTED と DENIED です。 |
| 広告パーソナライゼーションの同意 | 広告パーソナライゼーションに関する同意。デフォルト値は GRANTED です。有効な値は GRANTED と DENIED です。 |
アクション - 複数識別子でのトランザクションのアップロード
バッチ制限
このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：
- リクエストの最大数: 33000
- 最古のリクエストからの最大時間: 60分
- リクエストの最大サイズ: 40 MB
パラメータ
| パラメータ | 説明 |
|---|---|
| コンバージョンアクション | customers/{customer_id}/conversionActions/{conversion_action_id} 形式の有効な Google Ads コンバージョンアクションのリソース名。コンバージョンアクション ID は、Google Ads URL の ctId クエリパラメータです。コンバージョンアクションは STORE_SALES タイプでなければなりません。詳細については、Google Ads API: 店舗売上のコンバージョンのインポートを参照してください。 |
ユーザー識別子
| パラメータ | 説明 |
|---|---|
| 住所情報：国コード | ユーザーの住所における国コードをISO 3166-1 alpha-2形式の2文字で表します。 |
| 住所情報：名（既にSHA256ハッシュ化済み） | ユーザーの名を既に空白トリム、小文字化、SHA256ハッシュ化したものを提供します。 |
| 住所情報：名（SHA256ハッシュを適用） | ユーザーの名のプレーンテキストを提供し、コネクタが空白トリム、小文字化、SHA256ハッシュを適用します。 |
| 住所情報：姓（既にSHA256ハッシュ化済み） | ユーザーの姓を既に空白トリム、小文字化、SHA256ハッシュ化したものを提供します。 |
| 住所情報：姓（SHA256ハッシュを適用） | ユーザーの姓のプレーンテキストを提供し、コネクタが空白トリム、小文字化、SHA256ハッシュを適用します。 |
| 住所情報：郵便番号 | ユーザーの住所の郵便番号。 |
| 電子メールアドレス（既にSHA256ハッシュ化済み） | ユーザーの電子メールアドレスを既に空白トリム、小文字化、SHA256ハッシュ化したものを提供します。 |
| 電子メールアドレス（SHA256ハッシュを適用） | ユーザーの電子メールアドレスのプレーンテキストを提供し、コネクタが空白トリム、小文字化、SHA256ハッシュを適用します。 |
| 電話番号（既にSHA256ハッシュ化済み） | ユーザーの電話番号を既に空白トリム、SHA256ハッシュ化したものを提供します。 |
| 電話番号（SHA256ハッシュを適用） | ユーザーの電話番号のプレーンテキストを提供し、コネクタが空白トリム、SHA256ハッシュを適用します。 |
| 第三者ユーザーID | 第三者に割り当てられたユーザーID。 |
取引データ
| パラメータ | 説明 |
|---|---|
| 取引日時 | （必須）取引が発生したタイムスタンプを YYYY-MM-DD HH:MM:SS[+/-HH:MM] 形式で、ここで [+/-HH:MM] はUTCからのオプションのタイムゾーンオフセットです。 |
| 取引金額 | （必須）取引金額をマイクロ単位で、100万が1通貨単位に相当します。 |
| 通貨コード | （必須）取引通貨コードをISO 4217の3文字形式で表します。 |
| 取引アップロード比率 | （必須）顧客に関連付けられた全体の売上に対してアップロードされた売上の比率。この値は0から1の間でなければならず（0を除く）、例えば顧客に関連付けられた売上の半分をアップロードする場合、この値は0.5になります。 |
| 取引注文ID | 取引の注文ID。 |
| カスタムキー | 店舗売上のカスタム変数キーの名前。取引に適用可能な事前定義されたキーで、後でカスタムセグメンテーションのレポーティングに使用できます。 |
| カスタム値 | 各取引のカスタム変数の値。 |
| 店舗コード | Googleに事前にアップロードされたユニークな店舗ID。 |
| 商品ID | 商品のユニークな識別子。Merchant Centerの商品IDまたはGTIN（グローバルトレードアイテムナンバー）のいずれかです。 |
| 数量 | 売れた商品の数。構成されていない場合、デフォルトは1です。 |
| 国コード | フィードがアップロードされた国に関連するCommon Locale Data Repository (CLDR)の地域コード。 |
| 言語コード | フィードがアップロードされた言語に関連するISO 639-1コード。 |
| マーチャントID | Merchant CenterアカウントのID。 |
同意
コネクタはデフォルトで adUserData および adPersonalization の同意に GRANTED の値を送信します。デフォルトを上書きするには、関連するEventStream属性を Ad User Data Consent、Ad Personalization Consent、またはその両方にマップし、値を DENIED に構成します。
| パラメータ | 説明 |
|---|---|
| 広告ユーザーデータの同意 | 広告ユーザーデータに関する同意。デフォルト値は GRANTED です。有効な値は GRANTED と DENIED です。 |
| 広告パーソナライゼーションの同意 | 広告パーソナライゼーションに関する同意。デフォルト値は GRANTED です。有効な値は GRANTED と DENIED です。 |
最終更新日 :: 2025年July月10日