요약: 원링크 스마트 스크립트를 설정하여 모든 소스에서 온 모바일 웹 사이트 방문자를 모바일 앱 사용자로 전환하고 어트리뷰트합니다. 일러두기: 필수 사항은 아니지만 OneLink Smart Script V2로 마이그레이션하는 것을 고려해 보십시오.
설정
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 |
|
|
다른 쿼리 파라미터 |
|
활용 사례
다음 섹션에서는 일반적인 캠페인/미디어소스 시나리오에서 스마트 스크립트 사용 사례를 제공합니다.
메타 광고:크로스 플랫폼 기여
메타 광고는 외부 기여 링크를 사용하지 않는 SRN입니다.
앱이 처음 실행되면, 앱스플라이어는 이 사용자가 이전에(최근 7일 이내) 앱 광고에 반응(클릭/조회)한 적이 있는지 페이스북에 문의합니다. 사용자가 광고주의 Facebook 광고에 참여한 경우 메타 광고는 자체 속성을 부여합니다. 메타 광고는 또한 크로스 플랫폼에 기여하며, 이는 사용자가 모든 플랫폼에서 모바일이든 아니든 모든 유형의 캠페인과 상호작용하여 메타 광고에 의해 자체 기여할 수 있음을 의미합니다.
조치: 개발자에게 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, 온드 미디어 및 기타 미디어소스 링크
스냅챗 또는 X 광고와 같은 SRN은 Google Ads 또는 메타 광고와 같은 크로스 플랫폼과 다르게 작동합니다. 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를 참조하십시오. |