Адреса для метрики. Рекомендации

Как правило, сеанс метрики в системе MobileAppTracking™ (MAT) запускает пользователь, который просматривает адрес для метрики или нажимает на него. Эта операция связывается с последующим событием в приложении или с установкой и присваивается рекламному партнеру, который стимулировал пользователя установить мобильное приложение (или совершить нужное действие внутри приложения).

Адрес для метрики позволяет с легкостью передавать в MAT крупные объемы данных. Адрес состоит из нескольких обязательных параметров и большого количества дополнительных (например, для присвоения цвета в отчетности или ее углубления). Используя правильные параметры и следуя этим рекомендациям, можно создавать удобные адреса для метрики и настраивать подробную отчетность для своего бизнеса.

 

Базовая структура адреса для метрики MAT

Стандартный адрес для метрики MAT состоит из трех частей. Каждая из этих частей обязательна.

1. Базовый доменный URL-адрес (обязательно)

Существует уже большое количество базовых доменов (например, api-02 или api-03), и регулярно вводятся новые. В базовый URL уже включен идентификатор партнера MAT, для которого создавался URL.

 

2. Параметр действия (обязательно)

Обязательный параметр. Нужен, чтобы различать ссылки для кликов и ссылки для показов. Возможные значения:

  • ?action=click – для подсчета кликов;
  • ?action=impression – для подсчета просмотров.

3. Параметры приложения и кампании (обязательно)

  • &publisher_id=MAT_PUBLISHER_ID – определяет сетевого партнера;
  • &site_id=MAT_APP_ID – указывает на приложение, на которое ведет ссылка;
  • &offer_id=MAT_CAMPAIGN_ID – указывает на кампанию, с которой связана ссылка.

4. Уникальные идентификаторы устройств (необязательно, но рекомендуется)

Рекомендуется указывать в базовой ссылке для метрики MAT уникальные идентификаторы устройств – они обеспечивают атрибуцию 1:1 со стопроцентной точностью. Обратите внимание: вам необходимо либо жестко задать эти параметры, либо указать значение через макрос { }, который поддерживает данная рекламная сеть.

  • &ios_ifa=Value – iOS IFA (простой)
  • &ios_ifa_md5=Value – MD5-хеширование IFA
  • &ios_ifa_sha1=Value – SHA1-хеширование IFA
  • &device_id=Value — EMEI, только для устройств Android
  • &device_id_md5=Value
  • &device_id_sha1=Value
  • &device_id_sha256=Value
  • &android_id/&os_id=Value – идентификатор Android ID или Windows Hardware ID (простой)
  • &android_id_md5/&os_id_md5=Value – идентификатор Android ID или Windows Hardware ID (MD5-хеширование)
  • &android_id_sha1&os_id_sha1=Value – идентификатор Android ID или Windows Hardware ID (SHA1-хеширование)
  • &windows_aid=Value – идентификатор Windows Advertising ID
  • &windows_aid_md5=Value – идентификатор Windows Advertising ID (MD5-хеширование)
  • &windows_aid_sha1=Value – идентификатор Windows Advertising ID (SHA1-хеширование)
  • &user_id=Value – произвольный идентификатор, который назначается пользователю приложением. Чаще всего используется в кампаниях по повторному вовлечению.
  • &tpid=Value – постоянный уникальный идентификатор устройства, общий для всех приложений. Был создан TRUSTe в качестве безопасной замены устаревшего UDID. Как правило, не используется.
  • &mac_address=Value – устаревший
  • &mac_address_md5=Value – устаревший
  • &mac_address_sha1=Value – устаревший
  • &odin=Value – устаревший

Partner_Guide_-_Measurement_URLs_-_New_Page.png

Параметры оптимизации кампании

Кампания регулирует отношения ваших рекламных партнеров и мобильного приложения. Не создавайте кампанию для каждого партнера или источника трафика – несмотря на то, что поначалу такой подход может показаться разумным, он быстро станет обузой, когда счет пойдет на сотни и тысячи кампаний. Одна кампания MAT позволяет работать с любым количеством партнеров.

Воспринимайте деятельность каждого из партнеров как субкампанию в одной большой кампании MAT. Не создавайте для партнера новую кампанию – вместо этого воспользуйтесь параметромmy_campaign в адресе для метрики. Это справедливо и в том случае, если вам нужно сегментировать отчетность по рекламным объявлениям (my-ads), группам объявлений (my_adgroups), сайтам (my_site) и т. д. Подробное описание субпараметров для организации маркетинговой отчетности по мобильному приложению вы найдете ниже.

Рекламодателям и их партнерам нужны разные данные и разная отчетность, поэтому и те и другие могут включать субпараметры в адреса для метрики (см. схему ниже). У рекламодателей есть доступ как к своим субпараметрам, так и к субпараметрам партнеров. У партнеров есть доступ только к своим субпараметрам. Субпараметры указываются в отчетности по текущим данным и по когортам, а также в журналах. Это позволяет с легкостью анализировать и сравнивать эффективность рекламы.

