스마트 스크립트 설정

사용자가 모바일 웹사이트의 버튼이나 배너를 통해 앱을 설치하게 되는 웹 캠페인을 실행하는 경우, 최초의 유입 소스에 대한 정보가 손실될 수 있습니다. 모바일 웹사이트에서 스마트 스크립트를 실행하면 전체 어트리뷰션 정보를 받을 수 있습니다.

시작에 앞서

딥링크 생성 전에 알아야 할 사항은 다음과 같습니다.

요구 사항

관리자 및 편집자 권한
(선택 사항) Adjust SDK iOS | Android의 딥링크 구성

이용 조건

성장 솔루션:

스마트 스크립트는 애드온 솔루션으로 이용 가능합니다. 액세스를 원하는 경우 Adjust 담당자에게 문의하거나 sales@adjust.com으로 이메일을 보내주시기 바랍니다.

새 스크립트 생성

Campaign Lab에서 스마트 스크립트 를 선택합니다.
새 스마트 스크립트 를 선택합니다.

베이스 링크 선택하기

Base 링크는 사용자가 캠페인을 통해서가 아니라 웹 랜딩 페이지에 오가닉으로 유입된 경우와 같이 유입 트래픽 소스가 없는 경우, 모든 어트리뷰션이 수여되는 폴백 링크 토큰의 기능을 합니다.

드롭다운에서 원하는 앱을 선택합니다.
베이스 링크 선택하기
단일 플랫폼 링크(예: Android)를 선택한 경우, 다른 단일 플랫폼 링크(예: iOS)와 결합할 수 있습니다. 이를 통해 앱에 대해 두 플랫폼 모두에서 작동하는 단일 스마트 스크립트를 사용할 수 있습니다.

폴백 어트리뷰션 로직

클릭 이후 링크와 인게이지먼트를 이룬 사용자에 대한 어트리뷰션 방법을 선택합니다. 두 가지 옵션을 선택할 수 있습니다.

이전 광고에 어트리뷰션
스마트 배너에 어트리뷰션

사용자를 이전 광고에 어트리뷰션하도록 선택하면 fallback_click 파라미터가 링크에 추가됩니다. Adjust는 이 외 다른 링크가 없는 경우에만 fallback_click 파라미터가 있는 링크를 어트리뷰션에 고려합니다. 즉, 오가닉으로 분류되었을 사용자가 fallback_click 링크에 어트리뷰션됩니다. 해당 작동 방식에 대한 자세한 내용은 폴백 어트리뷰션 섹션을 참조하시기 바랍니다.

파라미터 매핑

유입 URL에서 가져온 파라미터를 Adjust 링크와 같은 나가는 URL에 매핑합니다. 예를 들어 utm_campaign 이 있는 경우 해당 값은 Adjust 캠페인 파라미터에 매핑됩니다. 없는 경우 정의한 기본 대체값이 사용됩니다.

3가지 유형의 파라미터를 매핑할 수 있습니다.

캠페인 파라미터 - channel , campaign , adgroup, creative와 같은 Adjust 캠페인 구조를 나타냅니다.

사용자 이동 위치 / 딥링크 파라미터 - 딥링크 경로를 전달하거나 웹 URL 기반 라우팅을 활용할 수 있습니다.

추가 파라미터 - 추가 데이터를 커스텀 키-값 쌍을 전달하거나 Adjust 라벨 파라미터를 활용하여 추가할 수 있습니다.

파트너 매핑

파트너와 이에 상응하는 링크 토큰이 트래픽 소스인 경우 어트리뷰션이 부여되어야 할 대상으로 매핑합니다. 예를 들어 트래픽 소스가 Facebook(Meta) 웹 캠페인(fbclid 또는 fbpid가 유입 URL에서 이용 가능한지에 따라 결정됨)인 경우, 해당 네트워크 링크 토큰이 어트리뷰션을 얻습니다.

다음 중 하나를 수행할 수 있습니다.

바로 사용 가능한 파트너 목록에서 선택: 이 경우 트래픽 조건이 사전 구성되어 있으므로 링크 토큰만 선택하면 됩니다(예: ttclid가 존재하는 경우 -> 파트너 = Tiktok).
커스텀 파트너/채널 설정 선택: 이 경우 트래픽 조건(예: utm_source contains social)과 이에 대응하는 링크 토큰을 지정해야 합니다. 이는 유입 URL에 고유한 클릭 ID가 없는 온드 미디어/언드 미디어 채널을 구성할 때 특히 유용합니다.

참고 : 스마트 스크립트를 사용하여 파트너의 웹-투-앱 트래픽을 어트리뷰션하는 경우, 파트너 대시보드(최종 URL 또는 트래킹 템플릿 필드)에 Adjust 트래킹 링크를 설정할 필요가 없습니다 . 올바른 파라미터(예: UTM)가 추가된 랜딩 페이지 URL로 사용자를 리다이렉트하도록 캠페인을 설정하면 됩니다. 올바른 링크 토큰이 포함된 Adjust 링크가 이제 스크립트에 의해 생성되어 랜딩 페이지의 CTA 뒤에 위치하기 때문입니다. 두 가지 트래킹 메서드를 모두 설정하면 클릭이 중복되고 리포트에 불일치가 발생할 수 있습니다.

