OneLink Smart Script V2 설정

요약: 원링크 스마트 스크립트를 설정하여 모든 소스에서 온 모바일 웹 사이트 방문자를 모바일 앱 사용자로 전환하고 어트리뷰트합니다.

7901_Smart_Script_flow_1920x1080_2__1_.png

 관련 자료

스마트 배너로 작업하는 것을 완전히 이해하려면 다음 문서를 확인하십시오.

설정

OneLink Smart Script는 두 가지 버전이 있습니다.

OneLink Smart Script V2(권장 버전): OneLink Smart Script를 처음 설정하는 경우 이 버전이 사용하기 좋은 버전입니다. 개발자 지원 없이 앱스플라이어 UI에서 생성할 수 있습니다. 어떤 이유로 개발자가 필요한 경우 작업 부분이 더 쉽습니다. 또한 Google 태그 관리자를 사용하여 설정할 수도 있습니다. 개발자 지침 참조

OneLink Smart Script V1(레거시): Onelink Smart Script를 이미 설정한 경우 이 버전의 설명서를 사용하여 이 스크립트를 유지 관리하고 편집하십시오. 일러두기: 필수 사항은 아니지만 V2로의 마이그레이션을 고려해 보십시오. 

 일러두기

문서 또는 스크립트가 업데이트될 때 알림을 받으려면 문서 머리글에서 팔로우 단추를 클릭합니다.

OneLink Smart Script 설정

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

  • 웹사이트에 스크립트를 내장합니다.
  • Google Tag Manager를 사용합니다.

직무별 작업

  • 광고주:
    • 수신 URL을 처리하는 스크립트의 인수를 기반으로 발신 URL에 포함할 내용을 결정합니다. 이를 통해 수신 URL을 조작하거나 특정 값을 강제 적용하여 송신 URL에 추가되는 어트리뷰션 및 딥링킹 데이터를 결정합니다.

    • 앱스플라이어 UI에서 스마트 스크립트를 생성합니다. 

    • 모바일 웹 사이트로 연결되는 모든 캠페인에 스크립트가 작동하는 파라미터를 포함한 들어오는 URL이 있는지 확인합니다.
    • 스마트 스크립트를 테스트합니다
  • 웹 개발사:
    • 스크립트가 작동하려는 모바일 사이트/페이지에서 실행되는지 확인합니다.
    • 예를 들어 웹 사이트의 CTA 아래에 링크로 배치하기 위해 결과 값을 필요에 따라 사용합니다.
    • 스크립트를 사용하여 QR 코드를 생성하는 데 필요할 수 있습니다.
    • 스크립트에 고급 인수를 수동으로 추가하는 데 필요할 수 있습니다.

선행 조건

작업 범위

