스마트 배너 v2

개요

앱스플라이어는 광고주가 웹사이트에 삽입할 수 있는 스마트 배너 SDK를 제공합니다. SDK는 필요한 데이터를 가져와 스마트 배너에 데이터를 동적으로 표시합니다. 스마트 배너 SDK는 또, 적절한 어트리뷰션 링크를 자동으로 생성해, 링크를 따로 만들 필요가 없습니다.

따라서 스마트 배너 SDK는 모바일 배너가 게재되는 모든 페이지에서 접근할 수 있어야 합니다.
스마트 배너 SDK는 고유한 웹 키를 이용하여 인증합니다. 웹 키는 웹사이트 작업 공간에서 얻을 수 있습니다.

인스톨

Smart banners only

  1. 스크립트 내 YOUR_WEB_KEY 자리 표시자를 웹 키로 바꿉니다. 웹 키는 웹사이트 작업 공간을 새로 만들 때 생성됩니다.
  2. 다음 코드 스니펫을 웹 사이트의 head 태그에 붙여 넣습니다. 반드시 head 태그의 맨 위 가까이에 붙여넣도록 하십시오.
<script>
!function(t,e,n,s,a,c,i,o,p){t.AppsFlyerSdkObject=a,t.AF=t.AF||function(){
(t.AF.q=t.AF.q||[]).push([Date.now()].concat(Array.prototype.slice.call(arguments)))},
t.AF.id=t.AF.id||i,t.AF.plugins={},o=e.createElement(n),p=e.getElementsByTagName(n)[0],o.async=1,
o.src="https://websdk.appsflyer.com?"+(c.length>0?"st="+c.split(",").sort().join(",")+"&":"")+(i.length>0?"af_id="+i:""),
p.parentNode.insertBefore(o,p)}(window,document,"script",0,"AF","banners",{banners: {key: ">>>>>YOUR_WEB_KEY<<<<"}});
// Smart Banners are by default set to the max z-index value, so they won't be hidden by the website elements. This can be changed if you want some website components to be on top of the banner.
AF('banners', 'showBanner');
</script>

ℹ️

참고

The showBanner 메소드는 설치 코드 끝에 있으며 더 많은 파라미터를 사용할 수 있습니다. 더 알아보기

Smart banners and People-Based Attribution

  1. Replace the YOUR_WEB_KEY placeholder in the script with your Web key. The web key is created when you create a new Website workplace.
  2. 스크립트 내 YOUR_PBA_KEY 플레이스 홀더를 귀하의 web dev key로 바꿉니다. web dev key는 브랜드 번들을 생성할 때 만들어집니다.
  3. 이 코드 스니펫을 귀사의 웹사이트 head 태그에 붙여넣습니다. 헤드 태그의 맨 위 가까이에 붙여넣도록 하십시오.
<script>
!function(t,e,n,s,a,c,i,o,p){t.AppsFlyerSdkObject=a,t.AF=t.AF||function(){
(t.AF.q=t.AF.q||[]).push([Date.now()].concat(Array.prototype.slice.call(arguments)))},
t.AF.id=t.AF.id||i,t.AF.plugins={},o=e.createElement(n),p=e.getElementsByTagName(n)[0],o.async=1,
o.src="https://websdk.appsflyer.com?"+(c.length>0?"st="+c.split(",").sort().join(",")+"&":"")+(i.length>0?"af_id="+i:""),
p.parentNode.insertBefore(o,p)}(window,document,"script",0,"AF", "pba,banners",{pba: {webAppId: "YOUR_PBA_KEY"}, banners: {key: "YOUR_WEB_KEY"}});
// Smart Banners are by default set to the max z-index value, so they won't be hidden by the website elements. This can be changed if you want some website components to be on top of the banner.
AF('banners', 'showBanner', { bannerZIndex: 1000, additionalParams: { p1: "v1", p2: "v2"}});
</script>

SDK 함수(function)

showBanner

Method signature

