Token atribusi

Token atribusi adalah ID unik yang dihasilkan oleh Vertex AI Search untuk commerce dan ditampilkan dengan setiap permintaan penelusuran. Model ini memungkinkan Vertex AI Search untuk commerce mengaitkan permintaan penelusuran dengan peristiwa penelusuran yang cocok, yang memungkinkan model pemeringkatan ulang untuk meningkatkan kualitas respons penelusuran. Token atribusi juga diperlukan dalam peristiwa penelusuran Vertex AI Search for commerce untuk pelaporan yang akurat.

Cara kerja token atribusi

Anda mengumpulkan attributionToken dari respons API penelusuran pengguna. Token atribusi diperlukan dalam peristiwa tayangan penelusuran, tetapi tidak boleh dikirim untuk peristiwa lain, seperti klik, tambahkan ke keranjang, dan pembelian.

Perilaku token atribusi

Token atribusi adalah:

  • Khusus pengunjung: attributionToken dikaitkan dengan respons penelusuran tertentu yang ditayangkan ke `visitorId tertentu. Hanya peristiwa penelusuran itu sendiri yang perlu diberi tag dengan token. Semua peristiwa non-penelusuran berikutnya tidak akan diberi tag dengan token.

  • Dikaitkan dengan peristiwa yang langsung mengikuti penelusuran: attributionToken sangat penting untuk peristiwa pengguna yang mewakili interaksi langsung dengan hasil penelusuran dari penelusuran tertentu tersebut.

    Hal ini mencakup:

    • Peristiwa penelusuran berikutnya: Jika pengguna yang sama melakukan penelusuran lain tepat setelah penelusuran awal (seperti menyaring kueri), attributionToken dari respons penelusuran pertama idealnya harus disertakan dalam peristiwa pengguna untuk penelusuran kedua jika penelusuran kedua merupakan kelanjutan dari penelusuran pertama.

    • Peristiwa pembelian selesai: Pembelian masih ditautkan melalui ID produk dan visitorId.

  • Memfasilitasi pemetaan peristiwa dan permintaan penelusuran: Menyertakan attributionToken dalam peristiwa pengguna berikutnya sangat penting untuk memetakan perilaku pengguna secara akurat kembali ke permintaan penelusuran tertentu dan hasilnya yang ditayangkan oleh Vertex AI Search untuk commerce.

    Penautan ini memungkinkan Vertex AI Search memahami:

    • Kueri dan hasil penelusuran mana yang menghasilkan engagement pengguna (klik, penayangan, menambahkan ke keranjang, pembelian).
    • Relevansi dan efektivitas peringkat penelusuran.
    • Apakah akan membuat contoh positif dan negatif untuk melatih model peringkat atau tidak.
    • Cara menghitung metrik per penelusuran seperti Rasio Klik-Tayang (CTR), Rasio Konversi (CVR), dan Pendapatan per Penelusuran.
    • Cara mengatribusikan konversi ke penelusuran tertentu yang menghasilkan konversi tersebut, terutama dalam skenario pengujian A/B.

Token atribusi di Search API

Setiap respons yang ditampilkan metode Vertex AI Search untuk commerce menyertakan attributionToken unik di akhir isi respons penelusuran. Contoh:

{
  "results": [
    {
      "id": "727121",
      "product": {
…
     }
  ],
  "totalSize": 19600,
  "attributionToken": "dfB0CgwIgKrltAYQ8afX4AIQARokNjZjMGEwYjEtMDAwMC0yNjAyLTk0Y2UtNTgyNDI5Y2JkMzUwKgUxMjM0NTIkxcvzF6OAlyLo5KotmNa3LY6-nRW3t4wtwvCeFdSynRWb1rctOg5kZWZhdWx0X3NlYXJjaGgB",
  "nextPageToken": "AM1MDZiNWOyQjM4UTLlNGN50iMwYjMtADMwATLwIGMhBzY2YDJaIw-bCbxQYAt1PJgIwgExEgC"
…

Token ini harus disertakan dalam peristiwa penelusuran berikutnya:

{
"eventType": "search",
"searchQuery":"red t-shirt", 
"productDetails":[
  {"product":{"id":"727121"}}, {"product":{"id":  …
  }
] ,
"visitorId":"GA1.1.1383176924.1721324981",
"attributionToken":"dfB0CgwIgKrltAYQ8afX4AIQARokNjZjMGEwYjEtMDAwMC0yNjAyLTk0Y2UtNTgyNDI5Y2JkMzUwKgUxMjM0NTIkxcvzF6OAlyLo5KotmNa3LY6-nRW3t4wtwvCeFdSynRWb1rctOg5kZWZhdWx0X3NlYXJjaGgB"
}

Vertex AI Search untuk commerce menggunakan data peristiwa untuk melatih modelnya. Token atribusi menyediakan cara untuk menautkan peristiwa dengan permintaan, mengenkode permintaan dan respons penelusuran lengkap dengan filter, faset, dan ID produk respons yang diminta. Tanpa token yang ada di peristiwa penelusuran, peristiwa tersebut akan diperlakukan seolah-olah bukan berasal dari Google Vertex AI Search dan peristiwa penelusuran mungkin salah digunakan seolah-olah berasal dari penyedia penelusuran lain.

Tidak masalah (dan diharapkan) jika peristiwa penelusuran tidak memiliki token jika ditayangkan dari penyedia penelusuran lain, misalnya selama eksperimen A/B. Namun, biasanya ada pemetaan 1:1 untuk permintaan API penelusuran guna menelusuri peristiwa dengan token.

Efek samping token yang tidak ada

Jika attributionToken tidak ada dalam peristiwa pengguna berikutnya yang relevan dari pengunjung yang sama, Vertex AI Search untuk commerce akan memperlakukan peristiwa tersebut seolah-olah tidak berasal dari layanan penelusurannya.

Hal ini dapat menyebabkan:

  • Pelatihan model yang tidak akurat.
  • Metrik dan analisis performa salah.
  • Potensi masalah dalam mencapai tingkat performa yang lebih tinggi (seperti Tingkat 3) yang memerlukan peristiwa yang dapat diatribusikan yang memadai.
  • Error dilaporkan di Dasbor kualitas data di Penelusuran untuk Commerce jika persentase peristiwa dengan token atribusi kurang dari 95%.

Untuk mempelajari perilaku pengguna dan mengoptimalkan hasil penelusuran, Vertex AI Search untuk commerce memerlukan atribusi yang akurat hanya untuk peristiwa penelusuran awal.

Kualitas data token atribusi

Dasbor kualitas data di konsol Penelusuran untuk Commerce akan menampilkan Status error kepatuhan yang Kritis atau Memblokir jika persentase peristiwa dengan token atribusi kurang dari 95%. Jika tidak, Status akan ditampilkan sebagai Sesuai:

Teks alternatif

Kualitas data di Tingkat 3 yang merupakan model yang dioptimalkan untuk pendapatan biasanya tidak akan dilatih tanpa peristiwa yang dapat diatribusikan yang memadai. Sebaiknya jangan deploy Vertex AI Search untuk commerce ke dalam produksi kecuali jika menayangkan hasil di Tingkat 3 atau Tingkat 4. Untuk informasi selengkapnya, lihat bagian Kualitas data tentang cara membuka tingkat performa, lihat halaman Kualitas data dalam dokumentasi ini.

Token atribusi untuk rekomendasi

Karena tidak ada peristiwa pengguna tertentu untuk rekomendasi, jangan sertakan token atribusi dari respons predict dalam peristiwa apa pun. Dengan kata lain, jangan kirim token atribusi ke PredictResponse.attribution_token dalam peristiwa pengguna berikutnya yang dihasilkan dari rekomendasi (seperti detail-page-view atau add-to-cart).

Rekomendasi dari Vertex AI Search otomatis membuat token sintetis untuk peristiwa yang dapat diatribusikan ke permintaan predict.