OneLink Smart Script 만드는 방법:

1. 앱스플라이어 사이드 메뉴에서 Engage > Web-to-app > Smart Script를 선택하세요.
2. 신규 사용자
   1. 시작하기 버튼을 클릭합니다.
   2. 4단계 이후부터 수행합니다.
3. 페이지 맨 위에 있는 + 새 Smart Script 버튼을 클릭합니다.
4. 화면상의 지침에 따라 Smart Script의 이름을 지정하십시오.
5. 스크립트의 기반이 될 OneLink 템플릿을 선택하세요. 템플릿에는 기본 리디렉션 설정이 포함되어 있습니다.
6. 발신 URL에 포함되어야 하는 파라미터를 매핑합니다. 이러한 파라미터는 수신 URL의 파라미터에 기반합니다. 참고: 미디어 소스(pid) 파라미터는 필수입니다.
   1. 매핑할 발신 파라미터/디멘션을 선택합니다.
      변경할 수 없는 앱스플라이어 파라미터 이름인 경우가 대부분이지만 어떤 경우에는 사용자의 파라미터 이름을 입력해야 합니다.
   2. 다음 중 하나를 기반으로 발신 파라미터의 값을 결정하고 구성합니다.
      • 수신 URL 파라미터: 발신 URL 파라미터로 대체할 하나 이상의 가능한 수신 URL 파라미터를 나열합니다. 수신 URL 파라미터 값은 발신 URL 파라미터의 값이 됩니다.
        • 예: any_param_name, utm_param_name. 수신 URL에 utm_param_name이 있는 경우 값이 선택한 발신 URL 파라미터의 값으로 사용됩니다.
        • 스마트 스크립트는 파라미터 목록을 왼쪽에서 오른쪽으로 검색하고 첫 번째 일치 항목을 발신 파라미터 URL에 매핑합니다.
        • 개발자는 이 파라미터 목록을 키로 참조합니다.
      • 기본값: 수신 URL 파라미터를 찾을 수 없거나 수신 URL 파라미터를 나열하지 않은 경우 발신 파라미터 값에 대해 원하는 기본값을 입력합니다.
        • 예: 발신 파라미터의 경우 수신 URL 파라미터가 any_paramname, utm_paramname을 나열하는 경우 목록에 파라미터가 모두 없으면 기본값이 발신 파라미터 값으로 사용됩니다.
      • 값 재정의: 대체할 발신 URL 값과 함께 수신 URL에서 값을 하나 이상 구성합니다.
        • 예: 캠페인 파라미터의 경우 수신 URL의 값이 campaign_name이면 발신 URL의 값을 new_campaign_name으로 변경할 수 있습니다.
   3. [선택 사항] + 새 파라미터를 클릭하여 추가 파라미터를 매핑합니다. 사용할 수 있는 모든 추가 인수 (파라미터 구성)를 참조하세요.
7. [선택 사항] 웹 리퍼러 매핑 섹션 아래에서 오가닉 검색 설치 미디어 소스를 켜서 URL 파라미터 매핑으로 해결되지 않은 오가닉 검색 트래픽에 대한 미디어 소스를 자동으로 설정합니다. 더 알아보기
8. 웹사이트에서 Smart Script를 구현하는 방법을 선택하세요.
   • 웹사이트에 스크립트를 내장합니다.
   • Google Tag Manager를 사용합니다.
9. 테스트를 클릭하여 Smart Script 테스트 페이지에서 스크립트를 테스트합니다. 올바른 발신 URL이 생성되었는지 확인합니다.
10. 클릭
    1. 저장 하여 변경 내용 저장
    2. 저장 및 생성 을 클릭하여 스크립트를 저장하고 생성합니다.
       1. 스크립트 다운로드를 클릭합니다.
