원링크 스마트 스크립트—웹투앱 URL 생성기

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

관련 자료: 원링크 스마트 스크립트 개발사 설명서 및 코드 샘플

6131_Smart_Script_flow_750x420_KB1.png

 뉴스

이 버전은 이전 모바일 랜딩 페이지 어트리뷰션 스크립트보다 향상된 기능을 제공하며 구현하기 쉽습니다. 

원링크 스마트 스크립트 소개

사용자는 앱 스토어 페이지에 도달하기 전 또는 광고 캠페인에 참여한 후에 모바일 웹 사이트에 도착합니다. 그러나 다음과 같이 작동하는 두 번의 클릭이 있습니다.

  • 웹 페이지로 연결하기
  • 웹 페이지에서 앱 스토어에서 연결하기

이 시나리오에서는 어트리뷰트와 딥링킹이 문제가 됩니다. 결국 앱을 다운로드한 사용자에 의한 인스톨은 잘못 어트리뷰트되거나 오가닉으로 어트리뷰트될 수 있습니다. 이 문제는 첫 번째 클릭이 광고 네트워크, Google 클릭 또는 온드 미디어소스에서 발생하는 경우에도 발생할 수 있습니다. 

원링크 스마트 스크립트는 다음과 같은 점에서 이러한 문제를 해결합니다.

  • 웹 페이지로 연결되는 들어오는 URL을 사용하여 앱 스토어로 연결되는 고유한, 나가는 원링크 롱 URL을 동적으로 생성합니다.
  • 광고 네트워크, SRN, Google 클릭 및 온드 미디어를 포함한 모든 미디어소스에 대한 정확한 웹투앱 어트리뷰션을 제공합니다. 
  • 딥링킹에 사용할 수 있습니다.
  • 웹 페이지 또는 랜딩 페이지에서 원활하게 실행됩니다. 
  • 스마트 배너를 사용할 필요가 없습니다. 
    일러두기: 스마트 배너는 많은 수직 계층에 훌륭한 전환 도구가 될 수 있으며 개발사가 설정할 필요가 없습니다. 다른 단계인 배너를 사용자 여정에 추가합니다.

 참고

  • 문서 또는 스크립트가 업데이트될 때 알림을 받으려면 문서 머리글에서 팔로우 단추를 클릭합니다.
  • 원링크 스마트 스크립트가 적합한 솔루션인지 잘 모르시겠습니까? 원링크 스마트 스크립트를 다른 앱스플라이어 웹투앱 솔루션과 비교해 보십시오.

예시

이 섹션의 예에서는 원링크 스마트 스크립트를 사용하여 정확한 어트리뷰션 또는 딥링킹 기능을 제공하는 출력 원링크 URL을 생성하는 방법을 보여줍니다. 특정 미디어소스가 있는 캠페인 유형에 대한 사용 사례에 대해서는 사용 사례를 참조하십시오. 

어트리뷰션

마크(Mark)는 호텔 체인의 마케터입니다. 그는 플로리다 올랜도에 있는 호캉스를 광고하는 이메일을 보냅니다. 이메일의 링크는 다음과 같은 형태입니다. https://hotel.me/pid=email&c=orlando

이 링크를 통해 사용자는 호텔의 모바일 웹 사이트로 리디렉션합니다. 그곳에서 사용자는 호텔의 모바일 앱을 다운로드하라고 초대하는 버튼을 볼 수 있습니다. 원링크 스마트 스크립트는 이메일의 원래 링크와 동일한 pidc 파라미터를 포함하는 URL을 자동으로 생성합니다. 링크는 다음과 같은 형태입니다. https://hotel.onelink.me/Ac4G?pid=email&c=orlando

사용자가 모바일 사이트의 버튼을 클릭하여 앱을 다운로드하면 앱 인스톨은 마크의 올랜도 이메일 캠페인에 어트리뷰트됩니다.

딥링킹

엠마(Emma)는 플로리다 올랜도에 있는 호캉스를 광고하는 이메일을 받습니다.

이메일 링크는 다음과 같은 형태입니다. https://hotel.me?type=email&campaign=Florida&city=orlando

