ローカル プロモーションのデータソース仕様

• プロモーション ID では大文字と小文字が区別されます。特定のプロモーションを商品データソース内の一連の商品にマッピングする場合は、両方のデータソースの ID を完全に一致させる必要があります。
• プロモーション ID にスペースや記号（%、! など）を使用することはできません。
• 1 つの商品アイテムに複数のプロモーション ID 値を追加するには（1 つの商品アイテムに 10 個まで追加可能）、商品データソースの「promotion id」列に値をカンマで区切って登録します。
• プロモーション ID は 60 文字以内で指定してください。

• すべての商品 [all_products]
• 特定の商品 [specific_products]

• 値を specific_products に設定すると、商品ターゲット設定属性を使用して、プロモーションが適用される商品が決定されます（商品ターゲット設定の詳細については、下記のオプションの属性をご覧ください）。
• 値を all_products に設定すると、商品ターゲット設定のフィルタは無視されます。

• コード不要 [no_code]
• 汎用コード [generic_code]

• クーポンコード必須 [offer_type] 属性が generic_code に設定されている場合、この属性は必須です。
• 汎用適用コード [generic_redemption_code] 属性に登録する値は 20 文字以内にしてください。

• プロモーションのタイトル [long_title] には、プロモーションを完全かつ正確に記載する必要があります。
• 60 文字以内で指定してください。

• 日付の形式: YYYY-MM-DD
• 時刻の形式: HH:MM:SS、GMT に関連する調整を含まない形式（下記を参照）。
  • 時間は GMT（グリニッジ標準時）に基づきます。そのため、直後に、自分のタイムゾーンと GMT との差が何時間何分か（+HH:MM または -HH:MM）も指定する必要があります。
    • たとえば、プロモーションの日時が PST（太平洋標準時）の場合、PST は GMT より 8 時間早いため「-08:00」を追加します。
• 日付と時刻は文字「T」で区切ります。
• まず開始の日付と時刻を入力し、スラッシュ（/）で区切った後に終了の日付と時刻を入力します。

• プロモーションの有効期限が 2019 年 7 月 19 日の午前 3 時から 2019 年 7 月 26 日の午後 9 時（東部標準時）までの場合:
  • 2019-07-19T03:00:00-05:00/2019-07-26T21:00:00-05:00
• プロモーションの有効期限が 2019 年 7 月 19 日の午前 3 時から 2019 年 7 月 26 日の午後 9 時（グリニッジ標準時）までの場合:
  • 2019-07-19T03:00:00+00:00/2019-07-26T21:00:00+00:00

• サマータイムが適用される場合は、以下のように調整してください。
  • 通常の時間においては、「-05:00」は EST を、「-08:00」は PST を表します。
  • サマータイムの期間においては、「-04:00」は EDT を、「-07:00」は PDT を表します。

• in_store
• online
• online_and_in_store

• オムニチャネルのプロモーション（店舗とオンラインの両方に適用される）を行う場合は、「online_and_in_store」の値を登録してください。
• この値を空のままにすると、プロモーションはデフォルトでオンラインになります。
  • オンライン プロモーションは、店舗の地域の範囲に限定されず、オンライン ショッピング広告に表示されます。

• all_stores
• specific_stores

• specific_stores を選択する場合は、含める店舗コード [store_codes_inclusion] 属性、または除外する店舗コード [store_codes_exclusion] 属性も使用する必要があります。
• all_stores を選択する場合は、含める店舗コード属性と除外する店舗コード属性（下記を参照）は無視されます。

• promotion_destination: local_inventory_ads
• promotion_destination: Shopping_ads
• promotion_destination: Buy_on_Google_listings
• promotion_destination: Free_listings

• specific_stores を使用してプロモーションを特定の店舗に適用する場合は、ビジネス プロフィールに登録されている店舗コードを登録します。
• 含める店舗コード [store_codes_inclusion] 属性、または除外する店舗コード [store_codes_exclusion] 属性のいずれかを使用することはできますが、両方を同時に使用することはできません。

• specific_stores を使用してプロモーションから特定の店舗を除外する場合は、ビジネス プロフィールに登録されている店舗コードを登録します。
• 除外する店舗コード [store_codes_exclusion] 属性、または含める店舗コード [store_codes_inclusion] 属性のいずれかを使用することはできますが、両方を同時に使用することはできません。

