Vytvořené přímé odkazy je třeba v sadě SDK pro měření povolit, abyste je mohli používat v kampaních na aplikace.
Tento článek vysvětluje, jak odložené přímé odkazy (DDL) aktivovat u podporovaných externích partnerů pro atribuci v kampaních na aplikace (AAP) a v nejnovější sadě SDK Google Analytics pro Firebase (GA4F). Přečtěte si, jak měřit konverze u mobilních aplikací pomocí nástrojů třetích stran.
Než začnete
Abyste mohli u podporovaných partnerů AAP odložené přímé odkazy aktivovat, musíte mít funkční přímé odkazy, které jsou správně zahrnuty v připojeném zdroji nebo odeslány jako DDL reklamní sestavy.
Pokyny
Aktivace odložených přímých odkazů prostřednictvím podporovaných partnerů pro atribuci v kampaních na aplikace
Externí partneři AAP, které společnost Google v současné době u odložených přímých odkazů podporuje:
- Adjust
- AppsFlyer
- Branch
- Kochava
- Singular
Podle níže uvedených pokynů odkazy DDL ve vybraném účtu partnera pro atribuci aktivujete.
Adjust
AppsFlyer
- Ve službě AppsFlyer klikněte na Konfigurace [Configuration] > Integrovaní partneři [Integrated Partners] a pak vyberte možnost Google Ads (AdWords).
- Na kartě Integrace [Integration] povolte možnost Odložené přímé odkazy se zdroji Google [Deferred deep linking with Google feeds].
- Klikněte na Save integration [Uložit propojení].
Branch
Kochava
Singular
Další informace o měření konverzí z aplikací pomocí partnera pro atribuci v kampaních na aplikace
Aktivace odložených přímých odkazů v sadě SDK GA4F
Odložené přímé odkazy můžete v sadě SDK GA4F aktivovat v systému Android verze 17.2.0 nebo novější takto:
Postup aktivování odložených přímých odkazů v sadě SDK GA4F
1. Nakonfigurujte aplikaci tak, aby používala Google Analytics pro Firebase.
V souboru build.gradle aplikace odstraňte všechny závislosti na firebase-core
. Poté přidejte nebo aktualizujte závislost na verzi firebase-analytics
17.2.0 nebo novější. Níže uvedený příklad používá novější verzi sady SDK.
dependencies {
...
implementation 'com.google.firebase:firebase-analytics:21.0.0'
...
}
2. Povolte funkci v aplikaci
Upravte manifest aplikace. Do značky aplikace přidejte níže uvedenou značku metadat.
<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">
<!-- Hodnota, jejíž přidání je třeba k povolení odložených přímých odkazů -->
<meta-data android:name="google_analytics_deferred_deep_link_enabled" android:value="true"/>
<activity
android:name=".MainActivity" >
</activity>
</application>
</manifest>
Jestliže je tato možnost zapnuta, načte GA4F při spuštění aplikace nakonfigurovaný přímý odkaz pro příslušnou nastavenou kampaň.
3. Zachyťte přímý odkaz
V hlavní třídě spouštěcí aktivity nastavte posluchač změn v souboru SharedPreferences. Spustí se, když bude k dispozici odložený přímý odkaz. Pokud posluchač zaregistrujete později v životním cyklu aplikace, je možné, že v tu chvíli už bude přímý odkaz načten. Posluchač se v takovém případě nespustí a hodnotu přímého odkazu budete moci okamžitě zjistit ze souboru SharedPreferences.
GA4F uloží přímý odkaz do souboru SharedPreferences google.analytics.deferred.deeplink.prefs
s klíčem deeplink
. Do stejného souboru SharedPreferences uloží GA4F i časové razítko kliknutí na reklamu s klíčem timestamp
. Časové razítko je uvedeno s přesností na mikrosekundy (milisekundy následované tečkou a mikrosekundami) a v souboru SharedPreferences je uloženo pomocí hodnoty Long, přičemž typ je Double. Skutečnou hodnotu zjistíte pomocí funkce Double.longBitsToDouble(...).
Příklad:
/**
* Hlavní aktivita při spouštění aplikace.
*/
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", "Přímý odkaz byl změněn");
if ("deeplink".equals(key)) {
String deeplink = sharedPreferences.getString(key, null);
Double cTime = Double.longBitsToDouble(sharedPreferences.getLong("timestamp", 0));
Log.d("DEEPLINK_LISTENER", "Získaný přímý odkaz: " + deeplink);
showDeepLinkResult(deeplink);
}
};
}
public void showDeepLinkResult(String result) {
String toastText = result;
if (toastText == null) {
toastText = "Přímý odkaz se nepodařilo získat";
} else if (toastText.isEmpty()) {
toastText = "Přímý odkaz je prázdný";
}
Toast.makeText(MainActivity.this, toastText, Toast.LENGTH_LONG).show();
Log.d("DEEPLINK", toastText);
}
}
4. Připravte data na diagnostické testování
Abyste mohli implementaci ověřit, zjistěte ID reklamy zařízení, na kterém chcete test provést. Pomocí níže uvedeného příkazu můžete nastavit odložené přímé odkazy, které aplikace obdrží.
"www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<ID reklamy vašeho zařízení>>&id_type=adid&bundleid=<<balíček vaší aplikace>>&deeplink=<<přímý odkaz, který chcete obdržet>>&ddl_test=1"
Pokud chcete zkontrolovat, zda byl přímý odkaz správně nastaven, můžete odpověď ověřit pomocí tohoto požadavku.
Platnost tohoto přímého odkazu je 24 hodin. Pokud platnost testovacího přímého odkazu vyprší, zopakujte tento krok.
5. Povolte testovací režim, v němž bude načten testovací odložený přímý odkaz
Až budete chtít začít na svých zařízeních testovat, zapněte režim testování odložených přímých odkazů.
adb shell setprop debug.deferred.deeplink <<balíček vaší aplikace>>
Poté na zařízení zapněte režim ladění. Začněte aplikaci používat a v nástroji Logcat zkontrolujte, zda zpráva protokolu obsahuje hodnotu gmp_version
alespoň 18200
. Vyhledáním klíčového slova deferred
vyfiltrujete všechny ladicí zprávy z Google Analytics pro Firebase související s touto funkcí.
Příklad:
D/FA: Deferred Deep Link feature enabled.
FA-SVC: Uploading data. app, uncompressed size, data: <<balíček vaší aplikace>>,
…
gmp_version: 18200