Создав ссылки на контент, включите их в своем SDK для отслеживания. Так вы сможете использовать эти ссылки в кампаниях для приложений.
В этой статье объясняется, как включить отложенные ссылки на контент в поддерживаемых сторонних партнерских сервисах для атрибуции конверсий в приложениях или в последней версии SDK Google Аналитики для Firebase. Подробнее о том, как отслеживать конверсии в мобильных приложениях с помощью сторонних инструментов…
Перед началом работы
Чтобы включить отложенные ссылки на контент в поддерживаемых партнерах по атрибуции конверсий в приложениях, необходимо иметь работающие ссылки на контент. Убедитесь, что они добавлены в соответствующий фид или переданы в виде отложенных ссылок на контент для группы объявлений.
Инструкции
Как активировать отложенные ссылки на контент в поддерживаемых партнерах по атрибуции конверсий в приложениях
В настоящее время отложенные ссылки на контент поддерживаются следующими сторонними партнерами по атрибуции конверсий в приложениях:
- Adjust;
- AppsFlyer;
- Branch;
- Kochava;
- Singular.
Чтобы включить отложенные ссылки на контент в партнерском сервисе для атрибуции конверсий в приложениях, выполните приведенные ниже инструкции.
Adjust
AppsFlyer
- В AppsFlyer нажмите Configuration > Integrated Partners (Конфигурация > Интегрированные партнеры), а затем выберите Google Ads (AdWords).
- На вкладке Integration (Интеграция) включите "Deferred deep linking with Google feeds" (Отложенная ссылка на контент с фидами Google).
- Нажмите Save integration (Сохранить интеграцию).
Branch
Kochava
Singular
Подробнее о том, как отслеживать конверсии в приложении с помощью партнера по атрибуции…
Как активировать отложенные ссылки на контент в GA4F SDK
Вы можете активировать отложенные ссылки на контент в SDK Google Аналитики для Firebase с помощью устройства Android версии 17.2.0 или более новой. Для этого выполните приведенные ниже инструкции.
Шаги по активации отложенных ссылок на контент в SDK Google Аналитики для Firebase
1. Настройте приложение так, чтобы оно использовало Google Аналитику для Firebase
В файле build.gradle приложения удалите все зависимости от firebase-core. Затем добавьте или измените зависимость от firebase-analytics версии 17.2.0 или выше. В приведенном ниже примере используется более новая версия SDK.
dependencies {
...
implementation 'com.google.firebase:firebase-analytics:21.0.0'
...
}2. Включите функцию в приложении
Отредактируйте файл манифеста приложения, добавив в тег приложения следующий тег метаданных:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.myawesome.app">
<uses-permission android:name="android.permission.INTERNET" />
<application
android:name=".MainActivity">
<!-- Значение, которое нужно добавить, чтобы включить отложенные ссылки на контент -->
<meta-data android:name="google_analytics_deferred_deep_link_enabled" android:value="true"/>
<activity
android:name=".MainActivity" >
</activity>
</application>
</manifest>Если сервис "Google Аналитика для Firebase" включен, при запуске приложения он будет получать настроенную ссылку на контент для соответствующей настроенной кампании.
3. Настройте ссылку на контент
Настройте прослушиватель изменения предпочтений SharedPreferences в основном классе Activity. Он будет запускаться, если доступна отложенная ссылка на контент. Если вы зарегистрируете прослушиватель позже в жизненном цикле приложения, ссылка на контент может быть получена до его запуска. В этом случае прослушиватель не будет активирован, и вы сможете сразу же найти значение ссылки на контент, прочитав SharedPreferences.
Google Аналитика для Firebase сохраняет ссылку на контент в файле SharedPreferences google.analytics.deferred.deeplink.prefs с ключом deeplink. В том же файле SharedPreferences Google Аналитика для Firebase также сохраняет временную метку клика по объявлению вместе с ключом timestamp. Обратите внимание, что формат временной метки использует микросекунды (миллисекунды, за которыми следуют точка и микросекунды) и сохраняется в SharedPreferences с использованием бита Long, если его тип – Double. Используйте Double.longBitsToDouble(...) для обработки фактического значения.
Пример
/**
* Основная активность запуска приложения.
*/
public class MainActivity extends AppCompatActivity {
private SharedPreferences preferences;
private SharedPreferences.OnSharedPreferenceChangeListener deepLinkListener;
@Override
protected void onStart() {
super.onStart();
preferences.registerOnSharedPreferenceChangeListener(deepLinkListener);
}
@Override
protected void onStop() {
super.onStop();
preferences.unregisterOnSharedPreferenceChangeListener(deepLinkListener);
deepLinkListener = null;
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
preferences =
getSharedPreferences("google.analytics.deferred.deeplink.prefs", MODE_PRIVATE);
deepLinkListener = (sharedPreferences, key) -> {
Log.d("DEEPLINK_LISTENER", "Deep link changed");
if ("deeplink".equals(key)) {
String deeplink = sharedPreferences.getString(key, null);
Double cTime = Double.longBitsToDouble(sharedPreferences.getLong("timestamp", 0));
Log.d("DEEPLINK_LISTENER", "Deep link retrieved: " + deeplink);
showDeepLinkResult(deeplink);
}
};
}
public void showDeepLinkResult(String result) {
String toastText = result;
if (toastText == null) {
toastText = "Ошибка получения ссылки на контент";
} else if (toastText.isEmpty()) {
toastText = "ссылка на контент пустая";
}
Toast.makeText(MainActivity.this, toastText, Toast.LENGTH_LONG).show();
Log.d("DEEPLINK", toastText);
}
}
4. Подготовьте данные для диагностического тестирования
Чтобы проверить правильность настройки, получите идентификатор AdID для устройства, которое вы хотите протестировать. Чтобы настроить отложенную ссылку, которую будет получать приложение, используйте приведенную ниже команду:
"www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<идентификатор adid вашего устройства>>&id_type=adid&bundleid=<<пакет приложения>>&deeplink=<<желаемая ссылка на контент>>&ddl_test=1"Чтобы проверить, правильно ли настроена ссылка на контент, вы можете использовать следующий запрос для проверки ответа:
Срок действия этой тестовой ссылки на контент истекает через 24 часа. Повторите этот шаг, если время ожидания тестовой ссылки на контент истекло.
5. Включите тестовый режим, чтобы получить тестовую отложенную ссылку на контент
Включите режим отложенного тестирования ссылок на контент, чтобы начать проверку на своих устройствах.
adb shell setprop debug.deferred.deeplink <<пакет приложения>>Затем включите режим отладки на вашем устройстве. Начните использовать свое приложение и в Logcat убедитесь, что сообщение в журнале о параметре gmp_version имеет значение не менее 18200. Введите ключевое слово deferred, чтобы отфильтровать все сообщения об отладке Google Аналитики для Firebase, касающиеся этой функции.
Пример
D/FA: отложенные ссылки на контент включены.
FA-SVC: Uploading data. app, uncompressed size, data: <<пакет приложения>>,
…
gmp_version: 18200
