OneLink Smart Script V2

요약: 자동으로 생성되고 브랜드 웹 사이트의 단추 또는 배너 뒤에 임베드되는 원링크를 사용자 정의합니다.

원링크 스마트 스크립트 소개

원링크 스마트 스크립트는 웹 페이지로 연결되는 수신 URL을 사용하여 앱 스토어로 연결되는 고유한 발신 원링크 URL을 자동으로 생성합니다.

발신 URL은 마케터로부터 받은 인수와 스크립트 입력을 사용하여 생성됩니다. 참고: afParameters 인수는 여러 다른 인수(파라미터)로 구성된 구조를 가지며, 각 인수에는 키, 재정의 값 및 기본 값이 있는 구성 객체가 포함되어 있습니다.

구현 단계

Smart Script를 설정하려면 다음 중 하나를 수행하십시오.

Embed the script in your website

스마트 스크립트 초기화 및 호출 코드는 앱스플라이어 대시보드의 스마트 스크립트 생성기(권장)에서 가져오거나 개발자가 수동으로 가져오고 호출할 수 있습니다.

📘

수신 URL 파라미터 유지

수신 URL 파라미터가 생성된 원링크에 매핑되도록 하려면 페이지에서 원링크가 생성되었는지 여부에 관계없이 모든 웹사이트 페이지에서 Smart Script를 가져오는 것이 좋습니다.

버전 2.5.0부터 사용 가능.

여기서 세부 사항과 전체 예시를 참조하십시오.

스마트 스크립트 생성기에서 생성된 코드 사용

  1. 스크립트, 초기화 코드 및 인수가 포함된 파일을 마케팅 담당자로부터 받으십시오.
  2. Test the script on the Smart Script test page. Ensure the correct outgoing URL is generated.
  3. 스마트 스크립트 결과 테스트 및 사용 지침을 따르십시오.

Github에서 연동 예제를 참고하십시오

스크립트를 수동으로 설정

  1. 스크립트를 다운로드합니다.
  2. 수신 파라미터를 마케팅 담당자의 발신 파라미터에 매핑하는 스크립트를 호출하는 인수를 가져옵니다.
  3. 스마트 스크립트 인수설정 개체를 초기화합니다.
  4. 다음 방법을 사용하여 웹/랜딩 페이지 HTML에서 스크립트를 호출하여 URL을 생성합니다:
var result = window.AF_SMART_SCRIPT.generateOneLinkURL({
  oneLinkURL,
  afParameters,
  referrerSkipList, // optional
  urlSkipList // optional
})
  1. 스마트 스크립트 결과 테스트 및 사용 지침을 따르십시오.

스마트 스크립트 결과 확인 및 사용

  1. 반환 값 확인 result. 가능한 반환 값은 다음을 포함합니다.
    • An outgoing Onelink URL. Use the result value as needed. For example, to place it as a link under a CTA on your website.
    • null. 스크립트가 다음을 반환하는 경우 null, 원하는 오류 흐름을 구현하십시오. 예: 웹/방문 페이지의 기존 URL은 변경되지 않습니다.
      var result_url = "No output from script"
      if (result) {
            result_url = result.clickURL;            
            // Put the generated OneLink URL behind CTA buttons
            document.getElementById('andrd_link').setAttribute('href', result_url);
            document.getElementById('ios_link').setAttribute('href', result_url);
            // Optionally - Create QR code from the generated OneLink URL
            window.AF_SMART_SCRIPT.displayQrCode("my_qr_code_div_id");
            //The size of the QR code is defined in the CSS file under #my_qr_code_div_id
            // #my_qr_code_div_id canvas { 
            //  height: 200px;
            //  width: 200px;
            //}
            // Optionally - fire an impression.
            // The impression will fire to https://impressions.onelink.me//.... 
            setTimeout(() => {
              window.AF_SMART_SCRIPT.fireImpressionsLink();
              console.log("Impression fired"); 
            }, 1000);
      }

Use Google Tag Manager

