Periode laporan kustom dapat memberikan laporan tingkat peristiwa yang lebih cepat dan pelaporan selektif untuk laporan agregat.
Dengan periode laporan kustom untuk Attribution Reporting (dikirimkan di Chrome 110), Anda dapat memerintahkan browser untuk memfilter konversi yang terjadi setelah periode waktu tertentu.
- Untuk laporan tingkat peristiwa, periode laporan memungkinkan Anda mendapatkan laporan lebih cepat, selain memfilter konversi yang terjadi setelah jangka waktu tertentu. Bergantung pada sasaran Anda, cara lain untuk melihat hal ini adalah sebagai kompromi: menggunakan periode laporan memberi Anda akses yang lebih cepat ke laporan, tetapi menyiratkan bahwa Anda mungkin kehilangan beberapa konversi. Tinjau bagian tingkat peristiwa untuk mengetahui detailnya.
- Untuk laporan gabungan, periode laporan memungkinkan Anda memfilter konversi yang terjadi setelah jangka waktu tertentu. Tinjau bagian agregat untuk mengetahui detailnya.
Apa yang dimaksud dengan periode laporan kustom?
Periode laporan kustom adalah periode setelah pendaftaran sumber saat laporan jenis yang sesuai (peristiwa atau gabungan) dapat dibuat untuk sumber ini.
Untuk laporan tingkat peristiwa, periode laporan juga berfungsi sebagai periode terakhir yang digunakan untuk mengirim laporan dari jenis yang sesuai.
Poin utama tentang periode pelaporan:
- Jika tidak ada
report_window
yang ditetapkan, nilai tersebut akan kembali keexpiry
. - Jika tidak ada
expiry
yang ditetapkan, nilai tersebut akan kembali ke default 30 hari. - Periode minimum laporan kustom adalah satu hari. Meskipun Anda menetapkan periode kurang dari sehari, nilainya akan dibulatkan ke hari. Tinjau contoh untuk laporan tingkat peristiwa.
- Periode laporan ditentukan dalam hitungan detik.
Perhatikan bahwa cara kerja expiry
tidak berubah; expiry
mengubah tayangan atau klik mana yang memenuhi syarat untuk atribusi.
Laporan tingkat peristiwa: pelaporan yang lebih cepat dan pelaporan selektif
Secara default, laporan tingkat peristiwa dikirim sesuai dengan jadwal periode laporan bawaan: tiga periode untuk klik dan satu periode untuk tampilan.
Untuk laporan tingkat peristiwa, periode laporan kustom memungkinkan Anda:
- Dapatkan laporan lebih cepat. Antara lain, periode laporan kustom memungkinkan Anda mendapatkan laporan satu hari setelah klik atau tayangan, bukan batas dua hari yang diberlakukan oleh periode masa berlaku bawaan sebelum Chrome 110.
- Memfilter konversi yang terjadi setelah jangka waktu tertentu.
Agar dapat menggunakan periode laporan untuk laporan tingkat peristiwa, tambahkan kolom event_report_window
ke header pendaftaran sumber Attribution-Reporting-Register-Source
.
Laporan tingkat peristiwa dijadwalkan untuk dikirim paling lambat setelah periode laporan tercapai.
Contoh jadwal untuk laporan tingkat peristiwa, klik
masa berlaku | event_report_window |
Jika konversi terjadi satu hari setelah klik, browser akan mengirim laporan: | Laporan yang difilter (tidak dikirim) untuk konversi yang terjadi: |
---|---|---|---|
Default (30 hari) | (Belum ditetapkan) | Sekitar 2 hari ditambah 1 jam setelah klik Perilaku pelaporan default — periode bawaan #1 |
Sekitar 30 hari setelah klik |
Kustom, ditetapkan ke 5 hari | (Belum ditetapkan) | Sekitar 2 hari ditambah 1 jam setelah klik Perilaku pelaporan default — periode bawaan #1 |
Lebih dari 5 hari setelah klik |
Default (30 hari) | Tetapkan ke 1 hari | Sekitar 1 hari ditambah 1 jam setelah klik Perilaku kustom karena periode laporan kustom Anda. Perhatikan bagaimana hal ini membuat laporan ini dibuat lebih cepat daripada di baris pertama, saat Anda harus menunggu periode bawaan pertama (2 hari) |
Lebih dari 1 hari setelah klik |
Kustom, ditetapkan ke 5 hari | Tetapkan ke 1 hari | Sekitar 1 hari ditambah 1 jam setelah klik Perilaku kustom karena periode laporan kustom Anda |
Lebih dari 1 hari setelah klik |
Default (30 hari) | Setel ke 4 jam | Sekitar 1 hari ditambah 1 jam setelah klik Perilaku kustom karena periode laporan kustom Anda. Hal ini terjadi karena adanya pembatasan: periode laporan minimum adalah satu hari. Meskipun Anda menetapkan periode laporan kurang dari sehari, misalnya, 4 jam, nilainya akan dibulatkan ke hari. |
Lebih dari 1 hari setelah klik |
Contoh jadwal untuk laporan tingkat peristiwa dan tampilan
masa berlaku | event_report_window |
Jika konversi terjadi satu hari setelah klik, browser akan mengirimkan laporan: |
---|---|---|
Default (30 hari) | (Belum ditetapkan) | Sekitar 30 hari ditambah 1 jam setelah penayangan Perilaku pelaporan default |
Kustom, ditetapkan ke 5 hari | (Belum ditetapkan) | Sekitar 5 hari ditambah 1 jam setelah penayangan Perilaku pelaporan default |
Default (30 hari) | Tetapkan ke 1 hari | Sekitar 1 hari ditambah 1 jam setelah penayangan Perilaku kustom karena periode laporan kustom Anda |
Kustom, ditetapkan ke 5 hari | Tetapkan ke 1 hari | Sekitar 1 hari ditambah 1 jam setelah penayangan Perilaku kustom karena periode laporan kustom Anda |
Laporan agregat: pelaporan selektif
Untuk laporan gabungan, manfaat periode laporan hanya untuk memfilter konversi yang terjadi setelah jangka waktu tertentu. Tidak ada manfaat dari mendapatkan laporan yang lebih cepat.
Agar dapat menggunakan periode laporan untuk laporan agregat, tambahkan kolom aggregatable_report_window
ke header pendaftaran sumber Attribution-Reporting-Register-Source
.
Dengan demikian, konversi yang terjadi setelah jangka waktu tertentu akan dikecualikan.
Laporan agregat dikirim dalam waktu satu jam setelah pemicuan, tetapi secara acak tertunda antara 10 menit dan satu jam.
masa berlaku | aggregatable_report_window |
Laporan yang difilter (tidak dikirim) untuk konversi yang terjadi: |
---|---|---|
Default (30 hari) | (Belum ditetapkan) | Lebih dari 30 hari setelah klik atau penayangan |
Kustom, ditetapkan ke 5 hari | (Belum ditetapkan) | Lebih dari 5 hari setelah klik atau penayangan |
Default (30 hari) | Tetapkan ke 1 hari | Lebih dari 1 hari setelah klik atau penayangan |
Kustom, ditetapkan ke 5 hari | Tetapkan ke 1 hari | Lebih dari 1 hari setelah klik atau penayangan |
Default (30 hari) | Setel ke 4 jam | Lebih dari 1 hari setelah klik atau penayangan. Hal ini terjadi karena adanya pembatasan: periode laporan minimum adalah satu hari. Meskipun Anda menetapkan periode laporan kurang dari sehari, misalnya, 4 jam, nilainya akan dibulatkan ke hari. |
Berinteraksi dan berbagi masukan
Anda dapat berpartisipasi dan bereksperimen dengan API ini.
- Baca laporan gabungan dan layanan agregasi, ajukan pertanyaan, dan sarankan masukan.
- Baca Panduan pelaporan Atribusi.
- Ajukan pertanyaan dan ikuti diskusi tentang repo Dukungan Developer Privacy Sandbox.