OneLink Smart Script 설정 방법:

  1. 앱스플라이어에서 경험 및 딥링킹 > 웹-투-앱 > 스마트 스크립트로 이동합니다.
  2. 스크립트의 기반이 될 원링크 템플릿을 선택하십시오. 템플릿에는 기본 리디렉션 설정이 포함되어 있습니다.
  3. 발신 URL에 포함되어야 하는 파라미터를 매핑합니다. 이러한 파라미터는 수신 URL의 파라미터에 기반합니다. 참고: 미디어 소스(pid) 파라미터는 필수입니다.
    1. 매핑할 발신 파라미터/기준을 선택합니다.
      종종 이것은 변경할 수 없는 앱스플라이어 파라미터 이름이지만 어떤 경우에는 사용자의 파라미터 이름을 입력해야 합니다.
    2. 다음 중 하나를 기반으로 발신 파라미터의 값을 결정하고 구성합니다.
      • 수신 URL 파라미터: 발신 URL 파라미터로 대체할 하나 이상의 가능한 수신 URL 파라미터를 나열합니다. 수신 URL 파라미터의 값은 발신 URL 파라미터의 값이 됩니다.
        • 예: any_param_name, utm_param_name. 수신 URL에 utm_param_name이 있는 경우 값이 선택한 발신 URL 파라미터의 값으로 사용됩니다.
        • 스마트 스크립트는 파라미터 목록을 왼쪽에서 오른쪽으로 검색하고 첫 번째 일치 항목을 발신 파라미터 URL에 매핑합니다.
        • 개발자는 이 파라미터 목록을 키로 참조합니다.
      • 기본값: 수신 URL 파라미터를 찾을 수 없거나 수신 URL 파라미터를 나열하지 않은 경우 발신 파라미터 값에 대해 원하는 기본값을 입력합니다.
        • 예: 발신 파라미터의 경우 수신 URL 파라미터가 any_paramname, utm_paramname을 나열하는 경우 목록에 파라미터가 모두 없으면 기본값이 발신 파라미터 값으로 사용됩니다.
      • 값 재정의: 대체할 발신 URL 값과 함께 수신 URL에서 값을 하나 이상 구성합니다.
        • 예: 캠페인 파라미터의 경우 수신 URL의 값이 campaign_name이면 발신 URL의 값을 new_campaign_name으로 변경할 수 있습니다.
    3. [선택 사항] + 새 파라미터를 클릭하여 추가 파라미터를 매핑합니다. 사용할 수 있는 모든 추가 인수 (파라미터 구성)를 참조하십시오.
  4. 웹사이트에서 스마트 스크립트를 구현하는 방법을 선택하십시오.
    • 웹사이트에 스크립트를 내장합니다.
    • Google Tag Manager를 사용합니다.
  5. 생성을 클릭합니다.
  6. 스크립트 다운로드를 클릭합니다.
  7. 웹사이트에 스크립트를 포함하도록 선택한 경우: 웹 개발자에게 스크립트를 보내 구현하고 생성된 발신 URL로 수행할 작업을 알려줍니다. 예를 들어 모바일 사이트의 CTA 버튼 아래에 배치하거나 데스크톱 사이트에 QR 코드를 제시합니다. 개발자 지침
  8. Google 태그 관리자를 사용하도록 선택한 경우:
    1. Google 태그 관리자에서 새 태그를 만들고 태그 이름을 지정하고 태그 설정을 클릭하고 커스텀 HTML을 선택합니다.
    2. HTML 상자에 생성된 스마트 스크립트 코드를 붙여넣습니다.
    3. 트리거를 클릭하고 새 트리거를 만들고 이름을 지정한 다음 트리거 설정(예: 모든 페이지 보기)을 선택합니다. 자세한 내용은 GTM 문서를 참조하십시오
    4. 저장을 클릭합니다.
    5. 웹 개발자에게 생성된 발신 URL로 수행할 작업을 알려주십시오. 예를 들어 모바일 사이트의 CTA 버튼 아래에 배치하거나 데스크톱 사이트에 QR 코드를 제시합니다. 개발자 지침
  9. 스마트 스크립트 테스트 페이지에서 스크립트를 테스트합니다. 올바른 발신 URL이 생성되었는지 확인하십시오.

중요! 스크립트를 업데이트할 때마다 다시 구현해야 합니다.

인수 구조

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

인수 설명
수신 URL 파라미터(개발자가 키로 참조)
  • 문자열 목록
  • 스크립트가 찾는 수신 URL에서 가능한 파라미터 목록이며, 이 값은 송신 URL에 값으로 배치됩니다.
  • 스크립트는 왼쪽에서 오른쪽으로 검색하여 첫 번째 일치에서 중지합니다.
  • 예: ['in_channel', 'utm_channel']
  • 스크립트의 채널 파라미터의 경우 스크립트는 수신 링크에서 in_channel을 검색하고 이 값을 채널 값으로 사용합니다.
기본값
  • 문자열
  • "폴백" 값이 무엇이길 원하는지 설명하십시오.
  • 키 목록에서 파라미터를 찾을 수 없는 경우 송신 URL에 defaultValue 값이 사용됩니다.
  • 비어 있는 키 목록을 전달하여 기본값을 강제 실행할 수 있습니다.

