Panduan Inisiasi Atribusi SKAdNetwork

SKAdNetwork API Apple bertujuan untuk mengukur keberhasilan kampanye iklan instal aplikasi sekaligus menjaga privasi pengguna. Untuk SKAdNetwork v2.0 dan v2.1, atribusi penginstalan untuk iklan yang dirender StoreKit didorong oleh klik pada iklan yang akan mendorong pengguna menginstal aplikasi. SKAdNetwork v2.2 dan versi yang lebih baru juga mendukung iklan tampilan-melalui, dengan atribusi didorong hanya dengan melihat iklan.

Panduan berikut diberikan untuk memastikan bahwa Google Mobile Ads SDK dapat memulai atribusi SKAdNetwork dengan benar.

Atribusi on-click untuk iklan seluler

Atribusi SKAdNetwork dimulai oleh peristiwa klik iklan Google Mobile Ads SDK hanya jika tindakan klik secara khusus diarahkan ke Apple App Store. Alasan persyaratan ini adalah untuk mencegah app store diluncurkan oleh klik yang tidak dimaksudkan untuk membuka app store. Jenis tindakan klik ini dapat mencakup, misalnya, membuka halaman Ad Choices.

Panduan

Untuk menjamin bahwa tindakan klik pada iklan dan penginstalan aplikasi berikutnya akan menghasilkan atribusi SKAdNetwork, saat membuat materi iklan, pastikan URL klik-tayang materi iklan adalah

  • link langsung ke aplikasi yang diiklankan di app store, atau,
  • menggunakan metode pengalihan, seperti HTTP 301, 302, atau jenis rantai pengalihan HTTP sisi server lainnya yang akan memiliki tujuan akhir app store.

Link ke app store secara langsung atau melalui rantai pengalihan dikonfirmasi jika URL dimulai dengan salah satu pola berikut:

  • https://apps.apple.com
  • https://itunes.apple.com
  • itms-apps://
  • itms://

Halaman landing lainnya atau menggunakan metode pengalihan sisi klien lainnya ditentukan untuk tidak diarahkan ke app store dan mungkin tidak memulai proses atribusi SKAdNetwork. Contoh:

  • Halaman HTML yang memerlukan tindakan pengguna untuk mengalihkan ke app store
  • Halaman HTML yang memiliki skrip pengalihan berbasis JavaScript otomatis ke app store
  • Tag refresh meta

Praktik terbaik untuk berbagai jenis materi iklan

Tindakan klik untuk memulai atribusi SKAdNetwork dapat disiapkan untuk berbagai jenis materi iklan sebagai berikut:

Materi iklan HTML
URL ini dapat disiapkan sebagai URL tujuan di tag anchor yang mengelilingi elemen yang dapat diklik, atau sebagai URL target operasi window.location dari peristiwa saat diklik berbasis JavaScript.
MRAID
Tindakan klik harus memanggil Mraid.open() untuk memulai atribusi SKAdNetwork.
Video VAST
URL app store harus ditetapkan di elemen ClickThrough dalam XML VAST.
Native
URL app store harus ditetapkan di kolom native.link.url untuk OpenRTB (atau kolom native_ad.click_link_url untuk protokol Google RTB yang tidak digunakan lagi).

Atribusi lihat-tayang untuk iklan seluler

Jika atribusi lihat-melalui SKAdNetwork v2.2 didukung, SKAdNetwork API akan memulai timer tayangan iklan setelah iklan dirender dan dilihat oleh pengguna. Atribusi hanya diizinkan untuk iklan yang telah ditampilkan selama minimal 3 detik.

Perhatikan bahwa iOS versi 15.3 dan yang lebih lama hanya mendukung 1 timer tayangan aktif sekaligus. Dalam hal ini, tayangan mungkin gagal memulai atribusi lihat-melalui jika ada beberapa iklan atribusi lihat-melalui dalam layar yang sama. Pembatasan ini telah dibatalkan di iOS versi 15.4 dan yang lebih baru, sehingga SKAdNetwork kini mengizinkan beberapa tayangan iklan serentak yang diaktifkan untuk atribusi lihat-tayang.

Panduan

Kolom permintaan bid BidRequest.imp.ext.skadn.fidelities untuk OpenRTB (atau BidRequest.mobile.skadn.supported_fidelity_types untuk protokol Google RTB yang tidak digunakan lagi) menentukan jenis fidelitas atribusi yang didukung oleh permintaan bid. Kolom ini mencakup jenis fidelitas VIEW_THROUGH_ADS di SKAdNetwork versi v2.2 dan yang lebih baru.

Pastikan respons bid tidak menyertakan fidelitas VIEW_THROUGH_ADS jika atribusi lihat-melalui tidak didukung. Merespons dengan fidelitas VIEW_THROUGH_ADS jika tidak didukung akan menyebabkan bid difilter sebelum lelang.

Kompatibilitas mundur

Mulai SKAdNetwork v4.0, permintaan iklan yang diaktifkan untuk atribusi SKAdNetwork kompatibel dengan versi sebelumnya. Hal ini memungkinkan jaringan iklan merespons dengan versi SKAdNetwork sebelumnya meskipun permintaan iklan mendukung versi yang lebih baru.

Panduan

Versi OS perangkat pengguna dan versi Google Mobile Ads SDK aplikasi penayang menentukan fitur SKAdNetwork yang didukung oleh permintaan iklan. Hal ini dapat ditentukan pada permintaan bid menggunakan kolom BidRequest.imp.ext.skadn.versions OpenRTB (atau kolom BidRequest.mobile.skadn.versions protokol Google RTB yang tidak digunakan lagi). Daftar ini mencantumkan semua versi SKAdNetwork yang didukung oleh permintaan iklan.

Untuk mencegah pemfilteran bid, pastikan versi SKAdNetwork yang digunakan untuk membuat respons adalah salah satu versi yang tercantum pada permintaan bid. Selain itu, saat versi SKAdNetwork yang lebih baru diperkenalkan, perhatikan bahwa merespons dengan versi yang lebih lama diizinkan selama versi tersebut ada dalam daftar ini. Hal ini memungkinkan jaringan iklan untuk terus merespons dengan versi sebelumnya dan menyesuaikan versi yang lebih baru sesuai kecepatannya sendiri.