Memfilter sumber sebelum atribusi menggunakan cakupan atribusi

Cakupan atribusi memungkinkan pemanggil API menentukan daftar string selama pendaftaran sumber dan pemicu yang dapat digunakan untuk pemfilteran sebelum atribusi terjadi. Hal ini memungkinkan pemfilteran yang lebih terperinci untuk meningkatkan efisiensi API dan memberikan fleksibilitas yang lebih besar. Misalnya, fitur ini memungkinkan pelacakan pengiklan terpisah di situs yang sama secara terpisah. Hal ini juga memfasilitasi pelacakan beberapa kampanye atau produk dalam satu banner iklan.

Cakupan atribusi adalah kolom opsional yang dapat ditetapkan selama pendaftaran sumber dan pemicu. Selama atribusi, hanya sumber yang nilai cakupan atribusinya berisi setidaknya salah satu nilai cakupan atribusi pemicu yang akan dipertimbangkan untuk atribusi. Jika tidak ada cakupan yang ditentukan dalam pemicu, semua sumber akan dipertimbangkan. Sebelum melanjutkan, Anda harus memahami Attribution reporting API dan filter tingkat tinggi.

Selama pendaftaran sumber

Parameter opsional attribution_scopes ditambahkan ke header Attribution-Reporting-Register-Source yang berisi dua parameter wajib: values, dan limit; dan satu parameter opsional: max_event_states.

  • limit: Merepresentasikan total jumlah cakupan berbeda yang diizinkan per tujuan untuk asal pelaporan sumber. Semua sumber terdaftar yang ada dengan asal dan tujuan pelaporan yang sama, tetapi dengan batas yang lebih kecil, akan dihapus.
  • values: Merepresentasikan daftar cakupan atribusi untuk sumber tertentu. Nilai ini harus berupa string dengan panjang maksimum 50.
  • max_event_states (opsional): Merepresentasikan jumlah maksimum status peristiwa yang direncanakan oleh pemanggil API untuk digunakan di semua pendaftaran sumber peristiwa berikutnya. Perhatikan bahwa sumber terdaftar yang ada dengan asal dan tujuan pelaporan yang sama, tetapi max_event_states value yang berbeda akan dihapus. Nilai default untuk kolom opsional ini adalah 3.

Contoh pendaftaran sumber

  Attribution-Reporting-Register-source: {
  //optional
  "attribution_scopes":{
  "limit": <int>,
  "values": <list of strings>,
  // optional
  "max_event_states": <int>
    },
  ...
  }

Selama pendaftaran pemicu

Parameter opsional attribution_scopes ditambahkan ke header Attribution-Reporting-Register-Trigger selama pendaftaran pemicu. Pastikan nilai parameter adalah daftar string yang mewakili cakupan untuk pemicu. Pemicu hanya akan cocok dengan sumber yang parameter nilai attribution_scopes-nya berisi minimal salah satu attribution_scopes pemicu, jika ditentukan.

Contoh pendaftaran pemicu

Attribution-Reporting-Register-Trigger: {
//optional
"attribution_scopes": <list of strings>,
...
}

Contoh cakupan atribusi

Contoh berikut menunjukkan kasus saat pemicu diatribusikan ke sumber saat menggunakan cakupan atribusi.

Pendaftaran sumber #1

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser1"],
  "max_event_states": 3
  },
  ...
  }

Pendaftaran sumber #2

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser2"],
  "max_event_states": 3
  },
  ...
  }

Pendaftaran pemicu

  Attribution-Reporting-Register-Trigger: {
  "attribution_scopes": ["advertiser1"],
  ...
  }

Saat pendaftaran pemicu terjadi, API akan memilih sumber yang akan dipertimbangkan untuk atribusi yang memiliki nilai attribution_scopes yang tumpang-tindih dengan nilai dalam pendaftaran pemicu. Pendaftaran sumber yang cocok akan dilanjutkan dengan alur atribusi lainnya. Dalam contoh ini, pemanggil API akan menerima laporan atribusi yang mengatribusikan pendaftaran pemicu ke pendaftaran sumber pertama.

Cakupan atribusi versus filter

Meskipun fungsi cakupan dan filter atribusi mungkin tampak serupa, faktor pembedanya adalah tempat penerapannya dalam alur pendaftaran pemicu. Pemfilteran cakupan atribusi terjadi sebelum atribusi. Artinya, tindakan ini akan mengurangi kumpulan sumber kandidat yang belum habis masa berlakunya dan memiliki situs tujuan dan asal pelaporan yang sama, berdasarkan sumber yang memiliki cakupan yang tumpang-tindih dengan cakupan yang ditemukan di pemicu. Namun, filter tingkat teratas diterapkan setelah pemicu diatribusikan ke satu sumber. Jika filter sumber dan pemicu tidak tumpang-tindih, laporan tidak akan dibuat.

Gambar berikut menampilkan grup sumber dan pemicu yang memiliki situs tujuan, asal pelaporan, dan masa berlaku yang sama. Kita akan membahas secara singkat cara penggunaan cakupan dan filter atribusi serta apakah laporan akan dibuat berdasarkan sumber dan pemicu yang tersedia.

<img "activewear"="" "attribution="" "casualwear"="" "casualwear",="" "outerwear"="" "outerwear".="" "outerwear"."="" #1".the="" 1.="" 2.="" alt="Gambar yang menampilkan 4 kotak berlabel sumber yang diberi nomor 1 hingga 4 dan satu kotak berlabel " and="" attributes="" filter:="" first="" following="" fourth="" has="" priority:="" scope":="" second="" source="" src="/static/assets/images/attribution-scopes-example-1.png" the="" third=" title="Contoh cara kerja atribusi dengan cakupan dan filter atribusi" trigger="" />

