요약: 원링크 스마트 스크립트를 설정하여 모든 소스에서 온 모바일 웹 사이트 방문자를 모바일 앱 사용자로 전환하고 어트리뷰트합니다. 일러두기: 필수 사항은 아니지만 OneLink Smart Script V2로 마이그레이션하는 것을 고려해 보십시오.
관련 자료
스마트 배너로 작업하는 것을 완전히 이해하려면 다음 문서를 확인하십시오.
- OneLink Smart Script 개요
- OneLink Smart Script V2 설정
- OneLink Smart Script V1(레거시) 설정 [본 문서]
- 모바일 웹-투-앱 어트리뷰션 솔루션
설정
OneLink Smart Script는 두 가지 버전이 있습니다.
OneLink Smart Script V2(권장 버전): OneLink Smart Script를 처음 설정하는 경우 이 버전을 사용하는 것이 좋습니다. 개발자 작업 부분이 더 쉬우며 Google Tag Manager를 사용하여 설정할 수도 있습니다. 일러두기: 필수 사항은 아니지만 V2로의 마이그레이션을 고려해 보십시오.
OneLink Smart Script V1(레거시): Onelink Smart Script를 이미 설정한 경우 이 버전의 설명서를 사용하여 이 스크립트를 유지 관리하고 편집하십시오.
책임
직무별 작업
|
선행 조건
|
웹 페이지에서 스크립트를 구현하는 방법:
파라미터
스마트 스크립트를 구현하기 위해 개발사에게 제공하는 파라미터/값
파라미터/값 | 설명 | 응답(개발자가 사용할) 기록 |
---|---|---|
원링크 URL(필수) |
|
|
pidKeysList (미디어소스) |
|
|
pidOverrideList |
|
|
pidStaticValue |
|
|
campaignKeysList(캠페인) |
|
|
campaignStaticValue |
|
|
gclIdParam |
|
|
skipList |
|
|
다른 쿼리 파라미터 |
|
활용 사례
다음 섹션에서는 일반적인 캠페인/미디어소스 시나리오에서 스마트 스크립트 사용 사례를 제공합니다.
Facebook 광고—크로스-플랫폼 어트리뷰션
Facebook은 외부 어트리뷰션 링크를 사용하지 않는 SRN입니다.
앱이 처음 실행되면, 앱스플라이어는 이 사용자가 이전에(최근 7일 이내) 앱 광고에 반응(클릭/조회)한 적이 있는지 페이스북에 문의합니다. 페이스북 광고에 반응한 적이 있으면, 페이스북은 자신의 어트리뷰션을 기록합니다. 페이스북은 또한 크로스 플랫폼 어트리뷰션을 합니다. 사용자가 페이스북 광고를 어느 플랫폼에서 보든, 모바일이든 아니든 전환으로 이어졌을 때 이를 인식하고 자신을 어트리뷰션합니다.
조치: 개발자에게 SkipList 메서드를 사용하여 Smart Script for Facebook(또는 원하는 다른 문자열)을 비활성화하도록 지시하십시오. 클릭의 HTTP 레퍼러에 Facebook이나 건너뛰기 목록의 문자열이 나타나면 스마트 스크립트는 null
을 반환합니다.
일러두기: 2021년 기간에 iOS 14 사용자와 예상대로 사용자가 기기 ID를 공유하지 않을 경우 Facebook 크로스 플랫폼 어트리뷰션이 영향을 받을 수 있습니다.
Google 광고—GCLID 및 UTM 파라미터
Google 광고 캠페인의 인스톨 어트리뷰션(GCLID 파라미터를 포함하는)을 위한 일반적인 프로세스에서는 클릭할 때 앱 스토어 페이지 URL로 리디렉션해야 합니다.
이 경우 Google 광고에서 웹/랜딩 페이지로 리드를 리디렉션하기 때문에 스크립트는 Google 광고 인스톨 캠페인 URL에서 GCLID 파라미터를 가져와서 출력 파라미터 af_sub[1-5]를 선택할 때 나가는 URL에 넣습니다. 일러두기! 이것은 인스톨 캠페인에 적용됩니다. 리인게이지먼트 캠페인을 의미하는 비 ACI 검색 캠페인의 경우 스마트 스크립트 출력에도 불구하고 Google이 미디어소스로 어트리뷰트될 수 있습니다.
전제 조건: Google 대시보드에서, 자동 태깅을 활성화합니다.
자동 태깅이 활성화된 상태에서, URL은 GCLID 파라미터를 포함합니다.
Google 광고용 스크립트를 설정하는 방법:
- 들어오는 링크에 있는 미디어소스 및 캠페인의 파라미터 이름 목록을 만듭니다.
예를 들어: utm_source 및 utm_campaign. - 나가는 URL에서 GCLID를 포함할 파라미터를 선택합니다.
모범 사례: 데이터가 앱스플라이어 로데이터 리포트에 표시되도록 af_sub[1-5]를 선택합니다. -
파라미터 목록 의 값들을 웹 개발자에게 제공합니다.
결과:
- 들어오는 링크의 미디어소스와 캠페인 파라미터(utm_source 및 utm_campaign)의 값은 내보내는 링크의 pid 및 c 파라미터 값을 채우는 데 사용됩니다.
- 나가는 URL에서 GCLID는 af_sub[1-5] 파라미터의 값입니다.
이러한 인스톨에 대해 Google 광고에 알리는 방법:
- 각 인스톨에 대해 CSV 또는 푸시 API를 통해 실시간으로 파라미터 af_sub[1-5]에서 GCLID 데이터를 가져옵니다.
- 수동으로 또는 Adwords API를 통해 GCLID 데이터를 Google에 업로드합니다.
일러두기
GCLID 솔루션은 구글이 공식적으로 지원하거나 권고하지 않습니다. 구글이 GCLID 파라미터를 삭제하는 경우, 앱스플라이어는 그에 따라 스크립트를 변경하겠습니다. 이 문서 헤더 부분 왼쪽에서 팔로우버튼을 클릭하여 이 문서를 팔로우하면 이 문서나 첨부 스크립트가 업데이트할 때 알림을 받으실 수 있습니다.
SRN, 온드 미디어 및 기타 미디어소스 링크
스냅챗이나 트위터 같은 SRN은 Google 광고나 Facebook 같은 크로스 플랫폼과는 다르게 작동합니다. SRN에서 집행하는 캠페인으로부터 사용자가 웹/랜딩 페이지로 유입되면 앱을 실제로 설치한 사용자가 아니라 광고를 클릭해서 랜딩 페이지까지만 도달한 사람 기준으로 광고비가 발생합니다.
이러한 SRN의 경우 스크립트 설정은 온드 미디어 또는 사용할 수 있는 다른 미디어소스의 링크에 대한 설정과 동일합니다.
스크립트 설정 방법:
- 들어오는 링크에 있는 미디어소스 및 캠페인의 파라미터 이름 목록을 만듭니다.
-
파라미터 목록의 값을 웹 개발사에 제공합니다.
SRN/미디어소스 유형은 들어오는 URL의 미디어소스 값이어야 하며 스크립트는 이 값을 찾아 웹/랜딩 페이지의 다운로드 버튼 뒤에 있는 나가는 원링크 URL에서 pid 값으로 사용합니다. 나가는 pid를 변경하려면 들어오는 미디어소스 값과 대체 pid 값을 pid 재지정 목록에 입력하십시오.
결과: 이러한 SRN/미디어소스의 경우 미디어소스의 값과 들어오는 링크의 캠페인 파라미터는 나가는 링크의 pid 및 c 파라미터의 값을 채우는 데 사용됩니다.
예시
들어오는 URL: https://hotel.me/af_pid=twitter&af_c=big_social
나가는 URL: https://hotel.onelink.me/Ac4G?pid=twitter&c=big_social
앱스플라이어 어트리뷰션 링크
앱스플라이어 어트리뷰션 링크는 미디어소스가 클릭 광고 네트워크일 때 사용할 수 있습니다. 앱스플라이어에서 이러한 링크를 설정할 때 웹 캠페인-앱 어트리뷰트를 위해 원하는 URL 경로가 포함된 리디렉션 URL 경로(af_r) 파라미터를 모바일 웹 사이트에 추가할 수 있습니다.
결과: af_r 및 af_redirect=true 파라미터는 들어오는 링크에 있으며 랜딩 페이지 스크립트는 변경되지 않습니다. 웹/랜딩 페이지의 앱스토어 바로가기 링크를 그대로 둡니다.
예시
들어오는 URL: https://app.appsflyer.com/id123456789?pid=click_ad_network_int&c=orlando&af_redirect=true&af_r=hotel.me
나가는 URL: 동일함
데스크톱
이 문서에 나오는 사용 사례는 모바일 기기를 사용하는 사용자입니다. 따라서 모바일 웹 사이트에서 앱 스토어로 안내되면 즉시 앱을 다운로드할 수 있습니다.
그러나 데스크톱 사용자는 기기(데스크톱 또는 랩톱)가 모바일 앱 다운로드와 호환되지 않으므로 앱 스토어로 즉시 전송되지 않습니다.
데스크톱 사용자용 스크립트 설정 방법:
- 원링크 템플릿의 경우 데스크톱에서 링크를 클릭하면 대상 URL을 설정합니다. URL은 전용 웹/랜딩 페이지로 리디렉션되어야 합니다. 랜딩 페이지에는 세부 정보를 입력하여 SMS 또는 앱을 다운로드할 수 있는 링크가 포함된 이메일을 받을 수 있는 웹 양식이 포함될 수 있습니다. 스크립트에서 웹 양식을 사용하고 앱 다운로드 링크를 전송하는 것은 선택사항입니다.
결과: 이 스크립트는 사용자가 사용하는 기기 또는 플랫폼을 감지합니다. 데스크톱인 경우 스크립트는 사용자를 전용 웹/랜딩 페이지로 리디렉션하는 나가는 원링크 URL을 생성합니다.
데스크톱 투 앱 전환을 참조하십시오.
에이전시
인스톨은 af_prt 파라미터를 사용하는 에이전시로 어트리뷰트됩니다.
원링크 스마트 스크립트를 사용하여 이 어트리뷰션 파라미터를 추가하려면 개발자에게 다음 지침을 따르라고 지시하십시오.
결과: 스크립트는 들어오는 URL에서 에이전시 이름을 가진 추가 파라미터를 감지하고 나가는 URL에 af_prt 파라미터를 추가합니다.
예시
Incoming URL: https://hotel.me/af_c=gogo&af_pid=email&partner_name=bigagency
나가는 URL: https://hotel.me/pid=email&c=gogo&af_prt=agency
제한 사항
제약 사항 | 설명 |
---|---|
태그 관리자 |
스마트 스크립트는 태그 관리자를 통해 구현할 수 없습니다. 웹-투-앱 어트리뷰션의 대체 솔루션으로 OneLink Smart Script V2 또는 Smart Banners를 참조하십시오. |