Створивши посилання на контент, ви маєте активувати перехід за ними в пакеті SDK для відстеження, щоб використовувати ці посилання в кампаніях для додатків.
У цій статті описано, як увімкнути перехід до контенту після встановлення додатка в підтримуваних сервісах сторонніх партнерів з атрибуції для додатків або найновішій версії пакета Google Analytics for Firebase (GA4F) SDK. Дізнайтесь, як відстежувати конверсії в мобільних додатках за допомогою сторонніх інструментів.
Перш ніж почати
Щоб увімкнути перехід до контенту після встановлення додатка в підтримуваних сервісах партнерів з атрибуції для додатків, потрібно мати дійсні посилання на контент, які належним чином долучено до фіду або для яких налаштовано перехід до контенту після встановлення додатка в групі оголошень.
Вказівки
Як активувати перехід до контенту після встановлення додатка через сервіси підтримуваних партнерів з атрибуції додатків
Нижче наведено, для сервісів яких сторонніх партнерів з атрибуції додатків Google підтримує перехід до контенту після встановлення додатка.
- 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
Ви можете активувати такий перехід у пакеті GA4F SDK на пристроях Android 17.2.0 або новіших версій, виконавши наведені нижче дії.
Кроки для активації переходу за посиланням після встановлення додатка в пакеті GA4F SDK
1. Налаштуйте додаток, щоб використовувати Google Analytics для Firebase
У файлі build.gradle папки app вилучіть усі залежності 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>
Коли функцію буде ввімкнено, під час запуску додатка GA4F витягуватиме сконфігуроване посилання на контент для відповідної налаштованої кампанії.
3. Витягніть посилання на контент
Налаштуйте прослуховувач змін SharedPreferences у класі запуску основної активності. Він активується, коли відкладене посилання на контент буде доступним. Якщо ви реєструєте прослуховувач на пізніших етапах життєвого циклу додатка, імовірно, посилання на контент уже доступне. У такому разі прослуховувач не активується, проте ви можете відразу дізнатися значення посилання на контент, зчитавши SharedPreferences.
GA4F зберігає посилання на контент у файлі SharedPreferences google.analytics.deferred.deeplink.prefs
із ключем deeplink
, а також позначку часу кліку оголошення з ключем 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 = "The deep link retrieval failed";
} else if (toastText.isEmpty()) {
toastText = "Deep link empty";
}
Toast.makeText(MainActivity.this, toastText, Toast.LENGTH_LONG).show();
Log.d("DEEPLINK", toastText);
}
}
4. Підготуйте дані для діагностичного тестування
Виконайте перевірку, отримавши рекламний ідентифікатор для пристрою, за допомогою якого хочете провести тестування. Щоб налаштувати відкладене посилання на контент, яке отримає додаток, можна скористатися наведеною нижче командою.
"www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<your device adid>>&id_type=adid&bundleid=<<your application package>>&deeplink=<<deeplink you want to receive>>&ddl_test=1"
Щоб дізнатись, чи правильно налаштовано посилання на контент, для перевірки відповіді можна скористатися запитом нижче.
Якщо термін дії тестового посилання на контент (24 години) завершиться, вам потрібно буде повторити цей крок.
5. Увімкніть режим тестування переходу за посиланням після встановлення додатка
Щоб почати тестування переходу за посиланням після встановлення додатка на своїх пристроях, увімкніть відповідний режим.
adb shell setprop debug.deferred.deeplink <<your application package>>
Далі ввімкніть на своєму пристрої режим налагодження. Почніть користуватися додатком і перевірте в Logcat запис у журналі. Для версії gmp_version
має показуватися значення принаймні 18200
. Якщо ви введете в пошуку ключове слово deferred
, то відфільтруєте всі повідомлення про налагодження від Google Analytics для Firebase, що стосуються переходу за посиланням після встановлення додатка.
Приклад
D/FA: Deferred Deep Link feature enabled.
FA-SVC: Uploading data. app, uncompressed size, data: <<your application package>>,
…
gmp_version: 18200