예: ['web_video']

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

재정의 값

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

예: {'video': 'video_new'}

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

설정 개체 

인수

OneLink Smart Script는 인수를 사용하여 수신 URL의 파라미터와 스크립트에 정의된 인수를 기반으로 송신 URL을 생성합니다.

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

afParameters

(필수)

 

 

 


mediaSource

(필수)

  • 미디어소스의 설정 개체.
  • 예:
    • 키: ['incoming_mediasource’' 'utm_source']
    • 기본값: ['any_source']
    • 재정의 값: {twitter: 'twitter_int', orig_src: 'new_src'}

키:

기본값:

재정의 값:

campaign

  • 캠페인의 설정 개체.
  • 예:
    • 키: ['incoming_campaign', 'utm_campaign']
    • 기본값: ['any_campaign_name']
    • 재정의 값: {campaign_name: 'new_campaign_name'}

키:

기본값:

재정의 값:

channel

  • 채널의 설정 개체.
  • 예:
    • 키: ['incoming_channel', 'utm_channel']
    • 기본값: ['any_video']
    • 재정의 값: {video: 'new_video'}

키:

기본값:

재정의 값:

ad

  • 광고의 설정 개체.
  • 예:
    • 키: ['incoming_ad', 'utm_ad']
    • 기본값: ['any_ad_name']
    • 재정의 값: {ad_name: 'new_ad_name'}

키:

기본값:

재정의 값:

adSet
  • 광고 세트의 설정 개체.
  • 예:
    • 키: ['incoming_adset', 'utm_adset']
    • 기본값: ['any_ad_name']
    • 재정의 값: {adset_name: 'new_adset_name'}

키:

기본값:

재정의 값:

deepLinkValue
  • deep_link_value의 설정 개체.
  • 예:
    • 키: ['product_id', 'page_name']
    • 기본값: 'new_offers_page'
    • 재정의 값: {twenty_percent_off: 'thirty_percent_off'}

키:

기본값:

재정의 값:

afSub1-5

af_sub[1-5]의 설정 개체.

키:

기본값:

재정의 값:

googleClickIdKey

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

 
기타 (사용자정의) 쿼리 파라미터
  • 어트리뷰션 또는 딥링킹을 위해 송신 OneLink URL에 포함할 다른 파라미터를 해당 설정 개체와 함께 나열합니다.
  • 사용자정의 파라미터의 이름은 개발자에 의해 설정 개체에 paramKey로 나열됩니다.
  • 예:
    • paramKey: 'deep_link_sub1'
    • 키: ['page_id']
    • 기본값: 'page1'
    • 재정의 값: {page12: 'new_page12'}

파라미터 키:

키:

기본값:

재정의 값:

스마트 스크립트를 구현하기 위한 인수(파라미터 및 값)

고급 인수

다음 표는 기술에 정통한 마케터 또는 개발자가 스마트 스크립트에서 구현할 수 있는 인수를 설명합니다. 

인수 설명 응답 기록(사용자 또는 사용자의 개발자가 사용)
 
referrerSkipList
  • 특정 클릭(예를 들어 Twitter 또는 Facebook)에 대한 HTTP 레퍼러의 문자열 목록으로, 발견될 경우 스마트 스크립트가 null을 반환합니다. 이 기능은 이미 클릭이 보고된 Twitter 및 Facebook과 같은 SRN에 유용할 수 있습니다.
  • 이 인수를 구현하면 스크립트가 원링크 URL을 생성하지 않습니다.

 

urlSkipList
  • 특정 클릭(예: af_r)에 대한 URL의 문자열 목록으로, 발견될 경우 스마트 스크립트가 null을 반환하게 됩니다. 이 기능은 af_r을 포함한 앱스플라이어 어트리뷰션 링크를 사용하여 사용자를 모바일 웹사이트로 리디렉션하고 원래 클릭했던 데이터가 손실되지 않도록 하는 경우에 유용할 수 있습니다.
  • 이 인수를 구현하면 스크립트가 원링크 URL을 생성하지 않습니다.

 

