[Устарело] Скрипт атрибуции целевой страницы для мобильных устройств

Описание:

Meta-ads — это SRN (сеть с самостоятельной атрибуцией) и не использует внешние ссылки атрибуции.

При первом запуске приложения AppsFlyer запрашивает в Meta ads, взаимодействовал ли пользователь ранее (в течение последних 28 дней) с объявлением рекламодателя в приложении Facebook. Если да, Meta ads выполняет атрибуцию самостоятельно.

Meta ads также подразумевает кроссплатформенность, а это означает, что пользователь может взаимодействовать с кампаниями любого типа, мобильными и другими, на любой платформе, и при этом Meta ads выполняет атрибуцию самостоятельно.

Вывод

Лид с доступным идентификатором устройства, попавший из приложения Facebook на целевую страницу, правильно атрибутируется к Meta ads. Это происходит независимо от нового клика, зарегистрированного на целевой странице.
Однако если пользователи решат не предоставлять идентификатор своего устройства, как это ожидается с пользователями iOS 14 в 2021 году, кроссплатформенная атрибуция Meta Ads может перестать работать.

Когда предоставление идентификатора устройства станет необязательным, используйте метод других SRN для Meta ads. 

• Новые пользователи, которые предоставят свой идентификатор устройства, будут правильно атрибутированы к Meta ads.
• Новые пользователи, которые не предоставят свой идентификатор устройства, будут атрибутированы к «Facebook_LP».

Инструкции

1. В своем аккаунте Meta ads создайте кампанию с целью «Трафик» или «Конверсии» с включенной мобильной атрибуцией, отправляя лидов на целевую страницу.
2. Кнопка загрузки целевой страницы на Android — прямая ссылка на Google Play.
3. Кнопка загрузки целевой страницы iOS — прямая ссылка на iTunes (ИЛИ ссылка атрибуции без идентификатора устройства).

Что делает скрипт

Скрипт целевой страницы не вносит изменений. Скрипт предназначен для обнаружения пользователя, пришедшего из приложения Facebook. Если это так, скрипт ничего не делает. На целевой странице остаются прямые ссылки на магазины приложений в том виде, в каком они есть. Это предотвращает запись еще одного клика, что может повлиять на CTR.

В скрипте найдите метод isFacebook(), чтобы узнать больше о том, что делает скрипт, когда пользователь приходит из приложения Facebook.

Описание:

Обычный процесс атрибуции установок в кампаниях Google Ads требует перенаправления лидов по кликам на URL страницы магазина приложения.

Поэтому при перенаправлении лидов из Google Ads на целевую страницу используйте посредника, чтобы связать установку с мобильного устройства и первоначальный клик в кампании Google Ads не для мобильных устройств.

Вывод

Решение для Google Ads состоит из двух частей.

Первая часть — это атрибуция в AppsFlyer мобильных пользователей, которые переходят на целевую страницу из Google и устанавливают приложение оттуда. Для этого необходимо пометить URL-адреса кликов из Google, идентифицировать их на целевой странице и создать динамическую ссылку OneLink с данными из URL-адреса.

Вторая часть — уведомление Google Ads об этих мобильных установках с помощью метода загрузки конверсий Google в автономном режиме.

Инструкции

Часть 1. Атрибуция к Google Ads в AppsFlyer

Что делает скрипт

Google Ads содержит параметр gclid. Скрипт ищет этот параметр в URL-адресе целевой страницы. Если находит, то создает ссылку OneLink, отражающую, что пользователь пришел из Google Ads. Затем скрипт помещает OneLink в качестве ссылки в кнопке загрузки на целевой странице.

В скрипте найдите gclidValue, чтобы узнать, как скрипт обнаруживает пользователей, приходящих из Google Ads, и соответствующим образом создает OneLink.

Описание:

Другие SRN, например Snapchat или Twitter, не являются кроссплатформенными, как Meta ads, и для того, чтобы атрибутировать к ним пользователей мобильных устройств, потребуется немного потрудиться.

Ваши кампании с другими SRN приводят ваших пользователей на целевую страницу, и вам выставляют счета в соответствии с количеством переходов по ссылкам, что не связано с количеством мобильных пользователей.

Вывод

При определении URL-адреса целевой страницы для кампании в SRN (кроме Meta Ads и Google Ads) добавьте к URL-адресу параметр идентификатора партнера (Partner ID), в котором указана исходная SRN.
На целевой странице запускается код JavaScript (см. ниже), который анализирует этот параметр и создает URL-адрес OneLink со значением Partner ID. Когда пользователи мобильных устройств нажимают на эту ссылку OneLink и устанавливают приложение, они атрибутируются к указанному медиа-источнику.