11. 웹사이트에 스크립트를 포함하도록 선택한 경우: 웹 개발자에게 스크립트를 보내 구현하고 생성된 발신 URL로 수행할 작업을 알려줍니다. 예를 들어 모바일 사이트의 CTA 버튼 아래에 배치하거나 데스크톱 사이트에 QR 코드를 제시합니다. 개발자 지침
12. Google 태그 관리자를 사용하도록 선택한 경우:
    1. Google 태그 관리자에서 새 태그를 만들고 태그 이름을 지정하고 태그 설정을 클릭하고 사용자 지정 HTML을 선택합니다.
    2. HTML 상자에 생성된 Smart Script 코드를 붙여넣습니다.
    3. 트리거를 클릭하고 새 트리거를 만들고 이름을 지정한 다음 트리거 설정(예: 모든 페이지 보기)을 선택합니다. 자세한 내용은 GTM 문서를 참조하세요.
    4. 저장을 클릭합니다.
    5. 웹 개발자에게 생성된 발신 URL로 수행할 작업을 알려주세요. 예를 들어 모바일 사이트의 CTA 버튼 아래에 배치하거나 데스크톱 사이트에 QR 코드를 제시합니다. 개발자 지침
13. 저장된 스크립트는 드롭다운 메뉴에서볼 수 있습니다.

스크립트를 편집하거나 삭제하려면:

1. Smart Script 이름 옆에 있는
   드롭다운 화살표를 클릭합니다.여기에서 저장된 모든 스크립트를 볼 수 있습니다.
   
   
    
2. 편집하려는 스크립트 옆에 있는 펜 아이콘을 클릭합니다.
   1. OneLink Smart Script를 만드는 방법을 따르세요.
3. 휴지통 아이콘을 클릭하여 Smart Script를 삭제합니다.

스크립트를 복제하려면:

1. 복제하려는 Smart Script로 이동하세요.
2. 상단 배너의 복제 버튼 을(를) 클릭합니다.
3. OneLink Smart Script 만드는 방법을 따르세요.

OneLink Smart Script는 인수를 사용하여 수신 URL의 파라미터와 스크립트에 정의된 인수를 기반으로 발신 URL을 생성합니다. afParameters 인수는 기여도 측정 및 딥링크에 사용되는 여러 다른 인수(파라미터)들로 구성된 구조를 가집니다. 아래 테이블에 설명된 바와 같이, 각 인수는 키, 오버라이드 값, 기본값을 가진 구조(개발자들 사이에서는 환경 설정 객체로 불림)를 포함하고 있습니다.

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

Smart Script를 구현하기 위한 인수(파라미터 및 값)

다음 표는 기술적 이해도가 높은 마케터나 개발자가 Smart Script에서 구현할 수 있는 인수에 대해 설명합니다.

Smart Script에 구현할 고급 인수(파라미터 및 값)

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

1. 수신 URL의 UTM 파라미터(예: utm_source 및 utm_campaign) 목록을 작성하고, 이를 발신 URL의 파라미터(예: media_source 및 campaign)와 매칭하세요. 
2. 웹 개발자에게 이 파라미터들을 인수 목록으로 제공하세요.
    

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

GCLID 파라미터가 포함되는 Google Ads 캠페인의 앱 설치 어트리뷰션을 위한 일반적인 프로세스는 광고를 클릭한 사용자를 앱 스토어 페이지 URL로 리디렉션해야 합니다. 

이 경우 Google Ads의 리드를 웹/랜딩 페이지로 리디렉션하므로, 스크립트는 Google Ads 설치 캠페인 URL에서 GCLID 파라미터를 가져와 유출 URL에 넣습니다. Smart Script 버전 2.9.0부터 GCLID, WBRAID, GBRAID 파라미터는 사용 가능한 경우 Smart Script에서 생성된 유출 URL에 있는 그대로 자동으로 전달됩니다.

클릭 ID를 다른 유출 파라미터(af_sub[1-5])에 매핑하여 앱스플라이어 로우 데이터 리포트에서 사용할 수도 있습니다.

 

노트!

• 이는 설치 캠페인에 적용됩니다. 비 ACI 검색 캠페인, 즉 리인게이지먼트 캠페인의 경우 Smart Script 출력 결과와 상관없이 Google이 미디어 소스로 어트리뷰션될 수 있습니다. 
• GCLID가 발견 되면, 스크립트는 들어오는 파라미터 키워드를 찾습니다. 발견되는 경우, 키워드 값을 af_keywords의 값으로 유출 URL에 넣습니다.

전제 조건: Google 대시보드에서, 자동 태깅을 활성화합니다. 
자동 태깅이 활성화된 상태에서, URL은 GCLID 파라미터를 포함합니다.

