스마트 스크립트 설정

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

시작에 앞서

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

요구 사항

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

이용 조건

새 스크립트 생성

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

베이스 링크 선택하기

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

1. 드롭다운에서 원하는 앱을 선택합니다.
2. 베이스 링크를 선택합니다.

파라미터 매핑

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

파트너 매핑

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

스크립트 배포

1. 스크립트 복사

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

2. 스크립트 배포

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

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

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

1. Google 태그 매니저로 이동합니다.
2. 태그 → 신규를 선택합니다. 구현은 개발자에게 달려있지만 다음 두 가지 태그를 만들 것을 권장합니다.

첫 번째 태그: '스마트 스크립트 로드'용

    <script>
    // Paste content of adjust-smart-script.min.js here
    </script>

두 번째 태그: '링크를 생성하고 다운로드에 첨부' 버튼용

    <script>
    // Then configure mapping and call AdjustSmartScript.createLink
    </script>

1. Tag Configuration을 선택한 다음 Custom HTML을 선택한 후에 <script>를 추가합니다.
2. 웹사이트의 모든 페이지가 아닌 특정 웹-앱 랜딩 페이지에서만 태그 실행/초기화 옵션을 환경 설정해야 할 수 있습니다.
3. '스마트 스크립트 로드' 태그를 먼저 실행합니다(페이지당 한 번 트리거됨).
4. 그런 다음 '링크를 생성하고 다운로드 버튼에 첨부' 태그를 실행합니다. 스크립트는 나가는 URL / Adjust 링크를 반환하며, 다운로드 버튼 뒤에 이 링크를 포함할 수 있습니다.
5. 이 기능이 완전히 도입되면 사용자가 웹 랜딩 페이지에서 '다운로드' 버튼을 클릭할 때 Adjust 링크는 사용자를 라우팅하고 모든 앱 전환을 웹 트래픽의 원래 소스로 다시 어트리뷰션합니다.

[선택] 스크립트 업데이트

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

스마트 스크립트 테스트

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

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

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

예시 로그:

[adjust-smart-script]: Use defaultLinkToken to create adjust link
[adjust-smart-script]: Found value for campaign is new_campaign
[adjust-smart-script]: Found value for adgroup is some_adset
[adjust-smart-script]: Found value for creative is logo_image
[adjust-smart-script]: Transformed value for ref_code is id+my_product
[adjust-smart-script]: Misconfigured deep link: no valid androidAppSchema provided```