Merekam peristiwa pengguna real-time

Halaman ini menjelaskan cara merekam peristiwa pengguna real-time. Vertex AI Search untuk commerce menggunakan peristiwa pengguna real-time untuk membuat rekomendasi dan hasil penelusuran. Mencatat sebanyak mungkin jenis peristiwa pengguna dengan informasi produk yang valid akan meningkatkan kualitas hasil Anda.

Prosedur perekaman di halaman ini berlaku untuk rekomendasi dan penelusuran. Setelah Anda merekam data, kedua layanan dapat menggunakan peristiwa tersebut, sehingga Anda tidak perlu mengupload data yang sama dua kali jika menggunakan kedua layanan.

Sebelum memulai

Sebelum merekam peristiwa pengguna, Anda harus:

  • Project Google Cloud dibuat, dengan penyiapan autentikasi.

  • Kunci API yang valid (untuk JavaScript Pixel atau Tag Manager), atau akun layanan yang valid dengan Peran Editor Retail yang ditetapkan jika menggunakan API untuk menulis secara langsung.

Komponen yang diperlukan

  • Token atribusi: Mengaktifkan metrik performa untuk peristiwa pengguna yang direkam guna merekam interaksi pengguna pertama kali dengan produk berdasarkan rekomendasi atau hasil penelusuran yang diberikan sebelumnya. Baca selengkapnya cara menyertakan token atribusi.

  • ID Pengunjung: Diperlukan saat merekam peristiwa pengguna. Untuk mengetahui informasi selengkapnya, lihat Tentang informasi pengguna.

Tips umum untuk merekam peristiwa pengguna

Praktik terbaik untuk merekam peristiwa pengguna

Vertex AI Search untuk commerce memerlukan data berkualitas tinggi untuk menghasilkan hasil berkualitas tinggi. Jika data Anda tidak lengkap atau salah, kualitas hasil Anda akan terpengaruh.

Saat merekam peristiwa pengguna, pastikan Anda menerapkan praktik terbaik berikut:

  • Jika Anda merekam peristiwa pengguna sebelum atau saat mengimpor katalog, bergabung kembali ke peristiwa yang direkam sebelum impor katalog selesai.

    Anda dapat mengimpor katalog sebelum, setelah, atau pada saat yang sama dengan saat Anda mencatat peristiwa pengguna. Melakukan tugas ini secara paralel dapat menghemat waktu jika katalognya besar dan ada banyak peristiwa pengguna. Setelah impor katalog selesai, Anda harus menggunakan API untuk bergabung kembali ke peristiwa yang diupload sebelum impor selesai.

    Vertex AI Search untuk e-commerce mencoba menggabungkan peristiwa pengguna yang direkam dengan metadata dari katalog produk saat peristiwa pengguna dibuat. Hanya peristiwa yang berhasil digabungkan yang digunakan untuk pelatihan, jadi pastikan untuk bergabung kembali ke peristiwa yang dicatat sebelum katalog diimpor sepenuhnya. Jika peristiwa merujuk ke item yang tidak ada dalam katalog, peristiwa tersebut akan dihapus atau tidak dikaitkan dengan produk yang benar. Demikian pula, jika Anda mengimpor peristiwa pengguna dari masa lalu, katalog harus menyertakan produk apa pun yang dirujuknya; Anda dapat menandai produk lama sebagai OUT_OF_STOCK daripada menghapusnya dari katalog.

  • Pastikan katalog Anda selalu aktual.

    Saat Anda merekam peristiwa pengguna, produk yang disertakan dalam peristiwa pengguna terhubung dengan katalog saat ini. Jika Anda merekam peristiwa untuk produk yang tidak ada dalam katalog saat ini, produk tersebut tidak dapat digunakan untuk melatih model Anda. Hal ini disebut peristiwa "tidak bergabung". Jika Anda mencatat peristiwa sebelum katalog diimpor sepenuhnya, Anda harus menggabungkan kembali peristiwa yang dicatat selama impor. Beberapa peristiwa yang tidak digabungkan adalah hal yang wajar. Namun, jika persentase peristiwa yang tidak tergabung mencapai 5% atau lebih dari total peristiwa pengguna, pastikan katalog Anda sudah terbaru, gabungkan kembali peristiwa yang direkam sebelum katalog diperbarui sepenuhnya, dan selidiki alasan peristiwa yang tidak tergabung dibuat.

    Anda dapat melihat peristiwa yang tidak digabungkan menggunakan pemfilteran peristiwa. Pelajari lebih lanjut.

  • Berikan informasi sebanyak mungkin dengan peristiwa pengguna Anda.

    Setiap jenis peristiwa pengguna memiliki informasi yang berbeda yang diperlukan dan diterima. Untuk mengetahui informasi selengkapnya, lihat Tentang peristiwa pengguna.

  • Siapkan pemberitahuan Cloud Monitoring agar Anda mengetahui apakah proses perekaman peristiwa pengguna mengalami gangguan.

  • Untuk impor peristiwa pengguna massal, batasi ukuran data yang Anda impor.

    Impor peristiwa pengguna massal dapat memerlukan waktu hingga 24 jam untuk diselesaikan.

    Ukuran setiap file harus 2 GB atau lebih kecil. Anda dapat menyertakan paling banyak 100 file dalam satu permintaan impor. Salah satu pendekatan adalah mengimpor peristiwa pengguna saja per hari sekaligus.

  • Setelah impor massal, tinjau pelaporan error untuk memastikan data Anda diimpor dengan benar.

  • Saat mengimpor data peristiwa pengguna, sertakan stempel waktu yang akurat untuk setiap peristiwa pengguna dan hindari mengimpor peristiwa pengguna berurutan dengan stempel waktu yang identik.

    Berikan stempel waktu di kolom eventTime dalam format yang ditentukan oleh RFC 3339.

  • Jika Anda telah mengimpor peristiwa pengguna yang salah, hubungi kontak Vertex AI Search for Commerce Anda untuk mengetahui cara memperbaiki masalah tersebut.

  • Jika memungkinkan, pastikan data peristiwa pengguna Anda berkelanjutan.

    Kesenjangan dalam data peristiwa pengguna dapat mengurangi kualitas model.

  • Gunakan bentuk ID unik yang aman untuk menjaga anonimitas pengguna terhadap Vertex AI Search untuk e-commerce dan melindungi privasi pengguna Anda. Anda bertanggung jawab untuk menyamarkan PII (informasi identitas pribadi), seperti alamat email atau rumah, dari data Anda.