스마트 스크립트를 구현하기 위한 고급 인수(파라미터 및 값)

활용 사례

다음 섹션에서는 일반적인 캠페인/미디어소스 시나리오에서 스마트 스크립트 사용 사례를 제공합니다.

UTM 매개변수

UTM 파라미터에 대한 스크립트를 설정하는 방법:

  1. 수신 URL(예: utm_sourceutm_campaign)에 UTM 파라미터 목록을 작성하고 이를 송신 URL의 파라미터(예: media_sourcecampaign)와 일치시키십시오. 
  2. 웹 개발자에 대한 인수 목록에 제공하십시오.

결과: 수신 파라미터의 값(utm_sourceutm_campaign)은 전송 링크의 (media_sourcecampaign) 파라미터 값을 채우는 데 사용됩니다. 

Google Ads GCLID

Google Ads 캠페인의 일반적인 인스톨 어트리뷰션 프로세스(GCLID 파라미터를 사용)에서는 광고를 클릭한 사용자를 앱의 스토어 페이지 URL로 리디렉션해야 합니다.

이 경우 Google 광고에서 웹/랜딩 페이지로 리드를 리디렉션하므로 스크립트는 Google 광고 인스톨 캠페인 URL에서 GCLID 파라미터를 가져와서 출력 파라미터 af_sub[1-5]를 선택할 때 나가는 URL에 넣습니다.

일러두기!

  • 이것은 인스톨 캠페인에 적용됩니다. 리인게이지먼트 캠페인을 의미하는 비 ACI 검색 캠페인의 경우 스마트 스크립트 출력에도 불구하고 Google이 미디어소스로 어트리뷰트될 수 있습니다. 
  • GCLID를 찾은 경우, 스크립트는 들어오는 파라미터 키워드를 찾습니다. 찾은 경우 키워드 값을 출력 URL에 af_keywords 값으로 넣습니다.

전제 조건Google 대시보드에서, 자동 태깅을 활성화합니다.
자동 태깅이 활성화된 상태에서, URL은 GCLID 파라미터를 포함합니다.

Google Ads GCLID에 대한 스크립트를 설정하는 방법:

  1. 나가는 URL에서 GCLID를 포함할 파라미터를 선택합니다.
    모범 사례: 데이터가 앱스플라이어 로데이터 리포트에 표시되도록 af_sub[1-5]를 선택합니다.
  2. 인수 목록을 웹 개발자에게 제공하십시오.

결과: 출력 URL에서 GCLID는 af_sub [1-5] 파라미터의 값입니다.

이러한 인스톨에 대해 Google 광고에 알리는 방법:

  1. 각 인스톨에 대해 CSV 또는 푸시 API를 통해 실시간으로 파라미터 af_sub[1-5]에서 GCLID 데이터를 가져옵니다.
  2. 수동으로 또는 Google Ads API를 통해 GCLID 데이터를 Google에 업로드합니다.

 일러두기

GCLID 솔루션은 구글이 공식적으로 지원하거나 권고하지 않습니다. 구글이 GCLID 파라미터를 삭제하는 경우, 앱스플라이어는 그에 따라 스크립트를 변경하겠습니다. 이 문서 헤더 부분 왼쪽에서 팔로우버튼을 클릭하여 이 문서를 팔로우하면 이 문서나 첨부 스크립트가 업데이트할 때 알림을 받으실 수 있습니다.

Facebook 클릭 ID

Facebook Ads는 클릭 ID를 전달합니다. 이 ID를 앱스플라이어의 로데이터에서 사용할 수 있도록 하려면 Facebook 클릭 ID를 선택한 출력 파라미터 af_sub[1-5]에 입력하십시오.

Facebook 클릭 ID를 설정하는 방법:

  1. 나가는 URL에서 Facebook 클릭 ID를 포함할 파라미터를 선택합니다.
    모범 사례: 데이터가 앱스플라이어 로데이터 리포트에 표시되도록 af_sub[1-5]를 선택합니다.
  2. 인수 목록을 웹 개발자에게 제공하십시오.

