[GA4] Mengirim postback SKAdNetwork ke Google Analytics

Artikel berikut akan memandu Anda melakukan langkah-langkah untuk mengirim postback SKAdNetwork ke Google Analytics menggunakan Measurement Protocol.

Langkah 1: Daftarkan postback SKAdNetwork untuk versi iOS yang relevan

Buka dokumentasi Apple untuk mengetahui informasi selengkapnya. Untuk pelanggan yang menggunakan Google Analytics for Firebase SDK, SDK tersebut mendaftarkan postback secara otomatis untuk aplikasi sehingga Anda dapat melewati langkah ini.

Langkah 2: Pastikan Anda menerima dan mendekode postback SKAdNetwork

Buka dokumentasi Apple untuk mengetahui informasi selengkapnya. Jika belum menyiapkan endpoint SKAdNetwork, Anda harus melakukannya dengan mengikuti dokumentasi Apple. 

Catatan: Google Analytics 4 saat ini tidak dapat dikonfigurasi sebagai endpoint.

Jika sudah menyiapkan endpoint dengan Partner Atribusi Aplikasi (AAP) yang disetujui Google atau solusi internal, Anda dapat langsung ke langkah 3 yang akan memandu Anda melalui proses mengirim hasil ke Google Analytics menggunakan Measurement Protocol.

Langkah 3: Kirim hasil postback ke Google Analytics menggunakan Measurement Protocol

Langkah ini dilakukan dengan mengirimkan peristiwa kustom campaign_details ke Google Analytics melalui Measurement Protocol menggunakan skema berikut (contoh codelab). 

Penerapan Measurement Protocol untuk SKAdNetwork di Google Analytics 4

Semua parameter diperlukan kecuali jika dinyatakan sebagai opsional.

Parameter tingkat permintaan

Parameter	Informasi selengkapnya
firebase_app_id: {gmp_app_id}	Di Google Analytics 4, buka Admin > Aliran Data > pilih aliran data Anda > ID Aplikasi Firebase. Ditetapkan di luar payload.
api_secret: {api_secret}	Untuk membuat secret baru, buka Admin > Aliran Data > pilih aliran data Anda > Measurement Protocol > Buat di Google Analytics 4. Ditetapkan di luar payload.
timestamp_micros: {stempel waktu postback SKAN yang diterima}	Opsional. Jika disediakan, stempel waktu harus dalam waktu 72 jam terakhir. Jika tidak disediakan, stempel waktu pengumpulan akan digunakan. Periode peristiwa utama di Google Analytics 4 untuk peristiwa akuisisi adalah 30 hari. Anda sebaiknya mengirimkan postback sesegera mungkin untuk meningkatkan akurasi pelaporan.
app_instance_id: {...}	Wajib. Buat string angka acak yang berbeda-beda. String ID khusus ini akan dihapus untuk ID instance aplikasi yang sebenarnya setelah data ini digunakan dalam pemodelan konversi.

Peristiwa GA

Peristiwa	Informasi selengkapnya
campaign_details	Peristiwa kustom.

Parameter GA (lama)

Parameter	Informasi selengkapnya
source: {source}	Parameter ini merupakan parameter yang digunakan dalam pemberian tag manual. Pelaporan Google Analytics 4 disusun menggunakan Pengelompokan Saluran Default Google Analytics 4. Sebaiknya gunakan pengelompokan ini sebagai panduan untuk mengategorikan setiap parameter. Kirim parameter ini untuk semua postback non-Google. Contoh: Postback Facebook: source: facebook medium: cpc|cpm content: ad_version_name campaign: Kampanye Facebook Musim Semi 22  campaign id: sama dengan yang ada di postback SKAN Untuk postback Google, kami akan mendekode kampanye berdasarkan integrasi properti Anda dengan Google Ads. Oleh karena itu, parameter di atas bersifat opsional untuk postback Google. Anda harus memastikan properti Google Analytics 4 ditautkan ke akun iklan Google Ads.  Catatan: Anda harus mengirimkan semua postback SKAdNetwork, bukan hanya postback non-Google, ke Google Analytics 4.
medium: {medium}
term: {term}  Opsional
content: {content}  Opsional
campaign_id: {campaign_id}	Nilai dari postback SKAdNetwork.
campaign: {campaign}  opsional tetapi jika tidak digunakan, kampanye akan ditampilkan sebagai (not set)	Untuk kampanye Google Ads, kami akan mendekode ID dan memberikan nama kampanye berdasarkan penautan Google Analytics dan Google Ads Anda serta memperbarui parameter sumber dan media. Jika akun Anda tidak ditautkan, kami tidak akan mendekode ID kampanye Google dan akan menggunakan parameter sumber dan media yang ditentukan. Untuk kampanye non-Google Ads, Anda dapat mendekode dan menetapkan nama kampanye. Jika tidak tahu, Anda dapat menyalin campaign_id SKAdNetwork Anda. Catatan: Jika nama tidak ditetapkan, nama kampanye akan muncul sebagai (not set).
source_platform: “apple_skan”	Penting: String ini harus sama persis; kapitalisasi dan tanda _ harus diikuti.
app_id: {app_id}	Nilai dari postback SKAdNetwork. Nilai ini akan menjadi ID app bundle Anda.
transaction_id: {transaction_id}	Nilai dari postback SKAdNetwork.