Tutorial menulis peristiwa pengguna

Tutorial ini menunjukkan cara merekam peristiwa pengguna menggunakan metode userEvents.write.

Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Cloud Shell Editor, klik Pandu saya:

Pandu saya

Cara melakukan streaming peristiwa pengguna

Anda dapat merekam peristiwa pengguna dengan beberapa cara:

Merekam peristiwa pengguna dengan piksel JavaScript

Contoh berikut mencatat detail-page-view UserEvent menggunakan piksel JavaScript.

<script type="text/javascript">
var user_event = {
  "eventType" : "detail-page-view",
  "visitorId": "visitor-id",
  "userInfo": {
      "userId": "user-id"
  },
  "experimentIds": "experiment-id",
  "productDetails": [
      {
        "product": {"id": "123"}
      }
  ]
};

var _gre = _gre || [];
// Credentials for project.
_gre.push(['apiKey', 'api-key']);
_gre.push(['logEvent', user_event]);
_gre.push(['projectId', 'project-id']);
_gre.push(['locationId', 'global']);
_gre.push(['catalogId', 'default_catalog']);

(function() {
  var gre = document.createElement('script'); gre.type = 'text/javascript'; gre.async = true;
  gre.src = 'https://www.gstatic.com/retail/v2_event.js';
  var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(gre, s);
})();

</script>

Jika Anda mengimpor peristiwa pengguna dengan Google Analytics 360, tetapkan visitorID ke ID klien Google Analytics. Perhatikan bahwa ID klien Google Analytics hanya merupakan bagian dari nama cookie _ga lengkap (misalnya, ID klien 123456789.123456789 adalah bagian dari cookie _ga GA1.3.123456789.123456789).

Berikut adalah contoh singkat yang menunjukkan format untuk menyetel ID klien dalam peristiwa pengguna. Ganti "G-XXXXXX" dengan ID pelacakan Google Analytics Anda.

<script type="text/javascript">
var tracker = ga.getByName('G-XXXXXX');
var user_event = {
      "visitorId": tracker.get('clientId')
};
</script>

Merekam peristiwa pengguna dengan metode userEvents.write

Anda dapat menggunakan metode userEvents.write untuk mengirim peristiwa pengguna langsung ke API dari server backend Anda.

Untuk merekam peristiwa pengguna, kirim permintaan POST ke metode userEvents.write dan berikan isi permintaan yang sesuai.

curl

export GOOGLE_APPLICATION_CREDENTIALS=/tmp/my-key.json
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data "{
         'eventType': 'detail-page-view',
         'visitorId': 'visitor0',
         'eventTime': '2020-01-01T03:33:33.000001Z',
         'experimentIds': ['321'],
         'attributionToken': 'ABC',
         'attributes': {
            'example_text_attribute': {
              'text': ['text_1', 'text_2']
            },
            'example_number_attribute': {
               'numbers': [3.14, 42, 1.2345]
            }
         },
         'productDetails': [{
           'product': {
             'id': 'abc'
           }
          }],
         'userInfo': {
           'userId': 'abc',
           'ipAddress': '8.8.8.8',
           'userAgent': 'Mozilla/5.0',
           'directUserRequest': true
         },
         'uri': 'http://example',
         'referrerUri': 'http://example',
         'pageViewId': 'currentPageUri'
}" \
"https://retail.googleapis.com/v2/projects/PROJECT_ID/locations/global/catalogs/default_catalog/userEvents:write"

Java

public static UserEvent writeUserEvents(UserEvent eventToWrite)
    throws IOException, InterruptedException {
  UserEventServiceClient userEventsClient = getUserEventServiceClient();

  WriteUserEventRequest request = WriteUserEventRequest.newBuilder()
      .setParent(DEFAULT_CATALOG_NAME)
      .setUserEvent(eventToWrite)
      .build();

  UserEvent writtenUserEvent = userEventsClient.writeUserEvent(request);

  userEventsClient.shutdownNow();
  userEventsClient.awaitTermination(2, TimeUnit.SECONDS);

  return writtenUserEvent;
}

Mencatat peristiwa pengguna dengan Google Analytics 4

Anda dapat merekam data peristiwa pengguna Google Analytics 4 ke Vertex AI Search untuk e-commerce.

Periksa sumber data Anda

Pastikan data peristiwa pengguna yang ingin Anda impor diformat dengan benar.

Untuk melihat tabel kolom Google Analytics 4 yang digunakan Vertex AI Search for Commerce dan kolom Vertex AI Search for Commerce yang dipetakan, lihat Kolom peristiwa pengguna Google Analytics 4.

Untuk semua parameter peristiwa Google Analytics, lihat dokumentasi referensi Peristiwa Google Analytics.

Pastikan bahwa:

  1. Jika Anda mengimpor peristiwa pembelian, yang diperlukan oleh beberapa model Vertex AI Search untuk e-commerce, pelaporan peristiwa Anda akan menyertakan kode mata uang. Lihat parameter peristiwa purchase di dokumentasi Google Analytics.

  2. Jika Anda berencana mengimpor peristiwa search, pelaporan peristiwa Anda akan mencakup kueri penelusuran.

    Impor peristiwa search didukung, tetapi peristiwa search tidak dipetakan dari Google Analytics 4 dengan cara yang sama seperti jenis peristiwa lainnya karena Google Analytics 4 tidak mendukung jenis peristiwa search Vertex AI Search for Commerce secara native. Selama impor, search peristiwa dibuat dari Google Analytics 4 dengan menggabungkan informasi dari parameter peristiwa view_item_list dan search_term.

    Lihat parameter peristiwa search di dokumentasi Google Analytics.