Google 태그 관리자에서 스마트 스크립트를 설정하는 방법:

  1. Confirm that the marketer followed their instructions and placed the Smart Script code into GTM.
  2. 반환 값 확인 AF_SMART_SCRIPT_RESULT. 가능한 반환 값은 다음을 포함합니다.
    • 발신 원링크 URL. 필요에 따라 결과 값을 사용할 수 있습니다. 예를 들어, 웹 사이트의 CTA 아래에 링크로 배치합니다.
    • null. 스크립트가 다음을 반환하는 경우 null, 원하는 오류 흐름을 구현하십시오. 예: 웹/방문 페이지의 기존 URL은 변경되지 않습니다.
      var result_url = AF_SMART_SCRIPT_RESULT.clickURL;
      if (result_url) {
            document.getElementById('andrd_link').setAttribute('href', result_url);
            document.getElementById('ios_link').setAttribute('href', result_url);
            // Optionally - Create QR code from the generated OneLink URL
            window.AF_SMART_SCRIPT.displayQrCode("my_qr_code_div_id");
            //The size of the QR code is defined in the CSS file under #my_qr_code_div_id
            // #my_qr_code_div_id canvas { 
            //  height: 200px;
            //  width: 200px;
            //}
            // Optionally - fire an impression.
            // The impression will fire to https://impressions.onelink.me//.... 
            setTimeout(() => {
              window.AF_SMART_SCRIPT.fireImpressionsLink();
              console.log("Impression fired"); 
            }, 1000);            
      }
  1. Test the script on the Smart Script test page. Ensure the correct outgoing URL is generated.

Create a QR code with the Smart Script result

전제 조건 : Smart Script V2.6 이상

📘

모범 활용 사례

  • 앱 브랜드에 따라 중앙 로고와 관련 코드 색상으로 QR 코드를 사용자 지정하십시오.
  • 사용자가 데스크톱에 있을 때 QR 코드를 표시하고 사용자가 모바일에 있을 때 링크가 있는 버튼을 표시합니다.

QR 코드 생성 방법:

  1. QR 코드를 호스팅하기 위해 사이트의 HTML 페이지에서 특정 ID를 가진 div 태그를 생성합니다.
    원하는 방식으로 div 태그 스타일을 지정할 수 있습니다.
  2. Smart Script를 실행하고 원링크 URL을 생성한 후 다음 메서드를 호출합니다. displayQrCode

displayQrCode


Method signature

const qrOptions = {
  logo,
  colorCode
}

window.AF_SMART_SCRIPT.displayQrCode(divId, qrOptions)

입력 인수

유형필수적이름설명주석
StringdivIDA div 호스팅하기 위해 사이트의 HTML 페이지에서 특정 ID를 가진 태그를 생성합니다.
Object아니오qrOptions설정 개체(아래 표의 세부 정보 참조)개체가 없으면 기본 색상의 로고가 없이 QR 코드가 생성됩니다.

qrOptions 개체

유형필수적이름설명주석
String아니오logo유효한 이미지 URL 또는 이미지 데이터 URI값이 유효하지 않으면 로고 없이 QR 코드가 생성됩니다.
String아니오colorCodeQR 코드의 16진수 색상값이 유효하지 않으면 코드 색이 기본인 검은색으로 대체됩니다.

사용 예시:

  • 로고가 없고 커스텀 색상이 없는 QR 코드 Github 예시
  • 로고와 커스텀 코드 색상이 있는 QR 코드 Github 예시

Fire an impression

You can fire an impression when a page loads, a CTA or banner displays, etc. Note: Impressions can only be fired on mobile devices; not on desktop.

전제 조건 : 스마트 스크립트 V2.2 이상

노출을 발생시키는 방법:

  1. 지침에 따라 스마트 스크립트를 실행하고 클릭 URL을 생성합니다.
  2. 결과가 유효한지(null이 아닌지) 확인하십시오.
  3. 다음 노출 기능을 실행합니다.

🚧

필수 해결책

통화를 fireImpressionsLink 의 값을 setTimeout 로 마무리하여 다음 통화 사이에 최소 1초의 지연이 있도록 하십시오: generateOneLinkURL and fireImpressionsLink

setTimeout(() => {
  window.AF_SMART_SCRIPT.fireImpressionsLink();
  console.log("Impression fired"); 
}, 1000);

You can find examples for firing impressions for mobile only and for cross platform support

인수

인수 설명
원링크 URL(필수)
  • 원링크 템플릿 도메인 + 템플릿 ID를 제공합니다. 일러두기: 원링크 사용자정의 링크 URL이 아닙니다!
  • yourbrand.onelink.me/A1b2
  • 유명 도메인 예: click.yourbrand.com/A1b2

afParameters

(필수)

 

 

 


mediaSource

(필수)

미디어소스의 설정 개체

  • 키: ['incoming_mediasource’' 'utm_source']
  • 재정의 값: {twitter: 'twitter_int', orig_src: 'new_src'}
  • 기본값: ['any_source']

campaign

캠페인의 설정 개체

  • 키: ['incoming_campaign', 'utm_campaign']
  • 재정의 값: {campaign_name: 'new_campaign_name'}
  • 기본값: ['any_campaign_name']

channel

채널의 설정 개체

  • 키: ['incoming_channel', 'utm_channel']
  • 재정의 값: {video: 'new_video'}
  • 기본값: ['any_video']

ad