스크립트 배포

1. 스크립트 복사

스크립트가 생성되면 '스크립트 뷰' 페이지로 이동하여 '스크립트 복사' 버튼을 클릭할 수 있습니다.

2. 스크립트 배포

1. 웹사이트에 스크립트 포함

구현을 위해 스크립트를 웹 개발자에게 전송합니다.
Smart Script는 Adjust 링크(아웃고잉 URL) 생성을 위해 두 가지 함수를 제공합니다. waitForEnrichedLink는 Promise를 반환하는 비동기 함수입니다. 사용 가능한 경우, Facebook 픽셀 ID 정보가 포함된 Adjust 링크를 생성합니다. createLink는 즉시 Adjust 링크를 반환하지만, 대부분의 경우 Facebook 픽셀 ID를 읽어올 수 없습니다.

Facebook 픽셀 ID가 중요한 경우, waitForEnrichedLink 사용을 권장합니다.

지연 없는 즉각적인 Adjust 링크 생성이 필요한 경우, createLink를 사용하거나 두 함수를 함께 사용할 수 있습니다. 예를 들어, createLink가 반환한 링크로 ‘앱 다운로드’ 버튼(CTA)을 먼저 렌더링 한 뒤, waitForEnrichedLink 처리가 완료되면 Facebook 픽셀 ID가 포함된 링크로 교체하는 방식을 권장합니다.

스마트 스크립트에 의해 생성된 Adjust 링크(나가는 URL)를 어떻게 처리할지 설명합니다. 예를 들어 '앱 다운로드' 버튼/CTA 뒤에 배치하거나, 데스크탑 웹사이트에 QR 코드를 제시할 수 있습니다.

2. Google 태그 매니저를 통해 스크립트 배포

Google 태그 매니저로 이동합니다.
태그 → 신규를 선택합니다.
Tag Configuration을 선택한 다음 Custom HTML을 선택하고, <script>를 추가합니다. Suite에서 복사한 코드를 이 스크립트 태그 안에 입력합니다. 클로징 태그인 /script를 누락하지 않도록 주의하시기 바랍니다.

    <script>
      // Paste Smart Script configuration you’ve copied from the Suite
      // The code contains the smart script, mapping and call for link creation
    </script>

스크립트는 아웃고잉 URL/Adjust 링크를 반환하며, 다운로드 버튼 뒤에 이 링크를 포함할 수 있습니다. 필요한 경우 개발자 팀과 협업하여 생성된 Adjust 링크를 '앱 다운로드' 버튼/CTA에 어떻게 연결할지 확인하시기 바랍니다.

아래의 예시는 페이지에 ID가download_button인 "다운로드" 버튼이 있다고 가정하며, 이 버튼이 클릭되었을 때 링크를 여는 동작을 추가합니다. waitForEnrichedLink 함수가 Facebook 픽셀 ID를 포함한 Adjust 링크를 반환하면, 버튼 핸들러는 해당 링크를 열도록 업데이트됩니다. 만약 Facebook 픽셀 ID가 필요하지 않은 환경이라면, waitForEnrichedLink 호출 코드와 닫는 </script> 태그 전까지의 관련 코드를 모두 삭제해도 안전합니다.

연동 코드 예시

// 링크 생성
var link = AdjustSmartScript.createLink(mapping);

var downloadButton = document.getElementById('download_button');
var openLinkFn = function () { window.open(link) };

// 다운로드 버튼 클릭 시 링크 실행
downloadButton.addEventListener('click', openLinkFn);
  
// 비동기 방식의 링크 생성
// Facebook 픽셀 ID가 확인될 때까지 대기합니다. Facebook 픽셀 ID가 필요하지 않은 경우
// 삭제해도 됩니다.
AdjustSmartScript.waitForEnrichedLink(mapping)
  .then(function (enrichedLink) {
    // 정보가 포함된 링크가 생성됩니다.
    // 버튼 클릭 시 새롭게 생성된 링크를 열도록 설정합니다.
    downloadButton.addEventListener('click', function () { window.open(enrichedLink) });

    downloadButton.removeEventListener('click', openLinkFn);
  })
  .catch(function (error) {
    // 오류 발생으로 정보 포함 링크가 생성되지 않은 경우
    console.log(error);
  });

웹사이트의 모든 페이지가 아닌 특정 웹-앱 랜딩 페이지에서만 태그 실행/초기화 옵션을 환경 설정해야 할 수 있습니다.
이 기능이 완전히 도입되면 사용자가 웹 랜딩 페이지에서 '다운로드' 버튼을 클릭할 때 Adjust 링크는 사용자를 라우팅하고 모든 앱 전환을 웹 트래픽의 원래 소스로 다시 어트리뷰션합니다.

선택 사항 - 스크립트 업데이트

