Omogočanje odloženega povezovanja v globino v kompletu za razvoj programske opreme za merjenje

Ko ustvarite povezave v globino, jih je treba omogočiti v kompletu za razvoj programske opreme za merjenje, da jih boste lahko uporabili v oglaševalskih akcijah za aplikacije.

V tem članku je pojasnjeno, kako omogočite odloženo povezovanje v globino v podprtih neodvisnih partnerjih za dodeljevanje za aplikacije (APP) ali v najnovejšem kompletu za razvoj programske opreme Googla Analytics za platformo Firebase (GA4F). Preberite, kako sledite sledenju konverzijam za aplikacije za mobilne naprave z orodji neodvisnih ponudnikov.


Preden začnete

Če želite omogočiti odloženo povezovanje v globino v podprtem partnerju za dodeljevanje za aplikacije, morate imeti delujoče povezave v globino, ki so ustrezno vključene v priloženi vir ali predložene kot odloženo povezovanje v globino za skupino oglasov.


Navodila

Aktiviranje odloženega povezovanja v globino v podprtih partnerjih za dodeljevanje za aplikacije

Neodvisni partnerji za dodeljevanje za aplikacije, ki jih Google trenutno podpira za odloženo povezovanje v globino, so:

  • Adjust
  • AppsFlyer
  • Branch
  • Kochava
  • Singular
Opomba: Drugi partnerji za dodeljevanje za aplikacije so na drugih stopnjah razvoja. Povezave v globino drugih ponudnikov, kot je AppsFlyer Onelinks, in druge »pametne povezave« niso podprte. Za najnovejša obvestila glede omogočanja odloženega povezovanja v globino se obrnite na ustreznega zastopnika partnerja za dodeljevanje za aplikacije.

Če želite izbranemu partnerju za dodeljevanje za aplikacije omogočiti odloženo povezovanje v globino, upoštevajte spodnja navodila.

Adjust

Za omogočanje povratnih objav glede odloženega povezovanja v globino Googlu Ads niso potrebne nobene dodatne nastavitve. Če želite onemogočiti ali spremeniti to vedenje, morate nastaviti povratni klic za odloženo povezovanje v globino.

AppsFlyer

  1. V partnerju AppsFlyer kliknite Configuration > Integrated Partners (Konfiguracija > Partner za integracijo) in izberite Google Ads (AdWords).
  2. Na zavihku Integration (Integracija) omogočite »Deferred deep linking with Google feeds« (Odloženo povezovanje v globino z Googlovimi viri).
  3. Kliknite Save integration (Shrani integracijo).

Branch

Če želite omogočiti povratne objave glede odloženega povezovanja v globino, vas mora Branch dodati na seznam dovoljenih. Za dostop do funkcije se obrnite na skupino za podporo pri partnerju Branch.

Kochava

Zagotovite, da je nastavitev »Perform Deeplink Request« (Izvedi zahtevo za povezavo v globino) omogočena. Ta nastavitev je izbrana privzeto, da so Googlu Ads omogočene povratne objave glede odloženega povezovanja v globino.

Singular

Za omogočanje povratnih objav glede odloženega povezovanja v globino Googlu Ads niso potrebne nobene dodatne nastavitve.

Preberite več o sledenju konverzijam za aplikacije s partnerjem za dodeljevanje za aplikacije.

Aktiviranje odloženega povezovanja v globino v kompletu za razvoj programske opreme Googla Analytics za platformo Firebase

DDL lahko aktivirate v kompletu za razvoj programske opreme GA4F tako, da uporabite različico Androida 17.2.0+ ali novejšo različico, in sicer tako, da upoštevate ta navodila:

Postopek za aktiviranje funkcije DDL v kompletu za razvoj programske opreme GA4F

1. Konfiguriranje aplikacije za uporabo storitve Google Analytics za platformo Firebase

