[사용 중단] 모바일 랜딩 페이지 어트리뷰션 스크립트

설명:

메타 광고는 외부 어트리뷰션 링크를 사용하지 않는 SRN(Self Reporting Network)입니다.

앱이 처음 실행되면, 앱스플라이어는 해당 사용자가 이전에(최근 28일 이내) 페이스북 앱에서 광고주 광고와의 인게이지먼트가 있는지 메타 광고 측에 문의합니다. 그런 적이 있다면 메타 광고가 스스로 어트리뷰션합니다.

메타 광고는 또한 크로스 플랫폼에 어트리뷰션하며, 이는 사용자가 모든 플랫폼에서 모바일이든 아니든 모든 유형의 캠페인과 상호작용하여 메타 광고에 의해 자체 어트리뷰션할 수 있음을 의미합니다.

결론:

사용 가능한 기기 ID가 있는 잠재 고객이 페이스북 앱에서 랜딩 페이지로 이동하면 메타 광고에 올바르게 어트리뷰션됩니다. 이는 랜딩 페이지에 기록된 새로운 클릭과 관계없이 발생합니다.
그러나 2021년 기간에 iOS 14 사용자와 예상대로 사용자가 기기 ID를 공유하지 않을 경우 메타 광고의 크로스 플랫폼 어트리뷰션이 더 이상 작동하지 않을 수 있습니다.

기기 ID 공유가 선택 사항이 되면 메타 광고에 대해 다른 SRN 방법을 선택하세요. 

• 기기 ID를 공유하는 신규 사용자는 메타 광고에 올바르게 어트리뷰션됩니다.
• 기기 ID를 공유하지 않는 신규 사용자는 "Facebook_LP"에 어트리뷰션됩니다.

지침:

1. 메타 광고 계정에서 랜딩 페이지로의 전환에 대해 모바일 어트리뷰션을 하는'트래픽'이나 '전환' 캠페인을 설정하세요.
2. 랜딩 페이지 안드로이드 다운로드 버튼: 구글 플레이 바로가기 링크
3. 랜딩 페이지 iOS 다운로드 버튼- iTunes 바로가기 링크 (혹은 디바이스 ID 없는 어트리뷰션 링크)

스크립트 동작

랜딩 페이지 스크립트는 아무 변경사항을 만들지 않습니다. 랜딩 페이지 스크립트는 사용자가 페이스북 앱으로부터 유입되었다는 사실을 감지하도록 짜여져 있습니다. 페이스북으로부터 유입된 사용자를 감지한 후에는 아무것도 하지 않습니다. 랜딩 페이지의 앱스토어 바로가기 링크를 그대로 둡니다. 추가 클릭이 발생하지 않도록 하여, CTR(Click-Through Rate: 클릭 전환) 데이터에 영향을 주지 않습니다.

스크립트에서  isFacebook() 메서드를 찾아 사용자가 페이스북 앱에서 유입된 경우 스크립트가 어떻게 동작하는지 더 자세히 알아보세요.

설명:

구글 애즈 캠페인의 앱 설치 어트리뷰션 방식은 클릭하는 리드를 앱스토어 페이지 URL로 보내는 것입니다.

그래서 구글 애즈에서 랜딩 페이지로 리드를 보낼 때 , 모바일 앱 설치와 모바일이 아닌 구글 애즈 캠페인 클릭을 연결하는 중계자(mediator)를 사용하세요.

결론:

구글 애즈 어트리뷰션 솔루션은 두 부분으로 나뉩니다.

첫 번째 부분은 앱스플라이어에서 어트리뷰션하는 것입니다. 구글에서 랜딩 페이지로 들어와 앱을 설치한 모바일 사용자를 구글로 어트리뷰션합니다. 이를 위해 구글의 클릭 URL을 태그하여 구글로부터 랜딩 페이지에서 유입된 리드를 확인하고, 이 URL에 있는 데이터로 동적 원링크를 생성해야 합니다.

두 번째 부분은 구글 애즈에 앱 인스톨에 대해 알리는 것입니다. 구글의 오프라인 전환 업로드 메서드를 이용하여 알립니다.