결과: 출력 URL에서 Facebook 클릭 ID는 af_sub [1-5] 파라미터의 값입니다.

SRN, 온드 미디어 및 기타 미디어소스 링크

스냅챗이나 트위터 같은 SRN은 Google 광고나 Facebook 같은 크로스 플랫폼과는 다르게 작동합니다. SRN에서 집행하는 캠페인으로부터 사용자가 웹/랜딩 페이지로 유입되면 앱을 실제로 설치한 사용자가 아니라 광고를 클릭해서 랜딩 페이지까지만 도달한 사람 기준으로 광고비가 발생합니다. 

이러한 SRN의 경우 스크립트 설정은 온드 미디어 또는 사용할 수 있는 다른 미디어소스의 링크에 대한 설정과 동일합니다. 

스크립트 설정 방법:

  1. 들어오는 링크에 있는 미디어소스 및 캠페인의 파라미터 이름 목록을 만듭니다.
  2.   인수 목록의 값을 웹 개발사에 제공합니다.
    SRN/미디어소스 유형은 들어오는 URL의 미디어소스 값이어야 하며 스크립트는 이 값을 찾아 웹/랜딩 페이지의 다운로드 버튼 뒤에 있는 나가는 원링크 URL에서 media_source 값으로 사용합니다. 송신 media_source를 변경하려면 웹 개발자에게 제공하는 인수 목록에서 수신 media_source 값과 재정의 media_source 값을 제공하십시오.

결과: 이러한 SRN/미디어소스의 경우 미디어소스의 값과 들어오는 링크의 캠페인 파라미터는 나가는 링크의 media_sourcecampaign 파라미터의 값을 채우는 데 사용됩니다. 

 예시

수신 URL: https://hotel.me/incoming_mediasource=twitter&incoming_campaign=big_social

나가는 URL: https://hotel.onelink.me/Ac4G?pid=twitter&c=big_social

앱스플라이어 어트리뷰션 링크

앱스플라이어 어트리뷰션 링크는 미디어소스가 클릭 광고 네트워크일 때 사용할 수 있습니다. 앱스플라이어에서 이러한 링크를 설정할 때 웹 캠페인-앱 어트리뷰트를 위해 원하는 URL 경로가 포함된 리디렉션 URL 경로(af_r) 파라미터를 모바일 웹사이트에 추가할 수 있습니다. 스크립트가 발신 원링크 URL을 생성하지 않도록 할 수 있으며, 그러면 기존 클릭에 의한 데이터의 일부가 손실될 수 있습니다.

조치: urlSkipList 인수를 사용하여 af_r 파라미터를 기재합니다.

결과: 스마트 스크립트가 들어오는 링크에서 af_r 파라미터를 찾으면 스마트 스크립트는 나가는 URL을 생성하지 않으며 개발자는 나가는 URL로 배치할 링크를 결정하고 구현해야 합니다.

 예시

들어오는 URL: https://app.appsflyer.com/id123456789?pid=click_ad_network_int&c=orlando&af_r=hotel.me

나가는 URL: 나가는 URL은 없습니다.

데스크톱

이 문서에 나오는 사용 사례는 모바일 기기를 사용하는 사용자입니다. 따라서 모바일 웹 사이트에서 앱 스토어로 안내되면 즉시 앱을 다운로드할 수 있습니다.

그러나 데스크톱 사용자는 기기(데스크톱 또는 랩톱)가 모바일 앱 다운로드와 호환되지 않으므로 앱 스토어로 즉시 전송되지 않습니다. 

데스크톱 사용자용 스크립트 설정 방법:

  • 원링크 템플릿의 경우 데스크톱에서 링크를 클릭하면 대상 URL을 설정합니다. URL은 전용 웹/랜딩 페이지로 리디렉션되어야 합니다. 랜딩 페이지에는 세부 정보를 입력하여 SMS 또는 앱을 다운로드할 수 있는 링크가 포함된 이메일을 받을 수 있는 웹 양식이 포함될 수 있습니다. 스크립트에서 웹 양식을 사용하고 앱 다운로드 링크를 전송하는 것은 선택사항입니다. 