Mencatat peristiwa Google Analytics 4

Mencatat peristiwa pengguna dengan menyertakan data JSON mentah yang dienkode URL untuk peristiwa dalam panggilan ke metode userEvents.collect.

Untuk parameter prebuilt_rule, gunakan nilai ga4_bq.

Agar mudah dibaca, contoh berikut tentang penggunaan panggilan userEvents.collect terlebih dahulu menetapkan GA4_EVENT sebagai variabel yang berisi data JSON mentah untuk contoh peristiwa. Panggilan userEvents.collect dalam contoh kemudian mengenkode data peristiwa menggunakan variabel GA4_EVENT.

  1. Untuk mempermudah encoding URL nanti, Anda dapat menetapkan GA4_EVENT sebagai variabel yang berisi data peristiwa. Contoh ini menunjukkan peristiwa add-to-cart.

    GA4_EVENT='{
  "event_timestamp": 1622994083878241,
  "event_name": "add_to_cart",
  "user_pseudo_id": "352499268.1622993559",
  "items": [
    {
      "item_id": "11",
      "price": 29.99,
      "quantity": 3
    }
  ],
  "event_params": [
    {
      "key": "currency",
      "value": {
        "string_value": "CAD"
      }
    }
  ],
  "user_id": "Alice"
}'

  2. Lakukan panggilan userEvents.collect yang menyertakan data JSON mentah berenkode URL dari peristiwa pengguna:

    curl \
-G \
--data-urlencode "raw_json=${GA4_EVENT}" \
-i \
"https://retail.googleapis.com/v2/projects/PROJECT_ID/locations/global/catalogs/default_catalog/userEvents:collect?key=EXAMPLEKEY1&prebuilt_rule=ga4_bq'"

Merekam peristiwa pengguna dengan Google Tag Manager

Tag Manager menyediakan cara untuk mengelola dan menguji beberapa tag tanpa banyak perubahan kode sisi server pada situs Anda.

Beberapa keputusan yang Anda buat selama penyiapan bergantung pada apakah Anda menggunakan Google Analytics dan E-commerce Google Analytics. E-commerce Google Analytics dapat diterapkan menggunakan Google Analytics 4 atau Enhanced E-commerce. Tag Cloud Retail mendukung keduanya.

Google Analytics maupun Google Analytics E-commerce tidak diperlukan; jika Anda tidak menggunakannya, Anda dapat mengonfigurasi Variable - Ecommerce (untuk menggunakan skema e-commerce GA4) atau Variable - Cloud Retail (untuk menggunakan skema Vertex AI Search for Commerce) saat membuat tag Cloud Retail, dan mengisi kode lapisan data situs Anda secara manual setelah membuat tag.

E-commerce Google Analytics adalah konfigurasi tambahan untuk Google Analytics yang meneruskan judul produk, ID, harga, detail transaksi, dan data e-commerce terstruktur lainnya ke Google Analytics. Vertex AI Search untuk e-commerce dapat otomatis menggunakan lapisan data E-commerce Google Analytics, sehingga jika Anda sudah menyiapkannya, konfigurasi dapat menjadi lebih mudah. Jika Anda belum mengonfigurasi E-commerce Google Analytics untuk Google Analytics, tetapi ingin menggunakannya, lihat detail selengkapnya dan petunjuk penyiapan di panduan developer GA4.

Gunakan prosedur sekali ini untuk menyiapkan tag Cloud Retail di Tag Manager guna merekam peristiwa pengguna.

Membuat variabel ID pengunjung

Nilai visitorId adalah untuk melacak pengguna. visitorId biasanya berupa ID sesi dan diperlukan untuk semua peristiwa. Siapkan variabel yang menetapkan ID sesi sebagai visitorId.

Jika menggunakan Google Analytics, Anda dapat menggunakan ID pengunjung Google Analytics. Untuk mengonfigurasi ini, gunakan prosedur berikut untuk mengganti nilai ID pengunjung untuk tag Cloud Retail. Ini memetakan cookie pihak pertama "_ga" ke variabel Tag Manager yang disebut "GA visitorId". Anda dapat melakukan hal yang sama untuk cookie ID sesi apa pun; cookie tersebut tidak harus berasal dari Google Analytics.

Prosedur ini mengasumsikan bahwa Anda menggunakan Google Analytics. Jika tidak, Anda dapat menggunakan cookie atau variabel lain, atau mendapatkan ID pengunjung dari lapisan data cloud_retail.

Untuk menyetel nilai visitorID ke variabel untuk tag Cloud Retail:

  1. Di Tag Manager, buka tab Variabel, lalu klik Baru untuk membuat variabel buatan pengguna baru.

  2. Beri nama variabel di bagian atas dialog, seperti "GA visitorId".

  3. Masukkan setelan variabel Anda.

    Anda dapat menggunakan ID klien atau ID cookie untuk ditetapkan sebagai sumber ID pengunjung. Selalu gunakan sumber ID pengunjung yang konsisten saat memproses peristiwa pengguna historis dan real-time.

    ID Klien

    Di Google Analytics 4, variabel ini dipetakan ke kolom user_pseudo_id dalam skema BigQuery Export Google Analytics 4.

    1. Tetapkan Jenis Variabel ke JavaScript Kustom.

    2. Masukkan skrip berikut di kolom JavaScript Kustom.

      Ganti "G-XXXXXX" dengan ID pelacakan Google Analytics Anda. Untuk menemukan ID pelacakan Anda, lihat Apa yang terjadi dengan ID Pelacakan saya?.

      function() {
 var tracker = ga.getByName('G-XXXXXX');
 return tracker.get('clientID');
}

    3. Klik Simpan untuk menyimpan variabel.

    1. Pilih Cookie Pihak Pertama sebagai jenis variabel.

    2. Di kolom Cookie Name, masukkan _ga.

    3. Klik Format Nilai, pilih Konversi tidak ditentukan ke.., lalu masukkan "" (string kosong).

    4. Klik Simpan untuk menyimpan variabel.

      Tindakan ini memetakan cookie pihak pertama "_ga" ke variabel Pengelola Tag yang disebut "GA visitorId".