지침:

Part 1 - 앱스플라이어에서 구글 애즈 어트리뷰션하기

스크립트 동작

구글 애즈에는  gclid 파라미터가 있습니다. 스크립트는 랜딩 페이지 URL에서 이 파라미터를 검색합니다. 파라미터를 찾으면, 사용자가 구글 애즈에서 유입되었다는 사실을 반영하는 원링크를 생성합니다. 그런다음 랜딩 페이지에 있는 다운로드 버튼 뒤에 생성된 원링크를 넣습니다.

스크립트에서  gclidValue를 찾아 스크립트가 어떻게 구글 애즈에서 유입되는 사용자를 감지하고 이에 따라 원링크를 생성하는지 확인하십시오.

설명:

예들 들어 스냅챗이나 트위터 같은 다른 SRN은 메타 광고와 달리 크로스 플랫폼이 아니어서 앱 설치 사용자를 어트리뷰션하려면 약간의 작업을 해야 합니다.

타 SRN에서 집행하는 캠페인으로부터 사용자가 랜딩 페이지로 유입되면 앱을 실제로 설치한 사용자가 아니라 광고를 클릭해서 랜딩 페이지까지만 도달한 사람 기준으로 광고비가 발생합니다.

결론:

메타 광고와 구글 애즈를 제외한 SRN에 집행하는 캠페인을 어트리뷰션 하기 위해서는 랜딩 페이지 URL을 정의할 때, 광고 성과 어트리뷰션 SRN을 알려주는 파트너 ID 파라미터를 추가합니다.
랜딩 페이지는 자바 스크립트(아래)를 실행시켜 이 파트너 ID 파라미터를 파싱(parsing: 분석)하고 파트너 ID 값이 들어간 원링크 URL을 생성합니다. 모바일 사용자가 원링크를 클릭하고 앱을 설치하면 파트너 ID 파라미터 값으로 알 수 있는 매체에 어트리뷰션이 기록됩니다.

지침:

SRN 광고 계정에서

1. 비 모바일 캠페인을 생성하세요.
2. 랜딩 페이지 URL을 정의할 때, 파트너 ID + 랜딩 페이지 파라미터를 추가하세요. (랜딩 페이지 URL은 앱스플라이어 어트리뷰션 링크가 아닙니다.) 형식은 "&af_pid=srn_lp"입니다. (아래 예 참조)

랜딩 페이지 로드에서

1. generateUrl 자바스크립트 함수를 활성화하세요.
2. 이 함수는 af_pid 파라미터를 찾고 pid 파라미터 값을 포함하여 원링크 URL을 생성합니다.
3. 랜딩 페이지의 앱 다운로드 버튼은 이렇게 생성된 원링크 URL을 사용합니다.
4. 신규 앱 사용자 획득에 대해 이렇게 광고주가 정의한 "파트너 ID + 랜딩 페이지" 미디어소스를 어트리뷰션으로 기록합니다.
5. 미디어소스에 포스트백이 전송되지 않습니다.

스크립트 자체에 이러한 이름을 사용하지 않도록 하는 로직이 있습니다. 스크립트에서 var SRNs를 찾습니다. SRN 이름 목록과 pidValue가 이 이름들을 체크하는 조건을 확인하실 수 있습니다. 스크립트 테스트를 완료한 후에 이 로직을 제거하십시오.

스크립트 동작

스크립트는 랜딩 페이지 URL에서 af_pid 파라미터를 보고 사용자가 SRN이나 다른 사전 정의된 네트워크에서 유입되었음을 인지합니다. 스크립트는 이에 따라 원링크를 생성하여 랜딩 페이지 앱 다운로드 버튼 뒤에 설정합니다.

스크립트 동작에 대한 상세한 사항은 스크립트에서 pidValue를 검색하세요.

설명:

어트리뷰션 링크는 SRN이 아닌 모든 미디어소스(매체)에 사용됩니다. 어트리뷰션하고자 하는 수천 연동 파트너사와 온드 미디어에 사용됩니다.

다행히, 앱스플라이어 어트리뷰션 링크를 사용하여 랜딩 페이지 어트리뷰션을 하는 솔루션은 간단합니다. (메타 광고 어트리뷰션 방식과 유사함)

