Kun olet luonut täsmälinkit, sinun on otettava ne käyttöön mittaus-SDK:ssasi, jotta voit käyttää niitä Sovelluskampanjoissa.
Tässä artikkelissa kerrotaan, miten otat lykätyn täsmälinkityksen käyttöön tuetun kolmantena osapuolena toimivan AAP-kumppanin ratkaisussa tai uusimmassa Google Analytics for Firebase (GA4F) SDK:ssa. Lue, miten voit seurata mobiilisovellusten konversioita kolmannen osapuolen työkaluilla.
Ennen kuin aloitat
Jotta voit ottaa lykätyn täsmälinkityksen käyttöön tuetun AAP-kumppanin ratkaisussa, sinulla on oltava toimivia täsmälinkkejä, jotka on sisällytetty oikein niihin liitettyyn syötteeseen tai lähetetty mainosryhmän lykättynä täsmälinkityksenä.
Ohjeet
Näin otat lykätyn täsmälinkityksen käyttöön AAP-kumppanin ratkaisussa
Google tukee lykättyä täsmälinkitystä tällä hetkellä seuraavien kolmantena osapuolena toimivien AAP-kumppaneiden ratkaisuissa:
- Adjust
- AppsFlyer
- Branch
- Kochava
- Singular.
Ota lykätty täsmälinkitys käyttöön haluamasi AAP-kumppanin ratkaisussa seuraamalla alta löytyviä ohjeita.
Adjust
AppsFlyer
- Avaa AppsFlyer, klikkaa Configuration > Integrated Partners (Määritys > Integrointikumppanit) ja valitse Google Ads (AdWords).
- Siirry Integration (Integrointi) ‑välilehdelle ja ota käyttöön "Deferred deep linking with Google feeds" (Lykätty täsmälinkitys Google-syötteiden kanssa).
- Klikkaa Save integration (Tallenna integrointi).
Branch
Kochava
Singular
Lue lisää sovelluskonversioseurannasta App Attribution Partner (AAP) ‑kumppanin avulla.
Näin otat lykätyn täsmälinkityksen käyttöön GA4F SDK:ssa
Voit aktivoida lykätyn täsmälinkityksen GA4F SDK:ssa käyttämällä Android-versiota 17.2.0 tai uudempaa sekä seuraamalla näitä ohjeita:
Lykätyn täsmälinkityksen aktivointi GA4F SDK:ssa
1. Määritä sovelluksesi käyttämään Google Analytics for Firebasea
Poista sovelluksen build.gradle-tiedostosta kaikki riippuvuudet firebase-coreen
. Lisää tai päivitä riippuvuus vähintään firebase-analyticsin
versioon 17.2.0. Alla olevassa esimerkissä käytetään SDK:n uudempaa versiota.
dependencies {
...
implementation 'com.google.firebase:firebase-analytics:21.0.0'
...
}
2. Ota ominaisuus käyttöön sovelluksessa
Muokkaa sovelluksen manifestia lisäämällä sovellustagiin alla oleva metadatatagi.
<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>
Kun ominaisuus on käytössä, GA4F hakee kampanjalle määrittämäsi täsmälinkin sovelluksen käynnistymisen jälkeen.
3. Kerää täsmälinkki
Ota pääkäynnistystoiminnon luokassa käyttöön SharedPreferences-muutoskuuntelija. Se käynnistyy, kun lykätty täsmälinkitys on käytettävissä. Jos kuuntelijan rekisteröinti tapahtuu toiminnon elinkaaren myöhemmässä vaiheessa, täsmälinkki on jo saatettu hakea. Siinä tapauksessa kuuntelija ei käynnisty ja täsmälinkin arvon voi lukea välittömästi SharedPreferences-tiedostosta.
GA4F tallentaa täsmälinkin SharedPreferences-tiedostoon google.analytics.deferred.deeplink.prefs
avaimella deeplink
. GA4F tallentaa samaan SharedPreferences-tiedostoon myös mainosklikkauksen aikaleiman avaimella timestamp
. Huomaa, että aikaleima ilmaistaan mikrosekunteina (millisekunnit.mikrosekunnit) ja tallennetaan SharedPreferences-tiedostoon käyttämällä Long-argumenttia, kun tyyppi on Double. Käytä Double.longBitsToDouble(...)-metodia oikean arvon jäsentämiseen.
Esimerkki
/**
* The main launch activity of the app.
*/
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. Valmistele data diagnostiikkatestiä varten
Selvitä toteutuksen tarkistamista varten sen laitteen mainostunnus, jolla haluat tehdä testin. Seuraavan komennon avulla voit asettaa lykätyn täsmälinkin, jonka sovellus vastaanottaa.
"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"
Seuraavan pyynnön avulla voit tarkistaa vastauksen nähdäksesi, onko täsmälinkki määritetty oikein.
Testitäsmälinkki vanhenee 24 tunnin kuluttua. Jos näin käy, toista tämä vaihe.
5. Ota käyttöön testitila testitäsmälinkin hakemiseksi
Ota käyttöön lykätyn täsmälinkityksen testitila, niin voit aloittaa testin laitteellasi.
adb shell setprop debug.deferred.deeplink <<your application package>>
Ota sitten laitteellasi käyttöön virheenkorjaustila. Ala käyttää sovellustasi ja tarkista Logcatissa, että lokiviestissä näkyvä gmp_version
on vähintään 18200
. Hakemalla avainsanaa deferred
saat esiin kaikki Google Analytics for Firebasen virheenkorjausviestit, jotka liittyvät kyseiseen toimintoon.
Esimerkki
D/FA: Deferred Deep Link feature enabled.
FA-SVC: Uploading data. app, uncompressed size, data: <<your application package>>,
…
gmp_version: 18200