OneLink Smart Script를 만드려면:

1. 앱스플라이어 사이드 메뉴에서 참여 > 웹-to-앱 > 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 파라미터의 값으로 사용됩니다.
        • Smart Script는 파라미터 목록을 왼쪽에서 오른쪽으로 검색하고 첫 번째 일치 항목을 발신 파라미터 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_source 및 utm_campaign)에 UTM 파라미터 목록을 작성하고 이를 발신 URL의 파라미터(예: media_source 및 campaign)와 매치시키세요. 
2. 웹 개발자에게 이 인수 목록에 제공하세요.
    

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

Google Ads 캠페인의 일반적인 설치 어트리뷰션 프로세스(GCLID 파라미터를 사용)에서는 광고를 클릭한 사용자가 앱스토어 페이지 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를 찾은 경우, 스크립트는 들어오는 파라미터 키워드를 찾습니다. 찾은 경우 발신 URL에 키워드 값을 af_keywords의 값으로 삽입합니다.

전제 조건: 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 또는 푸시 API를 통해 실시간으로 파라미터 af_sub[1-5]에서 GCLID 데이터를 가져옵니다.
2. 수동으로 또는 Google Ads API를 통해 GCLID 데이터를 Google에 업로드합니다.

Meta 광고는 FBCLID라는 클릭 ID를 전달합니다. Smart Script 버전 2.8.1부터는 사용 가능한 경우 FBCLID가 Smart Script에서 생성된 발신 URL로 원본 그대로 자동 전달됩니다. 클릭 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

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

다음 관련 웹 연동 문서를 확인하세요. 

• TikTok 
• Snap 

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

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

스크립트 설정 방법:

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

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

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

조치: urlSkipList 인수를 사용하여 af_r 파라미터를 나열합니다.

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

웹 리퍼러 매핑을 사용하면 사용자가 웹사이트에 도달한 페이지(예: 오가닉 검색 결과)를 학습할 수 있으므로 Smart Script 웹-to-앱 흐름에서 발생하는 설치 및 리인게이지먼트를 분석하기 위해 원하는 대로 데이터를 보강할 수 있습니다. 

랜딩 페이지 또는 웹사이트 HTTP 헤더 리퍼러 필드에서 이 정보를 수집하도록 Smart Script를 설정할 수 있습니다. 이 필드에는 사용자가 웹페이지로 연결되는 링크를 클릭한 페이지의 기본 URL이 포함됩니다.

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

1. Smart Script 페이지 열기
2. 웹 리퍼러 매핑 영역 섹션에서 웹 리퍼러 값에 대한 발신 URL 파라미터 키를 선택합니다.
   • af_channel - 파라미터는 대시보드 및 로우 데이터에서 사용할 수 있습니다.
   • af_sub1-5 - 파라미터는 af_sub1-5 열 아래의 로우 데이터와 original URL 열에서 사용할 수 있습니다.
   • 사용자 지정 파라미터 - 파라미터 이름과 값으로 구성됩니다. 파라미터는 원래 URL 열의 로데이터로 표시됩니다.

Universial Links 및 App Links를 사용한 리인게이지먼트에 대한 오가닉 검색 어트리뷰션에 대해 알아보려면 여기를 참조하세요.

URL 파라미터 매핑 섹션에서 아직 해결되지 않은 경우, 오가닉 검색 트래픽에 대한 미디어 소스를 자동으로 설정하도록 오가닉 검색 설치 미디어 소스를 켤 수 있습니다.

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

이 문서에 나오는 사용 사례 대부분은 모바일 기기를 사용하는 사용자입니다. 따라서 모바일 웹 사이트에서 앱 스토어로 안내되면 즉시 앱을 다운로드할 수 있습니다.

그러나 데스크톱 사용자 기기(데스크톱 또는 노트북)는 모바일 앱 다운로드와 호환되지 않으므로 앱 스토어로 즉시 전송되지 않습니다. 

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

• OneLink 템플릿에서 데스크톱에서 링크가 클릭 되었을 때에 대한 목적지 URL을 설정하세요. URL은 전용 웹/랜딩 페이지로 리디렉션되어야 합니다. 랜딩 페이지에는 사용자가 세부 정보를 입력하면 앱 다운로드 링크가 포함된 SMS나 이메일을 받을 수 있는 웹 폼이 포함될 수 있습니다. 웹 폼을 생성하고 스크립트에 해당 웹 폼의 URL을 제공하는 것은 사용자 선택사항입니다. 

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

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

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

QR 코드를 표시하는 방법:

1. Smart Script를 설정할 때 Smart Script 2.6+를 사용해야 합니다.
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로 생성된 원링크 링크의 발신 파라미터에 적용됩니다. 구현에 대한 자세한 내용은 개발자 허브를 참조하세요.

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

앱스플라이어에서 Smart Script를 생성하고 이를 Google Tag Manager(GTM)에 삽입하려고 할 때 "JavaScript가 너무 깁니다"라는 오류가 표시되는 경우가 있습니다. 이 경우 GTM 태그를 삭제하고 새 태그를 만드십시오.

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

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

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

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

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

새 파라미터를 만들거나 추가할 때 브라우저에 있는 모든 광고 차단기를 끄는 것이 좋습니다. 때때로 광고 차단기는 '광고'라는 단어가 포함된 옵션을 제거합니다.

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

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