광고의 설정 개체

  • 키: ['incoming_ad', 'utm_ad']
  • 재정의 값: {ad_name: 'new_ad_name'}
  • 기본값: ['any_ad_name']
adSet

광고 세트의 설정 개체

  • 키: ['incoming_adset', 'utm_adset']
  • 재정의 값: {'adset_name': 'new_adset_name'}
  • 기본값: ['any_adset_name']
deepLinkValue

deep_link_value 에 대한 설정 개체

  • 키: ['product_id', 'page_name']
  • 재정의 값: {twenty_percent_off: 'thirty_percent_off'}
  • 기본값: 'new_offers_page'
afSub1-5

af_sub[1-5] 에 대한 설정 개체

 
googleClickIdKey

GCLID를 전달하는 파라미터를 호출할 내용을 설명합니다.
일러두기! 앱스플라이어 로데이터 리포트에 표시하려면 파라미터가 af_sub[1-5] 중 하나여야 합니다.

 
기타 (사용자정의) 쿼리 파라미터
  • 어트리뷰션 또는 딥링킹을 위해 송신 원링크 URL에 포함할 다른 파라미터를 해당 설정 개체와 함께 나열합니다.
  • 사용자정의 파라미터의 이름은 개발자에 의해 설정 개체에 paramKey로 나열됩니다.
  • paramKey: 'deep_link_sub1'
  • 키: ['page_id']
  • 재정의 값: {page12: 'new_page12'}
  • 기본값: 'page1'
 
referrerSkipList
특정 클릭(예: Twitter 또는 Meta ads)에 대한 HTTP 리퍼러의 문자열 목록이 발견되면 스마트 스크립트에서 null을 반환합니다. 이런 기능은 클릭이 이미 리포트되는 Twitter 및 Facebook과 같은 SRN에 유용할 수 있습니다.  
urlSkipList 특정 클릭(예: af_r)에 대한 URL의 문자열 목록으로, 발견될 경우 스마트 스크립트가 null을 반환하게 됩니다. null이 기능은 af_r을 포함한 앱스플라이어 어트리뷰션 링크를 사용하여 사용자를 모바일 웹사이트로 리디렉션하고 원래 클릭했던 데이터가 손실되지 않도록 하는 경우에 유용할 수 있습니다.  
webReferrer This argument defines a key in the outgoing URL, which its value will be a copy of the HTTP document.referrer. The referrer is saved in the first page the user lands in, and may be used in any consecutive page in this domain which runs Smart Script with this argument.  

설정 개체

OneLink Smart Script는 인수를 사용하여 수신 URL의 파라미터와 스크립트에 정의된 인수를 기반으로 송신 URL을 생성합니다. afParameters 인수에는 어트리뷰션 및 딥링크에 사용되는 다른 여러 인수(파라미터)로 구성된 구조가 있으며, 각 인수에는 다음 표에 설명된 대로 키, 재정의 값 및 기본값이 있는 설정 개체가 포함됩니다.

인수 설명
keys
  • 문자열 목록
  • 스크립트가 찾는 수신 URL에서 가능한 파라미터 목록이며, 이 값은 송신 URL에 값으로 배치됩니다.
  • 스크립트는 왼쪽에서 오른쪽으로 검색하여 첫 번째 일치에서 중지합니다.
  • 예: ['in_channel', 'utm_channel']
  • 스크립트의 채널 파라미터의 경우 스크립트는 수신 링크에서 in_channel을 검색하고 이 값을 채널 값으로 사용합니다.

overrideValues

  • Dictionary {string: string}
  • 나가는 링크에서 변경하려는 값의 경우 들어오는 URL의 값을 바꾸려는 값과 함께 나열합니다.
  • 이 스크립트는 수신 URL의 파라미터 값을 사용자가 정의한 값으로 바꿉니다. 

예시: {'video': 'video_new'}

스크립트의 채널 파라미터의 경우, 수신 값이 비디오일 때마다 스크립트는 송신 링크에서 video_new로 변경합니다.

defaultValue
  • 문자열
  • "폴백" 값이 무엇이길 원하는지 설명하십시오.
  • 키 목록에서 파라미터를 찾을 수 없는 경우 송신 URL에 defaultValue 값이 사용됩니다.
  • 비어 있는 키 목록을 전달하여 기본값을 강제 실행할 수 있습니다.

예: ['web_video']

스크립트에서 채널 파라미터의 경우 in_channel 파라미터를 찾을 수 없으면 web_video가 채널 값으로 사용됩니다.

예시

Basic attribution

media_source 및 캠페인에 대한 단일 키를 사용하여 수신 URL을 발신 원링크 URL로 기본 변환하는 방법을 보여주는 를 참조하십시오.

Multiple keys