링크를 클릭하면 호텔의 모바일 웹 사이트로 리디렉션됩니다. 그곳에서 호텔의 모바일 앱을 다운로드하도록 초대하는 버튼을 볼 수 있습니다. 원클릭 스마트 스크립트는 이메일의 원래 링크와 동일한 pidc 파라미터를 포함하는 URL을 자동으로 생성합니다. 링크는 다음과 같은 형태입니다. https://hotel.onelink.me/Ac4G?pid=email&c=Florida&deep_link_value=orlando

엠마가 모바일 사이트의 버튼을 클릭하면 앱 스토어로 리디렉션됩니다. 그리고 앱을 다운로드하여 실행하면 앱의 올랜도 휴가 페이지와 딥링킹됩니다.

 참고

딥링킹은 앱 개발사가 구현한 앱 설정에 따른 것입니다. 더 알아보기.

설정

책임

직무별 작업

  • 광고주: 
    • 나가는 URL에 포함할 내용을 결정합니다. 여기에는 링크에 추가할 어트리뷰트 데이터와 딥링킹에 필요한 데이터가 포함됩니다. 들어오는 URL을 조작하거나 특정 값을 강제로 적용합니다. 

    • 모바일 웹 사이트로 연결되는 모든 캠페인에 스크립트가 작동하는 파라미터를 포함한 들어오는 URL이 있는지 확인합니다
  • 웹 개발사:
    • 스크립트를 초기화할 데이터를 설정합니다. 
    • 들어오는 URL 파라미터를 기준으로 나가는 원링크 URL을 생성하는 데 필요한 설정자를 입력합니다.  
    • 웹 사이트 또는 특정 페이지에 스크립트를 내장합니다. 

선행 조건

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

  1. 자동으로 생성된 나가는 원링크 URL에 포함할 파라미터/값을 결정합니다. 사용할 수 있는 파라미터 목록을 참조하십시오.
    • 들어오는 URL이 있는 모든 캠페인에 스크립트가 적용되는 파라미터가 있는지 확인합니다(그리고 pidc 파라미터로 배치 가능). 
  2. 웹 개발사에 파라미터 목록을 제공합니다.
  3. 개발사에 개발 지침을 따르고 스크립트를 구현하여 올바른 나가는 링크를 생성하도록 지시합니다.

파라미터

파라미터/값 설명 응답(개발자가 사용할) 기록
원링크 URL(필수)
  • 원링크 템플릿 도메인 + 템플릿 ID를 제공합니다. 일러두기: 원링크 사용자정의 링크 URL이 아닙니다!
  • 예: yourbrand.onelink.me/1a6f
  • 유명 도메인 예: yourbrand.com/1a6f
 
pidKeysList (미디어소스)
  • 내보내는 URL에서 미디어소스(pid) 파라미터로 배치될 내보내는 URL의 모든 미디어소스 파라미터를 나열합니다.
  • 예: ['af_pid', 'utm_source']
 

pidOverrideList

  • 나가는 링크에서 변경하려는 미디어소스의 경우 미디어소스 값을 들어오는 URL에 대체할 미디어소스 값과 함께 나열합니다.
  • 예: {
    'twitter': 'twitter_int',
    'snapchat': 'snapchat_int',
    'some_social_net': 'some_social_net_int'
    }

 

pidStaticValue

  • "폴백" 미디어소스를 원하는 대로 설명합니다.
  • pidKeysList에서 미디어소스 파라미터를 찾을 수 없는 경우 나가는 URL에서 pidStaticValue가 미디어소스(pid)로 사용됩니다.
  • 예: 'website' 또는 'landing_page'

 

campaignKeysList(캠페인)
  • 나가는 URL에서 캠페인(c) 파라미터로 배치될 들어오는 URL의 모든 캠페인 파라미터를 나열합니다.
  • 예: ['af_campaign', 'utm_campaign']

 

campaignStaticValue
  • "폴백" 캠페인이 무엇이길 원하는지 설명하십시오.
  • campaignKeysList에서 캠페인 파라미터를 찾을 수 없는 경우 campaignStaticValue가 나가는 URL에서 캠페인(c)으로 사용됩니다.
  • 예: 'website' 또는 'landing_page'

 

