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分
- リクエストの最大サイズ：40MB
パラメータ
| パラメータ | 説明 |
|---|---|
| コンバージョンアクション | コンバージョンアクションは、STORE_SALESまたはSTORE_SALES_DIRECT_UPLOADのタイプでなければなりません。 |
ユーザー識別子
| パラメータ | 説明 |
|---|---|
| 住所情報：国コード | ユーザーの住所に使用される2文字のISO 3166-1 alpha-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（Global Trade Item Number）のいずれかになります。 |
| 数量 | 売れたアイテムの数。構成されていない場合、デフォルトは1です。 |
| 国コード | アイテムがアップロードされているフィードに関連する国のCommon Locale Data Repository（CLDR）の地域コード。 |
| 言語コード | アイテムがアップロードされているフィードに関連する言語のISO 639-1コード |
| マーチャントID | Merchant CenterアカウントのID。 |
同意
コネクタは、adUserDataとadPersonalizationの同意について、デフォルトでGRANTEDの値を送信します。デフォルトを上書きするには、Ad User Data Consentおよび/またはAd Personalization Consentに対して、DENIEDの値を持つ関連するEventStream属性をマップします。
| パラメータ | 説明 |
|---|---|
| Ad User Data Consent | 広告ユーザーデータの同意。デフォルト値はGRANTEDです。有効な値はGRANTEDとDENIEDです。 |
| Ad Personalization Consent | 広告のパーソナライゼーションの同意。デフォルト値はGRANTEDです。有効な値はGRANTEDとDENIEDです。 |
アクション - トランザクションのアップロード（複数の識別子）
バッチ制限
このアクションは、ベンダーへの大量のデータ転送をサポートするために、バッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、以下のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：
- リクエストの最大数：33000
- 最も古いリクエストからの最大時間：60分
- リクエストの最大サイズ：40MB
パラメータ
| パラメータ | 説明 |
|---|---|
| コンバージョンアクション | コンバージョンアクションは、STORE_SALESまたはSTORE_SALES_DIRECT_UPLOADのタイプでなければなりません。 |
ユーザー識別子
| パラメータ | 説明 |
|---|---|
| 住所情報：国コード | ユーザーの住所に使用される2文字のISO 3166-1 alpha-2形式の国コード。 |
| 住所情報：名（すでにSHA256でハッシュ化されている） | すでに空白を削除し、小文字に変換し、SHA256でハッシュ化されたユーザーの名前を提供します。 |
| 住所情報：名（SHA256ハッシュを適用） | ユーザーのプレーンテキストの名前を提供し、コネクタはこの値を空白を削除し、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。 |
| 住所情報：姓（すでにSHA256でハッシュ化されている） | すでに空白を削除し、小文字に変換し、SHA256でハッシュ化されたユーザーの姓を提供します。 |
| 住所情報：姓（SHA256ハッシュを適用） | ユーザーのプレーンテキストの姓を提供し、コネクタはこの値を空白を削除し、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。 |
| 住所情報：郵便番号 | ユーザーの住所の郵便番号。 |
| メールアドレス（すでにSHA256でハッシュ化されている） | すでに空白を削除し、小文字に変換し、SHA256でハッシュ化されたユーザーのメールアドレスを提供します。 |
| メールアドレス（SHA256ハッシュを適用） | ユーザーのプレーンテキストのメールアドレスを提供し、コネクタはこの値を空白を削除し、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。 |
| 電話番号（すでにSHA256でハッシュ化されている） | すでに空白を削除し、SHA256でハッシュ化されたユーザーの電話番号を提供します。 |
| 電話番号（SHA256ハッシュを適用） | ユーザーのプレーンテキストの電話番号を提供し、コネクタはこの値を空白を削除し、SHA256ハッシュを使用してハッシュ化します。 |
| サードパーティユーザーID | サードパーティに割り当てられたユーザーID。 |
| 電話番号（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（Global Trade Item Number）のいずれかです。 |
| 数量 | 売れたアイテムの数。構成されていない場合、デフォルトは1です。 |
| 国コード | フィードにアップロードされたアイテムと関連する国のCommon Locale Data Repository（CLDR）領土コード。 |
| 言語コード | フィードにアップロードされたアイテムと関連する言語のISO 639-1コード |
| マーチャントID | Merchant CenterアカウントのID。 |
同意
コネクターは、adUserDataとadPersonalizationの同意について、デフォルトでGRANTEDの値を送信します。デフォルトを上書きするには、Ad User Data Consentおよび/またはAd Personalization Consentに対してDENIEDの値を持つ関連するEventStream属性をマップします。
| パラメータ | 説明 |
|---|---|
| Ad User Data Consent | 広告ユーザーデータの同意。デフォルト値はGRANTEDです。有効な値はGRANTEDとDENIEDです。 |
| Ad Personalization Consent | 広告のパーソナライゼーションの同意。デフォルト値はGRANTEDです。有効な値はGRANTEDとDENIEDです。 |
最終更新日 :: 2025年January月31日