OneLink Smart Script V2 설정

1. 앱스플라이어에서 경험 및 딥링킹 > 웹-투-앱 > 스마트 스크립트로 이동합니다.
2. 신규 사용자
   1. 시작하기 버튼을 클릭합니다.
   2. 4단계 이상을 수행합니다.
3. 페이지 맨 위에 있는 + 새 스마트 스크립트 단추를 클릭합니다.
4. 화면상의 지침에 따라 스마트 스크립트의 이름을 지정하십시오.
5. 스크립트의 기반이 될 원링크 템플릿을 선택하십시오. 템플릿에는 기본 리디렉션 설정이 포함되어 있습니다.
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. 웹사이트에서 스마트 스크립트를 구현하는 방법을 선택하십시오.
   • 웹사이트에 스크립트를 내장합니다.
   • Google Tag Manager를 사용합니다.
8. 검사를 클릭하여 Smart Script 검사 페이지에서 스크립트를 테스트합니다. 올바른 발신 URL이 생성되었는지 확인합니다.
9. 클릭
   1. 저장 하여 변경 내용 저장
   2. 저장 및 생성 을 클릭하여 스크립트를 저장하고 생성합니다.
      1. 스크립트 다운로드를 클릭합니다.
10. 웹사이트에 스크립트를 포함하도록 선택한 경우: 웹 개발자에게 스크립트를 보내 구현하고 생성된 발신 URL로 수행할 작업을 알려줍니다. 예를 들어 모바일 사이트의 CTA 버튼 아래에 배치하거나 데스크톱 사이트에 QR 코드를 제시합니다. 개발자 지침
11. Google 태그 관리자를 사용하도록 선택한 경우:
    1. Google 태그 관리자에서 새 태그를 만들고 태그 이름을 지정하고 태그 설정을 클릭하고 커스텀 HTML을 선택합니다.
    2. HTML 상자에 생성된 스마트 스크립트 코드를 붙여넣습니다.
    3. 트리거를 클릭하고 새 트리거를 만들고 이름을 지정한 다음 트리거 설정(예: 모든 페이지 보기)을 선택합니다. 자세한 내용은 GTM 문서를 참조하십시오
    4. 저장을 클릭합니다.
    5. 웹 개발자에게 생성된 발신 URL로 수행할 작업을 알려주십시오. 예를 들어 모바일 사이트의 CTA 버튼 아래에 배치하거나 데스크톱 사이트에 QR 코드를 제시합니다. 개발자 지침
12. 저장된 스크립트는 드롭다운 메뉴에서볼 수 있습니다.

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

1. 복제하려는 스마트 스크립트로 이동하십시오.
2. 상단 배너의 복제 버튼을 클릭합니다.
3. OneLink 스마트 스크립트를 만드는 방법을 따르십시오.

OneLink Smart Script는 인수를 사용하여 수신 URL의 파라미터와 스크립트에 정의된 인수를 기반으로 송신 URL을 생성합니다. afParameters 인수는 다음 표에 설명된 대로 키, 재정의 값 및 기본값을 포함하는 구조(개발자가 구성 개체로 tp라고 함)를 포함하는 속성 및 딥 링크에 사용되는 여러 다른 인수(파라미터)로 구성된 구조를 가지고 있습니다.

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

스마트 스크립트를 구현하기 위한 인수(파라미터 및 값)

다음 표는 기술에 정통한 마케터 또는 개발자가 스마트 스크립트에서 구현할 수 있는 인수를 설명합니다.

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 광고에서 웹/랜딩 페이지로 리드를 리디렉션하므로 스크립트는 Google 광고 인스톨 캠페인 URL에서 GCLID 파라미터를 가져와서 출력 파라미터 af_sub[1-5]를 선택할 때 나가는 URL에 넣습니다.

일러두기!

• 이것은 인스톨 캠페인에 적용됩니다. 리인게이지먼트 캠페인을 의미하는 비 ACI 검색 캠페인의 경우 스마트 스크립트 출력에도 불구하고 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 광고에 알리는 방법:

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

메타 광고는 Facebook 클릭 ID라고 하는 클릭 ID를 전달합니다. 앱스플라이어 로데이터에서 이 ID를 사용할 수 있도록 하려면 출력 파라미터 af_sub[1-5] 중 선택한 출력 URL에 발신 URL을 입력해야 합니다.

Facebook 클릭 ID를 설정하는 방법:

