Измерение эффективности кампании – Android SDK 2 (устаревшая версия)

Важно ! В этом документе описана устаревшая версия SDK. Новым пользователям следует использовать последнюю версию SDK .

В этом документе представлен обзор того, как измерять кампании и источники трафика с помощью Google Analytics SDK для Android v2.

Обзор

Измерение кампаний в Google Analytics может помочь вам повысить ценность ваших маркетинговых каналов, позволяя соотносить кампании и источники трафика с активностью пользователей в вашем приложении.

В Google Analytics SDK для Android доступно несколько видов измерения кампании:

• Измерение кампании Google Play – Узнайте, какие кампании, веб-сайты и приложения перенаправили пользователя на страницу вашего приложения в Google Play Store, чтобы загрузить его.
• Измерение общих кампаний . Узнайте, какие кампании или источники трафика запустили ваше приложение, оно было установлено.
• Измерение переходов . Узнайте, какой источник ссылающегося трафика, например веб-сайты или другие приложения, запустил ваше приложение после его установки.

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

Измерение кампании Google Play

Google Play Campaign Measurement позволяет вам увидеть, какие кампании и источники трафика побуждают пользователей загружать ваше приложение из Google Play Store. Мы рекомендуем всем разработчикам внедрить измерение кампаний в Google Play Store.

Как работает отслеживание кампаний в Google Play

Измерение кампании в Google Play Store основано на использовании параметров кампании для передачи информации о кампании и источнике трафика в ваше приложение во время его загрузки из Google Play Store.

Ниже приводится подробное описание того, как работает измерение кампании в Google Play:

1. Пользователь нажимает ссылку в объявлении, на веб-сайте или в приложении, которая ведет на страницу вашего приложения в Google Play Store. Ссылка отмечена тегом «Параметры кампании» .
2. После того, как пользователь загрузит и установит ваше приложение, Google Play Store отправит на устройство намерение INSTALL_REFERRER , которое включает в себя те же параметры кампании.
3. Затем ваше приложение отреагирует на это намерение, используя объект BroadcastReceiver , представленный ниже, прочитав параметры кампании и используя их для обновления информации о кампании Google Analytics.

Внедрение измерения кампании в Google Play

Чтобы реализовать измерение кампании в магазине Google Play:

1. Добавьте новый BroadcastReceiver в файл AndroidManifest.xml.

Следующий BroadcastReceiver позволяет вашему приложению реагировать на намерение INSTALL_REFERRER , транслируемое Google Play Store, когда ваше приложение установлено. Добавьте его в файл AndroidManifest.xml следующим образом:

<!-- Used for install referral measurement-->
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService"/>
<receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

Известная проблема . В настоящее время в Java-документе CampaignTrackingReceiver показан неправильный пример этого фрагмента.

2. Добавьте параметры кампании в ссылки в Google Play Store.

Параметры кампании используются для передачи информации о кампании или источнике трафика, который перенаправил пользователя на страницу вашего приложения в Google Play Store, в реализацию Google Analytics вашего приложения.

Чтобы узнать, как создать строку параметров кампании, воспользуйтесь Конструктором URL-адресов Google Play или обратитесь к справочному разделу «Параметры кампании» .

Создав строку параметров кампании, добавьте ее в URL-адреса своего магазина Google Play в качестве значения параметра referrer , как в этом примере:

https://play.google.com/store/apps/details?id=com.example.app
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Drunning%252Bshoes
%26utm_content%3DdisplayAd1
%26utm_campaign%3Dshoe%252Bcampaign

Магазин Google Play передаст значение параметра referrer только в реализацию Google Analytics вашего приложения, поэтому важно убедиться, что он присутствует в ваших ссылках в магазине Google Play.

Используете автоматическую пометку Google Рекламы? Вам не нужно предпринимать никаких дополнительных действий для пометки ссылок в Google Play Store, если они помечены автоматически. Узнайте, как включить автоматическую пометку Google Рекламы .

Измерение общих кампаний

Общие показатели кампании можно использовать, чтобы связать кампанию или источник трафика с пользователем после того, как он уже установил ваше приложение.

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

Реализация общего измерения кампании