Google Ads GCLID에 대한 스크립트를 설정하는 방법:

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

Google Ads에 이러한 설치를 알리는 방법:

권장 사항: Google 웹 연동을 설정하세요. 이 연동은 설치에 대한 자동 포스트백을 지원합니다. 

연동이 없다면:

1. CSV 또는 Push API를 통해 매 설치마다 실시간으로 af_sub[1-5]<0> 파라미터에서 GCLID 데이터를 가져옵니다.
2. 수동으로 또는 Google Ads API를 통해 GCLID 데이터를 Google에 업로드합니다.

Meta 광고에는 FBCLID라고 하는 클릭 ID가 포함됩니다. Smart Script 버전 2.8.1부터는 사용 가능한 경우, Smart Script에서 생성된 유출 URL에 FBCLID가 있는 그대로 자동으로 전달됩니다. 클릭 ID를 다른 유출 파라미터에 매핑하여 앱스플라이어 로우 데이터 리포트에서 사용할 수도 있습니다.

FBCLID를 다른 파라미터에 매핑하도록 스크립트를 설정하려면: 

1. 발신 URL에서 FBCLID를 포함할 파라미터를 선택합니다. 
   모범 사례: 앱스플라이어 로우 데이터 리포트에 데이터가 표시되도록 af_sub[1-5]를 선택하세요.
2. 인수 목록을 웹 개발자에게 제공하세요. 결과는 발신 URL에서 FBCLID가 af_sub[1-5] 파라미터의 값이 되는 것입니다.
    

TikTok, X(구 Twitter) 및 Snap 광고 캠페인의 설치 어트리뷰션은 광고 클릭 시 추가되는 네트워크별 클릭 ID 파라미터에 의존하며, 이는 설치 및 설치 후 이벤트를 원본 광고와 매칭하는 데 사용됩니다.

트래픽이 웹페이지나 랜딩 페이지로 처음 리디렉션될 때, 올바른 어트리뷰션을 보장하기 위해 클릭 ID를 보존하고 전달해야 합니다. 이 경우 Smart Script는 수신되는 클릭 ID 파라미터를 캡처하여 자신이 생성하는 발신 URL에 추가합니다.

클릭 ID는 설치 시 캡처되며, 해당 설치와 관련된 향후 이벤트에 사용됩니다.

Smart Script 버전 2.10.0부터, 아래의 클릭 ID 파라미터는 사용 가능한 경우 Smart Script에서 생성하는 아웃고잉 URL에 "있는 그대로" 자동으로 전달됩니다:

• TikTok: ttclid
• X(구 Twitter): twclid
• Snap: ScCid

af_sub1-af_sub5와 같은 다른 발신 파라미터에 이러한 클릭 ID를 매핑하여 앱스플라이어 로우 데이터 리포트에서 사용할 수도 있습니다.

다음의 관련 웹 연동 문서 참조: 

• TikTok 
• Snap 

Snapchat이나 X Ads 같은 SRN은 Google Ads나 Meta ads와 같은 크로스 플랫폼과는 다르게 작동합니다. 이러한 SRN의 캠페인은 사용자를 웹페이지나 랜딩 페이지로 유도하며, 파생된 모바일 사용자 수와 관계없이 클릭 유입에 따라 비용이 청구됩니다. 

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

스크립트 설정 방법:

1. 수신 링크에 포함되는 미디어 소스 및 캠페인 파라미터 이름 목록은 다음과 같습니다.
2. 인수 목록의 값을 웹 개발사에 제공합니다.
   SRN/미디어 소스 유형은 수신 URL의 미디어 소스 값이어야 하며, 스크립트가 이를 찾아 웹/랜딩 페이지의 다운로드 버튼 뒤에 있는 발신 OneLink URL의 media_source 값으로 사용합니다. 발신 media_source를 변경하려면 웹 개발자에게 제공하는 인수 목록에 수신 미디어 소스 값과 대체할 media_source 값을 포함하세요.

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