Sebelum atribusi

  • Sumber #1 difilter karena cakupan atribusinya tidak cocok dengan cakupan casualwear pemicu. Memiliki prioritas tertinggi di antara semua sumber yang tersedia tidak mencegahnya difilter karena pemfilteran pra-atribusi terjadi sebelum prioritas diperiksa.
  • Sumber #2 juga difilter karena tidak memiliki cakupan yang sama dengan pemicu. Sumber ini juga memiliki filter yang sama dengan pemicu, tetapi filter tingkat tinggi tidak diterapkan hingga setelah atribusi.

Selama atribusi

  • Sumber #3 tidak dipilih untuk atribusi karena memiliki prioritas yang lebih rendah daripada Sumber #4.
  • Sumber #4 dipilih karena memiliki cakupan atribusi yang cocok dengan pemicu dan memiliki prioritas tertinggi. Filter tingkat tinggi diterapkan setelah atribusi sehingga tidak diperhitungkan selama proses atribusi.

Atribusi postingan

  • Tidak ada laporan yang dihasilkan karena filter tingkat tinggi untuk sumber yang dipilih (sumber #4) dan pemicu tidak tumpang-tindih.

Contoh sebelumnya tidak menghasilkan laporan yang dibuat. Namun, jika sumber keempat dihapus sepenuhnya:

Gambar yang sama memiliki 4 kotak berlabel sumber yang diberi nomor 1 hingga 4 dan satu kotak berlabel

Selama atribusi

  • Sumber #3 dipilih karena memiliki cakupan atribusi yang tumpang-tindih dengan pemicu.

Atribusi postingan

  • Sumber #3 tidak ditolak karena filternya tumpang-tindih dengan filter di pemicu. Atribusi kemudian akan melalui pemeriksaan pasca-atribusi lainnya yang berakhir dengan laporan yang dibuat jika lulus semua pemeriksaan.

Cakupan atribusi mengurangi jumlah sumber yang dipertimbangkan untuk atribusi. Langkah atribusi yang tersisa kemudian diterapkan ke kumpulan sumber yang lebih kecil ini, yang dapat menghasilkan laporan.

Tempat cakupan atribusi dalam alur atribusi

Cakupan atribusi diterapkan sebelum sumber dipilih untuk atribusi. Hal ini juga mendahului filter tingkat teratas dan pemfilteran periode pelaporan kustom. Diagram berikut menunjukkan versi sederhana dari keseluruhan alur atribusi dengan cakupan atribusi yang terjadi sebelum atribusi dan pemeriksaan atribusi lainnya.

<img "attribution="" "attribution",="" "deactivation="" "filters="" "report="" "source="" "trigger="" alt="Gambar yang menampilkan versi sederhana alur atribusi dengan setiap langkah direpresentasikan sebagai persegi yang ditautkan ke langkah berikutnya dengan panah. Urutan langkahnya adalah " and="" check",="" checks"="" generation"."="" matching",="" of="" other="" registration",="" scopes="" source="" sources",="" src="/static/assets/images/attribution-scopes-attribution-flow.png" title="Diagram alur atribusi yang disederhanakan" />

Operasi alur atribusi

Berikut adalah recap berbagai operasi yang dilakukan selama alur atribusi:

  • Pendaftaran sumber: Saat pengguna berinteraksi dengan iklan di situs pengiklan, peristiwa sumber akan didaftarkan. Perangkat kemudian mengirim permintaan ke endpoint asal pelaporan, yang merespons dengan header yang berisi data peristiwa sumber.
  • Pendaftaran pemicu: Saat konversi terjadi di situs pengiklan, peristiwa pemicu akan didaftarkan. Permintaan lain dikirim oleh perangkat ke asal pelaporan, yang merespons dengan header yang berisi data peristiwa pemicu.
  • Pencocokan sumber: Perangkat mencocokkan peristiwa sumber dan pemicu berdasarkan kriteria seperti situs tujuan, asal pelaporan, dan masa berlaku.
  • Pemeriksaan cakupan atribusi: Sumber difilter berdasarkan persimpangan antara nilai attribution_scopes sumber dan pemicu.
  • Atribusi: Perangkat memilih sumber dengan prioritas tertinggi untuk atribusi jika beberapa sumber cocok. Jika prioritasnya sama, prioritas terbaru akan dipilih.
  • Pemeriksaan filter: Perangkat membandingkan filter sumber dan pemicu untuk menentukan apakah keduanya cocok. Jika filter tidak cocok, atribusi akan dihapus.
  • Penonaktifan sumber lain: Jika filter sumber yang dipilih cocok, perangkat akan menonaktifkan sumber yang cocok selama tahap Pencocokan sumber. Sumber yang dinonaktifkan akan mencakup sumber yang cakupan atribusinya tidak cocok dengan cakupan pemicu.
  • Pemeriksaan pasca-atribusi: Perangkat melakukan lebih banyak pemeriksaan pada atribusi yang dipilih seperti memeriksa apakah sumber berisi derau dengan laporan palsu, memeriksa atribusi duplikat menggunakan kunci penghapusan duplikat, memeriksa apakah pemicu berada dalam periode laporan sumber, dan memeriksa batas kapasitas.
  • Pembuatan laporan: Jika semua pemeriksaan lulus, perangkat akan membuat dan menjadwalkan laporan atribusi untuk dikirim ke endpoint origin pelaporan.

Langkah berikutnya