V elementu build.gradle aplikacije odstranite vse odvisnosti s firebase-core. Nato dodajte ali posodobite odvisnost s firebase-analytics različice 17.2.0+. V spodnjem primeru je uporabljena novejša različica kompleta za razvoj programske opreme.

odvisnosti {
    ...

    implementacija 'com.google.firebase:firebase-analytics:21.0.0'
    ...
}

2. Omogočanje te funkcije v aplikaciji

Spremenite manifest aplikacije tako, da oznaki aplikacije dodate naslednjo oznako z metapodatki.

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

     <!-- Vrednost, ki bo dodana za omogočanje odloženih povezav v globino -->
     <meta-data android:name="google_analytics_deferred_deep_link_enabled" android:value="true"/>

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

    </application>

</manifest>

Ko je ta funkcija omogočena, GA4F pridobi konfigurirano povezavo v globino ob zagonu aplikacije za ustrezno oglaševalsko akcijo, ki ste jo konfigurirali.

Opomba: Registriranje prejemnika prek manifesta ima tudi slabosti, kot sta poraba pomnilnika in zakasnitev zagona. To lahko odpravite tako, da prednost dodelite registru konteksta.

3. Zajem povezave v globino

V glavnem razredu dejavnosti zagona nastavite poslušalca sprememb nastavitev SharedPreferences. Ta se bo sprožil, ko bo DDL na voljo. Če boste poslušalca registrirali pozneje v življenjskem ciklu aplikacije, bo povezava v globino morda že pridobljena. V tem primeru se poslušalec ne bo sprožil in vrednost povezave v globino lahko takoj poiščete z branjem nastavitev SharedPreferences.

GA4F shrani povezavo v globino v datoteki SharedPreferences google.analytics.deferred.deeplink.prefs s ključem deeplink. GA4F shrani v isti datoteki SharedPreferences tudi časovni žig klika oglasa s ključem timestamp. Upoštevajte, da je oblika časovnega žiga v mikrosekundah (milisekundah, ki ji sledi pika in mikrosekunde) ter da je časovni žig shranjen v datoteki SharedPreferences prek možnosti »Long« (Dolgo), kadar je vrsta »Double«. Uporabite DoubleBitsToDouble(...), da razčlenite dejansko vrednost.

Primer:

/**
* Glavna dejavnost zagona aplikacije.
*/

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. Priprava podatkov za diagnostično preizkušanje

Če želite preveriti implementacijo, prenesite AdID za napravo, s katero želite izvesti preizkus. S tem ukazom lahko nastavite povezavo DDL, ki jo bo prejela aplikacija.

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"

Če želite preveriti, ali je bila povezava v globino pravilno nastavljena, lahko s to zahtevo preverite odziv.

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

Ta preizkusna povezava v globino poteče po 24 urah. Ponovite ta korak, če preizkusna povezava v globino poteče.

5. Omogočanje preizkusnega načina za pridobitev preizkusne povezave DDL

Če želite začeti preizkušati v napravah, omogočite preizkusni način za DDL.

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

Nato v napravi omogočite način za odpravljanje napak. Začnite uporabljati aplikacijo in v mehanizmu Logcat preverite, ali je pri vrednosti gmp_version v sporočilu v dnevniku prikazano vsaj 18200. Če poiščete ključno besedo deferred, boste filtrirali vsa sporočila o odpravljanju napak iz Googla Analytics za platformo Firebase, ki se nanašajo na zadevno funkcijo.

Primer:

D/FA: Funkcija odloženega povezovanja v globino je omogočena.
FA-SVC:
Nalaganje podatkov. app, uncompressed size, data: <<vaš paket aplikacije>>,

gmp_version:
18200


Sorodne povezave

Je bilo to uporabno?

Kako lahko to izboljšamo?
Iskanje
Počisti iskanje
Zapiranje iskanja
Glavni meni
1362202132309149679
true
Iskanje v centru za pomoč
true
true
true
true
true
73067
false
false
false