Ko ustvarite povezave v globino, jih je treba omogočiti v kompletu za razvoj programske opreme za merjenje, da jih boste lahko uporabili v oglaševalskih akcijah za aplikacije.
V tem članku je pojasnjeno, kako omogočite odloženo povezovanje v globino v podprtih neodvisnih partnerjih za dodeljevanje za aplikacije (APP) ali v najnovejšem kompletu za razvoj programske opreme Googla Analytics za platformo Firebase (GA4F). Preberite, kako sledite sledenju konverzijam za aplikacije za mobilne naprave z orodji neodvisnih ponudnikov.
Preden začnete
Če želite omogočiti odloženo povezovanje v globino v podprtem partnerju za dodeljevanje za aplikacije, morate imeti delujoče povezave v globino, ki so ustrezno vključene v priloženi vir ali predložene kot odloženo povezovanje v globino za skupino oglasov.
Navodila
Aktiviranje odloženega povezovanja v globino v podprtih partnerjih za dodeljevanje za aplikacije
Neodvisni partnerji za dodeljevanje za aplikacije, ki jih Google trenutno podpira za odloženo povezovanje v globino, so:
- Adjust
- AppsFlyer
- Branch
- Kochava
- Singular
Če želite izbranemu partnerju za dodeljevanje za aplikacije omogočiti odloženo povezovanje v globino, upoštevajte spodnja navodila.
Adjust
AppsFlyer
- V partnerju AppsFlyer kliknite Configuration > Integrated Partners (Konfiguracija > Partner za integracijo) in izberite Google Ads (AdWords).
- Na zavihku Integration (Integracija) omogočite »Deferred deep linking with Google feeds« (Odloženo povezovanje v globino z Googlovimi viri).
- Kliknite Save integration (Shrani integracijo).
Branch
Kochava
Singular
Preberite več o sledenju konverzijam za aplikacije s partnerjem za dodeljevanje za aplikacije.
Aktiviranje odloženega povezovanja v globino v kompletu za razvoj programske opreme Googla Analytics za platformo Firebase
DDL lahko aktivirate v kompletu za razvoj programske opreme GA4F tako, da uporabite različico Androida 17.2.0+ ali novejšo različico, in sicer tako, da upoštevate ta navodila:
Postopek za aktiviranje funkcije DDL v kompletu za razvoj programske opreme GA4F
1. Konfiguriranje aplikacije za uporabo storitve Google Analytics za platformo Firebase
V elementu build.gradle aplikacije odstranite vse odvisnosti s firebase-core
. Nato dodajte ali posodobite odvisnost s firebase-analytics
različice 17.2.0+. V spodnjem primeru je uporabljena novejša različica kompleta za razvoj programske opreme.
odvisnosti {
...
implementacija 'com.google.firebase:firebase-analytics:21.0.0'
...
}
2. Omogočanje te funkcije v aplikaciji
Spremenite manifest aplikacije tako, da oznaki aplikacije dodate naslednjo oznako z metapodatki.
<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">
<!-- Vrednost, ki bo dodana za omogočanje odloženih povezav v globino -->
<meta-data android:name="google_analytics_deferred_deep_link_enabled" android:value="true"/>
<activity
android:name=".MainActivity" >
</activity>
</application>
</manifest>
Ko je ta funkcija omogočena, GA4F pridobi konfigurirano povezavo v globino ob zagonu aplikacije za ustrezno oglaševalsko akcijo, ki ste jo konfigurirali.
3. Zajem povezave v globino
V glavnem razredu dejavnosti zagona nastavite poslušalca sprememb nastavitev SharedPreferences. Ta se bo sprožil, ko bo DDL na voljo. Če boste poslušalca registrirali pozneje v življenjskem ciklu aplikacije, bo povezava v globino morda že pridobljena. V tem primeru se poslušalec ne bo sprožil in vrednost povezave v globino lahko takoj poiščete z branjem nastavitev SharedPreferences.
GA4F shrani povezavo v globino v datoteki SharedPreferences google.analytics.deferred.deeplink.prefs
s ključem deeplink
. GA4F shrani v isti datoteki SharedPreferences tudi časovni žig klika oglasa s ključem timestamp
. Upoštevajte, da je oblika časovnega žiga v mikrosekundah (milisekundah, ki ji sledi pika in mikrosekunde) ter da je časovni žig shranjen v datoteki SharedPreferences prek možnosti »Long« (Dolgo), kadar je vrsta »Double«. Uporabite DoubleBitsToDouble(...), da razčlenite dejansko vrednost.
Primer:
/**
* Glavna dejavnost zagona aplikacije.
*/
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. Priprava podatkov za diagnostično preizkušanje
Če želite preveriti implementacijo, prenesite AdID za napravo, s katero želite izvesti preizkus. S tem ukazom lahko nastavite povezavo DDL, ki jo bo prejela aplikacija.
"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"
Če želite preveriti, ali je bila povezava v globino pravilno nastavljena, lahko s to zahtevo preverite odziv.
Ta preizkusna povezava v globino poteče po 24 urah. Ponovite ta korak, če preizkusna povezava v globino poteče.
5. Omogočanje preizkusnega načina za pridobitev preizkusne povezave DDL
Če želite začeti preizkušati v napravah, omogočite preizkusni način za DDL.
adb shell setprop debug.deferred.deeplink <<vaš paket aplikacije>>
Nato v napravi omogočite način za odpravljanje napak. Začnite uporabljati aplikacijo in v mehanizmu Logcat preverite, ali je pri vrednosti gmp_version
v sporočilu v dnevniku prikazano vsaj 18200
. Če poiščete ključno besedo deferred
, boste filtrirali vsa sporočila o odpravljanju napak iz Googla Analytics za platformo Firebase, ki se nanašajo na zadevno funkcijo.
Primer:
D/FA: Funkcija odloženega povezovanja v globino je omogočena.
FA-SVC: Nalaganje podatkov. app, uncompressed size, data: <<vaš paket aplikacije>>,
…
gmp_version: 18200