Selanjutnya, buat tag Cloud Retail di Tag Manager. Tag ini akan menggunakan variabel ID pengunjung yang baru saja Anda buat.

Membuat tag Google Tag Manager

Siapkan tag di Tag Manager untuk mengirim informasi peristiwa pengguna ke Vertex AI Search untuk commerce.

  1. Login ke Tag Manager dan pilih penampung untuk situs Anda.

  2. Buka tab Tag, lalu klik Baru untuk menambahkan tag baru.

  3. Beri nama tag Anda di bagian atas panel (placeholder-nya adalah Untitled Variable), seperti "Vertex AI Search untuk commerce".

  4. Klik Konfigurasi Tag, lalu pilih tag Cloud Retail untuk membuka panel konfigurasi tag.

  5. Masukkan kunci API Anda.

    Gunakan kunci yang Anda buat saat menyiapkan Vertex AI Search untuk commerce.

    Kunci API Anda tersedia dari halaman APIs & Services > Credentials di konsol Google Cloud .

  6. Masukkan nomor project Google Cloud tempat Vertex AI Search untuk commerce diaktifkan.

    Nomor project tersedia dari dasbor konsol Google Cloud .

  7. Untuk kolom Sumber Data Peristiwa Pengguna:

    • Lapisan Data (direkomendasikan): Pilih jika implementasi Anda akan menjadi salah satu dari berikut:

      • Anda telah menerapkan E-commerce Google Analytics melalui Tag Manager. Gunakan kembali lapisan data sebagai sumber data peristiwa daripada mengisi yang baru. Ini menggunakan skema Google Analytics 4 jika ada. Jika tidak, opsi ini menggunakan Enhanced E-commerce UA. Dengan sumber data ini, Anda hanya dapat merekam peristiwa add-to-cart, purchase-complete, detail-page-view, dan search. Peristiwa search direkam menggunakan tayangan iklan e-commerce yang digabungkan dengan kueri penelusuran (lihat Membuat variabel kueri penelusuran).

      • Anda menggunakan E-commerce Google Analytics, dan dapat mengisi kode lapisan data secara manual. Lihat Panduan Developer Tag Manager.

    • Variabel, Cloud Retail: Pilih untuk mengisi variabel Tag Manager dengan kolom yang diperlukan untuk Vertex AI Search untuk commerce. Anda dapat memilih opsi ini jika tidak menggunakan E-commerce Google Analytics, atau jika E-commerce Google Analytics tidak memiliki data yang diperlukan untuk Vertex AI Search for Commerce. Jika Anda beralih ke sumber ini dari opsi Lapisan Data - Cloud Retail lama, buat juga Variabel Lapisan Data dengan kunci cloud_retail dan kaitkan dengan opsi Variabel - Cloud Retail ini.

    • Variabel, E-commerce: Pilih jika Anda tidak menggunakan E-commerce Google Analytics di lapisan data, dan tidak dapat mengisi kode lapisan data secara manual, tetapi tetap ingin menggunakan skema E-commerce Google Analytics. Hal ini juga berguna jika Anda telah menerapkan E-commerce Google Analytics, tetapi ingin menambah atau mengubah nilai di dataLayer. Kemudian, Anda dapat menggabungkan nilai tersebut ke dalam variabel kustom dalam format skema E-commerce Google Analytics yang dapat digunakan oleh tag Cloud Retail.

      Di kolom Baca Data E-commerce dari Variabel Pengguna yang muncul, pilih variabel. Hal ini memungkinkan Vertex AI Search untuk commerce membaca data peristiwa pengguna E-commerce Google Analytics dari variabel kustom yang Anda buat.

      Variabel harus sesuai dengan format yang didokumentasikan dalam Panduan Developer GA4. Untuk membuat variabel dalam format yang benar, Anda dapat menggunakan Pembuat Objek E-commerce yang Disempurnakan, template variabel kustom dari galeri template komunitas Tag Manager. Template komunitas tidak dikelola oleh Google. Untuk menggunakan template ini, lihat halaman galeri Pembuat Objek Enhanced E-commerce untuk mengetahui dokumentasi dan referensi lainnya.

  8. Klik tombol + Timpa nilai pada pesan UserEvent.

  9. Untuk Pemilih Kolom, pilih visitorId sebagai kolom, dan untuk Nilai Kolom, pilih variabel ID pengunjung baru yang Anda buat di Buat variabel ID pengunjung.

  10. Klik Simpan.

    Tag Cloud Retail Anda telah dibuat.

Opsi sumber data lama

Sebelumnya, Lapisan Data - E-commerce dan Lapisan Data - Retail Cloud tersedia sebagai opsi sumber data. Opsi lama ini tidak tersedia di tag baru. Jika Anda mengalihkan tag yang ada ke sumber data baru, pratinjau dengan Pengelola Tag untuk memverifikasinya sebelum di-deploy. Saat beralih:

  • Jika menggunakan Lapisan Data - E-commerce, Anda dapat beralih ke Lapisan Data. Ini menggunakan skema Google Analytics 4 jika ada. Jika tidak, opsi ini menggunakan Enhanced E-commerce UA.

  • Jika Anda menggunakan Lapisan Data - Retail Cloud, beralihlah ke opsi Variabel - Retail Cloud. Buat Variabel Lapisan Data dengan kunci cloud_retail dan kaitkan dengan opsi Variabel - Cloud Retail.

Berikutnya:

Membuat variabel kueri penelusuran

Jika menggunakan penelusuran, Anda dapat membuat variabel di Tag Manager untuk kueri penelusuran dan melampirkannya ke tag Cloud Retail. Dengan demikian, Vertex AI Search untuk commerce dapat menerima kueri penelusuran dari Analytics.

