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

개요

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

선행 조건

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

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

인스톨

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

SDK 메서드

새 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에서는 작동하지 않는다는 것입니다.