OneLink Smart Script V2 설정

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

설정

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

OneLink Smart Script V2(권장 버전): OneLink Smart Script를 처음 설정하는 경우 이 버전이 사용하기 좋은 버전입니다. 개발자 작업 부분이 더 쉬우며 Google Tag Manager를 사용하여 설정할 수도 있습니다. 개발자 지침 참조

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

일러두기

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

OneLink Smart Script 설정

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

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

작업 범위
직무별 작업 광고주: 수신 URL을 처리하는 스크립트의 설정 개체 및 인수를 기반으로 송신 URL을 결정합니다. 이를 통해 수신 URL을 조작하거나 특정 값을 강제 적용하여 송신 URL에 추가되는 어트리뷰션 및 딥링킹 데이터를 결정합니다. 모바일 웹 사이트로 연결되는 모든 캠페인에 스크립트가 작동하는 파라미터를 포함한 들어오는 URL이 있는지 확인합니다. 웹 개발사: 웹 사이트 또는 특정 페이지에 스크립트를 내장합니다. 스크립트를 초기화하도록 데이터를 구성하고 마케터가 제공한 수신 URL 파라미터를 기반으로 발신 OneLink URL을 생성하는 데 필요한 인수(파라미터 및 값)를 입력합니다. 여기에는 필수 및 선택적 파라미터가 포함됩니다.
선행 조건 최소 한 개 이상의 앱이 등록된 앱스플라이어 계정 원링크 템플릿은 OneLinkURL 파라미터의 값으로 사용됩니다.

웹 페이지에서 스크립트를 내장하는 방법:

자동으로 생성된 나가는 원링크 URL에 포함할 파라미터와 값을 결정합니다. 사용할 수 있는 인수를 참조하십시오.
- 수신 URL을 가진 모든 캠페인은 스크립트가 작동하는 파라미터(예: 송신 URL에 미디어소스 파라미터로 배치할 수 있음)를 가지고 있는지 확인하십시오.
- 각 파라미터에 대해 키, 재정의 값 및 기본값을 포함할 수 있는 설정 개체를 입력해야 합니다.
웹 개발자에게 인수를 제공합니다.
개발사에 개발 지침을 따르고 스크립트를 구현하여 올바른 나가는 링크를 생성하도록 지시합니다.

작업 범위
직무별 작업 광고주: 면책사항: 광고주는 자바스크립트에서 스크립트를 구성하고 초기화하도록 코딩하는 방법을 알려야 합니다. 그렇지 않으면 개발자가 있어야 합니다. 수신 URL을 처리하는 스크립트의 설정 개체 및 인수를 기반으로 송신 URL을 결정합니다. 이를 통해 수신 URL을 조작하거나 특정 값을 강제 적용하여 송신 URL에 추가되는 어트리뷰션 및 딥링킹 데이터를 결정합니다. 스크립트를 초기화하도록 데이터를 구성하고 마케터가 제공한 수신 URL 파라미터를 기반으로 발신 OneLink URL을 생성하는 데 필요한 인수(파라미터 및 값)를 입력합니다. 여기에는 필수 및 선택적 파라미터가 포함됩니다. 이를 위해서는 개발자 지원이 필요할 수 있습니다. Google Tag Manager에 스마트 스크립트 코드 및 초기화 코드를 입력합니다. 모바일 웹 사이트로 연결되는 모든 캠페인에 스크립트가 작동하는 파라미터를 포함한 들어오는 URL이 있는지 확인합니다. 웹 개발사: 초기화 코드가 결과를 반환하고 필요에 따라 결과를 사용하는지 확인합니다. 예를 들어, 웹 사이트의 CTA 아래에 링크로 배치합니다.
선행 조건 최소 한 개 이상의 앱이 등록된 앱스플라이어 계정 웹 사이트에 연동된 A Google Tag Manager 계정. 원링크 템플릿은 OneLinkURL 파라미터의 값으로 사용됩니다.

웹 페이지에서 스크립트를 구현하는 방법:

Google Tag Manager에서 새 태그를 작성합니다.
태그 이름을 지정하고 태그 설정을 클릭하여 사용자정의 HTML을 선택합니다.
HTML 상자에서 다음을 수행합니다.
1. 원링크 스마트 스크립트 코드를 붙여넣습니다.
2. 스마트 스크립트 코드를 붙여넣은 다음에 스마트 스크립트 초기화 코드를 인수 및 설정 오브젝트와 함께 추가하십시오. 초기화 코드 예시를 참조하십시오.
3. 다음 코드 라인을 바꿉니다.
```
var result = window.AF_SMART_SCRIPT.generateOneLinkURL({
```
  다음으로 바꾸면 됩니다.
```
AF_SMART_SCRIPT_RESULT = window.AF_SMART_SCRIPT.generateOneLinkURL({
```
4. [선택사항] 코드 뒤에 URL을 가진 버튼 대신 QR 코드를 표시하려는 경우:
```
var result_url = result.clickURL;
      if (result_url) {
            document.getElementById('output_url').innerHTML = result_url;
```
  다음을 입력하십시오.
