Token atribusi

Halaman ini menjelaskan cara menggunakan token atribusi untuk meningkatkan performa dari waktu ke waktu.

Token atribusi adalah ID unik yang dihasilkan oleh Vertex AI Search untuk retail dan ditampilkan dengan setiap permintaan prediksi atau penelusuran. Solusi ini memungkinkan Vertex AI Search untuk retail mengaitkan tindakan dan hasil pengguna dengan satu sama lain, serta melatih model peringkat ulang untuk meningkatkan kualitas hasil.

Menyertakan token atribusi dalam peristiwa pengguna bersifat opsional. Jika Anda tidak menyediakan token atribusi, Vertex AI Search untuk retail memperkirakan token atribusi dengan menyelaraskan hasilnya dalam respons penelusuran atau prediksi serta peristiwa pengguna yang diserap berdasarkan ID pengunjung dan stempel waktu.

Cara kerja token atribusi

Setiap respons yang ditampilkan oleh metode predict atau search menyertakan attributionToken unik dalam isi responsnya. Contoh:

{
  "results": [{"id": "352"}, {"id": "456"}],
  "attribution_token": "abc123"
}

Saat situs Anda menampilkan produk berdasarkan hasil dari Vertex AI Search untuk retail, Anda harus menampilkan token atribusi dari hasil tersebut saat pengguna berinteraksi dengan produk yang ditampilkan (misalnya, tampilan, atau klik add-to-cart). Feedback loop ini memungkinkan Vertex AI Search untuk retail memberikan informasi tentang pengaruh hasil Anda terhadap bisnis Anda.

Cara menampilkan token atribusi

Tampilkan token atribusi dengan menyertakannya dalam peristiwa pengguna yang Anda rekam untuk tindakan apa pun yang dilakukan pengguna dengan produk dalam rekomendasi atau hasil penelusuran. Tindakan yang dapat dilakukan pengguna pada produk tersebut bergantung pada desain situs Anda; tindakan umum termasuk menambahkan produk ke daftar favorit, meminta tampilan mendetail, menambahkannya ke keranjang belanja, atau pembelian sekali klik.

Untuk menampilkan token atribusi, Anda harus mengaitkannya terlebih dahulu dengan produk seperti yang ditampilkan di panel rekomendasi atau hasil penelusuran di situs Anda. Cara umum untuk melakukannya adalah dengan menambahkannya ke semua URL yang terkait dengan tindakan yang dapat dilakukan di panel rekomendasi atau hasil penelusuran. Contoh:

https://www.example.com/54321/?rtoken=abc123

Saat pengguna berinteraksi dengan produk tersebut di panel rekomendasi atau hasil penelusuran (yang menghasilkan peristiwa pengguna), token atribusi dapat diurai dari link URL dan disisipkan ke dalam peristiwa pengguna yang Anda kirim ke Vertex AI Search untuk retail untuk interaksi tersebut.

Misalnya, Anda meminta prediksi yang terkait dengan menampilkan produk kepada pengguna. Vertex AI Search untuk retail menampilkan kumpulan ID katalog yang direkomendasikan, beserta token atribusi terkait.

{
  "results": [{"id": "352"}, {"id": "456"}],
  "attribution_token": "abc123"
}

Situs Anda menampilkan item yang direkomendasikan di panel rekomendasi, dan menyertakan token atribusi yang ditampilkan untuk prediksi tersebut dengan setiap URL di panel rekomendasi. Situs Anda harus dikonfigurasi untuk merekam peristiwa tersebut yang akan dikirim ke Vertex AI Search untuk retail. Untuk mengetahui contoh objek peristiwa pengguna, lihat peristiwa penelusuran pengguna. Jika pengguna mengklik salah satu produk dalam hasil untuk melihat tampilan yang lebih mendetail, Anda perlu menyertakan token atribusi dengan peristiwa pengguna yang Anda catat pada klik tersebut. Peristiwa pengguna akan terlihat mirip dengan contoh berikut:

{
  "eventType" : "detail-page-view",
  "visitorId": "visitor1",
  "userInfo": {
    "userId": "user1"
   },
   "attributionToken": "abc123",
   "productDetails": [{
     "product": {
        "id": "abc"
       }
     }]
}

Saat pengguna berinteraksi dengan produk yang ditampilkan karena rekomendasi atau hasil penelusuran, dan Anda menyertakan token atribusi dengan peristiwa pengguna untuk interaksi tersebut, Vertex AI Search untuk retail akan menggunakan informasi tersebut untuk evaluasi.

Misalnya, pengguna melihat produk di hasil penelusuran dan menggunakan hasilnya untuk menambahkan produk tersebut ke wishlist dan juga untuk mendapatkan tampilan mendetail produk tersebut. Anda harus menyertakan token atribusi untuk kedua peristiwa pengguna yang dihasilkan dari hasil penelusuran (add-to-cart dan detail-page-view).

Sekarang, anggaplah pengguna yang sama menambahkan produk tersebut ke keranjang dari tampilan detail. Anda tidak perlu menyertakan token atribusi bersama tindakan tersebut, karena token tersebut diambil dari tampilan detail, bukan hasil penelusuran. Demikian pula, jika pengguna tersebut akhirnya membeli produk, tetapi tidak langsung dari hasil penelusuran, tidak ada gunanya menampilkan token atribusi bersama peristiwa pembelian.