Инструкции

В вашем аккаунте SRN:

1. Создайте немобильную кампанию
2. При определении URL-адреса целевой страницы добавьте к URL-адресу параметр Partner ID + целевая страница (который не является ссылкой атрибуции AF). Формат: &af_pid=srn_lp (см. пример ниже).

На вашей целевой странице:

1. Активируйте функцию Javascript generateUrl
2. Функция ищет параметр af_pid и создает URL-адрес OneLink, содержащий его значение в параметре pid
3. Кнопка загрузки на целевой странице использует сгенерированный URL-адрес OneLink.
4. Новые мобильные пользователи атрибутируются к пользовательскому медиа-источнику «Partner ID + landing page» (Идентификатор партнера + целевая страница).
5. В медиа-источник постбэки не отправляются.

Сам скрипт содержит логику, запрещающую использовать эти названия. Найдите в скрипте var SRNs. Вы должны увидеть список названий SRN и условие, проверяющее, содержит ли pidValue какое-либо из этих названий. Удалите эту логику после завершения тестирования скрипта.

Что делает скрипт

Скрипт видит параметр af_pid в URL-адресе целевой страницы и приходит к выводу, что пользователь является пользователем SRN или другой настраиваемой сети. Скрипт соответствующим образом создает ссылку OneLink и устанавливает ее в качестве ссылки в кнопке загрузки на целевой странице.

Чтобы узнать больше о том, что делает скрипт, найдите в скрипте значение pidValue.

Описание:

Ссылки атрибуции используются для любого медиа-источника, который не является SRN. Сюда входят тысячи интегрированных партнеров и любые собственные медиа, которые вы хотите указать.

К счастью, решение для атрибуции целевой страницы при использовании ссылок атрибуции AppsFlyer простое (и аналогично решению для Meta ads).

Вывод

ссылка атрибуции перенаправляет лида на целевую страницу и тем самым обеспечивает правильную атрибуцию (если после этого будет установлено мобильное приложение).

Осталось только НЕ препятствовать правильной атрибуции другим последним кликом.

Инструкции

1. Создайте ссылку атрибуции для медиа-источника.
2. Добавьте в нее параметр целевой страницы, ведущий на целевую страницу.
3. Добавьте &af_redirect=true в значение целевой страницы в любых параметрах перенаправления (например, af_r, af_ios_url и af_android_url) в ссылке атрибуции.
   Пример: https://yourapp.onelink.me/abcd?pid=email&c={CAMPAIGN_NAME}&af_r=http://www.yoursite.com/yourlandingpage?af_redirect=true
4. Необязательно: добавьте идентификатор устройства (GAID/IDFA) в ссылку атрибуции, чтобы разрешить атрибуцию путем сопоставления идентификаторов вместо вероятностного моделирования
5. Кнопка загрузки на целевой странице на Android — прямая ссылка на Google Play.
6. Кнопка загрузки на целевой странице на iOS — прямая ссылка на iTunes
   
   

    Примечание

   Скрипт и образец HTML предоставляют возможность настроить одну кнопку загрузки, которая подходит как для Android, так и для iOS. Прочитайте комментарии к скрипту, чтобы узнать, как его реализовать.

Что делает скрипт

Скрипт ищет параметр af_redirect в URL-адресе целевой страницы. Если находит, то не вносит никаких изменений в кнопки загрузки на целевой странице. Это связано с тем, что параметр af_redirect указывает, что пользователь попадает на целевую страницу после клика. Таким образом, нет необходимости в дополнительных ссылках атрибуции.

Подробнее о том, как скрипт обрабатывает случаи, когда пользователи попадают на целевую страницу после клика по ссылке атрибуции, см. метод isAFLink() в скрипте.

Описание

У вас могут быть источники трафика, которые перенаправляют пользователей на вашу целевую страницу по ссылкам с параметрами UTM.

Вывод

Если исходный URL-адрес НЕ является ссылкой атрибуции AppsFlyer, скрипт ищет в ссылке параметры utm_source и utm_campaign. Если они есть, скрипт подготавливает URL-адрес OneLink, в котором они используются в качестве названия медиа-источника (pid) и названия кампании (c) соответственно.

Обратите внимание, что в ссылках атрибуции AppsFlyer, которые также содержат параметры UTM, используются параметры AppsFlyer, а не параметры UTM.

Инструкции

В медиа-источнике:

