A késleltetett mélylinkek engedélyezése a mérési SDK-ban

A mélylinkek létrehozását követően az alkalmazáskampányokban való használatukhoz engedélyeznie kell őket a mérési SDK-ban.

Ez a cikk ismerteti, hogyan engedélyezheti a késleltetett mélylinkeket (DDL) a támogatott külső alkalmazás-hozzárendelési partnereknél (AAP) vagy a legújabb Google Analytics for Firebase (GA4F) SDK-ban. További információ a mobilalkalmazások konverziókövetésének harmadik felek eszközeivel történő nyomon követéséről.

Mielőtt elkezdené

Ha engedélyezni szeretné a DDL-t egy támogatott AAP-ban, olyan működő mélylinkekkel kell rendelkeznie, amelyek megfelelően szerepelnek a csatolt feedben, vagy amelyeket hirdetéscsoport-szintű DDL-ként küld be.

Utasítások

A DDL aktiválása a támogatott AAP-kban

A Google által jelenleg támogatott, harmadik féltől származó AAP-k a következők:

Módosítás
AppsFlyer
Branch
Kochava
Singular

Megjegyzés: Más AAP-k eltérő fejlesztési fázisban vannak. A harmadik felek mélylinkjeit, például az AppsFlyer Onelinkeket és más „intelligens linkeket” nem támogatjuk. A DDL engedélyezésével kapcsolatos legfrissebb információkért forduljon az illetékes AAP-képviselőhöz.

Az alábbi lépéseket követve engedélyezheti a DDL-t a kiválasztott AAP-ben.

Módosítás

A Google Ads szolgáltatásba való DDL-visszaküldések engedélyezéséhez nincs szükség további beállításokra. Ha ki szeretné kapcsolni vagy módosítani szeretné ezt a viselkedést, akkor be kell állítania egy késleltetett mélylink-visszahívást.

AppsFlyer

Az AppsFlyer szolgáltatásban kattintson a Konfiguráció > Integrált partnerek lehetőségre, majd válassza a Google Ads (AdWords) elemet.
Az Integráció lapon engedélyezze a „Késleltetett mélylink a Google-feedekkel” lehetőséget.
Kattintson a Save integration (Integráció mentése) lehetőségre.

Branch

A DDL-visszaküldések engedélyezéséhez fel kell vennie a fiókot a Branch engedélyezőlistájára. A funkció használatához vegye fel a kapcsolatot a fiók ügyfélszolgálati csapatával.

Kochava

Győződjön meg arról, hogy a „Mélylinkkérelem végrehajtása” beállítás engedélyezve van. Ez az alapértelmezett beállítás a DDL-visszaküldések Google Ads szolgáltatásba való engedélyezéséhez.

Singular

A Google Ads szolgáltatásba való DDL-visszaküldések engedélyezéséhez nincs szükség további beállításokra.

További információ az alkalmazáskonverziók alkalmazás-hozzárendelési partnerekkel történő nyomon követéséről.

A DDL aktiválása a GA4F SDK-ban

A DDL-t a Android 17.2.0+ vagy újabb verziójával aktiválhatja a GA4F SDK-ban az alábbi lépéseket követve:

A DDL aktiválásának lépései a GA4F SDK-ban

1. Állítsa be az alkalmazásta Google Analytics Firebase-hez használatához

Az alkalmazás build.gradle verziójában távolítsa el az összes firebase-core függőséget. Ezután adja hozzá vagy frissítse a függőséget a firebase-analytics 17.2.0-s vagy újabb verziójában. Az alábbi példa az SDK újabb verzióját használja.

dependencies {

        ...

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

        ...

    }

2. A funkció engedélyezése az alkalmazásban

Módosítsa az alkalmazás jegyzékfájlját úgy, hogy hozzáadja az alábbi metadatacímkét az alkalmazáscímkéhez.

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

Ha engedélyezve van, a GA4F az alkalmazás indításakor lekéri a beállított mélylinket a megfelelő beállított kampányhoz.

Megjegyzés: A címzett jegyzékfájlon keresztül történő regisztrálása hátrányokkal jár, például memóriahasználattal és az indítási várakozási idővel. Ezt csökkentheti a kontextus regisztrációs adatbázisának támogatása.

3. A mélylink rögzítése

Állítson be egy SharedPreferences változásfigyelőt a fő indítási tevékenység osztályán belül. Ez akkor aktiválódik, ha rendelkezésre áll egy DDL. Ha az alkalmazás életciklusában később regisztrálja a figyelőt, akkor előfordulhat, hogy a mélylink lekérése már megtörtént. Ebben az esetben a figyelő nem aktiválódik, Ön pedig bármikor megkeresheti a mélylink értékét a SharedPreferences olvasásával.

A GA4F a mélylinket a google.analytics.deferred.deeplink.prefs SharedPreferences fájlban tárolja a deeplink kulccsal. A GA4F ugyanabban a SharedPreferences-fájlban tárolja a hirdetéskattintási időbélyeget, a kulcs időbélyegével együtt. Felhívjuk figyelmét, hogy az időbélyeg formátuma mikroszekundum (az ezredmásodpercet egy tizedesjel és egy mikroszekundum követi), és a SharedPreferences Long típussal tárolja, ha a típus Double. A Double.longBitsToDouble(...) használatával elemezheti a tényleges értéket.

Példa:

/** * Az alkalmazás fő indítási tevékenysége. */ 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. Adatok előkészítése diagnosztikai tesztelésre

Az implementáció ellenőrzéséhez töltse le annak az eszköznek az hirdetésazonosítóját, amelyen tesztelni szeretne. A következő paranccsal állíthatja be az alkalmazás által fogadott DDL-t.

curl

"www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<your device adid>>&id_type=adid&bundleid=<<az Ön alkalmazáscsomagja>>&deeplink=<<a fogadni kívánt mélylink>>&ddl_test=1"

Ha ellenőrizni szeretné a mélylink megfelelő beállítását, használja ezt a kérelmet a válasz ellenőrzéséhez.

curl "www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<your device adid>>&id_type=adid&bundleid=<<az Ön alkalmazáscsomagja>>&ddl_test=1"

A tesztelési mélylink 24 óra múlva lejár. Ismételje meg ezt a lépést, ha a tesztelési mélylink lejár.

5. Tesztelési mód engedélyezése a teszt DDL lekéréséhez

Engedélyezze a DDL-tesztüzemmódot az eszközökön való tesztelés megkezdéséhez.

adb shell setprop debug.deferred.deeplink <<az Ön alkalmazáscsomagja>>

Ezt követően engedélyezze a hibakeresési üzemmódot az eszközön. Kezdje el használni az alkalmazást, és a Logcat szolgáltatásban ellenőrizze, hogy a naplóüzenet által megjelenített gmp_version legalább 18200. A késleltetett kulcsszóra való keresés a Google Analytics Firebase-hez szolgáltatásból származó összes, a funkcióval kapcsolatos hibakeresési üzenetet kiszűri.