Edasilükatud süvalinkimise lubamine mõõtmise SDK-s

Pärast süvalinkide loomist tuleb teil need oma mõõtmise SDK-s lubada, et saaksite neid oma rakendusekampaaniates kasutada.

Selles artiklis selgitatakse, kuidas lubada edasilükatud süvalinkimine (DDL) toetatud kolmandate osapoolte rakenduse omistamise partnerites (AAP-des) või uusimas Google Analytics for Firebase'i (GA4F) SDK-s. Vaadake, kuidas jälgida mobiilirakenduse konversioone kolmandate osapoolte tööriistadega.

Enne alustamist

Selleks, et lubada DDL toetatud AAP-s, peavad teil olema toimivad süvalingid, mis on õigesti lisatud nende seotud voogudesse või esitatud reklaamirühma DDL-ina.

Juhised

Edasilükatud süvalinkimise aktiveerimine toetatud AAP-des

Kolmandate osapoolte AAP-d, mida Google DDL-i jaoks praegu toetab, on järgmised.

Adjust
AppsFlyer
Branch
Kochava
Singular

Märkus. Muud AAP-d on eri arendusetappides. Kolmandate osapoolte süvalingid, nagu AppsFlyer Onelinks ja muud „nutikad lingid“ pole lubatud. Kui soovite saada uusimat teavet DDL-i lubamise kohta, võtke ühendust asjakohase AAP esindajaga.

Järgige allpool esitatud juhiseid, et lubada DDL oma valitud AAP-s.

Adjust

Google Adsi jaoks DDL-i tagasipostituste lubamiseks pole vaja seadeid muuta. Kui soovite selle käitumise keelata või seda muuta, peate seadistama edasilükatud süvalinkimise tagasikutsumise.

AppsFlyer

Klikkige AppsFlyeris valikutel Configuration > Integrated Partners ja seejärel tehke valik Google Ads (AdWords).
Lubage vahekaardil Integration valik „Deferred deep linking with Google feeds“.
Klikkige käsul Save integration.

Branch

DDL-i tagasipostituste lubamiseks peate olema Branchi lubamisloendis. Funktsioonile juurdepääsemiseks võtke ühendust Branchi tugitiimiga.

Kochava

Veenduge, et seade „Perform Deeplink Request“ oleks lubatud. See on vaikimisi määratud lubama DDL-i tagasipostitusi Google Adsile.

Singular

Google Adsi jaoks DDL-i tagasipostituste lubamiseks pole vaja seadeid muuta.

Vaadake lisateavet rakenduse omistamise partneri abil rakendusekonversioonide jälgimise kohta.

Kuidas aktiveerida edasilükatud süvalinkimine GA4F-i SDK-s?

GA4F-i SDK-s edasilükatud süvalinkimise aktiveerimiseks tuleb teil kasutada Androidi versiooni 17.2.0+ või uuemat versiooni ja teha alltoodud toimingud.

Toimingud edasilükatud süvalinkimise aktiveerimiseks GA4F-i SDK-s

1. Seadistage oma rakendus kasutama Google Analytics for Firebase'i

Eemaldage rakenduse failis build.gradle kõik teegil firebase-core põhinevad sõltuvused. Seejärel lisage või värskendage teegi firebase-analytics versioonil 17.2.0+ põhinevat sõltuvust. Alltoodud näites on kasutatud SDK uuemat versiooni.

dependencies {

        ...

        implementation 'com.google.firebase:firebase-analytics:21.0.0'

        ...

    }

2. Lubage funktsioon oma rakenduses

Muutke oma rakenduse manifesti. Selleks lisage alltoodud metaandmete märgend oma rakenduse märgendisse.

<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">

    

         <!-- Edasilükatud süvalinkide lubamiseks lisatav väärtus -->

         <meta-data android:name="google_analytics_deferred_deep_link_enabled" android:value="true"/>

    

           <activity

                android:name=".MainActivity" >

           </activity>

    

        </application>

    

    </manifest>

Kui see on lubatud, toob GA4F rakenduse käivitamisel seadistatud süvalingi, mis vastab teie seadistatud kampaaniale.

Märkus. Manifesti kaudu vastuvõtja registreerimisega kaasnevad omad puudused, nagu mälukasutus ja käivitamise latentsusaeg. Nende puuduste minimeerimisel võib olla abi kontekstiregistri kasutamisest.

3. Süvalingi salvestamine

Seadistage oma peamise käivitustegevuse klassi raames liidese SharedPreferences muudatuste jälgija. See käivitatakse siis, kui edasilükatud süvalink on saadaval. Kui registreerite jälgija rakenduse hilisemas eluetapis, võib süvalink olla juba toodud. Sellisel juhul jälgijat ei käivitata ja teil on võimalik kontrollida süvalingi väärtust kohe, lugedes selleks liidest SharedPreferences.

GA4F salvestab süvalingi liidese SharedPreferences faili google.analytics.deferred.deeplink.prefs võtmega deeplink. Samuti salvestab GA4F samasse liidese SharedPreferences faili reklaamikliki ajatempli võtmega timestamp. Pange tähele, et ajatempli vorming on mikrosekundites (millisekundid, millele järgneb punkt ja mikrosekundid) ning see on salvestatud liidesesse SharedPreference, kasutades klassi Long, kui tüüp on Double. Tegeliku väärtuse sõelumiseks kasutage meetodit Double.longBitsToDouble(...).

Näide

/** * Rakenduse peamine käivitustegevus. */ 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. Valmistage andmed ette diagnostikatestideks

Juurutuse valideerimiseks hankige selle seadme AdID, mille abil soovite testida with. Selle edasilükatud süvalingi määramiseks, mille rakendus vastu võtab, võite kasutada järgmist käsku.

curl

"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"

Selleks et kontrollida, kas süvalingi määramine õnnestus, võite kasutada alltoodud taotlust, et kinnitada vastus.

curl "www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<your device adid>>&id_type=adid&bundleid=<<your application package>>&ddl_test=1"

See testitav süvalink aegub pärast 24 tundi. Kui testitav süvalink aegub, korrake seda toimingut.

5. Lubage testimisrežiim testitava edasilükatud süvalingi toomiseks

Lubage edasilükatud süvalingi testimisrežiim, et teha oma seadmete abil testimine.

adb shell setprop debug.deferred.deeplink <<your application package>>

Järgmiseks lubage oma seadmes silumisrežiim. Alustage oma rakenduse kasutamist ja kontrollige Logcati abil, et logisõnumis oleks muutuja gmp_version väärtuseks vähemalt 18200. Kui otsite märksõna deferred, filtreeritakse välja kõik Google Analytics for Firebase'i silumissõnumid, mis on selle funktsiooniga seotud.