AF('banners', 'showBanner', { bannerContainerQuery: String,
              bannerZIndex: Integer,              
              additionalParams: <Key, Value Dictionary>);

설명
스니펫으로 제공된 배너 키에 따라 스마트 배너를 보여주기 시작합니다.

ℹ️

참고

(브라우저가 아닌) 앱에서 배너 페이지를 로드하기 위해 래퍼/하이브리드 앱에서 스마트 배너를 구현할 때는 이 기능을 사용하지 마십시오. showBanner 를 사용하면 앱 내에 배너가 표시됩니다. 래퍼/하이브리드 앱에 showBanner 를 사용하는 경우 모바일 앱 로드에 hideBanner 를 사용하십시오.

입력 인수

유형이름설명
StringbannerContainerQuery이 메서드가 전달되면, SDK가 이 쿼리로 페이지 내 요소(element)를 찾으려고 시도하고, 이 요소를 배너 배치를 위한 엔트리 포인트(entry point)로 사용합니다. 그렇지 않은 경우 document.body 가 사용됩니다.
IntegerbannerZIndex스마트 배너는 기본적으로 최대 z-지수 값으로 설정되어 있으므로 웹사이트 요소에 의해 숨겨지지 않습니다. 일부 웹 사이트 구성 요소를 배너 상단에 표시하려는 경우 변경할 수 있습니다.
<Key, Value Dictionary>additionalParams전달되면 이러한 키와 값(예를 들어, deep_link_value: apples)이 원링크 URL에 쿼리 파라미터로 추가됩니다.

사용법 예시

  • 파라미터를 원링크 URL에 추가
AF('banners', 'showBanner', { additionalParams: { deep_link_value: "apples", deep_link_sub1: "22", af_adset: "my_adset"}});
  • 이 배너의 Z 인덱스와 해당 배치에 대한 컨테이너 ID를 설정합니다
AF('banners', 'showBanner', { bannerContainerQuery: "#my-container-id"
                              bannerZIndex: 999});

updateParams

Method signature

AF('banners', 'updateParams', { <Key, Value Dictionary> });

설명
배너가 표시된 후 CTA(콜투액션) 버튼에 할당된 원링크 URL에 최대 10개의 파라미터(예를 들어, deep_link_value)를 프로그래밍 방식으로 추가합니다.

입력은 파라미터 키와 값이 있는 객체입니다.

키는 빈 값을 가질 수 없습니다.
키의 이름을 null, NaN, 또는 arg로 지정할 수 없습니다
잘못된 문자:
키: /, \, *, !, @, #, ?, $, %, ^, &, ~, ``, =, +, ', ", ;, :, >, <
값 = \, ;, $, >, <, ^, #, ``

  • 파라미터는 원링크 URL에 쿼리 파라미터로 추가됩니다.
  • updateParams를 사용하여 파라미터를 추가하는 경우, 노출 URL은 클릭 URL과 다릅니다.
  • 추가된 파라미터는 원래의 원링크 URL의 파라미터를 대체하지 않습니다. 추가하는 파라미터가 이미 원링크 URL에 있다면, 변경되지 않습니다.
  • updateParams를 두 번 이상 호출하면 마지막 호출의 파라미터만이 URL에 추가됩니다.

입력 인수

유형이름설명
<Key, Value Dictionary>N/A이러한 키와 값(예를 들어, deep_link_value: apples)이 원링크 URL에 쿼리 파라미터로 추가됩니다.

사용법 예시

  • 파라미터를 원링크 URL에 추가
AF('banners', 'updateParams', { deep_link_value: "new_param", deep_link_sub4: "gg_77", af_ad: "new_ad_param"});

hideBanner

Method signature

AF('banners', 'hideBanner');

설명

)은 페이지에서 표시된 배너(예: 특정 사용자 입력 후)를 프로그래밍 방식으로 제거합니다.

입력 인수

N/A

사용법 예시

  • 배너 숨기기
AF('banners', 'hideBanner');