Analisis nilai Shapley

Metode nilai Shapley adalah algoritma yang menetapkan kredit ke berbagai saluran iklan dan poin kontak berdasarkan kontribusi sesuai model mereka terhadap konversi. Dengan menggunakan metode nilai Shapley, Anda dapat membuat model kontribusi yang dimiliki saluran tertentu pada konversi.

Ads Data Hub menggunakan "Metode Nilai Shapley yang Disederhanakan", yang dijelaskan secara mendetail di makalah Metode Nilai Shapley untuk Model Atribusi di Iklan Online.

Catatan: Model nilai Shapley hanya dapat digunakan dengan tabel berbasis Transfer Data: cm_dt_*, dv360_dt_*.

Pembatasan privasi

Filter privasi akan menghapus poin kontak yang memiliki kurang dari 50 pengguna dan pengguna pencilan yang berkontribusi pada jumlah kredit yang tidak proporsional ke sebuah poin kontak. Dengan demikian, output dari model nilai Shapley mungkin tidak memiliki beberapa poin kontak yang ada di tabel poin kontak input.

Pesan privasi ditampilkan setelah setiap iterasi model nilai Shapley. Pesan ini menyertakan informasi tentang pengguna dan poin kontak yang difilter.

Ringkasan penghitungan nilai nilai Shapley

1. Buat tabel poin kontak dan kredit:
   1. touchpoint_temp_table.
   2. user_credit_temp_table.
2. Panggil fungsi bernilai tabel ADH.TOUCHPOINT_ANALYSIS menggunakan tabel sementara di atas sebagai argumen.

Membuat tabel poin kontak dan kredit

Membuat tabel poin kontak

Tabel poin kontak adalah tempat peristiwa pengguna yang terkait dengan poin kontak ditentukan. Data contoh dapat mencakup, tetapi tidak terbatas pada: campaign_id , creative_id, placement_id, atau site_id.

Catatan: Analisis nilai Shapley saat ini dibatasi hingga maksimum 150 poin kontak.

Tabel harus berisi kolom berikut:

Nama kolom	Jenis
touchpoint	string Nama poin kontak arbitrer. (Tidak boleh NULL atau berisi koma.)
user_id	string ID pengguna yang mengunjungi poin kontak. (Tidak boleh NULL atau 0.)
event_time	int Waktu saat pengguna mengunjungi poin kontak. (Tidak boleh NULL.)

Perhatian: Kueri akan gagal jika jumlah total poin kontak yang berbeda lebih besar dari 150, atau jika user_id tidak ada di user_credit_temp_table.

Kode contoh untuk membuat tabel:

CREATE TABLE touchpoint_temp_table
AS (
  SELECT user_id, event.event_time, CAST(event.site_id AS STRING) AS touchpoint
  FROM adh.cm_dt_impressions
  WHERE
    event.event_type IN ('VIEW')
    AND user_id <> '0'
    AND event.campaign_id IN UNNEST(@campaign_ids)

  UNION ALL

    SELECT
      user_id, event.event_time, CAST(event.site_id AS STRING) AS touchpoint
    FROM adh.cm_dt_clicks
    WHERE
      event.event_type IN ('CLICK')
      AND user_id <> '0'
      AND event.campaign_id IN UNNEST(@campaign_ids)
);

Membuat tabel kredit pengguna

Tabel kredit pengguna adalah tempat peristiwa konversi ditentukan. Untuk setiap pengguna, hanya peristiwa dengan stempel waktu sebelum konversi yang dipertimbangkan.

Tabel harus berisi kolom berikut:

Nama kolom	Jenis
user_id	string ID pengguna yang mengunjungi poin kontak. (Tidak boleh NULL atau 0.)
event_time	int Waktu saat peristiwa kontribusi terjadi. (Tidak boleh NULL.)
credit	integer Kredit yang dikontribusikan oleh pengguna. Nilai ini dapat berupa kredit yang ingin dianalisis. Misalnya, nilai konversi, jumlah konversi, dll. Harus antara 1 dan 100.

Catatan: Jika satu pengguna memiliki beberapa peristiwa konversi, upload seperti yang Anda lakukan pada peristiwa lainnya. Pastikan tidak ada peristiwa yang menggunakan pasangan duplikat user_id dan event_time.

Kode contoh untuk membuat tabel:

CREATE TABLE user_credit_temp_table AS (
  SELECT
    user_id,
    MAX(event.event_time) AS event_time,
    1 AS credit
  FROM adh.cm_dt_activities_attributed
  WHERE user_id <> '0'
    AND event.campaign_id IN UNNEST(@campaign_ids)
    AND DATE(TIMESTAMP_MICROS(event.event_time)) BETWEEN @start_date AND @end_date
    AND event.activity_id IN UNNEST (@activity_ids)
  GROUP BY user_id
);

Fungsi bernilai tabel

Fungsi bernilai tabel adalah fungsi yang menampilkan hasil tabel. Dengan demikian, Anda dapat melakukan kueri fungsi bernilai tabel seperti yang Anda lakukan pada tabel normal.

Sintaksis

ADH.TOUCHPOINT_ANALYSIS(TABLE touchpoints_tmp_table_name, TABLE credits_tmp_table_name, STRING model_name)

Argumen

Nama
touchpoints_tmp_table_name	Nama tabel poin kontak sementara yang dibuat klien. Tabel harus memiliki skema yang berisi kolom touchpoint, user_id, dan event_time.
credits_tmp_table_name	Nama tabel kredit pengguna sementara yang dibuat klien. Tabel harus memiliki skema yang berisi kolom user_id, credit, dan conversion_time.
model	string Harus SHAPLEY_VALUES.

Tabel output

Tabel output akan berisi skema berikut:

Nama kolom	Jenis
touchpoint	string Nama poin kontak.
score	integer Skor nilai Shapley yang dihitung untuk poin kontak ini.

Kode contoh untuk menggunakan fungsi bernilai tabel

SELECT *
FROM ADH.TOUCHPOINT_ANALYSIS(
  TABLE tmp.touchpoint_temp_table,
  TABLE tmp.user_credit_temp_table,
  'SHAPLEY_VALUES')