media_source 및 캠페인에 대한 다중 키를 사용하여 수신 URL을 발신 원링크 URL로 변환하는 방법을 보여주는 를 참조하십시오.

UTM parameters

media_source 및 캠페인에 대한 UTM 파라미터를 사용하여 수신 URL을 발신 원링크 URL로 변환하는 방법을 보여주는 를 참조하십시오.

Override values

송신 media_source 값을 대체하여 수신 URL을 발신 원링크 URL로 변환하는 방법을 보여주는 를 참조하십시오.

Default values

수신 media_source 값을 찾을 수 없을 때 기본값을 사용하여 수신 URL을 발신 원링크 URL로 변환하는 방법을 보여주는 를 참조하십시오.

Forced default values

수신 media_source 값을 찾은 때에도 기본값을 사용하여 수신 URL을 발신 원링크 URL로 변환하는 방법을 보여주는 를 참조하십시오.

Google click ID passthrough to af_sub

수신 URL을 Google 클릭 ID를 af_sub4에 전달하는 발신 원링크 URL로 변환하는 것을 보여주는 를 참조하십시오. 참고: GCLID가 발견되면 스크립트는 수신 파라미터 키워드를 찾고 키워드 값을 af_keywords 값으로 발신 URL에 넣습니다.

Facebook click ID passthrough to af_sub

수신 URL을 Facebook 클릭 ID를 af_sub2에 전달하는 발신 원링크 URL로 변환하는 것을 보여주는 를 참조하십시오.

Set attribution and OneLink parameters

앱스플라이어 어트리뷰션 및 원링크 파라미터를 사용하여 수신 URL을 발신 원링크 URL로 변환하는 방법을 보여주는 를 참조하십시오.

Set additional custom parameters

수신 URL을 추가 사용자 정의 파라미터(용 af_prt 파라미터 포함)가 있는 발신 원링크 URL로 변환하는 것을 보여주는 를 참조하십시오.

Referrer skip list

건너뛰기 목록을 만들어 특정 클릭(예: Twitter 또는 메타 광고)에 대한 스마트 스크립트를 비활성화하는 것을 보여주는 를 참조하십시오. 건너뛰기 목록의 문자열이 클릭의 HTTP 리퍼러에 나타나면 스마트 스크립트는 다음을 반환합니다. null.

URL skip list

URL의 특정 문자열에 대해 스마트 스크립트를 사용하지 않도록 설정하는 방법에 대한 를 참조하십시오(예를 들어, af_r) 건너뛰기 목록을 생성. 건너뛰기 목록의 문자열이 클릭 URL에 나타나면 스마트 스크립트는 다음을 반환합니다. null.

Smart Script set up with Google Tag Manager

Google Tag Manager를 사용하여 설정된 원링크 스마트 스크립트를 사용하여 수신 URL을 발신 원링크 URL로 변환하는 를 참조하십시오.

Impressions - OneLink Template with mobile-only support

모바일 디바이스에만 있는 원링크 템플릿을 사용하여 생성된 노출의 예시를 참조하십시오.

🚧

필수 해결책

통화를 fireImpressionsLink 의 값을 setTimeout 로 마무리하여 다음 통화 사이에 최소 1초의 지연이 있도록 하십시오: generateOneLinkURL and fireImpressionsLink

Impressions - OneLink Template with Cross-platform support

크로스 플랫폼 지원 기능을 포함한 원링크 템플릿을 사용하여 생성된 노출의 예시를 참조하십시오.
비모바일 플랫폼(예: 데스크톱 또는 콘솔)에서 생성된 노출의 예시를 참조하십시오.

📘

Firing an impression from a cross platform landing page

You can find here a code example for firing an impression from a demo landing page

🚧

필수 해결책

통화를 fireImpressionsLink 의 값을 setTimeout 로 마무리하여 다음 통화 사이에 최소 1초의 지연이 있도록 하십시오: generateOneLinkURL and fireImpressionsLink

Preserve incoming URL parameters across pages

📘

버전 2.5.0부터 사용 가능.

랜딩 페이지의 수신 파라미터(예: utm_source)는 기본적으로 웹 사이트의 다른 페이지로 전달되지 않습니다.
모든 웹 사이트 페이지에서 Smart Script를 가져오면 수신 URL 파라미터가 유지되고 Smart Script는 다른 페이지에서 사용할 수 있습니다.

여기에서 이 사용 사례의 를 찾아볼 수 있습니다.

Copy HTTP referrer to outgoing URL

📘

Available from version 2.7.0.

This example demonstrates how to copy the HTTP document.referrer to a key defined by webReferrerin the outgoing URL. The referrer is saved in the first page of the website the user lands in, and may be used in any consecutive page in this domain which runs Smart Script with this argument.