Jenis variabel yang Anda buat bergantung pada sumber data peristiwa pengguna.

  • Variabel - E-commerce, atau lapisan data dengan skema E-commerce Google Analytics: Buat variabel URL atau elemen DOM di Tag Manager dan lampirkan ke tag Cloud Retail Anda. Selain itu, aktifkan opsi agar tag Anda menggunakan tayangan iklan E-commerce Google Analytics untuk membuat peristiwa penelusuran.
  • Variabel - Cloud Retail, atau lapisan data yang diisi secara manual: Buat variabel URL atau elemen DOM di Tag Manager dan lampirkan ke tag Cloud Retail Anda. Untuk menentukan apakah jenis peristiwa pengguna adalah search, Anda juga harus:
    • Buat variabel jenis konstanta untuk jenis peristiwa penelusuran dan lampirkan ke tag Anda.
    • Tetapkan jenis peristiwa penelusuran di lapisan data atau variabel Retail Cloud.

Membuat dan melampirkan variabel Tag Manager untuk kueri penelusuran

Jika menggunakan penelusuran, Anda dapat membuat variabel URL, elemen DOM, atau JavaScript kustom yang akan diisi dengan kueri penelusuran yang dimasukkan di situs Anda.

Sebagai alternatif untuk prosedur ini, Anda dapat mengonfigurasi lapisan data untuk memberikan informasi kueri penelusuran. Namun, Anda dapat memilih untuk menggunakan variabel Tag Manager jika Anda tidak memiliki akses ke lapisan data, atau lebih memilih untuk tidak mengonfigurasi lapisan data.

Anda dapat membuat variabel jenis URL, variabel jenis elemen DOM, atau variabel JavaScript kustom (halaman). Tag mana yang Anda buat dan cara mengonfigurasinya, bergantung pada penerapan situs Anda:

  • Variabel URL mendapatkan kueri penelusuran dari URL hasil penelusuran situs Anda. Gunakan variabel ini jika situs Anda menyertakan string kueri di URL hasil penelusurannya.
  • Variabel elemen DOM mendapatkan informasi kueri penelusuran dari Document Object Model (DOM) situs Anda. Anda tidak perlu mengedit DOM untuk menggunakan variabel ini. Namun, Anda harus dapat membaca dan memahami DOM untuk mengonfigurasi variabel ini dengan benar.
  • Variabel JavaScript Kustom menampilkan data yang diformat oleh fungsi JavaScript. Hal ini berguna jika Anda memiliki data yang ingin diformat dalam skema Cloud Retail atau E-commerce.

Pertama, buat variabel Tag Manager berjenis URL, elemen DOM, atau JavaScript Kustom:

  1. Di Tag Manager, buka tab Variabel, lalu klik Baru untuk membuat variabel buatan pengguna baru.

  2. Beri nama variabel di bagian atas dialog, seperti "search_variable".

  3. Masukkan setelan variabel Anda:

    Jenis URL

    1. Tetapkan Jenis Variabel ke URL.

    2. Tetapkan Component Type ke Query.

    3. Jika Anda menentukan kunci kueri, tetapkan ke kunci yang mendahului kueri penelusuran di URL Anda.

      Misalnya, jika URL-nya adalah http://example.com/?q=shoes, kunci kuerinya adalah q. Dalam contoh ini, nilai variabel akan ditetapkan ke shoes.

    Jenis elemen DOM

    1. Tetapkan Jenis Variabel ke Elemen DOM.

    2. Tetapkan Metode Pemilihan dan masukkan ID elemen atau pemilih elemen kueri penelusuran.

      Setelan ini bergantung pada apakah situs Anda menggunakan ID elemen atau pemilih CSS untuk mengidentifikasi kueri penelusuran.

    3. Jika Anda menentukan atribut, tetapkan ke atribut yang berisi istilah kueri penelusuran.

      Misalnya, jika kueri penelusuran di DOM Anda adalah <id="search" value="shoes">, atributnya adalah value. Dalam contoh ini, nilai variabel Anda akan ditetapkan ke shoes.

    Jenis JavaScript kustom

    1. Tetapkan Jenis Variabel ke JavaScript Kustom.

    2. Ganti variabel dalam kode berikut dan tempelkan ke panel JavaScript Kustom.

    3. Di panel JavaScript Kustom, tambahkan kode JavaScript yang menampilkan peristiwa penelusuran di Skema Retail.

      Kode contoh berikut mengubah data dalam variabel Ecommerce Items yang ada menjadi array productDetails yang digunakan oleh skema Vertex AI Search untuk commerce dan menampilkan peristiwa lengkap. Untuk menggunakan kode ini, ganti Ecommerce Items, Search Query, dan Search Filter dengan variabel dalam penerapan Tag Manager Anda.

      function () {

  var retail;
  var items = [];

  for (var i = 0; i < {{Ecommerce Items}}.length; i++) {
    var item = {'product':
                {
                  'id': {{Ecommerce Items}}[i].item_id
                }
               };

    items.push(item);
  }

  retail = {
    'eventType': 'search',
    'searchQuery': '{{Search Query}}',
    'filter': '{{Search Filter}}',
    'productDetails': items
  }

  return retail;
}

  4. Klik Simpan untuk menyimpan variabel.

Selanjutnya, lampirkan variabel ke tag Cloud Retail Anda:

  1. Di halaman Tag Manager, Tag, klik tag Cloud Retail Anda untuk mengeditnya.

  2. Jika sumber data peristiwa pengguna tag Anda adalah Variabel - E-commerce atau Anda menggunakan lapisan data dengan skema E-commerce Google Analytics, centang kotak Gunakan tayangan iklan e-commerce yang disempurnakan untuk membuat peristiwa penelusuran.

    Hal ini memungkinkan Vertex AI Search untuk commerce menentukan apakah jenis peristiwa pengguna adalah search berdasarkan data penelusuran yang didapat dari tag ini.

  3. Di bagian Data Peristiwa Pengguna, klik tombol + Timpa nilai pada pesan UserEvent.

  4. Pilih searchQuery dari Pemilih Kolom dan tetapkan variabel kueri penelusuran Anda sebagai Nilai Kolom.

  5. Simpan tag Anda.

