След като създадете преки връзки, трябва да ги активирате в използвания от Вас SDK за измерване, за да ги използвате в кампаниите си за приложения.
В тази статия се обяснява как да активирате отложено създаване на пряка връзка (DDL) в поддържани партньори за приписването при приложения (AAP) на трети страни или в най-новата версия на SDK на Google Анализ за Firebase (GA4F). Научете как да проследявате реализациите от мобилни приложения с инструменти на трети страни.
Преди да започнете
За да активирате отложено създаване на пряка връзка в поддържан партньор за приписването при приложения, трябва да имате работещи преки връзки, които да са правилно включени в прикачената им емисия или да са изпратени като отложено създавани преки връзки на ниво рекламна група.
Инструкции
Как да активирате отложено създаваните преки връзки при партньори за приписването при приложения
Понастоящем поддържаните от Google AAP на трети страни за DDL са:
- Adjust
- AppsFlyer
- Branch
- Kochava
- Singular
Изпълнете стъпките по-долу, за да активирате отложено създаване на пряка връзка в избрания от вас партньор за приписването при приложения.
Adjust
AppsFlyer
- В AppsFlyer кликнете върху Configuration > Integrated Partners и изберете Google Ads (AdWords).
- В раздела Integration активирайте Deferred deep linking with Google feeds.
- Кликнете върху Save integration.
Branch
Kochava
Singular
Научете повече за проследяването на реализациите от приложения чрез партньор за приписването при приложения.
Как да активирате отложено създаваните преки връзки в SDK на GA4F
Можете да активирате отложено създаваните преки връзки в SDK на GA4F, като използвате Android 17.2.0 или по-нова версия и изпълните следните стъпки:
Стъпки за активиране на отложено създаваните преки връзки в SDK на GA4F
1. Конфигурирайте приложението си да използва Google Анализ за Firebase
В приложението build.gradle премахнете всички необходими ресурси на firebase-core
. След това добавете или актуализирайте необходимия ресурс за firebase-analytics
версия 17.2.0 или по-нова. Примерът по-долу използва по-нова версия на SDK.
dependencies {
...
implementation 'com.google.firebase:firebase-analytics:21.0.0'
...
}
2. Активирайте функцията в приложението си
Променете манифеста на приложението си, като добавите следния маркер за метаданни към маркера application.
<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">
<!-- Value to be added to enable deferred deep links -->
<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
. GA4F също така съхранява в същия файл клеймото за дата и час на кликването върху рекламата с ключ 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. Подгответе данните за диагностични тестове
За да проверите изпълненото от Вас внедряване, получете ID за рекламиране за устройството, с което искате да тествате. Можете да използвате следната команда, за да зададете отложено създаваната пряка връзка, която ще бъде получена от приложението
"www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<ID за рекламиране за устройството Ви>>&id_type=adid&bundleid=<<пакетът на приложението Ви>>&deeplink=<<пряката връзка, която искате да получите>>&ddl_test=1"
За да разберете дали пряката връзка е зададена правилно, можете да проверите отговора на тази заявка.
Тази тестова пряка връзка изтича след 24 часа. Повторете тази стъпка, ако тестовата пряка връзка изтече.
5. Активирайте тестовия режим, за да извлечете тестовата отложено създавана пряка връзка
Активирайте тестовия режим за отложено създаване на преки връзки, за да започнете тестване на устройствата си.
adb shell setprop debug.deferred.deeplink <<пакетът на приложението Ви>>
След това активирайте режима за отстраняване на грешки на устройството си. Започнете да използвате приложението си и в Logcat проверете дали съобщението в регистрационния файл показва gmp_version
от поне 18 200
. Търсенето на ключовата дума deferred
ще филтрира всички съобщения за отстраняване на грешки от Google Анализ за Firebase, свързани с тази функционалност.
Пример:
D/FA: Deferred Deep Link feature enabled.
FA-SVC: Uploading data. app, uncompressed size, data: <<пакетът на приложението Ви>>,
…
gmp_version: 18200