Pēc dziļo saišu izveides jums būs tās jāiespējo novērtēšanas programmatūras izstrādes komplektā (Software Development Kit — SDK), lai varētu tās izmantot lietotņu kampaņās.
Šajā rakstā ir paskaidrots, kā iespējot atlikto dziļās saites izveidi atbalstītos trešās puses lietotņu attiecinājuma partneros (LAP) vai jaunākajā Google Analytics platformai Firebase (GA4F) SDK versijā. Uzziniet, kā uzskaitīt mobilo lietotņu reklāmguvumu uzskaiti, izmantojot trešo pušu rīkus.
Pirms darba sākšanas
Lai atbalstītā LAP iespējotu atlikto dziļās saites izveidi, ir nepieciešamas aktīvas dziļās saites, kas pareizi iekļautas tām pievienotajā plūsmā vai iesniegtas kā reklāmu kopas atliktās dziļās saites.
Norādījumi
Kā aktivizēt atlikto dziļās saites izveidi atbalstītos LAP
Google pašlaik atbalsta atlikto dziļās saites izveidi šādos trešo pušu LAP:
- Pielāgot
- AppsFlyer
- Branch;
- Kochava;
- Singular.
Lai izvēlētajā LAP iespējotu atlikto dziļās saites izveidi, veiciet tālāk norādītās darbības.
Pielāgot
AppsFlyer
- Pakalpojumā AppsFlyer noklikšķiniet uz Configuration (Konfigurācija) > Integrated Partners (Integrētie partneri) un pēc tam atlasiet Google Ads (AdWords).
- Cilnē Integration (Integrācija) iespējojiet opciju “Deferred deep linking with Google feeds” (Atlikto dziļo saišu izveide ar Google plūsmām).
- Noklikšķiniet uz Save integration (Saglabāt integrāciju).
Branch
Kochava
Singular
Uzziniet vairāk par lietotņu reklāmguvumu uzskaiti, izmantojot lietotņu attiecinājuma partneri.
Atliktās dziļās saites izveides aktivizēšana GA4F programmatūras izstrādes komplektā
Varat aktivizēt atliktās dziļās saites GA4F programmatūras izstrādes komplektā, izmantojot Android versiju 17.2.0 vai jaunāku versiju, kā norādīts tālāk.
Darbības, kas jāveic atlikto dziļo saišu aktivizēšanai GA4F programmatūras izstrādes komplektā
1. Konfigurējiet lietotni, lai izmantotu pakalpojumu Google Analytics platformai Firebase
Lietotnē build.gradle noņemiet visus atkarības gadījumus šeit: firebase-core
. Pēc tam pievienojiet vai atjauniniet atkarības gadījumus firebase-analytics
versijā 17.2.0 vai jaunākā versijā. Tālāk sniegtajā piemērā tiek izmantota jaunāka SDK versija.
dependencies {
...
implementation 'com.google.firebase:firebase-analytics:21.0.0'
...
}
2. Iespējojiet funkciju savā lietotnē
Mainiet savu lietojumprogrammas manifestu, lietojumprogrammas tagam pievienojot tālāk norādīto metadatu tagu.
<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">
<!-- Vērtība, kas jāpievieno, lai iespējotu atliktās dziļās saites -->
<meta-data android:name="google_analytics_deferred_deep_link_enabled" android:value="true"/>
<activity
android:name=".MainActivity" >
</activity>
</application>
</manifest>
Kad šis iestatījums būs iespējots, lietotnes startēšanas brīdī GA4F izgūs konfigurēto dziļo saiti atbilstošajai konfigurētajai kampaņai.
3. Tveriet dziļo saiti
Iestatiet SharedPreferences izmaiņu uztvērēju savā galvenajā palaišanas darbību klasē. Tas tiks aktivizēts, kad būs pieejama atliktā dziļā saite. Ja uztvērēju reģistrējat vēlākā lietotnes darbības cikla posmā, iespējams, dziļā saite jau būs izgūta. Šādā gadījumā uztvērējs netiks aktivizēts un jūs varēsiet nekavējoties atrast dziļās saites vērtību, lasot SharedPreferences.
GA4F dziļo saiti glabā SharedPreferences failā google.analytics.deferred.fragment.prefs
ar atslēgu deeplink
. GA4F tajā pašā SharedPreferences failā glabā arī reklāmas klikšķa laikspiedolu ar atslēgu timestamp
. Ņemiet vērā, ka laikspiedola formāts ir mikrosekundes (milisekundes, kam seko punkts un mikrosekundes) un tas tiek glabāts saskarnē SharedPreferences, izmantojot vērtību “Long”, kad tips ir “Double”. Izmantojiet Double.longBitsToDouble(...), lai parsētu faktisko vērtību.
Piemērs
/**
*Lietotnes galvenā palaišana darbības.
*/
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. Sagatavojiet datus diagnostikas testēšanai
Lai pārbaudītu, vai dziļā saite ir ievietota pareizi, iegūstiet reklamēšanas ID ierīcei, ar kuru vēlaties testēt. Lai iestatītu atlikto dziļo saiti, kuru saņems lietotne, varat izmantot tālāk norādīto komandu.
"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"
Lai pārbaudītu, vai dziļā saite ir iestatīta pareizi, varat izmantot šo pieprasījumu, lai verificētu atbildi.
Šīs testa dziļās saites derīguma termiņš beidzas pēc 24 stundām. Atkārtojiet šo darbību, ja testa dziļās saites derīguma termiņš beidzas.
5. Iespējojiet testa režīmu, lai iegūtu testa atlikto dziļo saiti
Iespējojiet atliktās dziļās saites testa režīmu, lai sāktu testēšanu savās ierīcēs.
adb shell setprop debug.deferred.deeplink <<your application package>>
Pēc tam ierīcē iespējojiet atkļūdošanas režīmu. Sāciet izmantot savu lietotni un rīkā Logcat pārbaudiet, vai žurnāla ziņojumā vienuma gmp_version
vērtība ir vismaz 18200
. Meklējot atslēgvārdu deferred
, tiks filtrēti visi ar šo funkcionalitāti saistītie Google Analytics platformai Firebase atkļūdošanas ziņojumi.
Piemērs
D/FA: Deferred Deep Link feature enabled.
FA-SVC: Uploading data. app, uncompressed size, data: <<your application package>>,
…
gmp_version: 18200