Omogućivanje odgođenog dubinskog povezivanja u SDK-u za mjerenje

Nakon što izradite dubinske veze, morat ćete ih omogućiti u SDK-u za mjerenje da biste ih upotrebljavali u kampanjama za aplikacije.

U ovom se članku objašnjava kako omogućiti odgođeno dubinsko povezivanje (DDL) kod podržanih partnera za atribuciju za aplikacije (AAP-ovima) trećih strana ili u najnovijem Google Analytics for Firebase (GA4F) SDK-u. Saznajte kako pratiti konverzije u mobilnim aplikacijama pomoću alata trećih strana.

---

Prije nego što započnete

Da biste omogućili DDL u podržanom partneru za atribuciju za aplikacije (AAP), morate imati funkcionalne dubinske veze koje su ispravno uključene u priloženom feedu ili poslane kao DDL grupe oglasa.

---

Upute

Kako aktivirati DDL u podržanim AAP-ovima

AAP-ovi trećih strana koje Google trenutačno podržava za DDL sljedeći su:

• Adjust
• AppsFlyer
• Branch
• Kochava
• Singular

Napomena: drugi AAP-ovi u različitim su fazama razvoja. Dubinske veze trećih strana, kao što su AppsFlyer Onelinks i druge pametne veze, nisu podržane. Najnovija ažuriranja o omogućavanju DDL-a zatražite od svojeg predstavnika AAP-a.

Slijedite korake u nastavku da biste omogućili DDL kod odabranog AAP-a.

Adjust

Za omogućavanje DDL postbackova na Google Ads nisu potrebne dodatne postavke. Ako želite onemogućiti ili promijeniti to ponašanje, trebate postaviti povratni poziv odgođene dubinske veze.

AppsFlyer

1. U AppsFlyeru kliknite Konfiguracija > Integrirani partneri, a zatim odaberite Google Ads (AdWords).
2. Na kartici Integracija omogućite opciju Odgođeno dubinsko povezivanje s Googleovim feedovima.
3. Kliknite Save integration (Spremi integraciju).

Branch

Da biste omogućili DDL postbackove, Branch vas mora uvrstiti na popis dopuštenih. Obratite se korisničkoj podršci Brancha da biste dobili pristup značajci.

Kochava

Provjerite je li omogućena postavka Izvrši zahtjev za dubinsko povezivanje. To je prema zadanim postavkama postavljeno kako bi se omogućili DDL postbackovi na Google Ads.

Singular

Za omogućavanje DDL postbackova na Google Ads nisu potrebne dodatne postavke.

Saznajte više o praćenju aplikacijskih konverzija pomoću partnera za atribuciju za aplikacije.

Kako aktivirati DDL u GA4F SDK-u

DDL možete aktivirati u GA4F SDK-u pomoću verzije Androida 17.2.0+ ili novije slijedeći ove korake:

Koraci za aktivaciju DDL-a u GA4F SDK-u

1. Konfigurirajte aplikaciju za upotrebu Google Analyticsa za Firebase

U aplikaciji build.gradle uklonite sve zavisnosti na firebase-core. Zatim dodajte ili ažurirajte zavisnost na firebase-analytics verziji 17.2.0+. Primjer u nastavku upotrebljava noviju verziju SDK-a.

dependencies {
    ...
    implementation 'com.google.firebase:firebase-analytics:21.0.0'
    ...
}

2. Omogućite značajku u aplikaciji

Izmijenite manifest aplikacije dodavanjem sljedeće oznake metapodataka u oznaku aplikacije.

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

     <!-- Vrijednost koju treba dodati za omogućivanje odgođenih dubinskih veza -->
     <meta-data android:name="google_analytics_deferred_deep_link_enabled" android:value="true"/>

       <activity
            android:name=".MainActivity" >
       </activity>

    </application>

</manifest>

Kad je omogućeno, GA4F će dohvatiti konfiguriranu dubinsku vezu pri pokretanju aplikacije za odgovarajuću kampanju koju ste konfigurirali.

Napomena: registriranje primatelja putem manifesta dolazi s nedostacima kao što su upotreba memorije i latencija pokretanja. To se može ublažiti upotrebom registra konteksta.

3. Snimite dubinsku vezu

Postavite osluškivača promjene SharedPreferences u glavnoj klasi aktivnosti pokretanja. To će se pokrenuti kad DDL bude dostupan. Ako slušatelja registrirate kasnije u životnom ciklusu aplikacije, dubinska veza možda je već dohvaćena. U tom se slučaju slušatelj neće pokrenuti, a vi možete odmah potražiti vrijednost dubinske veze čitanjem SharedPreferences.

GA4F pohranjuje dubinsku vezu u datoteci SharedPreferences google.analytics.deferred.dogfood.prefs s ključem deeplink. GA4F također pohranjuje u istoj datoteci SharedPreferences vremensku oznaku klika na oglas s ključem timestamp. Imajte na umu da je format vremenske oznake mikrosekunde (milisekunde nakon kojih slijedi točka i mikrosekunde) i pohranjuje se u formatu SharedPreference pomoću Long kada je vrsta Double. Upotrijebite Double.longBitsToDouble(...) za raščlanjivanje stvarne vrijednosti.

Primjer:

/**
* Glavna aktivnost pokretanja aplikacije.
*/
public class MainActivity extends AppCompatActivity {

  privatno SharedPreferences preferences;
  privatno 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. Pripremite podatke za dijagnostičko testiranje

Da biste potvrdili svoju implementaciju, pronađite ID oglasa za uređaj s kojim želite testirati. Za postavljanje DDL-a koji će aplikacija primiti možete upotrijebiti sljedeću naredbu:

curl "www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<ID oglasa vašeg uređaja>>&id_type=adid&bundleid=<<vaš paket aplikacije>>&deeplink=<<dubinska veza koju želite primiti>>&ddl_test=1"

Da biste provjerili je li dubinska veza ispravno postavljena, za potvrdu odgovora možete upotrijebiti ovaj zahtjev.

curl "www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<ID oglasa vašeg uređaja>>&id_type=adid&bundleid=<<vaš paket aplikacije>>&ddl_test=1"

Ta testna dubinska veza istječe nakon 24 sata. Ponovite taj korak ako testna dubinska veza istekne.

5. Omogućite testni način rada za dohvaćanje testnog DDL-a

Omogućite testni način rada DDL-a za početak testiranja na uređajima.

adb shell setprop debug.deferred.deeplink <<paket vaše aplikacije>>

Zatim omogućite način otklanjanja pogrešaka na svojem uređaju. Počnite upotrebljavati svoju aplikaciju i u Logcatu provjerite prikazuje li poruka zapisnika gmp_version od barem 18200. Pretraživanje ključne riječi deferred filtrirat će sve poruke o otklanjanju pogrešaka iz Google Analyticsa za Firebase koje su povezane s tom funkcijom.

Primjer:

D/FA: Deferred Deep Link feature enabled.
FA-SVC: Uploading data. app, uncompressed size, data: <<paket vaše aplikacije>>,
…
gmp_version: 18200

---

Povezani članci

• O dubinskim vezama
• Dodavanje i uređivanje dubinskog povezivanja za kampanje za angažman u aplikaciji