결론:

어트리뷰션 링크는 리드(lead)를 랜딩 페이지로 리디렉션하여, 리디렉션 후 앱 설치가 발생하면 정확히 어트리뷰션을 합니다.

새로운 라스크 클릭으로 정확한 어트리뷰션을 막지 않도록 하기만 하면 됩니다.

지침:

1. 어트리뷰션할 미디어소스에 대한 어트리뷰션 링크를 생성하십시오.
2. 생성된 어트리뷰션 링크에 랜딩 페이지로 연결하는랜딩 페이지 파라미터를 추가하십시오.
3. 어트리뷰션 링크에 있는 리디렉션 파라미터의 랜딩 페이지 값(즉, af_r, af_ios_url 및 af_android_url)에 &af_redirect=true를 추가하십시오.
   예: https://yourapp.onelink.me/abcd?pid=email&c={CAMPAIGN_NAME}&af_r=http://www.yoursite.com/yourlandingpage?af_redirect=true
4. 선택사항 - 디바이스 ID(GAID / IDFA)를 어트리뷰션 링크에 추가하면 확률적 모델링 대신 ID 매칭을 할 수 있습니다.
5. 랜딩 페이지 안드로이드 앱 다운로드 버튼 - 구글 플레이 바로가기 연결
6. 랜딩 페이지 iOS 앱 다운로드 버튼 - iTunes 바로가기 연결
   
   

   참고

   스크립트와 HTML 샘플 페이지는 안드로이드와 iOS 모두 지원하는 하나의 다운로드 버튼을 설정하는 옵션을 제공합니다. 스크립트의 주석을 읽고 구현하는 방법을 학습하십시오.

스크립트 동작

스크립트는 랜딩 페이지 URL에서 af_redirect 파라미터를 찾습니다. 발견하면, 랜딩 페이지의 앱 다운로드 버튼에 아무런 변경을 하지 않습니다. af_redirect 파라미터는 사용자가 클릭 후 랜딩 페이지에 도달한다는 것을 의미하기 때문입니다. 그러므로, 추가 어트리뷰션 링크가 필요하지 않습니다.

사용자가 어트리뷰션 링크 클릭 후 랜딩 페이지에 도달하는 경우, 스크립트가 어떻게 동작하는지에 대한 상세한 내용은 스크립트 내 isAFLink()를 찾아 보세요.

설명

UTM 파라미터가 있는 링크를 사용하여 랜딩 페이지로 사용자를 리디렉션하는 트래픽 소스가 있습니다.

결론:

원래 URL이 앱스플라이어 어트리뷰션 링크가 아니면, 스크립트는 그 링크에서  utm_source와 utm_campaign 파라미터를 찾습니다. 이 파라미터들이 존재하면, 스크립트는 원링크 URL을 준비하고 원링크 URL에서 이들이 각각 미디어소스명(pid), 캠페인 이름(c)가 됩니다.

앱스플라이어 어트리뷰션 링크는 UTM 파라미터를 포함하기 때문에 UTM파라미터가 아니라 앱스플라이어 파라미터가 사용됩니다.

지침:

미디어소스에서 하는 작업:

1. 링크에 utm_source가 존재하는지 확인하십시오.
2. utm_campaign 파라미터는 선택사항이지만 있는 것이 훨씬 좋습니다.

랜딩 페이지 로드에서

1. generateUrl 자바스크립트 함수를 활성화하세요.
2. 함수가  utm_source와 utm_campaign파라미터를 검색하고 이 파라미터들의 값을 포함하는 원링크 URL을 생성합니다.
3. 랜딩 페이지의 앱 다운로드 버튼은 이렇게 생성된 원링크 URL을 사용합니다.
4. 신규 모바일 앱 사용자에 대해   utm_source 파라미터의 값이 미디어소스로서 어트리뷰션으로 기록됩니다. 
5. 미디어소스에 포스트백이 전송되지 않습니다.

스크립트 동작