Best_Practices_for_Tracking_Links_2_URL_Params.png
 

Партнерские субпараметры для оптимизации кампании

Партнерам доступны следующие шесть субпараметров для кампаний

  • sub_publisher – значение sub_publisher, переданное на адрес для метрики по клику. Это название или идентификатор издателя партнера.
  • sub_site – значение sub_site, передаваемое на адрес для метрики по клику. Это название или идентификатор партнерского сайта или мобильного приложения.
  • sub_campaign – значение sub_campaign, передаваемое на адрес для метрики по клику. Это название или идентификатор кампании, которая рекламируется партнером.
  • sub_adgroup – значение sub_adgroup, передаваемое на адрес для метрики по клику. Это название или идентификатор группы объявлений, которая рекламируется партнером.
  • sub_ad – значение sub_ad, передаваемое на адрес для метрики по клику. Это название или идентификатор рекламного объявления, которое рекламируется партнером.
  • sub_keyword – значение publisher_sub_keyword, передаваемое на адрес для метрики по клику. Это название или идентификатор релевантного ключевого слова для интеграции в Google AdWords (или в кампании контекстной рекламы в других поисковых системах).

Те или иные параметры используются в зависимости от структуры партнерской системы. Не у всех партнеров есть данные по каждому из шести параметров оптимизации.

 

Субпараметры рекламодателя для оптимизации кампании

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

  • my_partner – значение my_publisher, передаваемое на адрес для метрики по клику. Это имя или идентификатор партнера рекламодателя.
  • advertiser_sub_site – значение my_site, передаваемое на адрес для метрики по клику. Это название или идентификатор сайта или мобильного приложения рекламодателя.
  • advertiser_sub_campaign – значение my_campaign, передаваемое на адрес для метрики по клику. Это название или идентификатор кампании.
  • advertiser_sub_adgroup – значение my_adgroup, передаваемое на адрес для метрики по клику. Это название или идентификатор группы объявлений.
  • advertiser_sub_ad – значение my_ad, передаваемое на адрес для метрики по клику. Это название или идентификатор рекламного объявления.
  • advertiser_sub_keyword – значение my_keyword, передаваемое на адрес для метрики по клику. Это название или идентификатор релевантного ключевого слова для интеграции в Google AdWords (или в рекламные кампании в других поисковых системах).

Те или иные параметры используются в зависимости от структуры рекламной системы. Не у всех рекламодателей есть данные по каждому из шести параметров оптимизации.

 

sub_publisher / my_partner

Как правило, параметр sub_publisher предоставляют только рекламные сети, поскольку они выступают в роли посредников между несколькими партнерами (издателями) и рекламодателем. Некоторые рекламные сети передают имена или идентификаторы партнеров, позволяя анализировать и оптимизировать эффективность их работы. Чаще всего рекламная сеть передает имя или идентификатор партнера динамически, поэтому данную функцию придется запрашивать отдельно. Если партнер дает рекламу в слепой сети, он не сможет передавать партнерскую информацию (sub_publisher). Как правило, у прямых партнеров (не из рекламной сети) нет субиздателей.

К примеру, рекламная сеть монетизирует трафик через сервис интернет-радио «Pandora». Таким образом, субпараметр publisher_id ассоциируется с таким же субпараметром, созданным в MAT. В этом случае параметр sub_publisher имеет значение «Pandora» (см. примеры ссылок для метрики далее).

  • Пример рекламодателя:
    https://12345.api-02.com/serve?action=click&publisher_id=100&site_id=1000&my_partner=Pandora
  • Пример партнера:
    https://12345.api-02.com/serve?action=click&publisher_id=100&site_id=1000&sub_publisher=Pandora

 

sub_site / my_site

Если вы даете рекламу в мобильной сети, параметр sub_site определяет веб-сайт или свойство, которое выводит рекламу (мобильные приложения также считаются сайтами). Если ваш партнер – крупный издатель видеоигр, а вы рекламируетесь в его мобильных приложениях, устанавливайте для параметра sub_site названия или идентификаторы этих приложений. Если речь идет о покупке через определенное рекламное объявление в конкретном мобильном приложении, значение sub_site можно задать жестко, а не генерировать его динамически. Рекламные сети также могут передавать значение параметра sub_site, но они должны делать это динамически, так как для сетей нетипична привязка к покупкам на конкретных сайтах.

К примеру, вы рекламируете свое приложение у разработчика игр, который владеет несколькими приложениями. Тогда в параметр sub_site динамически подставляется название приложения (см. примеры адресов для метрики далее).

  • Пример рекламодателя:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&my_site={sub_site}
  • Пример партнера:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub_site={sub_site}

 

