[非推奨] モバイルランディングページアトリビューションスクリプト

説明：

Meta広告はSRN（サーバー連携媒体）のため、アトリビューションに計測リンクを使用しません。

AppsFlyerは、アプリが最初に起動された際に、ユーザーが過去28日以内にFacebookアプリ上の広告主の広告と接触したことがあるかどうかをMeta広告に照会します。もしそうであれば、Meta広告は自己属性です。

Meta広告はクロスプラットフォームにも対応しています。つまり、ユーザーは、あらゆるプラットフォーム上で、モバイルかどうかに関わらず、あらゆるタイプのキャンペーンと関連付け、Meta広告へアトリビューションできます。

結論：

Facebookアプリからランディングページに到達したユーザーで利用可能なデバイス ID を持つリードは、Meta広告に正しく成果が紐づきます。これは、ランディングページに記録された新しいクリックに関係なく起こります。
ただし、2021年にリリースが予想されるiOS 14では、ユーザーがデバイスIDの共有をオプトアウトすると、Meta広告のクロスプラットフォームアトリビューションは機能しなくなる可能性があります。

デバイスIDの共有がオプションになる場合は、Meta広告で他のSRNメソッド を使用してください。 

• デバイスIDを共有する新規ユーザーは、Meta広告に正常に成果が紐づきます。
• デバイスIDを共有しない新規ユーザーは、「Facebook_LP」に成果が紐づきます。

手順：

1. Meta広告アカウントで、ランディングページへ遷移するように モバイルアトリビューションを有効にした "Traffic" または "Conversions" キャンペーンを作成します。
2. ランディングページ Androidダウンロードボタン - Google Playへの直接リンク
3. ランディングページ iOSダウンロードボタン - iTunesへの直接リンク（または端末IDを含まない計測リンク）

スクリプトの機能：

ランディングページスクリプトは変更を加えません。このスクリプトは、Facebookアプリからのユーザーを検出するように設計されています。存在する場合、何もせず、ランディングページのアプリストアへの直接リンクはそのままにします。これにより、CTRに影響を与える可能性のある別のクリックが記録されるのを防ぎます。

スクリプトで、 isFacebook() と呼ばれるメソッドを探し、ユーザーがFacebookアプリから来たときにスクリプトが実行する詳細を確認します。

説明：

Google広告キャンペーンのインストールアトリビューションの通常のプロセスでは、クリックのリードをアプリのストアページURLにリダイレクトする必要があります。

したがって、Google広告からランディングページにリードをリダイレクトする場合は、メディエーターを使用して、モバイルインストールとモバイル以外のGoogle広告キャンペーンの元のクリックとを結び付けます。

結論：

Google広告のソリューションには2つの部分があります。

最初の部分では、Googleからランディングページにアクセスし、そこからアプリをインストールするモバイルユーザーを AppsFlyerでアトリビューションします。GoogleからのクリックURLにタグを付け、ランディングページでそれを識別し、URLからのデータでダイナミックOneLinkを作成する必要があります。

2番目の部分は、Googleのオフラインコンバージョンのアップロード方法を使用して、これらのモバイルインストールについてGoogle広告に通知する処理をします。

手順：

パート1 - Google広告にアトリビューションする

スクリプトの機能：

Google広告には gclidパラメータが付いています。スクリプトは、ランディングページURLでこのパラメータを探します。表示された場合、ユーザーがGoogle広告から来ていることを反映するようにOneLinkを作成します。次に、スクリプトはOneLinkをリンク先ページのダウンロードボタンの背後にあるリンクとして配置します。

スクリプトで gclidValue を探し、スクリプトがGoogle広告からのユーザーを検出し、それに応じてOneLinkを作成する方法を学習します。

説明：

SnapchatやTwitterなどのその他のSRNは、Meta広告のようなクロスプラットフォームではなく、モバイルユーザーをその媒体にアトリビューションさせるには少し作業が必要です。

他のSRN媒体のキャンペーンでは、ユーザーをランディングページに誘導し、誘導されたモバイルユーザーとは無関係に、クリックリードに従って課金されます。

結論：