결과: 이 스크립트는 사용자가 사용하는 기기 또는 플랫폼을 감지합니다. 데스크톱인 경우 스크립트는 사용자를 전용 웹/랜딩 페이지로 리디렉션하는 나가는 원링크 URL을 생성합니다.

데스크톱 투 앱 전환을 참조하십시오.

에이전시

인스톨은 af_prt 파라미터를 사용하는 에이전시로 어트리뷰트됩니다.

원링크 스마트 스크립트를 사용하여 이 어트리뷰션 파라미터를 추가하려면 개발자에게 다음 지침을 따르라고 지시하십시오.  

결과: 스크립트는 들어오는 URL에서 에이전시 이름을 가진 추가 파라미터를 감지하고 나가는 URL에 af_prt 파라미터를 추가합니다.

 예시

수신 URL: https://hotel.me/incoming_campaign=gogo&incoming_media_source=email&partner_name=bigagency

나가는 URL: https://hotel.me/pid=email&c=gogo&af_prt=agency

QR 코드

스마트 스크립트는 링크가 있는 버튼 대신 웹 페이지에 QR 코드를 표시합니다. 

QR 코드를 표시하는 방법:

  1. 스마트 스크립트를 설정할 때 Smart Script 2.1 이상을 사용해야 합니다.
  2. 개발자에게 스마트 스크립트 결과를 사용하여 QR 코드를 작성하려면 해당 지시사항을 따르도록 하십시오.
  3. 모범 사례: 개발자에게 사용자가 데스크탑을 사용할 때 QR 코드를 표시하고 사용자가 모바일을 사용할 때 링크가 있는 버튼을 표시하도록 하십시오. 

결과: 스크립트는 URL을 가지고 있는 버튼 대신 QR 코드를 표시합니다. 일러두기: 스마트 스크립트를 통해 생성된 QR 코드는 사용자 정의할 수 없습니다.

 예시

들어오는 URL:

https://hotel.me/qr_code.html?incmp=gogo&inmedia=email

나가는 URL:

https://hotel.onelink.me/LtRd/?af_js_web=true&af_ss_ver=2_1_0&pid=email&c=gogo

나가는 QR 코드:

노출

원링크 스마트 스크립트를 사용하여 웹사이트의 노출수를 계산할 수 있습니다. 그렇게 하려면 개발자가 노출 함수를 호출해야 합니다 . 그런 다음 인스톨은 뷰-쓰루 어트리뷰션을 통해 노출에 어트리뷰트합니다.

일러두기:

  • 노출수 계산은 클릭수를 계산하는 일반 스마트 스크립트 생성 URL에 추가됩니다. 스마트 스크립트를 사용하여 클릭수, 노출수 또는 둘 다를 계산할 수 있습니다.
  • 스마트 스크립트를 통한 조회연결 어트리뷰션은 모바일 장치에서만 작동합니다. 데스크탑이 아닙니다.

이러한 노출에 대한 신규 인스톨 기여도(뷰-쓰루 어트리뷰션): 

  1. 스마트 스크립트를 설정할 때 Smart Script 2.2 이상을 사용해야 합니다.
  2. 개발자에게 스마트 스크립트에서 노출 함수를 호출하도록 지시하십시오.
  3. 뷰-쓰루 어트리뷰션이 켜져 있는지 확인하십시오.
  4. [선택 사항] 기본 1일 조회수 전환 확인 기간 값을 변경하려면 귀하 또는 귀하의 개발자가 af_viewthrough_lookback 파라미터를 새 값으로 추가해야 합니다. 예를 들어, af_viewthrough_lookback=1d 입니다.
도움이 되었습니까?

댓글

댓글 0개

댓글을 남기려면 로그인하세요.