gclIdParam
  • GCLID를 전달하는 파라미터를 호출할 내용을 설명합니다.
    중요! 앱스플라이어 로데이터 리포트에 표시하려면 파라미터가 af_sub[1-5] 중 하나여야 합니다.
 
skipList
  • 특정 클릭(예: Twitter 또는 Facebook)을 위한 스마트 스크립트를 사용 안 함으로 설정하는 HTTP 리퍼러의 문자열에 기재합니다. 문자열이 나타나면 스마트 스크립트가 실행되지 않습니다. 이런 기능은 클릭이 이미 리포트되는 Twitter 및 Facebook과 같은 SRN에 유용할 수 있습니다.
  • SRN에서조차도 스마트 스크립트가 항상 실행되기를 원하는 경우, 개발자에게 빈 skiplist를 전달하라고 알려주십시오.
 
다른 쿼리 파라미터
  • 어트리뷰션 또는 딥링킹을 위해 나가는 원링크 URL에 포함할 다른 파라미터를 나열합니다.
  • 딥링킹을 위한 deep_link_value를 추가합니다.
    • 파라미터를 추가하는 것 외에도, 사용자와 개발자는 딥링킹 논리를 구현해야 합니다. 더 알아보기.
  • 들어오는 URL의 파라미터를 사용하거나 정적 값을 강제 적용할 수 있습니다. 
 
스마트 스크립트를 구현하기 위해 개발사에게 제공하는 파라미터/값

활용 사례

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

Facebook 광고크로스-플랫폼 어트리뷰션

Facebook은 외부 어트리뷰션 링크를 사용하지 않는 SRN입니다.

앱이 처음 실행되면, 앱스플라이어는 이 사용자가 이전에(최근 7일 이내) 앱 광고에 반응(클릭/조회)한 적이 있는지 페이스북에 문의합니다. 페이스북 광고에 반응한 적이 있으면, 페이스북은 자신의 어트리뷰션을 기록합니다. 페이스북은 또한 크로스 플랫폼 어트리뷰션을 합니다. 사용자가 페이스북 광고를 어느 플랫폼에서 보든, 모바일이든 아니든 전환으로 이어졌을 때 이를 인식하고 자신을 어트리뷰션합니다.

결과: 랜딩 페이지 스크립트는 변경되지 않습니다. 랜딩 페이지 스크립트는 사용자가 페이스북으로부터 유입되었다는 사실을 감지하도록 짜여져 있습니다. 페이스북으로부터 유입된 사용자를 감지한 후에는 아무것도 하지 않습니다. 웹/랜딩 페이지의 링크를 그대로 둡니다. 추가 클릭이 발생하지 않도록 하여, CTR(Click-Through Rate: 클릭 전환) 데이터에 영향을 주지 않습니다.

일러두기: 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 광고용 스크립트를 설정하는 방법:

  1. 들어오는 링크에 있는 미디어소스 및 캠페인의 파라미터 이름 목록을 만듭니다.
    예를 들어: utm_sourceutm_campaign.
  2. 나가는 URL에서 GCLID를 포함할 파라미터를 선택합니다.
    모범 사례: 데이터가 앱스플라이어 로데이터 리포트에 표시되도록 af_sub[1-5]를 선택합니다.
  3. 파라미터 목록 의 값들을 웹 개발자에게 제공합니다.

결과:

  • 들어오는 링크의 미디어소스와 캠페인 파라미터(utm_sourceutm_campaign)의 값은 내보내는 링크의 pidc 파라미터 값을 채우는 데 사용됩니다. 
  • 나가는 URL에서 GCLID는 af_sub[1-5] 파라미터의 값입니다.

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

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

 참고

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

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

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

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

스크립트 설정 방법:

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

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

 예:

들어오는 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_raf_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 파라미터를 추가합니다.

 예:

들어오는 URL: https://hotel.me/af_c=gogo&af_pid=email&partner_name=bigagency

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

제한 사항

제약 사항 설명
태그 관리자

스마트 스크립트는 태그 관리자를 통해 구현할 수 없습니다. 대안적인 웹투앱 어트리뷰션 솔루션으로 스마트 배너를 참조하십시오.

도움이 되었습니까?

댓글

댓글 0개

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