Berikutnya:

Membuat dan melampirkan variabel konstanta

Anda dapat menggunakan prosedur ini jika memilih Variabel - Cloud Retail atau lapisan data yang diisi secara manual sebagai sumber peristiwa pengguna untuk tag Cloud Retail.

Membuat variabel jenis konstanta untuk peristiwa penelusuran dan menyetelnya sebagai penggantian peristiwa pengguna di tag Cloud Retail memungkinkan Vertex AI Search untuk commerce menentukan apakah jenis peristiwa pengguna adalah search.

Sebagai alternatif untuk prosedur ini, Anda dapat menentukan jenis peristiwa pengguna search menggunakan lapisan data atau variabel Cloud Retail yang berfungsi sebagai sumber peristiwa tag Anda. Jika tidak, gunakan langkah-langkah berikut untuk menyetel jenis acara.

Pertama, buat variabel jenis konstanta:

  1. Di Tag Manager, buka tab Variabel, lalu klik Baru untuk membuat variabel buatan pengguna baru.

  2. Beri nama variabel di bagian atas dialog, seperti "search_constant".

  3. Tetapkan Jenis Variabel ke Konstan.

  4. Masukkan search di kolom Nilai

  5. Klik Simpan untuk menyimpan variabel.

Selanjutnya, lampirkan variabel ke tag Cloud Retail Anda:

  1. Di halaman Tag Manager, Tag, klik tag Cloud Retail Anda untuk mengeditnya.

  2. Di bagian Data Peristiwa Pengguna, klik tombol + Timpa nilai pada pesan UserEvent.

  3. Pilih eventType dari Pemilih Kolom dan tetapkan variabel kueri penelusuran Anda sebagai Nilai Kolom.

  4. Simpan tag Anda.

Selanjutnya, buat pemicu peristiwa untuk tag Anda.

Membuat pemicu peristiwa untuk tag Tag Manager

Buat pemicu untuk semua jenis peristiwa pengguna yang akan digunakan oleh model Vertex AI Search untuk commerce.

Tag Tag Manager harus memiliki pemicu yang mengontrol kapan tag harus "diaktifkan" di situs. Pemicu memproses saat peristiwa terjadi (seperti pengguna melihat halaman beranda atau menambahkan item ke keranjang) dan meminta tag Anda untuk mengirimkan informasi peristiwa pengguna tersebut ke Vertex AI Search untuk e-commerce.

Tag Manager menyediakan beberapa pemicu standar. Misalnya, Window Loaded adalah pemicu untuk peristiwa detail-page-view. Untuk mengetahui detail tentang setiap jenis, lihat Jenis pemicu dalam dokumentasi Tag Manager.

Biasanya, Anda akan menyetel tag untuk dipicu saat pengguna melihat halaman yang memiliki peristiwa yang diperlukan untuk Vertex AI Search untuk commerce (seperti halaman beranda, halaman detail produk, halaman keranjang, atau halaman checkout selesai). Dalam kasus ini, tag harus diaktifkan setelah halaman dimuat, sehingga cookie tersedia dan semua variabel lapisan data terisi. Untuk melakukannya, tetapkan pemicu agar diaktifkan pada Window Loaded atau DOM Ready.

Anda mungkin perlu mengaktifkan tag saat tindakan dilakukan, bukan saat halaman dimuat (misalnya, jika pengguna menambahkan item ke keranjang tidak memaksa halaman dimuat ulang). Dalam kasus ini, Anda dapat mengonfigurasi tindakan klik tersebut di situs Anda untuk secara bersamaan mengirimkan update ke lapisan data dan mengaitkan pemicu dengan tindakan tersebut.

Misalnya, jika Anda membuat pemicu untuk peristiwa add-to-cart, Anda dapat memilih jenis pemicu ke Klik - Hanya Link dan menyetelnya agar diaktifkan pada ID klik (dalam contoh ini, addtocart). Kemudian, Anda akan mengonfigurasi link addtocart di situs Anda agar juga memperbarui lapisan data dengan nilai baru saat diklik:

  <a id="addtocart" href="javascript:void(0);"
         onclick="dataLayer.push({
                  'cloud_retail': {
                  'eventType': 'add-to-cart',
                  'visitorId': '456',
                  'cartId': 'mobile',
                  'productDetails': [{
                  'product': {
                  'id': '54321'
                  },
                  'quantity': 1
                  }]}});">Add to Cart</a>

Untuk beberapa peristiwa pengguna, Anda harus membuat pemicu kustom. Biasanya, Anda membuat pemicu kustom di Tag Manager menggunakan nama peristiwa pengguna. Jika tidak dapat mengubah kode frontend, Anda dapat membuat pemicu kustom menggunakan makro JavaScript. Untuk mengetahui informasi selengkapnya tentang pemicu kustom, lihat Pemicu peristiwa kustom.

Gunakan prosedur berikut untuk membuat pemicu di Tag Manager:

Membuat pemicu baru untuk tag Tag Manager

Jika Anda tidak menggunakan E-commerce Google Analytics, buat pemicu peristiwa baru untuk peristiwa pengguna yang diperlukan oleh model Vertex AI Search untuk commerce Anda. Kemudian, kaitkan pemicu baru dengan tag Cloud Retail yang Anda buat di Tag Manager.

Sebelum memulai langkah-langkah berikut, pastikan Anda telah membuat tag Cloud Retail di Tag Manager. Lihat Membuat tag Tag Manager.

Pertama, buat pemicu. Ulangi prosedur ini untuk semua peristiwa pengguna yang diperlukan oleh model Vertex AI Search for Commerce Anda:

  1. Di halaman Tag Manager, Pemicu, klik Baru > Konfigurasi Pemicu.

  2. Pilih jenis pemicu yang berlaku untuk peristiwa pengguna yang Anda buat pemicunya.

  3. Simpan pemicu Anda.

