요약: 원링크 스마트 스크립트를 설정하여 모든 소스에서 온 모바일 웹 사이트 방문자를 모바일 앱 사용자로 전환하고 어트리뷰트합니다.
관련 자료
스마트 배너로 작업하는 것을 완전히 이해하려면 다음 문서를 확인하십시오.
- OneLink Smart Script 개요
- OneLink Smart Script V2 설정 [본 문서]
- OneLink Smart Script V1(레거시) 설정
- 모바일 웹-투-앱 어트리뷰션 솔루션
설정
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를 사용합니다.
직무별 작업
|
선행 조건
|
웹 페이지에서 스크립트를 내장하는 방법:
직무별 작업
|
선행 조건
|
웹 페이지에서 스크립트를 구현하는 방법:
- Google Tag Manager에서 새 태그를 작성합니다.
- 태그 이름을 지정하고 태그 설정을 클릭하여 사용자정의 HTML을 선택합니다.
-
HTML 상자에서 다음을 수행합니다.
- 원링크 스마트 스크립트 코드를 붙여넣습니다.
- 스마트 스크립트 코드를 붙여넣은 다음에 스마트 스크립트 초기화 코드를 인수 및 설정 오브젝트와 함께 추가하십시오. 초기화 코드 예시를 참조하십시오.
-
다음 코드 라인을 바꿉니다.
다음으로 바꾸면 됩니다.var result = window.AF_SMART_SCRIPT.generateOneLinkURL({
AF_SMART_SCRIPT_RESULT = window.AF_SMART_SCRIPT.generateOneLinkURL({
-
[선택사항] 코드 뒤에 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");
- 모든 코드를
<script></script>
태그 안에 넣으십시오.
- 상단 우측 모서리에 있는 저장 버튼을 클릭합니다.
- 개발자에게 GTM를 위한 OneLink Smart Script 지시 사항을 따르도록 하십시오.
설정 개체
OneLink Smart Script는 인수를 사용하여 수신 URL의 파라미터와 스크립트에 정의된 인수를 기반으로 송신 URL을 생성합니다. afParameters 인수에는 어트리뷰션 및 딥링크에 사용되는 다른 여러 인수(파라미터)로 구성된 구조가 있으며, 각 인수에는 다음 표에 설명된 대로 키, 재정의 값 및 기본값이 있는 설정 개체가 포함됩니다.
인수 | 설명 | 예 |
---|---|---|
키 |
|
|
overrideValues |
|
예: {'video': 'video_new'} 스크립트의 채널 파라미터의 경우, 수신 값이 비디오일 때마다 스크립트는 송신 링크에서 video_new로 변경합니다. |
defaultValue |
|
예: ['web_video'] 스크립트에서 채널 파라미터의 경우 in_channel 파라미터를 찾을 수 없으면 web_video가 채널 값으로 사용됩니다. |
인수
OneLink Smart Script는 인수를 사용하여 수신 URL의 파라미터와 스크립트에 정의된 인수를 기반으로 송신 URL을 생성합니다.
인수 | 설명 | 응답(개발자가 사용할) 기록 | |
---|---|---|---|
원링크 URL(필수) |
|
||
afParameters (필수)
|
mediaSource (필수) |
|
키: 재정의 값: 기본값: |
campaign |
|
키: 재정의 값: 기본값: |
|
channel |
|
키: 재정의 값: 기본값: |
|
ad |
|
키: 재정의 값: 기본값: |
|
adSet |
|
키: 재정의 값: 기본값: |
|
deepLinkValue |
|
|
|
afSub1-5 |
af_sub[1-5]의 설정 개체. |
키: 재정의 값: 기본값: |
|
googleClickIdKey |
GCLID를 전달하는 파라미터를 호출할 내용을 설명합니다. |
||
기타 (사용자정의) 쿼리 파라미터 |
|
파라미터 키: 키: 재정의 값: 기본값: |
|
referrerSkipList |
특정 클릭(예를 들어 Twitter 또는 Facebook)에 대한 HTTP 레퍼러의 문자열 목록으로, 발견될 경우 스마트 스크립트가 |
||
urlSkipList |
특정 클릭(예: af_r)에 대한 URL의 문자열 목록으로, 발견될 경우 스마트 스크립트가 |
활용 사례
다음 섹션에서는 일반적인 캠페인/미디어소스 시나리오에서 스마트 스크립트 사용 사례를 제공합니다.
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 코드:
댓글
댓글을 남기려면 로그인하세요.