미디어 소스가 클릭 광고 네트워크인 경우 앱스플라이어 어트리뷰션 링크를 사용할 수 있습니다. 앱스플라이어에서 이러한 링크를 설정할 때 웹 캠페인에서 앱으로의 어트리뷰션을 위해 모바일 웹사이트의 원하는 URL 경로가 포함된 리디렉션 URL 경로(af_r) 파라미터를 추가하는 옵션을 사용할 수 있습니다. 원본 클릭의 데이터 일부가 손실될 수 있으므로, 스크립트가 발신 OneLink URL을 생성하지 않도록 설정하고 싶을 수 있습니다.

조치: urlSkipList 인수를 사용하여 af_r 파라미터를 목록에 추가하세요.

결과: Smart Script가 수신 링크에서 af_r 파라미터를 발견하면 발신 URL을 생성하지 않으며, 개발자가 발신 URL로 어떤 링크를 배치하고 구현할지 직접 결정해야 합니다.

웹 리퍼러 매핑은 사용자가 웹사이트에 어떤 페이지(예: 오가닉 검색 결과)에서 도달했는지 보여주어, Smart Script의 웹-to-앱 흐름에서 발생하는 설치 및 재참여 분석을 위한 데이터를 더욱 풍부하게 만듭니다. 

Smart Script가 랜딩 페이지나 웹사이트 HTTP 헤더의 Referer 필드에서 이 정보를 수집하도록 설정할 수 있습니다. 이 필드에는 사용자가 귀사의 웹 페이지로 이동하게 한 링크를 클릭한 이전 페이지의 기본 URL이 포함됩니다.

웹 리퍼러를 수집하도록 스크립트를 설정하려면

1. Smart Script 페이지 열기
2. 웹 리퍼러 매핑 영역 섹션에서 웹 리퍼러 값에 해당하는발신 URL 파라미터 키를 선택하세요:
   • af_channel - 파라미터는 대시보드 및 로데이터에서 사용할 수 있습니다.
   • af_sub1-5 - 해당 파라미터는 로우 데이터의 af_sub1-5 컬럼 및 original URL 컬럼에서 확인 가능합니다.
   • 사용자 지정 파라미터 - 파라미터 이름과 값으로 구성됩니다. 파라미터는 오리지널 URL 열의 로우 데이터로 표시됩니다.

Universal Links 및 App Links 기반의 재참여용 오가닉 검색 기여 측정에 대해 알아보려면 여기를 참고하시기 바랍니다.

URL 파라미터 매핑 섹션에서 아직 해결되지 않은 오가닉 검색 트래픽의 미디어 소스를 자동으로 설정하려면, 오가닉 검색 설치를 위한 미디어 소스를 활성화할 수 있습니다.

• 사용자의 웹 리퍼러가 지원되는 검색 엔진(예: google.com 또는 bing.com)과 일치하는 경우, Media Source는 일치하는 채널(예: google_organic_seo)로 설정됩니다.  
• 일치하는 항목이 없는 경우 URL 파라미터 매핑에서 설정한 기본 값이 사용됩니다.

이 문서에 나오는 사용 사례는 모바일 기기를 사용하는 사용자입니다. 다운로드따라서 모바일 웹사이트에서 앱 스토어로 이동했을 때 앱을 즉시 다운로드할 수 있습니다.

하지만 데스크톱 사용자의 기기(데스크톱 또는 노트북)는 모바일 앱 다운로드를 지원하지 않으므로 앱 스토어로 바로 이동되어서는 안 됩니다. 

데스크톱 사용자용 스크립트 설정 방법:

• OneLink 템플릿의 '데스크톱에서 링크를 클릭했을 때(When link is clicked on desktop)' 항목에서 목적지 URL을 설정하세요. URL은 전용 웹/랜딩 페이지로 리디렉션되어야 합니다. 랜딩 페이지에는 사용자가 세부 정보를 입력하여 앱 다운로드 링크가 포함된 SMS나 이메일을 받을 수 있는 웹 양식을 포함할 수 있습니다. 스크립트 내에서 웹 양식을 생성하고 해당 URL을 제공하는 것은 선택 사항입니다. 

결과: 이 스크립트는 사용자가 사용하는 기기 또는 플랫폼을 감지합니다. 데스크톱인 경우 스크립트는 사용자를 전용 웹/랜딩 페이지로 리다이렉트하는 발신 OneLink URL을 생성합니다.

