Povolenie odloženého priameho odkazovania v súprave SDK na meranie

Ak chcete priame odkazy po vytvorení používať v kampaniach na aplikácie (angl. App campaign), musíte ich povoliť v súprave SDK na meranie.

V tomto článku vám vysvetlíme, ako povoliť odložené priame odkazovanie u podporovaných partnerov atribúcie pre aplikácie tretích strán alebo v najnovšej súprave Google Analytics for Firebase (GA4F) SDK. Ako sledovať konverzie mobilných aplikácií pomocou nástrojov tretích strán

Skôr než začnete

Ak chcete povoliť odložené priame odkazovanie u podporovaných partnerov atribúcie pre aplikácie, musíte mať funkčné priame odkazy, ktoré sú správne zahrnuté v pripojenom feede alebo odoslané ako odložené priame odkazy reklamnej skupiny.

Pokyny

Aktivácia odloženého priameho odkazovania u podporovaných partnerov atribúcie pre aplikácie

Partneri atribúcie pre aplikácie tretích strán, ktorých momentálne podporuje Google pre odložené priame odkazovanie, sú:

Adjust,
AppsFlyer,
Branch,
Kochava,
Singular.

Poznámka: Iní partneri atribúcie pre aplikácie sú v rôznych fázach vývoja. Priame odkazy tretích strán, ako sú AppsFlyer Onelink, ani iné inteligentné odkazy nie sú podporované. Ak chcete získať najnovšie informácie o aktivácii odloženého priameho odkazovania, kontaktujte príslušného zástupcu partnera atribúcie pre aplikácie.

Ak chcete povoliť odložené priame odkazovanie pre vami vybraného partnera atribúcie pre aplikácie, postupujte podľa nasledujúcich krokov.

Adjust

Na povolenie volaní postback odloženého priameho odkazovania do služby Google Ads nie sú potrebné žiadne ďalšie nastavenia. Ak chcete toto správanie vypnúť alebo zmeniť, musíte nastaviť spätné volanie odloženého priameho odkazu.

AppsFlyer

V službe AppsFlyer kliknite na položky Configuration > Integrated Partners (Konfigurácia > Integrační partneri) a vyberte Google Ads (AdWords).
Na karte Integration (Integrácia) aktivujte „Deferred deep linking with Google feeds“ (Odložené priame odkazovanie s informačnými kanálmi Googlu).
Kliknite na Save integration (Uložiť integráciu).

Branch

Ak chcete povoliť volania postback odloženého priameho odkazovania, musíte byť na zozname povolených platformy Branch. Ak chcete získať prístup k tejto funkcii, kontaktujte tím podpory platformy Branch.

Kochava

Uistite sa, že je zapnuté nastavenie Perform Deeplink Request (Vykonanie žiadosti o priamy odkaz). Je predvolene nastavené na povolenie volaní postback odloženého priameho odkazovania do služby Google Ads.

Singular

Na povolenie volaní postback odloženého priameho odkazovania do služby Google Ads nie sú potrebné žiadne ďalšie nastavenia.

Ďalšie informácie o sledovaní konverzií aplikácie pomocou partnera atribúcie pre aplikácie

Aktivácia odloženého priameho odkazovania v súprave GA4F SDK

DDL môžete aktivovať pomocou súpravy GA4F SDK pre Android od verzie 17.2.0 podľa týchto pokynov:

Postup aktivácie DDL v súprave GA4F SDK

1. Konfigurácia aplikácie na používanie služby Google Analytics for Firebase

V súbore build.gradle aplikácie odstráňte všetky dependencie na súprave firebase-core. Potom pridajte dependenciu na súprave firebase-analytics od verzie 17.2.0. V príklade nižšie je použitá novšia verzia súpravy SDK.

dependencies {

        ...

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

        ...

    }

2. Povolenie funkcie v aplikácii

Upravte manifest aplikácie pridaním nasledujúcej značky metadát do značky aplikácie.

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

    

         <!-- Hodnota, ktorá sa pridáva na povolenie odložených priamych odkazov -->

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

    

           <activity

                android:name=".MainActivity" >

           </activity>

    

        </application>

    

    </manifest>