스크립트는 랜딩 페이지 URL에서 UTM 파라미터를 검색합니다. UTM 파라미터를 발견하면, 이를 원링크 파라미터로 변환합니다. 이런 식으로, 캠페인 정보가 최종 어트리뷰션으로 전달됩니다.

설명

모바일 오가닉 사용자는 '알려지지 않은 소스에서 유입된 모바일 웹 리드(lead)'로 정의됩니다. 랜딩 페이지를 바로 방문하는 경우는 드물지만 모바일 앱을 설치하는 모바일 오가닉 사용자는 대부분 광고주의 웹사이트에서 유입될 수 있습니다.

결론:

광고주의 웹사이트에서 모바일 앱으로 유입되는 오가닉 트래픽이 상당히 많은 경우에는, 어트리뷰션 데이터를 광고주 자사의 트래픽으로 기록하는 것이 좋습니다.

지침:

모바일 오가닉 사용자를 어트리뷰션하려면, 웹사이트에 원링크 어트리뷰션 링크를 설정한 다운로드 버튼이나 앱 설치 버튼이 있어야 합니다. 원링크는 디바이스 종류를 감지하여 감지된 디바이스에 따라 리드(lead)를 적절한 앱스토어로 안내합니다.

원링크 URL 설정 방법은 여기를 참조하십시오.

스크립트 동작

스크립트는 먼저 다른 어트리뷰션 방식들을 다 적용해서 검토한 후에, 신규 사용자가 캠페인으로 유입되지 않은 오가닉 사용자임을 확정합니다. 스크립트는 원링크를 생성하여 이 사실을 반영하고 랜딩 페이지의 다운로드 버튼 뒤에 생성된 원링크를 넣습니다.

설명

위 모든 방식은 사용자가 캠페인과 랜딩 페이지에 반응하여 행동할 때, 모바일 디바이스를 이용한다는 전제 하에 가능합니다.

그러면 데시크톱 사용자는 어떻게 어트리뷰션할까요?

데스크톱 사용자는 랜딩페이지/웹사이트에 도착한 후 '독립적으로' 모바일 디바이스로 앱스토어를 방문하여 모바일 앱을 설치합니다. 모바일 디바이스로 참여하지 않는 사용자들을 어트리뷰션하기는 불가능합니다. 그래서 이들은 '오가닉'으로 분류됩니다.

결론:

이러한 문제는 데스크톱 사용자일 경우, 랜딩 페이지에서 앱 다운로드 메시지를 위한 양식 을 사용하여 해결할 수 있습니다. 모바일 디바이스로 원링크 URL이 들어있는 SMS 문자메시지나 이메일을 보내는 방식입니다.

지침:

1. 우선, 방문자가 데스크톱 사용자임을 인식합니다.
2. 사용자가 전화번호를 입력하면, 앱을 설치할 수 있는 원링크 숏링크 URL을 문자 메시지로 보냅니다. 랜딩 페이지에 이메일 주소를 입력하도록 하여 앱 다운로드 메시지를 이메일로 전송할 수도 있습니다.
3. 원링크를 사용하는 것이 여기에서 매우 중요합니다. 메시지 전송 시점에서는 모바일 디바이스 OS를 알 수 없기 때문입니다. 원링크는 자동으로 모바일 디바이스 OS를 감지하고 OS에 따라 알맞은 앱스토어로 리디렉션합니다.
4. 이 소스를 확인할 수 있도록 "&pid=desktop_website" 를 원링크 URL에 추가하십시오.
5. "&c={PAGE NAME}"을 추가하여 웹사이트에서 데스트톱 사용자의 전환율이 가장 높은 페이지와 가장 낮은 페이지를 확인하십시오.

스크립트 동작

스크립트는 사용자가 접속한 디바이스나 OS를 감지합니다. 데스크톱이면, 스크립트는 웹 형식 URL로 이어지는 링크를 리턴하고, 이 링크를 다운로드 버튼 뒤에 놓습니다. 사용자가 다운로드 버튼을 클릭하면 개인 정보를 입력할 수 있는 웹 양식으로 이동하고, 여기에 입력한 정보, 즉, 핸드폰 번호나 이메일 주소로 앱 다운로드 링크가 전송됩니다.