데스크톱 투 앱 전환을 참조하세요.

스마트 스크립트는 링크가 있는 버튼 대신 웹 페이지에 QR 코드를 표시합니다. 

QR 코드를 표시하는 방법:

1. Smart Script는 뒤에 링크가 연결된 버튼 대신 웹 페이지에 QR 코드를 표시합니다.
2. 개발자에게 Smart Script 결과로 QR 코드를 생성하도록 해당 지침을 따르라고 안내하세요.
3. [모범 사례] 개발자에게 다음을 요청합니다.
   • QR 코드 중앙에 앱 로고를 추가하고 색상을 변경하여 QR 코드를 사용자 지정하세요.
   • 사용자가 데스크톱 환경일 때는 QR 코드를 표시하고, 모바일 환경일 때는 링크가 포함된 버튼을 표시하세요. 

결과: 스크립트는 URL이 연결된 버튼 대신 QR 코드를 표시합니다.

OneLink Smart Script를 사용하여 웹사이트의 임프레션 수를 계산할 수 있습니다. 그렇게 하려면 개발자가 임프레션 함수를 호출해야 합니다. 그런 다음 설치는 뷰-쓰루 어트리뷰션을 통해 노출수를 어트리뷰트션 합니다.

노트:

• 노출 수 계산은 클릭수를 계산하는 일반 Smart Script 생성 URL에 추가됩니다. Smart Script를 사용하여 클릭수, 노출 수 또는 둘 다를 계산할 수 있습니다.
• Smart Script를 통한 뷰 쓰루 어트리뷰션은 데스크톱이 아닌 모바일 기기에서만 작동합니다.

이러한 노출에 대해 신규 설치를 기여로 측정하려면(조회 기여 측정 방식): 

1. Smart Script를 설정할 때 Smart Script 2.3 이상을 사용해야 합니다.
2. 개발자에게 Smart Script 내의 노출 함수를 호출하도록 요청하세요.
3. 뷰-쓰루 어트리뷰션이 켜져 있는지 확인하세요.

사용자가 웹사이트의 다른 페이지로 이동해도 OneLink 링크 생성을 위한 수신 URL이 정상적으로 작동하나요?

예. 수신 URL 파라미터는 브라우징 세션 기간 동안 저장되며 Smart Script로 생성된 OneLink 링크의 수신 파라미터에 적용됩니다. 구현에 대한 자세한 내용은 개발자 허브를 참조하세요.

Google Tag Manager를 통해 Smart Script를 구현할 때 오류가 발생하는 이유는 무엇인가요?

간혹 앱스플라이어에서 Smart Script를 생성하여 Google 태그 관리자(GTM)에 삽입하려고 할 때 "JavaScript가 너무 깁니다"라는 오류가 표시될 수 있습니다. 이 경우 GTM 태그를 삭제하고 새 태그를 만드세요.

나열되지 않은 파라미터를 추가할 수 있나요?

예. OneLink Smart Script 페이지에서 + New parameter를 클릭하여 추가 파라미터를 매핑합니다.

• 새 파라미터는 사용자 지정 파라미터이거나 드롭다운에 나열되지 않은 앱스플라이어 예약 파라미터일 수 있습니다.
  • 사용할 수 있는 모든 추가 인수 (파라미터 구성)를 참조하세요.
• 드롭다운에서 사용자 지정 옵션을 사용하고 발신 URL 파라미터 필드에 대한 파라미터를 사용합니다.

예를 들어 is_retargeting 파라미터로 추가하려면 매핑 대상 필드에서 사용자 지정 파라미터를 선택한 다음 발신 URL 파라미터 필드에 is_retargeting 파라미터를 선택합니다.

드롭다운에 광고 세트 및 기타 파라미터가 표시되지 않습니다.

새 파라미터를 생성하거나 추가할 때 브라우저에 활성화된 모든 광고 차단 프로그램을 끄는 것을 권장합니다. 광고 차단 프로그램이 'Ad'라는 단어가 포함된 옵션을 제거하는 경우가 있습니다.

Smart Script는 어떤 브라우저에서 작동하나요?

Smart Script는 JavaScript를 사용하며 모든 브라우저에서 작동합니다.