SRN（Meta広告およびGoogle広告以外）のキャンペーンのランディングページURLを定義する場合は、元のSRNを示すパートナーIDパラメータをURLに追加します。
ランディングページは、そのパラメーターを解析し、パートナーID値を持つOneLink URLを構築するjavaScript（下記参照）を起動します。モバイルユーザーがそのOneLinkをクリックしてインストールすると、指定されたメディアソースにアトリビューションされます。

手順：

SRN媒体アカウントで -

1. モバイル以外のキャンペーンを作成する
2. ランディングページURLを入稿する際に、パートナーID +ランディングページパラメータをURL（AFアトリビューションリンクではありません）に追加します。形式は" &af_pid=srn_lp "です（下の例を参照）。

ランディングページの読み込み時 -

1. generateUrl Javascript 機能を有効にする
2. この関数は af_pid パラメーターを探し、 pid パラメーターの下にその値を含むOneLink URLを作成します。
3. ランディングページに設置されているダウンロードボタンは、生成されたOneLink URLを使用します。
4. 新しいモバイルユーザーは、カスタム "パートナーID +ランディングページ" メディアソースにアトリビューションされます。
5. メディアソースにポストバックは送信されません。

スクリプト自体には、これらの名前を使用できないようにするロジックが含まれています。スクリプト内でvar SRNsを探してください。SRN名のリストと、 pidValueがこれらの名前のいずれかであるかどうかをチェックする条件が表示されます。スクリプトのテストが完了したら、このロジックを削除してください。

スクリプトの機能：

スクリプトは、ランディングページURLのaf_pidパラメータを確認し、ユーザーがSRNまたはその他のカスタムネットワークから来ていると結論付けます。スクリプトはそれに応じてOneLinkを作成し、それをランディングページのダウンロードボタンの背後にあるリンクとして設定します。

スクリプトの機能の詳細については、スクリプトで pidValue を探してください。

説明：

計測リンクは、SRN以外のすべてのメディアソースに使用されます。これには、何千もの連携済みパートナーと、アトリビューションさせたいオウンドメディアが含まれます。

AppsFlyerの計測リンクを使用する場合のランディングページアトリビューションのソリューションはシンプルです（Meta広告のソリューションに似ています）。

結論：

アトリビューションリンクは、リードをランディングページにリダイレクトし、これにより、正しいアトリビューションも処理します（モバイルインストールが続く場合）。

ラストクリックが再度発生し、正しいアトリビューションを妨げることがないようご注意ください。

手順：

1. メディアソース用の計測リンクを作成します。
2. ランディングページパラメータを、ランディングページに遷移する計測リンクに追加します。
3. 計測リンクのいずれのリダイレクトパラメータ（hat is, af_r, af_ios_url, and 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. ランディングページAndroidダウンロードボタン - Google Playへの直接リンク
6. ランディングページiOSダウンロードボタン - iTunesへの直接リンク
   
   

    注意

   スクリプトとHTMLサンプルページには、AndroidとiOSの両方に対応する1つのダウンロードボタンを設定するオプションがあります。スクリプト内のコメントから、実装方法をご確認ください。

スクリプトの機能：

スクリプトは、ランディングページURLで af_redirect パラメータを探します。表示された場合、ランディングページのダウンロードボタンは変更されません。これは、ユーザーがクリック後にランディングページに到達することをaf_redirectパラメータが示すためです。したがって、追加の計測リンク使用の必要はありません。

ユーザーが計測リンクをクリックした後にランディングページに到達した場合のスクリプトの処理について詳しくは、スクリプトのメソッド isAFLink() をご覧ください。

説明

UTMパラメータを使用したリンクを使用してユーザーをランディングページにリダイレクトするトラフィックソースがある場合があります。

結論：

元のURLがAppsFlyerの計測リンクでない場合、スクリプトはリンク内のutm_sourceおよびutm_campaignパラメータを検索します。存在する場合、スクリプトはそれらのutmパラメータを、それぞれメディアソース名（pid）およびキャンペーン名（c）として持つOneLink URLを準備します。

UTMパラメータを含むAppsFlyer計測リンクでは、UTMパラメータではなく、AppsFlyerパラメータが使用されていることに注意してください。

手順：

メディアソース・媒体上で -

1. リンクに utm_source が存在することを確認してください。
2. utm_campaignパラメータはオプションですが、付与することを強くお勧めします。

ランディングページの読み込み時 -