```
window.AF_SMART_SCRIPT.displayQrCode("my_qr_code_div_id");
```
5. 모든 코드를 <script></script> 태그 안에 넣으십시오.
상단 우측 모서리에 있는 저장 버튼을 클릭합니다.
개발자에게 GTM를 위한 OneLink Smart Script 지시 사항을 따르도록 하십시오.

설정 개체

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

설정 개체
인수	설명	예
키	문자열 목록 스크립트가 찾는 수신 URL에서 가능한 파라미터 목록이며, 이 값은 송신 URL에 값으로 배치됩니다. 스크립트는 왼쪽에서 오른쪽으로 검색하여 첫 번째 일치에서 중지합니다.	예: ['in_channel', 'utm_channel'] 스크립트의 채널 파라미터의 경우 스크립트는 수신 링크에서 in_channel을 검색하고 이 값을 채널 값으로 사용합니다.
overrideValues	사전 {string: string} 나가는 링크에서 변경하려는 값의 경우 들어오는 URL의 값을 바꾸려는 값과 함께 나열합니다. 이 스크립트는 수신 URL의 파라미터 값을 사용자가 정의한 값으로 바꿉니다.	예: {'video': 'video_new'} 스크립트의 채널 파라미터의 경우, 수신 값이 비디오일 때마다 스크립트는 송신 링크에서 video_new로 변경합니다.
defaultValue	문자열 "폴백" 값이 무엇이길 원하는지 설명하십시오. 키 목록에서 파라미터를 찾을 수 없는 경우 송신 URL에 defaultValue 값이 사용됩니다. 비어 있는 키 목록을 전달하여 기본값을 강제 실행할 수 있습니다.	예: ['web_video'] 스크립트에서 채널 파라미터의 경우 in_channel 파라미터를 찾을 수 없으면 web_video가 채널 값으로 사용됩니다.

인수

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

Smart Script를 구현하기 위해 개발자에게 제공되는 인수(파라미터 및 값)
인수		설명	응답(개발자가 사용할) 기록
원링크 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'} 기본값: 'ten_percent_off'
	afSub1-5	af_sub[1-5]의 설정 개체.	키: 재정의 값: 기본값:
	googleClickIdKey	GCLID를 전달하는 파라미터를 호출할 내용을 설명합니다. 중요! 앱스플라이어 로데이터 리포트에 표시하려면 파라미터가 af_sub[1-5] 중 하나여야 합니다.
	기타 (사용자정의) 쿼리 파라미터	어트리뷰션 또는 딥링킹을 위해 송신 OneLink URL에 포함할 다른 파라미터를 해당 설정 개체와 함께 나열합니다. 사용자정의 파라미터의 이름은 개발자에 의해 설정 개체에 paramKey로 나열됩니다. 예: paramKey: 'deep_link_sub1' 키: ['page_id'] 재정의 값: {page12: 'new_page12'} 기본값: 'page1'	파라미터 키: 키: 재정의 값: 기본값:
referrerSkipList		특정 클릭(예를 들어 Twitter 또는 Facebook)에 대한 HTTP 레퍼러의 문자열 목록으로, 발견될 경우 스마트 스크립트가 `null`을 반환합니다. 이 기능은 이미 클릭이 보고된 Twitter 및 Facebook과 같은 SRN에 유용할 수 있습니다.
urlSkipList		특정 클릭(예: af_r)에 대한 URL의 문자열 목록으로, 발견될 경우 스마트 스크립트가 `null`을 반환하게 됩니다. 이 기능은 af_r을 포함한 앱스플라이어 어트리뷰션 링크를 사용하여 사용자를 모바일 웹사이트로 리디렉션하고 원래 클릭했던 데이터가 손실되지 않도록 하는 경우에 유용할 수 있습니다.

활용 사례

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

UTM 매개변수

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

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

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

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에 대한 스크립트를 설정하는 방법:

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

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

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

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

일러두기

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

Facebook 클릭 ID

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

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

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

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

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

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

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

스크립트 설정 방법:

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

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

예시

수신 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 코드를 표시하는 방법:

스마트 스크립트를 설정할 때 Smart Script 2.1 이상을 사용해야 합니다.
개발자에게 스마트 스크립트 결과를 사용하여 QR 코드를 작성하려면 해당 지시사항을 따르도록 하십시오.
모범 사례: 개발자에게 사용자가 데스크탑을 사용할 때 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 코드:

관련 자료

설정

일러두기

OneLink Smart Script 설정

설정 개체

인수

활용 사례

UTM 매개변수

Google Ads GCLID

일러두기

Facebook 클릭 ID

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

예시

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

예시

데스크톱

에이전시

예시

QR 코드

예시

댓글

이 섹션의 문서

페이지 내용 :

OneLink Smart Script V2 설정

관련 자료

설정

일러두기

OneLink Smart Script 설정

설정 개체

인수

활용 사례

UTM 매개변수

Google Ads GCLID

일러두기

Facebook 클릭 ID

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

예시

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

예시

데스크톱

에이전시

예시

QR 코드

예시

댓글

이 섹션의 문서

관련 문서

페이지 내용 :