Selanjutnya, kaitkan pemicu baru dengan tag Cloud Retail Anda. Prosedur ini hanya perlu dilakukan satu kali:

  1. Di halaman Tag Manager, Tag, klik tag Cloud Retail Anda untuk mengeditnya.

  2. Klik Pemicuan, pilih pemicu baru, lalu klik Tambahkan.

  3. Simpan tag Anda.

Selanjutnya, pratinjau tag Anda, dan siapkan pemantauan error perekaman peristiwa dan masalah lainnya untuk memastikan data terus diterima dengan berhasil.

Jika Anda menggunakan lapisan data cloud_retail sebagai sumber peristiwa pengguna, pastikan Anda juga menyiapkan lapisan data.

Menggunakan kembali pemicu E-commerce Google Analytics

Jika Anda telah menerapkan E-commerce Google Analytics menggunakan Tag Manager, gunakan kembali pemicu peristiwa dari E-commerce Google Analytics untuk Vertex AI Search for Commerce.

Dengan sumber data ini, Anda hanya dapat merekam peristiwa add-to-cart, purchase-complete, detail-page-view, dan search. Peristiwa search direkam menggunakan tayangan iklan e-commerce yang digabungkan dengan kueri penelusuran (lihat Membuat variabel kueri penelusuran).

Tabel berikut menunjukkan cara pemetaan peristiwa E-commerce dan E-commerce yang Disempurnakan Google Analytics ke peristiwa Vertex AI Search untuk commerce.

Google Analytics 4 Enhanced E-commerce Vertex AI Search untuk commerce
add_to_cart add add-to-cart
purchase purchase purchase-complete
view_item detail detail-page-view
view_item_list atau view_search_results impressions search (jika digabungkan dengan kolom searchQuery)