1. generateUrl Javascript 機能を有効にする
2. この関数は、utm_sourceおよびutm_campaignパラメーターを探し、それらの値を含むOneLink URLを作成します。
3. ランディングページに設置されているダウンロードボタンは、生成されたOneLink URLを使用します。
4. ユーザーはメディアソースとしてutm_source値にアトリビューションされます。
5. メディアソースにポストバックは送信されません。

スクリプトの機能：

スクリプトは、ランディングページURLでUTMパラメータを探します。見つかった場合は、OneLinkパラメータに変換します。このようにして、キャンペーン情報は最終的なアトリビューションに引き継がれます。

説明

オーガニックモバイル訪問者は、未知のソースからの直接的なモバイルWebリードです。専用のランディングページにアクセスすることは滅多にありませんが、広告主のWebサイトからのモバイルインストールの大部分が発生する可能性があります。

結論：

Webサイトからのモバイルオーガニックトラフィックが大量にある場合は、自分のトラフィックのアトリビューションデータを記録することを強くお勧めします。

手順：

オーガニックモバイル訪問者をアトリビューションするには、Webサイトに ダウンロード または インストール ボタンを配置し、OneLink計測リンクを背後に配置する必要があります。OneLinkを使用すると、デバイスタイプを判別し、それに応じてリードを正しいアプリストアにリダイレクトできます。

OneLink URLを設定および作成する方法は、こちらをご確認ください。

スクリプトの機能：

他のすべてのオプションを使い果たし、スクリプトは、ユーザーがどのキャンペーンにも属していないオーガニックユーザーであると判断します。スクリプトはそれを反映するOneLinkを作成し、それをリンク先ページのダウンロードボタンの後ろにリンクとして配置します。

説明

上記のすべてのオプションは、ユーザーがキャンペーンとランディングページに接触する際にモバイル端末を使用することを前提としています。

こちらでは、デスクトップユーザーのアトリビューションに関して説明します。

デスクトップユーザーはランディングページ / ウェブサイトにアクセスし、その後 "独立して" モバイル端末でアプリストアにアクセスし、モバイルアプリをインストールします。モバイルデバイスとの以前のエンゲージメントがない場合、これらのユーザーをアトリビューションすることは不可能であるため、オーガニックとして計測されます。

結論：

この問題の優れた解決策は、ランディングページでテキストをダウンロードするフォームを使用することです。これは、デスクトップユーザーのみを対象としています。ダウンロードボタンをクリックすると、モバイル端末にOneLink URLを含むSMS / Eメールを送信します。

手順：

1. 訪問者がデスクトップユーザーであることを識別する
2. ユーザーが電話番号を入力したら、OneLinkショートURLを使用して、アプリへのリンクをテキストメッセージで送信します。また、アプリのダウンロードメッセージをメールで送信するようにメールアドレスを要求することもできます。
3. ユーザーにメッセージを送信するときのモバイル端末プラットフォームは不明なため、OneLinkの使用はここでは非常に重要です。OneLinkの診断およびリダイレクト機能がこれを処理します。
4. このソースを識別するには、OneLink URLに "&pid=desktop_website" を追加します。
5. デスクトップユーザーのウェブサイトでコンバージョンページの良し悪しを見つけるのに役立つように、「&c={PAGE NAME}」を追加します。

スクリプトの機能：

スクリプトは、ユーザーが使用しているデバイスまたはプラットフォームを検出します。デスクトップの場合、スクリプトはWebフォームURLへのリンクを返し、ダウンロードボタンの後ろに配置します。ユーザーが [ダウンロード] をクリックすると、Webフォームに送信され、詳細を入力してSMSを取得するか、アプリをダウンロードするためのリンクが記載されたメールを受け取ります。

詳細は、スクリプトで isMobileDevice() を探してください。

スクリプトを実装する前に、次のことを考慮してください。

• スクリプトは例としてのみ提供されています。アトリビューションフローへの一般的なランディングページについて説明します。要件に合わせてスクリプトを調整してください。
• スクリプトは、メディアソース、キャンペーン、キーワードなど、ランディングページURL内の特定のパラメーターを探します。サイトIDや広告セットなどのパラメーターをさらに追加する場合は、それに応じてスクリプトを変更する必要があります。

//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>