웹사이트에 스마트 스크립트를 배포한 후 편집하는 경우, 개발자가 스크립트를 수동으로 재배포/업데이트해야 변경 사항이 적용됩니다. 이 과정은 자동으로 발생하지 않습니다.

스마트 스크립트 테스트

스마트 스크립트는 브라우저의 콘솔에서 로그를 출력합니다. 특정 매핑에서 스크립트가 어떻게 작동하는지 테스트하고, 올바른 링크가 생성되는지 확인하는 것이 좋습니다.

브라우저에서 개발자 도구 콘솔로 이동합니다.
스마트 스크립트를 구현한 웹 페이지로 이동합니다.
[adjust-smart-script] 접두사가 있는 로그가 없는 경우 페이지를 새로고침합니다. 여전히 로그가 표시되지 않으면 다음을 확인합니다.
- 코드가 AdjustSmartScript.setLogLevel('error') 또는 AdjustSmartScript.setLogLevel('none')을 호출하여 로깅을 억제하지 않습니다.
- 코드가 AdjustSmartScript.createLink(params) 함수를 호출합니다.

inputUrl 속성의 여러 값을 사용하여 다양한 사용 사례를 테스트할 수 있습니다. 예를 들어 Meta 캠페인을 진행 중이고 오가닉 사용자가 랜딩 페이지를 방문할 것으로 예상되는 경우, 캠페인과 Meta 파라미터가 포함된 URL과 추가 파라미터가 없는 또 다른 URL을 가질 수 있습니다.

예시 로그:

[adjust-smart-script]: 구성된 네트워크 없음
[adjust-smart-script]: defaultLinkToken을 사용하여 Adjust 링크 생성
[adjust-smart-script]: 캠페인 값으로 new_campaign 찾음
[adjust-smart-script]: 광고그룹 값으로 some_adset 찾음
[adjust-smart-script]: 크리에이티브 값으로 logo_image 찾음
[adjust-smart-script]: ref_code의 변환된 값은 id+my_product
[adjust-smart-script]: 잘못 구성된 딥링크: 제공된 유효한 androidAppSchema 없음

스마트 스크립트 테스트 툴

스마트 스크립트(SmartScript) 테스트 툴은 스마트 스크립트가 어떻게 유입된 랜딩 페이지 URL을 처리하고 발신 URL을 생성하는지 시뮬레이션하는 테스트 인터페이스입니다. 이 가이드를 참조해서 스마트 스크립트 테스트 툴을 사용하면, 웹사이트 구현 전이나 구현 중에 파트너 로직, 파라미터 처리, 링크 토큰 로직이 예상대로 작동하는지 검증할 수 있습니다.

Copilot Pulse 기능

스마트 스크립트 테스트 툴은 주어진 랜딩 페이지 URL에 대한 스마트 스크립트 실행을 시뮬레이션하고, 스마트 스크립트 구성에 의해 생성된 발신 URL(Adjust 링크)을 보여줍니다.

스마트 스크립트 테스트 툴은 두 가지 옵션의 인풋을 지원합니다:

직접 커스텀 테스트 URL을 입력합니다.
사전 입력된 예시 URL을 선택합니다(예: Meta, Google, TikTok과 같은 일반 소스로부터의 UTM과 클릭 ID를 포함한 URL).

스마트 스크립트 테스트 툴은 스마트 스크립트 구성 작동 방식을 다음과 같이 검증합니다.

파트너 로직(예: 스마트 스크립트 설정에 따른 파트너 선택)
파트너 처리(예: 유입된 파라미터 중 무엇이 발신 Adjust 링크로 전달되는지)
트래픽 조건 작동 방식(예: 조건이 인풋 URL에 적용되는지 여부)
발신 Adjust 링크에 사용되는 링크 토큰 로직

일반적인 사용 사례는 다음과 같습니다.

파트너 파라미터와 유입된 캠페인 파라미터가 발신 Adjust 링크에 전달되는지 검증
스마트 스크립트 구성이 클릭 ID와 소스 특정 파라미터를 예상대로 처리하는지 확인
웹사이트 라이브에 앞서 생성된 Adjust 링크를 예상한 캠페인 로직과 비교
특정 이슈가 구성 또는 웹사이트 구현 중 무엇과 관련되었는지 확인

솔루션 작동 방식

스마트 스크립트 테스트 툴은 스마트 스크립트가 랜딩 페이지 URL을 어떻게 처리하는지 시뮬레이션합니다.

랜딩 페이지 URL을 제공합니다(커스텀 URL 또는 사전 입력된 URL).
스마트 스크립트 테스트 툴은 스마트 스크립트 구성을 사용하여 스마트 스크립트 실행을 시뮬레이션합니다.
스마트 스크립트 테스트 툴은 다음을 포함한 스마트 스크립트 구성에 따라 발신 URL(Adjust 링크)를 생성합니다.
- 파트너 로직
- 파트너 처리
- 트래픽 조건
- 링크 토큰 로직
발신 Adjust 링크를 검토하여 아웃풋이 예상한 구성 작동 방식과 일치하는지 확인합니다.