스마트 배너 마이그레이션 가이드 v1에서 v2로

⚠️

중요 공지

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.

개요

SDK를 새 버전으로 업그레이드하는 것은 간단한 프로세스일 수 있지만 변경 사항을 이해하는 것이 중요합니다. 이 설명서에서는 현재 SDK를 새 버전으로 업그레이드하는 단계와 변경 사항에 맞게 코드를 조정하는 방법에 대해 설명합니다.

선행 조건

  1. 최신 버전의 SDK를 다운로드하십시오.
    독립 실행형 PBA 웹 SDK가 이미 있는 경우 제거하고 스마트 배너 및 사람 기반 어트리뷰션용 웹 SDK로 교체하십시오. 단순히 독립 실행형 스마트 배너용 웹 SDK를 추가하지 마십시오.

여기에서 두 SDK 스니펫을 모두 찾아볼 수 있습니다(적합한 것을 선택하십시오).
1. 스마트 배너에만 웹 SDK 사용.
2. 스마트 배너와 유저 중심 어트리뷰션(PBA)을 둘 다 사용.

인스톨

웹사이트의 이전 SDK 스니펫을 새것으로 바꿉니다.
모바일 배너를 표시하는 모든 페이지의 <head> 태그에 있는 이전 코드 스니펫을 새 SDK 스니펫으로 바꾸기만 하면 됩니다.

SDK 메서드

  1. 새 SDK가 준비되면 변경 내용을 반영하도록 코드를 조정해야 합니다.
    이 경우 이전 SDK에는 다음과 같은 사용되지 않는 기능이 포함되었습니다.
    disableBanners()
    disableTracking()
    getAdditionalParams()
    setAdditionalParams()

이러한 기능은 새 SDK에서 삭제되었으므로 코드에서 해당 기능에 대한 참조를 삭제해야 합니다.

showBanner

이전 SDK에서 showBanner 함수는 다음과 같은 방식으로 호출되었습니다.

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

새 SDK에서 showBanner 기능은 다음과 같이 호출됩니다.

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

hideBanner

The hideBanner 기능도 다음과 같이 변경되었습니다:

hideBanner()

새 버전으로

AF('banners', 'hideBanner')

updateParams

새 SDK를 사용하면 배너가 표시된 후 CTA(콜투액션) 버튼에 할당된 원링크 URL에 프로그래밍 방식으로 최대 10개의 파라미터를 추가할 수 있습니다. 이 기능은 동적 데이터를 원링크에 전달해야 하는 추적 또는 기타 목적에 유용합니다.

예:

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

중요한 것은 이 방법이 사용되지 않는 스마트 배너 웹 SDK에서는 작동하지 않는다는 것입니다.