Panduan migrasi Smart Banner v1 ke v2

⚠️

Pemberitahuan Penting

As of Nov. 8th, 2023, AppsFlyer Smart Banner web SDK v1, is deprecated. From this date onwards websites using the Smart Banner web SDK v1 can no longer show Smart Banners.
Please upgrade to Smart Banner v2 by following the instructions in this article.

Overview

Memutakhirkan SDK Anda ke versi baru bisa menjadi proses yang sederhana, tetapi penting untuk memahami perubahan yang telah dibuat. Di tutorial ini, kita akan membahas langkah-langkah untuk memutakhirkan SDK Anda saat ini ke versi baru, dan cara menyesuaikan kode Anda untuk mengakomodasi perubahan.

Prasyarat

  1. Pastikan untuk mengunduh SDK versi terbaru.
    Jika Anda sudah memiliki SDK Web PBA mandiri, hapus dan ganti dengan SDK Web untuk Spanduk Cerdas dan Atribusi Berbasis Manusia; jangan hanya menambahkan SDK Web mandiri untuk Spanduk Cerdas.

Anda dapat menemukan kedua cuplikan SDK di sini (silakan pilih salah satu yang cocok untuk Anda):
1. Menggunakan SDK Web hanya untuk Spanduk Cerdas.
2. Menggunakan SDK Web untuk Spanduk Cerdas dan Atribusi Berbasis Manusia.

Instalasi

Mengganti cuplikan SDK lama di situs web Anda dengan yang baru.
Cukup ganti cuplikan kode lama di <head> tag setiap halaman yang menampilkan spanduk seluler Anda dengan cuplikan SDK baru.

metode SDK

  1. Setelah SDK baru terpasang, Anda perlu menyesuaikan kode Anda untuk menampilkan perubahan.
    Di kasus ini, SDK lama termasuk fungsi kedaluwarsa, seperti misalnya:
    disableBanners()
    disableTracking()
    getAdditionalParams()
    setAdditionalParams()

Fungsi ini telah dihapus di SDK baru, jadi Anda perlu untuk menghapus semua referensi ke fungsi tersebut di kode Anda.

showBanner

Di SDK lama, fungsi showBanner dipanggil seperti ini:

showBanner({ bannerContainerQuery: "#container-id",
              bannerZIndex: 1000,
              additionalParams: { deep_link_value: "flights", deep_link_sub1: "london"}});

Di SDK baru, showBanner fungsi ini dipanggil seperti ini:

AF('banners', 'showBanner', { bannerContainerQuery: "#container-id",
              bannerZIndex: 1000,
              additionalParams: { deep_link_value: "flights", deep_link_sub1: "london"}});

hideBanner

The hideBanner fungsi juga telah berubah, dari:

hideBanner()

ke versi baru

AF('banners', 'hideBanner')

updateParams

SDK baru memungkinkan Anda untuk secara terprogram menambahkan hingga 10 parameter ke URL OneLink yang ditetapkan ke tombol call-to-action (CTA), setelah spanduk ditampilkan. Hal ini berguna untuk melacak atau tujuan lain di mana Anda butuh untuk meneruskan data dinamis ke OneLink Anda.

Contoh:

AF ("banners", "updateParams", {af_ad: "my_new_ad", deep_link_sub8: "promo_summer"})

Penting untuk dicatat bahwa metode ini tidak bekerja dengan SDK web Spanduk Cerdas yang kedaluwarsa.