După ce ați creat linkuri directe, va trebui să le activați în kitul dvs. SDK de măsurare pentru a le folosi în campaniile pentru aplicații.
Din acest articol veți afla cum să activați linkurile directe amânate (DDL) în Parteneri de atribuire a aplicațiilor (AAP) de la o terță parte care au fost acceptați sau în cel mai recent kit SDK Google Analytics pentru Firebase (GA4F). Aflați cum să faceți Urmărirea conversiilor în aplicațiile mobile cu ajutorul instrumentelor de la terți.
Înainte să începeți
Pentru a activa linkurile directe amânate (DDL) la un Partener de atribuire a aplicațiilor (AAP) acceptat, trebuie să aveți linkuri directe funcționale, care sunt incluse corespunzător în feedul lor atașat sau trimise ca un link direct amânat (DDL) pentru grupul de anunțuri.
Instrucțiuni
Cum activați linkuri directe amânate la parteneri de atribuire a aplicațiilor acceptați
Partenerii de atribuire a aplicațiilor terță parte acceptați de Google pentru linkuri DDL sunt următorii:
- Adjust,
- AppsFlyer,
- Branch,
- Kochava,
- Singular.
Urmați pașii de mai jos pentru a activa linkurile DDL la partenerul de atribuire a aplicațiilor (AAP) pe care l-ați ales.
Adjust
AppsFlyer,
- În AppsFlyer, dați clic pe Configurație > Parteneri integrați, apoi selectați Google Ads (AdWords).
- În fila Integrare, activați „Linkuri directe amânate cu feeduri Google”.
- Dați clic pe Salvați integrarea.
Branch
Kochava
Singular.
Aflați mai multe Despre urmărirea conversiilor în aplicație cu ajutorul unui partener de atribuire a aplicațiilor.
Cum să activați linkuri directe amânate (DDL) în SDK-ul GA4F
Puteți activa linkuri directe amânate în SDK-ul GA4F folosind Android versiunea 17.2.0 sau o versiune ulterioară sau o versiune mai nouă, urmând acești pași:
Pașii pentru activarea linkurilor directe amânate în SDK-ul GA4F
1. Configurați-vă aplicația pentru a folosi Google Analytics pentru Firebase
În fișierul build.gradle al aplicației, eliminați toate dependențele de pe firebase-core. Apoi, adăugați sau actualizați dependența de firebase-analytics versiunea 17.2.0 sau o versiune ulterioară. Exemplul de mai jos folosește o versiune mai nouă a SDK-ului.
dependențe {
...
implementare 'com.google.firebase:firebase-analytics:21.0.0'
...
}2. Activați funcția în aplicația dvs.
Modificați manifestul aplicației adăugând următoarea etichetă de metadate la eticheta aplicației dvs.
<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">
<!-- Valoare de adăugat pentru a activa linkurile directe amânate -->
<meta-data android:name="google_analytics_deferred_deep_link_enabled" android:value="true"/>
<activity
android:name=".MainActivity" >
</activity>
</application>
</manifest>Dacă opțiunea este activată, GA4F va prelua la începutul aplicației linkul direct configurat, pentru campania corespunzătoare pe care ați configurat-o.
3. Capturați linkul direct
Configurați un listener al modificărilor SharedPreferences în clasa cu activități principale de lansare. Acesta va fi declanșat când este disponibil un link direct amânat. Dacă înregistrați listenerul mai târziu în ciclul de viață al aplicației, este posibil ca linkul direct să fi fost deja preluat. În acest caz, listenerul nu va fi declanșat și puteți căuta imediat valoarea linkului direct citind SharedPreferences.
GA4F stochează linkul direct într-un fișier SharedPreferences google.analytics.deferred.deeplink.prefs cu cheia deeplink. GA4F stochează în același fișier SharedPreferences și marcajul temporal pentru clicul pe anunț cu marcajul timestamp al cheii. Rețineți că formatul marcajului temporal este în microsecunde (milisecunde urmate de un punct și de microsecunde) și este stocat în SharedPreferences folosind un cod Long când tipul este Double. Folosiți Double.longBitsToDouble(...) pentru a analiza valoarea reală.
Exemplu:
/**
* Activitatea principală de lansare a aplicației.
*/
clasă publică 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. Pregătiți datele pentru testarea de diagnosticare
Pentru a valida implementarea, obțineți ID-ul publicitar pentru dispozitivul cu care doriți să testați. Puteți folosi următoarea comandă pentru a seta linkul direct amânat pe care îl va primi aplicația.
"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"Pentru a verifica dacă linkul direct a fost setat corect, puteți folosi această solicitare pentru a verifica răspunsul.
Acest link direct de testare expiră după 24 de ore. Repetați acest pas dacă linkul direct de testare expiră.
5. Activați modul de testare pentru preluarea linkului direct amânat de testare
Activați modul de testare pentru linkul direct amânat pentru a începe testarea pe dispozitive.
adb shell setprop debug.deferred.deeplink <<your application package>>Apoi, activați modul de remediere a erorilor pe dispozitivul dvs. Începeți să folosiți aplicația și în Logcat verificați că mesajul de înregistrare în jurnal afișează o valoare gmp_version de cel puțin 18200. Căutarea cuvântului cheie deferred va filtra toate mesajele de remediere a erorilor de la Google Analytics pentru Firebase care sunt legate de funcția respectivă.
Exemplu:
D/FA: funcția Link direct amânat este activată.
FA-SVC: Se încarcă date. aplicație, dimensiune necomprimată, date: <<aplicația dvs. package>>,
…
gmp_version: 18200