Чтобы установить значения кампании для общей кампании, вызовите setCampaign() и передайте строку параметра кампании в качестве аргумента.

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

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before calling activityStart().
    EasyTracker.getInstance().setContext(this);

    if (intent.getData() != null) {
      EasyTracker.getTracker().setCampaign(uri.getPath());
    }
    ... // The rest of your onCreate() code.
  }

  @Override
  public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


  @Override
  public void onStop() {
    super.onStop();
    EasyTracker.getInstance().activityStop(this);
    ... // The rest of your onStop() code.
  }
}

Измерение рефералов

Измерение рефералов аналогично другим типам измерения кампаний в том, что оно позволяет вам измерить источник перехода, который запустил ваше приложение на устройстве пользователя. Однако для измерения рефералов используется простая строка, например «google.com» или «myOtherApp», а не строка параметров кампании.

Когда вы устанавливаете ссылающийся источник, например «google.com», для параметра источника устанавливается значение «google.com», а для среднего параметра неявно устанавливается значение «реферер».

Как и в случае с измерением кампании, установка ссылающегося источника по умолчанию приведет к тому, что следующий вызов отправки начнет новый сеанс.

В следующем фрагменте кода мы предполагаем, что вы пометили все ссылки, по которым открывается ваше приложение, либо параметрами кампании Google Analytics, либо простым параметром referrer , описывающим ссылающийся источник. Если параметр referrer присутствует при отсутствии других параметров кампании, информация о кампании пользователя обновляется новым источником перехода:

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before activityStart() is called.
    EasyTracker.getInstance().setContext(this);

    if (uri != null) {
      if(uri.getQueryParmeter("utm_source") != null) {    // Use campaign parameters if avaialble.
        EasyTracker.getTracker().setCampaign(uri.getPath());
      } else if (uri.getQueryParameter("referrer") != null) {    // Otherwise, try to find a referrer parameter.
        EasyTracker.getTracker().setReferrer(uri.getQueryParameter("referrer"));
      }
    }
  }


  @Override
    public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


  @Override
  public void onStop() {
    super.onStop();
    EasyTracker.getInstance().activityStop(this);
    ... // The rest of your onStop() code.
  }
}

Известные вопросы

• В примере использования Javadoc для CampaignTrackingReceiver используется неправильный путь к классу. См. раздел «Реализация измерения кампании в Google Play», чтобы узнать о правильном использовании.
• Для каждого приложения можно указать только один класс BroadcastReceiver . Если вам нужно включить два или более BroadcastReceivers из разных SDK, вам нужно будет создать собственный класс BroadcastReceiver , который будет получать все широковещательные сообщения и вызывать соответствующие BroadcastReceivers для каждого типа широковещательных сообщений.
• Google Play Campaign Measurement в настоящее время не поддерживает установку веб-на устройство, инициированную из интернет-магазина Play Store.

Параметры кампании

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

• При общем измерении кампании незакодированная строка параметра кампании передается в качестве аргумента функции setCampaign() .
• В Google Play Campaign Measurement параметр referrer со строкой закодированного параметра кампании в качестве значения добавляется ко всем URL-адресам, указывающим на страницу вашего приложения в Play Store.

Ниже приведен пример допустимой незакодированной строки кампании, которую можно использовать для общего измерения кампании:

"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"

В таблице ниже показан полный список доступных параметров кампании, которые можно использовать в Google Play или для общего измерения кампании.

Параметр	Описание	Примеры)
utm_campaign	Название кампании; используется для анализа ключевых слов для определения конкретного продвижения продукта или стратегической кампании.	utm_campaign=spring_sale
utm_source	Источник кампании; используется для идентификации поисковой системы, информационного бюллетеня или другого источника	utm_source=google
utm_medium	Канал кампании; используется для идентификации средства массовой информации, например электронной почты или цены за клик (cpc).	utm_medium=cpc
utm_term	Срок кампании; используется с платным поиском для предоставления ключевых слов для объявлений.	utm_term=running+shoes
utm_content	Содержание кампании; используется для A/B-тестирования и рекламы с таргетингом на контент, чтобы различать объявления или ссылки, ведущие на один и тот же URL-адрес.	utm_content=logolink utm_content=textlink
gclid	параметр автоматической пометки Google Рекламы ; используется для оценки Google Рекламы. Это значение генерируется динамически и никогда не должно изменяться.

Конструктор URL-адресов Google Play

Используйте конструктор URL-адресов Google Play для создания URL-адресов для измерения эффективности кампании в Google Play.