Parameter baru yang diperlukan

Catatan: Parameter baru ini dapat disiapkan di antarmuka pengguna Google Analytics 4. Namun, tindakan ini tidak bersifat wajib. Jika Anda ingin melihat pelaporan dimensi kustom tertentu berdasarkan parameter ini, parameter tersebut harus didaftarkan di Google Analytics 4.

Parameter	Informasi selengkapnya
version: {version}	Nilai dari postback SKAdNetwork
conversion_value: {conversion_value}	Nilai dari postback SKAdNetwork
fidelity_type: {fidelity_type}	Nilai dari postback SKAdNetwork.
attribution_signature: {attribution_signature}	Nilai dari postback SKAdNetwork. Catatan: Parameter ini berfungsi sebagai fitur keamanan. Postback SKAdNetwork ditandatangani secara kriptografis.
redownload: {redownload}	Nilai dari postback SKAdNetwork.
source_app_id: {source_app_id}	Nilai dari postback SKAdNetwork. Catatan: ID ini adalah ID aplikasi tempat iklan diklik yang menghasilkan penginstalan.
did_win: {did_win}	Nilai dari postback SKAdNetwork. Catatan: Pengiklan hanya menerima postback unggulan. AdTech akan menerima postback unggulan dan postback urutan kedua/pendukung.
ad_network_id: {ad_network_id} {ad_network_id} merepresentasikan nilai di postback.	Nilai dari postback SKAdNetwork. Parameter ini menunjukkan jaringan iklan yang menampilkan iklan Anda. Parameter ini juga akan menjadi informasi yang berguna untuk dimensi traffic “sumber”.

 

Langkah 4: Pastikan hit Marketing Platform diterima

Peristiwa campaign_details tidak ditampilkan secara langsung di Google Analytics. Sebagai gantinya, postback SKAdNetwork diubah menjadi peristiwa dan diintegrasikan ke dalam peristiwa utama dan pelaporan peristiwa first_open. Postback ini dapat disegmentasikan dengan menambahkan platform sumber dimensi (platform sumber = SKAN).

Jika Anda ingin memastikan bahwa hit dikirim, sebaiknya catat peristiwa pengujian ke dalam log dengan menduplikasi peristiwa campaign_details menggunakan nama peristiwa yang berbeda (yaitu, campaign_details_skan_test). Selanjutnya, Anda dapat memeriksa apakah peristiwa pengujian muncul di laporan Real-Time Google Analytics 4. Jika Anda mendaftarkan parameter dan peristiwa pengujian, keduanya akan muncul di pelaporan ad hoc selain di laporan Real-time.

Catatan:

• Jika Anda ingin semua postback SKAdNetwork ditampilkan dalam pelaporan, selain mengirimkannya sebagai peristiwa campaign.details, Anda juga harus mendaftarkan peristiwa dan parameter duplikat yang telah dibahas sebelumnya. Jika Anda memilih untuk melakukannya, postback SKAdNetwork tetap harus dikirim menggunakan peristiwa campaign.details. Jika tidak, Google Analytics tidak akan mengenalinya dan tidak akan dapat melakukan pemodelan konversi untuk meningkatkan akurasi pelaporan first_open iOS Anda. 
• Postback SKAdNetwork harus dikirim dalam waktu 4 hari sejak diterima agar Google Analytics dapat menggunakannya dalam pemodelan dan pelaporan konversi.

Pelajari lebih lanjut langkah-langkah umum verifikasi.