Keď je táto funkcia povolená, GA4F načíta konfigurovaný priamy odkaz pri spustení aplikácie pre príslušnú kampaň, ktorú ste nakonfigurovali.

Poznámka: Registrácia príjemcu prostredníctvom manifestu má nevýhody, ako sú využitie pamäte a latencia pri spustení. Možno ich zmierniť uprednostnením kontextového registra.

3. Zachytenie priameho odkazu

Nastavte prijímač zmien SharedPreferences v rámci hlavnej triedy aktivity spustenia. Spustí sa, keď bude k dispozícii DDL. Ak príjemcu zaregistrujete neskôr v rámci životného cyklu aplikácie, priamy odkaz už možno bol načítaný. V takom prípade sa prijímač nespustí a hodnotu priameho odkazu môžete okamžite vyhľadať tak, že načítate SharedPreferences.

GA4F uchováva priamy odkaz v súbore SharedPreferences google.analytics.deferred.deeplink.prefs s kľúčom deeplink. GA4F v rovnakom súbore SharedPreferences uchováva aj časovú pečiatku kliknutia na reklamu s kľúčom timestamp. Upozorňujeme, že časová pečiatka je vo formáte mikrosekúnd (milisekundy, za ktorými nasledujú bodka a mikrosekundy) a v súbore SharedPreferences sa v prípade typu Double uchováva pomocou typu Long. Na analýzu skutočnej hodnoty použite funkciu Double.longBitsToDouble(…).

Príklad:

/** * Hlavná aktivita spustenia aplikácie */ 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", "Priamy odkaz bol zmenený"); if ("deeplink".equals(key)) { String deeplink = sharedPreferences.getString(key, null); Double cTime = Double.longBitsToDouble(sharedPreferences.getLong("timestamp", 0)); Log.d("DEEPLINK_LISTENER", "Bol získaný priamy odkaz: " + deeplink); showDeepLinkResult(deeplink); } }; }

public void showDeepLinkResult(String result) { String toastText = result; if (toastText == null) { toastText = "Nepodarilo sa získať priamy odkaz"; } else if (toastText.isEmpty()) { toastText = "Priamy odkaz je prázdny"; } Toast.makeText(MainActivity.this, toastText, Toast.LENGTH_LONG).show(); Log.d("DEEPLINK", toastText); } }

4. Príprava údajov na diagnostické testovanie

Ak chcete overiť implementáciu, získajte AdID pre zariadenie, v ktorom chcete testovať. Nasledujúcim príkazom môžete nastaviť odložené priame odkazovanie, ktoré bude aplikácia prijímať.

curl

"www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<your device adid>>&id_type=adid&bundleid=<<váš aplikačný balík>>&deeplink=<<priamy odkaz, ktorý chcete prijať>>&ddl_test=1"

Ak chcete skontrolovať, či bol priamy odkaz nastavený správne, pomocou tejto žiadosti môžete overiť odpoveď.

curl "www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<reklamný identifikátor vášho zariadenia>>&id_type=adid&bundleid=<<váš aplikačný balík>>&ddl_test=1"

Platnosť tohto priameho odkazu vyprší po 24 hodinách. Ak platnosť priameho odkazu vyprší, tento krok zopakujte.

5. Povolenie testovacieho režimu na načítanie testovacích DDL

Ak chcete začať testovať na svojich zariadeniach, povoľte testovací režim odloženého priameho odkazovania.

adb shell setprop debug.deferred.deeplink <<váš aplikačný balík>>

Potom v zariadení zapnite režim ladenia. Začnite používať aplikáciu a v nástroji Logcat skontrolujte, či sa v správe denníka zobrazuje gmp_version s hodnotou aspoň 18200. Vyhľadaním kľúčového slova deferred odfiltrujete všetky správy ladenia zo služby Google Analytics for Firebase, ktoré súvisia s touto funkciou.