1. 수신 URL에서 Facebook 클릭 ID를 포함할 파라미터를 선택합니다.
   모범 사례: 데이터가 앱스플라이어 로데이터 리포트에 표시되도록 af_sub[1-5]를 선택합니다.
2. 인수 목록을 웹 개발자에게 제공하십시오.
   

결과: 출력 URL에서 Facebook 클릭 ID는 af_sub [1-5] 파라미터의 값입니다.

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

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

스크립트 설정 방법:

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

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

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

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

결과: 스마트 스크립트가 들어오는 링크에서 af_r 파라미터를 찾으면 스마트 스크립트는 나가는 URL을 생성하지 않으며 개발자는 나가는 URL로 배치할 링크를 결정하고 구현해야 합니다.

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

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

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

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

유니버설 링크 및 앱 링크를 사용한 리인게이지먼트에 대한 유기적 검색 어트리뷰션에 대해 알아보려면 여기를 참조하세요.

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

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

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

• 원링크 템플릿의 경우 데스크톱에서 링크를 클릭하면 대상 URL을 설정합니다. URL은 전용 웹/랜딩 페이지로 리디렉션되어야 합니다. 랜딩 페이지에는 세부 정보를 입력하여 SMS 또는 앱을 다운로드할 수 있는 링크가 포함된 이메일을 받을 수 있는 웹 양식이 포함될 수 있습니다. 스크립트에서 웹 양식을 사용하고 앱 다운로드 링크를 전송하는 것은 선택사항입니다. 

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

데스크톱 투 앱 전환을 참조하십시오.

인스톨은 af_prt 파라미터를 사용하는 에이전시로 어트리뷰트됩니다.

원링크 스마트 스크립트를 사용하여 이 어트리뷰션 파라미터를 추가하려면 개발자에게 다음 지침을 따르라고 지시하십시오.  

결과: 스크립트는 들어오는 URL에서 에이전시 이름을 가진 추가 파라미터를 감지하고 나가는 URL에 af_prt 파라미터를 추가합니다.

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

QR 코드를 표시하는 방법:

1. Smart Script를 설정할 때 Smart Script 2.6+를 사용해야 합니다.
2. 개발자에게 스마트 스크립트 결과를 사용하여 QR 코드를 작성하려면 해당 지시사항을 따르도록 하십시오.
3. [모범 사례] 개발자에게 다음을 수행하도록 지시합니다.
   • QR 코드 센터에 앱 로고를 추가하고 색상을 사용자 지정하여QR 코드를 사용자 지정합니다.
   • 사용자가 데스크톱에 있을 때 QR 코드를 표시하고 사용자가 모바일에 있을 때 링크가 있는 버튼을 표시합니다. 

결과: 스크립트는 URL을 가지고 있는 버튼 대신 QR 코드를 표시합니다.

원링크 스마트 스크립트를 사용하여 웹사이트의 노출수를 계산할 수 있습니다. 그렇게 하려면 개발자가 노출 함수를 호출해야 합니다 . 그런 다음 인스톨은 뷰-쓰루 어트리뷰션을 통해 노출에 어트리뷰트합니다.

일러두기:

• 노출수 계산은 클릭수를 계산하는 일반 스마트 스크립트 생성 URL에 추가됩니다. 스마트 스크립트를 사용하여 클릭수, 노출수 또는 둘 다를 계산할 수 있습니다.
• 스마트 스크립트를 통한 조회연결 어트리뷰션은 모바일 장치에서만 작동합니다. 데스크탑이 아닙니다.

이러한 노출에 대한 신규 인스톨 기여도(뷰-쓰루 어트리뷰션): 

1. 스마트 스크립트를 설정할 때 Smart Script 2.3 이상을 사용해야 합니다.
2. 개발자에게 스마트 스크립트에서 노출 함수를 호출하도록 지시하십시오.
3. 뷰-쓰루 어트리뷰션이 켜져 있는지 확인하십시오.

사용자가 웹사이트의 다른 페이지로 이동하는 경우 원링크 링크 생성을 위한 수신 URL이 작동합니까?

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

Google Tag Manager를 통해 스마트 스크립트를 구현할 때 오류가 발생하는 이유는 무엇인가요?

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

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

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

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

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

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

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

Smart Script는 어떤 브라우저에서 작동합니까?

Smart Script는 자바스크립트를 사용하므로 모든 브라우저에서 작동할 것입니다.