스마트 배너 마이그레이션 가이드 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에서는 작동하지 않는다는 것입니다.
최신 데이터 5개월 전