自動割引を設定する

価格トークンを実装するには、以下の説明に従ってください

トークンの構造

JWT トークンには、ヘッダーとペイロードの 2 つの JSON オブジェクトが含まれます。

ヘッダー

---

{

"alg": "ES256",

"typ": "JWT"

}

---

Google が生成するトークン ヘッダーには次の 2 つのフィールドがあります。

• alg - 使用されるアルゴリズム、値は常に "ES256"
• typ - メディアタイプ、値は常に "JWT"

トークン ヘッダーに他のフィールドがある場合や、フィールドの値が上記とは異なる場合は、トークンを拒否する必要があります。

ペイロード

---

{
"exp": 1571673600,
"o": "tddy123uk",
"m": "140301646",
"p": 21.99,
"pp": 15.00,
"c": "USD"
}

---

ペイロードには以下のフィールドがあります。

• exp - 有効期限（Unix 時間）。トークンの有効期限が切れている場合は、拒否する必要があります。
• o - オファー ID。ランディング ページが商品または有効なバリエーションと一致しているかどうかを確認するために使用します。ランディング ページが商品または有効なバリエーションと一致していない場合は、拒否する必要があります。有効なバリエーションとは、同じ靴の別サイズなどです。
• m - 販売者 ID。販売者 ID が一致しない場合、トークンを拒否する必要があります。
• p - Google 自動割引（GAD）の価格
• pp - 以前の価格*
  * EEA: 以前の価格も、ショッピング広告に表示されている場合は URL に渡されます。オンライン ショップに以前の価格を表示することもできます。

  以前の価格は、クロアチア、ラトビア、ノルウェー、ポーランド、スペインでは Google で過去 30 日間にユーザーに表示された最低価格を表します。

  その他の EEA 加盟国でも、以前の価格は一般的には Google で過去 30 日間にユーザーに表示された最低価格を表しますが、過去 60 日間に異なる値下げ（10% オフ、20% オフ、50% オフなど）が連続して適用された場合は、最初の値下げ前に適用されていた価格になります。

  例: 商品の価格が、1 日目: 100 ユーロ、7 日目: 90 ユーロ、14 日目: 80 ユーロ、21 日目: 70 ユーロに変更された場合、22 日目の以前の価格はクロアチア、ラトビア、ノルウェー、ポーランド、スペインでは 80 ユーロ、その他のすべての EEA 加盟国では 100 ユーロになります。

• c - 通貨、大文字

トークンの使用

トークンの使用に関する正確な詳細は、使用するライブラリによって異なりますが、大まかな手順は、デコードと署名の検証、フィールドの検証、価格の使用の 3 つです。

デコードと署名の検証 Base64URL でエンコードされたトークンが pv2 URL リクエスト パラメータで渡されます。

ほとんどのライブラリではデコードと署名の検証を組み合わせて 1 つの関数にしています。入力は「token」、「ES256」（アルゴリズム）、「public key」で、出力は「token_body」です。

検証用の公開鍵:

次のキーは、自動割引のすべてのユーザーが期限なしで使用することを想定しています。

フィールドの検証

選択したライブラリが前のステップで鍵とアルゴリズムを受け取り、ヘッダー オプションにかかわらずそれらを強制的に使用する場合、ヘッダーの追加確認は必要ありません。それ以外の場合は、上記のガイドラインに従ってヘッダー フィールドを確認する必要があります。詳しくは、JSON Web Token Best Current Practices（JSON ウェブトークンの現在のベスト プラクティス）をご覧ください。

使用しているライブラリにかかわらず、販売者側のデータに照らして o、m、p のフィールドを検証する必要があります。一致しない場合は、ユーザーが商品および販売者間でトークンをコピーできないように、トークンを拒否する必要があります。販売者は exp フィールドを確認してトークンが期限切れの場合は拒否できます。ただし、これは必須ではありません。

価格の使用 すべてのフィールドが有効でトークンが期限切れではない場合、販売者は p フィールドで指定された価格を使用する必要があります。

このページに記載されている要件を既存のクーポン機能が満たしている場合、それを使用して価格を割り引きできます。特に、ランディング ページの価格は、トークンの価格と一致している必要があり、購入手続きページで割引を追加するだけでは不十分です。

テスト 統合が完了すると、以下の 3 つのステップでテストが行われます。

• 機能テスト（販売者が実施）
• 鍵の検証（Google が提供するトークンを使用して販売者が実施）
• 完全なエンドツーエンドのテスト（Google が実施）

機能テスト 開発中および開発後にテストを行う最も簡単な方法は、一時的な鍵ペアを生成することです。これにより、トークンを完全に管理できます。以下のコマンドを使用すると、有効な鍵ペアを生成できます。

トークンは、ES256 をアルゴリズムとして使用して jwt.io などのツールで生成できます。

鍵の検証 本番環境用の鍵が正しく設定されていることを検証するため、オンボーディング中に Merchant Center で署名付きトークンを使用できます（サンプル URL）。