1. Убедитесь, что в ссылке есть utm_source.
2. Параметр utm_campaign необязателен, но настоятельно рекомендуется.

На вашей целевой странице:

1. Активируйте функцию Javascript generateUrl
2. Функция ищет параметры utm_source и utm_campaign и создает URL-адрес OneLink, содержащий их значения.
3. Кнопка загрузки на целевой странице использует сгенерированный URL-адрес OneLink.
4. Новые мобильные пользователи атрибутируются к значению utm_source в качестве медиа-источника.
5. В медиа-источник постбэки не отправляются.

Что делает скрипт

Скрипт ищет параметры UTM в URL-адресе целевой страницы. Если они обнаружены, скрипт преобразует их в параметры OneLink. Таким образом, информация о кампании передается в окончательную атрибуцию.

Описание

Органические мобильные посетители — это, по определению, прямые посетители из неизвестных источников в мобильном интернете. Они редко посещают специальные целевые страницы, но, возможно, подавляющее большинство мобильных установок приходит с веб-сайта рекламодателя.

Вывод

Если с вашего веб-сайта поступает значительное количество органического мобильного трафика, настоятельно рекомендуется записывать данные атрибуции вашего собственного трафика.

Инструкции

Для атрибуции органических мобильных посетителей на веб-сайте должны быть кнопки загрузки или установки, а в них — ссылка атрибуции OneLink. OneLink позволяет диагностировать тип устройства и перенаправлять лидов в соответствующий магазин приложений.

Чтобы узнать, как настраивать и создавать URL-адреса OneLink, перейдите по этой ссылке.

Что делает скрипт

Исчерпав все остальные опции, скрипт определяет, что пользователь является органическим пользователем, не участвовавшим в какой-либо кампании. Скрипт создает ссылку OneLink, которая отражает это и помещает ее в качестве ссылки в кнопку загрузки на целевой странице.

Описание

Все описанные выше варианты предполагают, что пользователи используют мобильные устройства при взаимодействии с кампанией и целевой страницей.

Но как насчет пользователей настольных компьютеров?

Пользователи настольных компьютеров могут зайти на вашу целевую страницу или на сайт, а затем «самостоятельно» посетить магазин приложений со своих мобильных устройств и установить мобильное приложение. Без предварительного взаимодействия с мобильными устройствами невозможно атрибутировать этих пользователей, поэтому их относят к «органическим».

Вывод

Отличным решением этой проблемы с атрибуцией является использование формы «из СМС к скачиванию» на целевой странице только для пользователей настольных компьютеров. После этого необходимо отправить на мобильное устройство СМС или электронное письмо с URL-адресом OneLink.

Инструкции

1. Определите, что посетитель является пользователем настольного компьютера.
2. Когда пользователь вводит в форму свой номер телефона, отправьте ему текстовое сообщение со ссылкой на ваше приложение с коротким URL-адресом OneLink. Вы также можете запросить у него адрес электронной почты, чтобы отправить письмо для загрузки приложения.
3. Использование OneLink здесь имеет решающее значение, поскольку платформа мобильного устройства при отправке сообщения пользователю неизвестна. Функции диагностики и перенаправления OneLink позаботятся об этом за вас.
4. Добавьте «&pid=desktop_website» к URL-адресу OneLink, чтобы идентифицировать этот источник.
5. Добавьте «&c={PAGE NAME}», чтобы найти страницы с самой высокой и низкой конверсией на вашем сайте для пользователей настольных компьютеров.

Что делает скрипт

Скрипт определяет устройство или платформу, на которой находится пользователь. Если это настольный компьютер, скрипт возвращает ссылку на URL-адрес веб-формы и помещает ее в кнопки загрузки. Когда пользователь нажимает кнопку «Загрузить», он отправляется в веб-форму, где заполняет свои данные, чтобы получить SMS или электронное письмо со ссылкой для загрузки приложения.

Вы сами должны создать веб-форму и указать ее URL в скрипте.  Чтобы узнать больше, найдите isMobileDevice() в скрипте.

Перед реализацией скрипта учтите следующее:

• Скрипт приведен только в качестве примера. Он охватывает общую целевую страницу и поток атрибуции. Адаптируйте скрипт в соответствии со своими требованиями.
• Скрипт ищет определенные параметры в URL-адресе целевой страницы, такие как медиа-источник, кампания, ключевые слова и т. д. Если вы хотите добавить дополнительные параметры, такие как идентификатор сайта и группы объявлений, вам необходимо соответствующим образом изменить скрипт.

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