sub_campaign / my_campaign

В кампании определяется рекламный план вашего мобильного приложения. Как правило, кампания состоит из названия, целевого URL (адрес целевой страницы), цены или ставки, а также самих рекламных объявлений для кампании. Обычно рекламные сети и партнеры не передают название или идентификатор кампании динамически, поэтому следует вручную прописать этот параметр в адресе для метрики (в зависимости от партнера, может понадобиться также прописать названия или идентификаторы групп объявлений).

К примеру, вы ведете две кампании (одна стимулирующая, вторая – нет) с одним и тем же партнером. Вы задаете для параметра sub_campaign значение Incentivized (стимулирующая), чтобы различать их (см. примеры адресов для метрики ниже).

  • Пример рекламодателя:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&my_campaign=Incentivized-US
  • Пример партнера:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub_campaign=Incentivized-US

 

sub_adgroup / my_adgroup

Партнеры, которые используют группы объявлений, могут динамически указывать значение параметра adgroup в своем адресе для метрики. Партнеры, которые не используют группы, обычно пользуются двухуровневой системой управления кампаниями и объявлениями в каждой кампании. Если группы объявлений нет, параметр sub_adgroup не может использоваться для метрики.

К примеру, вы создаете группу объявлений на баннерах 728х90. Ваш адрес для метрики будет выглядеть примерно так:

  • Пример рекламодателя:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&my_adgroup=Banner728x90
  • Пример партнера:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub_adgroup=Banner728x90

 

sub_ad / my_ad

Через параметр sub_ad можно передавать название или идентификатор рекламного объявления, которое настраивалось для партнера. Как правило, значение для каждого объявления прописывается напрямую. Если у вас пять разных объявлений, для каждого из них напрямую прописывается название.

К примеру, вы создаете группу объявлений на баннерах 728х90, и у вас есть синий баннер под названием AdwithBlue. Тогда ваш адрес для метрики будет выглядеть примерно так:

  • Пример рекламодателя:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&my_adgroup=Banner728x90&my_ad=AdwithBlue
  • advertiser_sub_ad как числовой идентификатор:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&my_adgroup=Banner728x90&my_ad=101
  • Пример партнера:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub_adgroup=Banner728x90&sub_ad=AdwithBlue
  • sub_ad как числовой идентификатор:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub_adgroup=Banner728x90&sub_ad=10

 

sub_keyword / my_keyword

С помощью параметра sub_keyword можно передавать название или идентификатор релевантного ключевого слова для интеграции в Google AdWords (или другие кампании в поисковых системах). Ниже приводятся примеры.

  • Пример рекламодателя:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&my_keyword=MyKeyword
  • Пример партнера:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub_keyword=PartnerKeyword

 

Дополнительные параметры синхронизации

MAT поддерживает пять дополнительных субпараметров, они доступны в отчетности URL возврата данных и в журналах. Как правило, там хранится уникальная информация для партнеров, которая не стандартизирована для кросс-канального анализа и поэтому недоступна в общих отчетах.

Дополнительные параметры:

  • sub1 – строка дополнительной информации, указанной партнером;
  • sub2 – строка дополнительной информации, указанной партнером;
  • sub3 – строка дополнительной информации, указанной партнером;
  • sub4 – строка дополнительной информации, указанной партнером;
  • sub5 – строка дополнительной информации, указанной партнером.

В следующем примере URL показывается пример адреса для метрики, в который входит параметр sub1.

 

В следующем примере URL показывается пример адреса для метрики, в который входят параметры sub1 и sub2.

 

Каждый из этих параметров может содержать любые нужные значения. Дополнительные субпараметры поддерживают строки до 500 символов (субпараметры для оптимизации поддерживают только строки до 100 символов).

Ссылочный идентификатор

Ссылочный идентификатор – дополнительный параметр (как и sub1sub5). В нем может храниться только ссылочный идентификатор из партнерской системы (также называемый идентификатором транзакции, клика, рекламным или трекинговым). Подробное описание этого параметра вы найдете в статье Для чего используются ссылочные идентификаторы?

 

Использование кода страны или IP устройства

Если партнер использует уникальную интеграцию с MAT и замеряет клики со стороны сервера, тогда все клики от этих партнеров (а также и все установки с этих кликов) поступают будто бы с географического расположения этих серверов. Чтобы устранить эту проблему, передавайте в MAT по клику двухзначный ISO-код страны или IP устройства, чтобы можно было выполнить атрибуцию в соответствии со страной, из которой была фактически выполнена установка.

  • country_code – это двух- или трехзначный ISO-код страны, из которой поступил клик.
  • device_ip – IP-адрес устройства, полученный при клике.

Передача данных о цене

Теперь данные о цене можно передавать динамически, через адрес для метрики.  Эта функция реализуется через параметры cost и cost_model. Подробное описание вы найдете в соответствующей статье.