Sebelum memulai langkah-langkah ini, pastikan Anda telah:

  • Siapkan tag di Tag Manager dengan jenis tag Google Analytics - Peristiwa GA4, dan aktifkan E-commerce yang Disempurnakan atau GA4 di tag tersebut. Lihat dokumentasi Tag Manager, dan Panduan Developer GA4 untuk mengetahui detailnya.
  • Mengonfigurasi tag Enhanced E-commerce atau GA4 di Tag Manager untuk dipicu pada peristiwa pengguna yang ingin Anda catat untuk Vertex AI Search untuk commerce.
  • Membuat tag Cloud Retail di Tag Manager, dengan 'Lapisan Data' atau 'Variabel - E-commerce' sebagai sumber data peristiwa pengguna (lihat Membuat tag Tag Manager.

Untuk menggunakan kembali pemicu E-commerce Google Analytics:

  1. Di halaman Tag Manager, Tag, klik tag E-commerce Google Analytics Anda (jenis Google Analytics - Peristiwa GA4) untuk mengeditnya.

  2. Di bagian Setelan Lanjutan > Pengurutan Tag, pilih Aktifkan tag setelah <Nama tag E-commerce yang Disempurnakan atau GA4> diaktifkan.

  3. Pilih tag Cloud Retail Anda sebagai Tag Pembersihan.

    Pilih Jangan aktifkan <nama tag Cloud Retail> jika <nama tag Enhanced Ecommerce atau GA4> gagal atau dijeda.

  4. Simpan tag Anda.

Selanjutnya, pratinjau tag Anda, dan siapkan pemantauan error perekaman peristiwa dan masalah lainnya untuk memastikan data terus diterima dengan berhasil.

Jika Anda menggunakan lapisan data cloud_retail sebagai sumber peristiwa pengguna, pastikan Anda juga menyiapkan lapisan data.

Menggunakan lapisan data cloud_retail dengan Tag Manager

Jika Anda membuat tag Cloud Retail di Tag Manager untuk menggunakan lapisan data cloud_retail sebagai sumber peristiwa pengguna, siapkan variabel dataLayer di HTML sumber seperti yang dijelaskan dalam Panduan Developer Tag Manager.

Tentang lapisan data

Sebagian besar tag Tag Manager memerlukan data yang berubah bergantung pada pengguna atau halaman (seperti ID pengguna atau ID produk). Untuk tag Cloud Retail, data tersebut harus diekspos secara terstruktur menggunakan lapisan data sehingga Tag Manager dapat menggunakannya.

Lapisan data adalah objek JavaScript yang biasanya ditambahkan ke halaman menggunakan kode sisi server atau, di frontend, menggunakan HTML atau template. Jika halaman dikonfigurasi dengan lapisan data, halaman tersebut akan berisi beberapa kode seperti berikut:

dataLayer = dataLayer || [];
dataLayer.push({
  'cloud_retail': {
    'eventType': 'home-page-view',
    'visitorId': 'visitor_a',

    'userInfo': {
      'userId': '789'
    },
  }
});

Kode ini membuat objek dataLayer dan menetapkan struktur cloud_retail kepadanya sebagai elemen array.

Kolom wajib diisi di lapisan data cloud_retail

Tentang peristiwa pengguna mencantumkan semua kolom dan contoh yang diperlukan untuk jenis peristiwa yang harus diteruskan ke lapisan data cloud_retail.

Kode atau template sisi server Anda harus memiliki tag skrip yang benar di setiap halaman yang ingin Anda kirimi peristiwa. Setelah objek dataLayer diisi dengan benar di setiap halaman, Anda akan dapat menguji tag Cloud Retail.

Beberapa kolom seperti visitorId diperlukan untuk pesan UserEvent, tetapi mungkin tidak tersedia saat mengisi lapisan data. Misalnya, visitorId mungkin berasal dari cookie pengguna, atau experimentIds dari framework eksperimen A/B. Dalam hal ini, gunakan variabel untuk mengganti kolom pada tag Tag Manager.

Anda dapat mengganti kolom berikut:

  • visitorId
  • userInfo.userId
  • attributionToken
  • experimentIds

Untuk mengetahui cara mengganti kolom UserEvent di Tag Manager, lihat Menetapkan kolom visitorID di Tag Manager, yang menjelaskan cara mengganti nilai kolom visitorId dengan variabel buatan pengguna.

Contoh berikut menunjukkan lapisan data yang perlu disertakan di halaman Anda untuk UserEvent detail-page-view menggunakan Tag Manager:

<script>
  dataLayer = dataLayer || [];
  dataLayer.push({
    'cloud_retail': {
      'eventType' : 'detail-page-view',
      'visitorId': 'visitor_a',
      'userInfo': {
          // The user and visitor ID fields can typically be
          // be populated from a client-side JavaScript
          // variable such as a cookie. If you set the user
          // and/or visitor ID values from the server,
          // populate the `userID`.
          'userId': 'user_a'
      },
      // In most cases, the experiment ID field is populated from a
      // client side JavaScript variable as defined by the experiment
      // manager.
      // If you set the experiment ID value from the server,
      // populate the `experimentIds` field here.
      'productDetails': [
            {
              'product': {'id': '123'}
            }
      ],
    // You can use the 'cloud_retail' data layer element along with other
    // data layer elements.
    'ecommerce': {
      ...
    },
  }];
</script>

Melihat pratinjau tag Tag Manager

Mode pratinjau Tag Manager memungkinkan Anda menguji tag baru sebelum memublikasikannya ke situs aktif Anda.

Untuk mengetahui detail selengkapnya tentang mode pratinjau, lihat dokumentasi Tag Manager untuk mode pratinjau.

Gunakan prosedur berikut untuk mengonfirmasi bahwa tag Anda diaktifkan dengan benar.

  1. Di halaman ringkasan Tag Manager, klik Pratinjau.

    Mode pratinjau Tag Manager akan terbuka di tab browser baru.

  2. Masukkan informasi situs Anda, lalu klik Mulai untuk memulai Tag Assistant.

    Di tab browser saat ini, Tag Assistant akan dimulai, dan situs Anda akan terbuka di tab baru.

  3. Di situs Anda, buka halaman tempat tag Cloud Retail harus diaktifkan.

  4. Pastikan Tag Assistant mencantumkan tag Cloud Retail di tab Tag di bagian Tag Diaktifkan.

  5. Di Tag Assistant, buka tab Data Layer dan periksa apakah nilai yang benar dari lapisan data cloud_retail atau e-commerce ditampilkan.

Memeriksa error tag

Jika beberapa kolom salah atau tidak ada saat Anda melihat pratinjau tag, tag biasanya juga menampilkan error, kecuali jika tag tidak diaktifkan sama sekali.

Anda dapat memeriksa halaman Monitoring di konsol Search for Commerce untuk mengetahui error. Halaman ini mencatat sebagian besar error kecuali error sintaksis, yang biasanya hanya muncul di hasil permintaan.

Anda dapat menggunakan langkah-langkah berikut untuk menggunakan Chrome DevTools guna memeriksa error yang dihasilkan, termasuk error sintaksis.

  1. Aktifkan mode pratinjau di Tag Manager untuk situs Anda di browser Chrome dan buka halaman mana pun tempat tag Cloud Retail harus dipicu.

  2. Dengan mode pratinjau terbuka, buka DevTools dan klik tab Network.

  3. Muat ulang halaman.

  4. Di DevTools, telusuri userEvent.

    Tab Network menampilkan peristiwa userEvent:collect dan kode statusnya.

    • Respons 200 menunjukkan bahwa tag Anda dalam kondisi baik.
    • Respons lain, seperti error 400 dan menandai peristiwa dengan warna merah, menunjukkan bahwa proses pen-debug-an diperlukan.

  5. Klik dua kali nama peristiwa untuk mengeksekusi permintaan dan menampilkan respons lengkap dengan informasi error lainnya.

    Misalnya, Anda mungkin melihat error 400 yang berisi pesan, "'visitorId' is required, and cannot be empty", yang menunjukkan bahwa visitorId tidak ditetapkan dengan benar.

  6. Jika tidak ada userEvent yang diaktifkan, periksa tab Console DevTools untuk mengetahui apakah ada error sintaksis di lapisan data.

Merekam peristiwa pengguna dengan pemberian tag sisi server

Pemberian tag sisi server memungkinkan Anda men-deploy satu penampung sisi server dengan banyak klien hilir. Hal ini akan membuat satu sumber tepercaya di sisi klien, dengan banyak konsumen sisi server. Arsitektur ini mengalihkan beban dari web ke server, sehingga diinginkan oleh pengguna yang ingin memaksimalkan performa situs mereka.

Keuntungan lain dari pemberian tag sisi server adalah satu tag sisi server juga dapat mendukung banyak klien upstream, misalnya, web dan seluler. Pelajari cara menyiapkan pemberian tag sisi server.

Vertex AI Search untuk commerce menyediakan tag sisi server lama miliknya sendiri.

Tag sisi server Cloud Retail memerlukan dan menerima parameter yang serupa dengan tag web Cloud Retail, seperti:

  • Nomor project
  • Kunci API (untuk autentikasi)
  • Penggantian untuk kolom utama seperti visitorId dan searchQuery

Perbedaan utama antara versi server dan versi web tag Cloud Retail adalah Anda tidak dapat menentukan sumber data. Sumber data untuk tag server adalah aliran data yang dikirim dari tag Google dalam skema GA4.

Menyiapkan tag Retail Cloud

Melihat peristiwa yang direkam

Lihat metrik integrasi acara di tab Acara di halaman Data pada konsol Penelusuran untuk e-commerce. Halaman ini menampilkan semua peristiwa yang ditulis atau diimpor pada tahun lalu. Metrik dapat memerlukan waktu hingga 24 jam untuk muncul setelah penyerapan data berhasil.

Buka halaman Data

Langkah berikutnya