스크립트에서 웹 양식을 사용하고 앱 다운로드 링크를 전송하는 것은 선택사항입니다. 상세 내용은 스크립트에서  isMobileDevice()를 찾아 확인하십시오.

스크립트를 구현하기 전 다음 사항을 숙지하십시오.

• 이 스크립트는 예시일 뿐입니다. 이 스크립트는 일반적인 랜딩 페이지 어트리뷰션 과정을 다룹니다. 이 스크립트를 귀사의 요건에 따라 응용하십시오.
• 이 스크립트는 랜딩 패이지 URL에서 미디어소스, 캠페인, 키워드 같은 특정 파라미터를 검색합니다. site ID나 ad set같은 파라미터를 추가하시려면, 이 스크립트를 그에 따라 변경해야 합니다.

//Returns the value of a parameter existing in the page's URL or ' ' if not exists.
function getParameterFromURL(name, url) {
  if (!url) url = window.location.href;
  name = name.replace(/[\[\]]/g, '\\$&');
  var regex = new RegExp('[?&]' + name + '(=([^&#]*)|&|#|$)'),
    results = regex.exec(url);
  if (!results) return null;
  if (!results[2]) return '';
  return decodeURIComponent(results[2].replace(/\+/g, ' '));
}

function isMobileDevice() {
  return (typeof window.orientation !== "undefined") || (navigator.userAgent.indexOf('IEMobile') !== -1);
}

function getMobileOperatingSystem() {
  var userAgent = navigator.userAgent || navigator.vendor || window.opera;
  if (userAgent) {
    if (/android/i.test(userAgent)) {
      return "Android";
    }

    // iOS detection from: http://stackoverflow.com/a/9039885/177710
    if (/iPad|iPhone|iPod/.test(userAgent) && !window.MSStream) {
      return "iOS";
    }
  }
  return "unknown";
}

function isAFLink() {
  return getParameterFromURL('af_redirect');
}


// Note - when device ID sharing becomes optional stop calling this method (or always return false)
function isFacebook() {
  if (document.referrer && document.referrer != "") {
    return document.referrer.toLowerCase().includes('facebook');
  } else {
    return false;
  }
}

