Menyiapkan diskon otomatis

Untuk menerapkan token harga, ikuti petunjuk berikut.

Struktur token

Token JWT berisi dua objek JSON: header dan payload.

Header

{

"alg": "ES256",

"typ": "JWT"

}

Header token yang dibuat Google memiliki 2 kolom:

• alg - algoritma yang digunakan, nilainya selalu "ES256"
• typ - jenis media, nilainya selalu "JWT"

Jika header token berisi kolom lain, atau nilai kolom berbeda dengan yang dijelaskan di atas, token harus ditolak.

Payload

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

Payload memiliki kolom berikut:

• exp - waktu berakhirnya masa berlaku yang dinyatakan dalam waktu Unix. Jika masa berlaku token telah berakhir, token tersebut harus ditolak.
• o - ID penawaran, digunakan untuk memeriksa apakah halaman landing cocok dengan produk atau varian yang valid. Jika tidak cocok dengan produk atau varian yang valid, halaman landing akan ditolak. Varian yang valid dapat berupa ukuran lain untuk sepatu yang sama.
• m - ID penjual. Jika ID Merchant tidak cocok, token harus ditolak.
• p - harga Diskon Otomatis Google (GAD)
• pp - Harga sebelumnya*
  *Untuk EEA: Harga sebelumnya juga akan diteruskan di URL jika ditampilkan di iklan Shopping. Anda dapat memilih untuk menampilkan harga sebelumnya di toko online Anda. Harga sebelumnya mewakili harga terendah yang ditampilkan kepada pengguna di Google selama 30 hari terakhir di negara-negara berikut: Kroasia, Latvia, Norwegia, Polandia, Spanyol. Untuk semua negara EEA lainnya, harga sebelumnya mencerminkan harga sebelum penerapan pengurangan harga berturut-turut selama 60 hari terakhir.
• c - mata uang, huruf besar

Pemakaian token

Detail persis tentang pemakaian token bergantung pada library yang digunakan, tetapi di tingkat atas, ada 3 langkah: dekode dan validasi tanda tangan, validasi kolom, serta pemakaian harga.

Dekode dan validasi tanda tangan Token dengan enkode Base64URL diteruskan dalam parameter permintaan URL pv2:

Sebagian besar library menggabungkan validasi tanda tangan dan dekode menjadi fungsi tunggal dengan 'token", "ES256" (algoritma), dan "kunci publik" sebagai input, dan "token_body" sebagai output:

Kunci publik untuk validasi:

Kunci berikut ditujukan untuk digunakan oleh semua pengguna diskon otomatis tanpa batas masa berlaku.

Validasi kolom

Jika library yang dipilih menerima kunci dan algoritma di langkah sebelumnya, lalu memaksa penggunaannya meskipun ada opsi header, pemeriksaan header tambahan tidak perlu dilakukan. Jika tidak, kolom header harus diperiksa sesuai dengan panduan di atas. Untuk informasi selengkapnya, tinjau JSON Web Token Best Current Practices.

Apa pun library yang digunakan, kolom o, m, dan p harus divalidasi terhadap data dari pihak penjual. Jika tidak cocok, token harus ditolak agar pelanggan tidak dapat menyalin token ke produk dan/atau penjual lain. Penjual dapat memeriksa kolom exp dan menolak token jika masa berlaku token sudah berakhir, tetapi tindakan ini tidak wajib.

Pemakaian harga Jika semua kolom sudah valid dan masa berlaku token belum berakhir, penjual harus menggunakan harga yang tercantum di kolom p.

Anda dapat menggunakan fungsi kupon yang ada untuk memberi diskon pada harga jika memenuhi persyaratan yang tercantum di halaman ini. Khususnya, harga di halaman landing harus sesuai dengan harga di token. Menambahkan diskon di halaman checkout saja tidak cukup.

Pengujian Integrasi yang telah diselesaikan akan diuji dalam 3 langkah:

• Pengujian fungsional (dilakukan oleh penjual)
• Validasi kunci (dilakukan oleh penjual dengan token yang disediakan Google)
• Pengujian lengkap yang menyeluruh (dilakukan oleh Google)

Pengujian fungsional Cara termudah untuk melakukan pengujian selama dan setelah pengembangan adalah dengan membuat pasangan kunci sementara. Tindakan ini memberi Anda kontrol penuh atas token tersebut. Pasangan kunci yang valid dapat dibuat dengan perintah ini:

Token dapat dibuat dengan jwt.io atau alat serupa menggunakan algoritma ES256.

Validasi kunci Untuk memvalidasi bahwa kunci produksi dikonfigurasi dengan benar, token bertanda tangan tersedia di Merchant Center selama aktivasi (URL contoh).