Google Adsストアセールスコネクタ構成ガイド
この記事では、Google Adsストアセールスコネクタの構成方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します：
- API名：Google Ads API
- APIバージョン：v17
- 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のタイプでなければなりません。 |
ユーザー識別子
| パラメータ | 説明 |
|---|---|
| 住所情報：国コード | ユーザーの住所に使用される国コード。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からのオプションのタイムゾーンオフセットです。 |
| トランザクション金額 | （必須）トランザクション金額（マイクロ単位）。1,000,000が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にEventStream属性をマップし、値をDENIEDにします。
| パラメータ | 説明 |
|---|---|
| Ad User Data Consent | 広告ユーザーデータの同意。デフォルト値はGRANTEDです。有効な値はGRANTEDとDENIEDです。 |
| Ad Personalization Consent | 広告のパーソナライゼーションの同意。デフォルト値はGRANTEDです。有効な値はGRANTEDとDENIEDです。 |
アクション - トランザクションのアップロード（複数の識別子）
バッチ制限
このアクションは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、以下のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：
- リクエストの最大数：33000
- 最も古いリクエストからの最大時間：60分
- リクエストの最大サイズ：40MB
パラメータ
| パラメータ | 説明 |
|---|---|
| コンバージョンアクション | コンバージョンアクションは、STORE_SALESまたはSTORE_SALES_DIRECT_UPLOADのタイプでなければなりません。 |
ユーザー識別子
| パラメータ | 説明 |
|---|---|
| 住所情報：国コード | ユーザーの住所に使用される国コード。ISO-3166-1 alpha-2形式の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からのオプションのタイムゾーンオフセット。 |
| トランザクション金額 | (必須) マイクロ単位のトランザクション金額。ここで一百万は一通貨単位に相当します。 |
| 通貨コード | (必須) 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です。 |
最終更新日 :: 2024年December月18日