// generateUrl returns the URL to use behind the iOS and Android "Download" buttons on a landing page, based on the source of the page visitor.
// By default these buttons should direct to the apps' pages on iTunes and Google Play.
// If these links should be kept with no change, generateUrl returns ' '.
// Otherwise, generateUrl returns the URL to be used under BOTH buttons (a single app download button could also be used in this case).
// Parameters: isDebug - if true, alerts are issued for each of the cases, otherwise not.  	 
function generateUrl(isDebug) {
  var oneLinkURL = 'https://yourapp.onelink.me/abcd';   // **** Replace with your own basic OneLink URL ****
  var webFormURL = 'https://yoursite.com/webform.html'; // **** Replace with your own web form URL for getting the user's email or SMS ****
  var finalURL = "";
  var partnerIDParam = '?pid=';

  var campaignValue;
  if (getParameterFromURL('c')) {
    campaignValue = getParameterFromURL('c');
  } else if (getParameterFromURL('utm_campaign')) {
    campaignValue = getParameterFromURL('utm_campaign');
  } else if (document.getElementsByTagName('title')[0]) {
    campaignValue = document.getElementsByTagName('title')[0].innerText;
  } else {
    campaignValue = 'unknown';
  }
  var campaignParam = '&c=';
  var gclidParam = '&af_sub1=';
  var gclidValue = getParameterFromURL('gclid');
  var kwParam = '&af_keywords=';
  var pidValue;
  var kwValue = getParameterFromURL('keyword');
		
  if (getParameterFromURL('af_pid')) {
    pidValue = getParameterFromURL('af_pid');
  } else if (getParameterFromURL('utm_source')) {
    pidValue = getParameterFromURL('utm_source');
  }
  
  // Prevent the use of real SRN names. Remove this part after you are done testing the script.
    var SRNs = [
    'twitter_int',
    'facebook_int',
    'snapchat_int',
    'doubleclick_int',
    'yahoogemini_int',
    'yahoojapan_int',
  ];

  if (SRNs.includes(pidValue)) {
  	alert("DO NOT USE NAMES OF SRNS IN af_pid or utm_source - use the names listed in Other SRNs: Add Parameter section in the landing page article\nhttps://support.appsflyer.com/hc/en-us/articles/360000677217#other-srns-add-parameter");
    return;
  }

  // Desktop user
  if (!isMobileDevice()) {
    return webFormURL;
  }

  // User was redirected using af_r parameter on an AppsFlyer attribution link
  if (isAFLink()) {
    if (isDebug) {
      alert("This user comes from AppsFlyer by redirection and is ready to be attributed. \nKeep direct app store links.");
    }
    return; // in this case, the original store links in the install buttons stay the same

    /*
    If you want one install button in the landing page that serves both iOS and Android, uncomment the code below
    The code identifies the operating system and returns the relevant direct link to Google Play or iTunes
 
    if (getMobileOperatingSystem() === 'Android') {
      return 'direct link to Google Play';
    } 
 
    if (getMobileOperatingSystem() === 'iOS') {
      return 'direct link to iTunes';
    }
    */
  }

  // Google Ads
  if (gclidValue) {
    partnerIDParam += 'google_lp';
    campaignParam += campaignValue;
    gclidParam += gclidValue
    if (!kwValue) {
      finalURL = oneLinkURL + partnerIDParam + campaignParam + gclidParam;
      if (isDebug) {
        alert("This user comes from Google AdWords\n " + finalURL);
      }
      return finalURL;

    } else { // Google Ads with KW
      kwParam += kwValue;
      finalURL = oneLinkURL + partnerIDParam + campaignParam + gclidParam + kwParam;
      if (isDebug) {
        alert("This user comes from Google AdWords - there is a keyword associated with the ad\n " + finalURL);
      }
      return finalURL;
    }

  // Other SRNs and custom networks  
  } else if (pidValue) {
    campaignParam += campaignValue;
    partnerIDParam += pidValue;
    finalURL = oneLinkURL + partnerIDParam + campaignParam;
    if (isDebug) {
      alert("This user comes the SRN or custom network " + pidValue + "\n" + finalURL);
    }
    return finalURL;
  } else if (isFacebook()) {
    if (isDebug) {
      alert("This user comes from a paid Facebook ad - don't do anything. \nKeep direct app store links.");
    }
    return ' ';
    
  } else { // organic mobile user
    campaignParam += campaignValue;
    partnerIDParam += 'website'; //**** Replace value if you wish organic users to be attributed to another media source than 'website' ****
    finalURL = oneLinkURL + partnerIDParam + campaignParam;
    if (isDebug) {
      alert("This user comes from an unknown mobile source.\n The user would be attributed to media source 'website' and to the campaign " + campaignParam + "\n" + finalURL);
    }
    return finalURL;
  }
}

<html>
<head>
  <title>Landing Page</title>
</head>
<body>
  <h1>Landing Page</h1>
  <!-- By default, the install buttons should have direct links to the stores -->
  <div>
    <a id="andrd_link" href="https://play.google.com/store/apps/details?id=com.appsflyer.sampleapp"><img src="/images/andrd.png"alt=""></a>
  </div>
  <div>
    <a id="ios_link" href="https://itunes.apple.com/us/app/id3********"><img src="/images/ios.png" alt=""></a>
  </div>
  <!-- If you want one button to serve both Android and iOS, use the code below instead
  <a id="store_link" href=""><img src="download.png" alt=""></a>
  -->
  <script type="text/javascript" src="/landing-page-test.js"></script>
  <script type="text/javascript">
    window.onload = function () {
      var url = generateUrl(true);

      // onelink is generated
      if (url) {
        document.getElementById('andrd_link').setAttribute('href', url);
        document.getElementById('ios_link').setAttribute('href', url);
      }

      //otherwise, if onelink is not generated it means that the user is redirected
      // and the store links in the buttons stay the same

      /* for the one button solution for both Android and iOS, use the code below instead

      document.getElementById('store_link').setAttribute('href', url);

      */

    };
  </script>
</body>

</html>