プロモーションの対象商品 [product_applicability] 属性が specific_products に設定されている場合、この商品アイテム ID 属性を設定することで、関連する ID で表される商品データソース内の商品アイテムにプロモーションをマッピングします。

• プロモーション ソースでは、最大 20 個の商品アイテム ID を 1 つのプロモーションにマッピングできます。
• 20 を超えるアイテムにプロモーションを割り当てる場合は、プロモーション対象の商品 ID [item_id] 属性を使用しないでください。代わりに、商品データソース内の商品アイテムにプロモーション ID を直接追加してください。

• カテゴリ内に対象外の商品がある場合は、この属性を設定しないでください。その場合は、商品データソース内の対象の商品アイテムにプロモーション ID [promotion_id] を手動でマッピングするか、プロモーション対象の商品 ID [item_id] 属性（上記を参照）を使用して、プロモーション ソース内の対象の商品アイテムをマッピングします。マッピングについて詳しくは、プロモーション実装ガイドのプロモーション用の商品を選択するをご覧ください。
• ファッション・アクセサリー（166）やメディア（783）など、最上位のカテゴリはサポートされていません。商品が上記のいずれかに該当する場合は、より詳細なカテゴリを指定する必要があります。例: ファッション・アクセサリー > 衣料品 > スポーツウェア > 自転車ウェア（5697）

• 商品カテゴリ内に対象外の商品がある場合は、この属性を設定しないでください。その場合は、商品データソース内の対象の商品アイテムにプロモーション ID [promotion_id] を手動でマッピングするか、プロモーション対象の商品 ID [item_id] 属性（上記を参照）を使用して、プロモーション ソース内の対象の商品アイテムをマッピングします（最大 20 個までの商品アイテムをマッピング可能）。マッピングについて詳しくは、プロモーション実装ガイドのプロモーション用の商品を選択するをご覧ください。

• カテゴリ内に対象となる商品アイテムがある場合は、この属性を設定しないでください。その場合は、商品データソース内の対象の商品アイテムにプロモーション ID [promotion_id] を手動でマッピングするか、プロモーション対象の商品 ID [item_id] 属性（上記を参照）を使用して、プロモーション ソース内の対象の商品アイテムをマッピングします（最大 20 個までの商品アイテムをマッピング可能）。マッピングについて詳しくは、プロモーション実装ガイドのプロモーション用の商品を選択するをご覧ください。

• 最大 10 個の商品カテゴリを指定できます。各商品カテゴリはカンマで区切ってください。
• 商品カテゴリ内に対象となる商品アイテムがある場合は、この属性を設定しないでください。その場合は、商品データソース内の対象の商品アイテムにプロモーション ID [promotion_id] を手動でマッピングするか、プロモーション対象の商品 ID [item_id] 属性（上記を参照）を使用して、プロモーション ソース内の対象の商品アイテムをマッピングします（最大 20 個までの商品アイテムをマッピング可能）。マッピングについて詳しくは、プロモーション実装ガイドのプロモーション用の商品を選択するをご覧ください。

• 最大 10 個のブランドを指定できます。各ブランドはカンマで区切ってください。
• ブランドでは大文字と小文字が区別され、スペースの有無も区別されます。商品データソース内で指定されているブランドの名前と完全に一致している必要があります。
• ブランド内に対象となる商品アイテムがある場合は、この属性を設定しないでください。その場合は、商品データソース内の対象の商品アイテムにプロモーション ID [promotion_id] を手動でマッピングするか、プロモーション対象の商品 ID [item_id] 属性（上記を参照）を使用して、プロモーション ソース内の対象の商品アイテムをマッピングします（最大 20 個までの商品アイテムをマッピング可能）。マッピングについて詳しくは、プロモーション実装ガイドのプロモーション用の商品を選択するをご覧ください。

• 使用できるキー: google_product_category、product_type、brand
• 形式: {属性1: “値A”, 属性2: “値B”}
• 最大文字数は 500 文字です。

• {brand: “Nike”, google_product_category: “ファッション・アクセサリー > 靴”}

重要:

• プロモーションのタグ [promotion_tags] 属性は、カテゴリ内またはブランド内のすべてではなく一部の商品アイテムにプロモーションが適用され、特定のアイテム ID が不明な場合に使用してください。