Selepas anda membuat pautan dalam, anda perlu mendayakan pautan tersebut dalam SDK ukuran anda untuk menggunakan pautan tersebut dalam Kempen apl anda.
Artikel ini menerangkan cara mendayakan pautan dalam tertunda (DDL) dalam Rakan Kongsi Atribusi Apl (AAP) pihak ketiga yang disokong atau dalam SDK Google Analytics untuk Firebase (GA4F) yang terkini. Ketahui cara menjejaki Penjejakan penukaran apl mudah alih dengan alatan pihak ketiga.
Sebelum anda bermula
Untuk mendayakan DDL dalam AAP yang disokong, anda perlu mempunyai pautan dalam yang berfungsi, yang disertakan dengan betul dalam suapan dilampirkan mereka atau diserahkan sebagai DDL kumpulan iklan.
Arahan
Cara mengaktifkan DDL dalam AAP yang disokong
AAP pihak ketiga yang disokong oleh Google untuk DDL pada masa ini adalah seperti yang berikut:
- Adjust
- AppsFlyer
- Branch
- Kochava
- Singular
Ikut langkah di bawah untuk mendayakan DDL dalam AAP pilihan anda.
Adjust
AppsFlyer
- Dalam AppsFlyer, klik Konfigurasi > Rakan Kongsi Penyepaduan, kemudian pilih Google Ads (AdWords).
- Di bawah tab Penyepaduan, dayakan “Pautan dalam tertunda dengan suapan Google”.
- Klik Simpan penyepaduan.
Branch
Kochava
Singular
Ketahui lebih lanjut Perihal menjejaki penukaran apl dengan Rakan Kongsi Atribusi Apl.
Cara mengaktifkan DDL dalam SDK GA4F
Anda boleh mengaktifkan DDL dalam SDK GA4F menggunakan Android versi 17.2.0+ atau lebih baharu dengan mengikut langkah ini:
Langkah untuk mengaktifkan DDL dalam SDK GA4F
1. Konfigurasikan apl anda untuk menggunakan Google Analitis untuk Firebase
Dalam build.gradle apl, alih keluar semua pergantungan pada firebase-core
. Kemudian, tambahkan atau kemas kini pergantungan pada firebase-analytics
versi 17.2.0+. Contoh di bawah menggunakan versi SDK lebih baharu.
dependencies {
...
implementation 'com.google.firebase:firebase-analytics:21.0.0'
...
}
2. Dayakan ciri tersebut dalam apl anda
Ubah suai manifes aplikasi anda dengan menambahkan tag metadata berikut pada tag aplikasi anda.
<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">
<!-- Nilai untuk ditambahkan untuk mendayakan pautan dalam tertunda -->
<meta-data android:name="google_analytics_deferred_deep_link_enabled" android:value="true"/>
<activity
android:name=".MainActivity" >
</activity>
</application>
</manifest>
Apabila didayakan, GA4F akan mengambil pautan dalam yang dikonfigurasikan, semasa permulaan apl, untuk kempen sepadan yang anda konfigurasikan.
3. Rekodkan pautan dalam
Sediakan pendengar perubahan SharedPreferences dalam kelas aktiviti pelancaran utama anda. Perkara ini akan dicetuskan apabila DDL tersedia. Jika anda mendaftarkan pendengar kemudian dalam kitaran hayat apl, pautan dalam mungkin telah diambil. Dalam keadaan ini, pendengar tidak akan dicetuskan dan anda boleh mencari nilai pautan dalam dengan serta-merta dengan membaca SharedPreferences.
GA4F menyimpan pautan dalam fail SharedPreferences google.analytics.deferred.deeplink.prefs
dengan kunci deeplink
. GA4F turut menyimpan, dalam fail SharedPreferences yang sama, cap masa klik iklan dengan kunci timestamp
. Harap maklum bahawa format cap masa ialah mikrosaat (milisaat diikuti dengan titik dan mikrosaat) dan disimpan dalam SharedPreferences menggunakan Long apabila taip ialah Double. Gunakan Double.longBitsToDouble(...) untuk menghuraikan nilai sebenar.
Contoh:
/**
* Aktiviti pelancaran utama apl.
*/
kelas awam MainActivity extends AppCompatActivity {
peribadi SharedPreferences pilihan;
peribadi SharedPreferences.OnSharedPreferenceChangeListener deepLinkListener;
@Override
protected void onStart() {
super.onStart();
preferences.registerOnSharedPreferenceChangeListener(deepLinkListener);
}
@Override
protected void onStop() {
super.onStop();
preferences.unregisterOnSharedPreferenceChangeListener(deepLinkListener);
deepLinkListener = nol;
}
@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. Sediakan data untuk ujian diagnostik
Untuk mengesahkan pelaksanaan anda, dapatkan AdID bagi peranti yang ingin anda gunakan untuk menguji. Anda boleh menggunakan perintah berikut untuk menetapkan DDL yang akan diterima oleh apl.
"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"
Untuk menyemak sama ada pautan dalam telah ditetapkan dengan betul, anda boleh menggunakan permintaan ini untuk mengesahkan respons.
Pautan dalam ini tamat tempoh selepas 24 jam. Ulang langkah ini jika pautan dalam ujian tamat tempoh.
5. Dayakan mod ujian untuk mengambil DDL ujian
Dayakan mod ujian DDL untuk memulakan ujian pada peranti anda.
adb shell setprop debug.deferred.deeplink <<your application pakej>>
Seterusnya, dayakan mod nyahpepijat pada peranti anda. Mula menggunakan apl anda dan, dalam Logcat, semak sama ada mesej log menunjukkan gmp_version
dengan sekurang-kurangnya 18200
. Mencari kata kunci ditunda
akan menapis semua mesej nyahpepijat daripada Google Analitis untuk Firebase yang berkaitan dengan fungsi tersebut.
Contoh:
D/FA: Ciri Pautan Dalam Tertunda didayakan.
FA-SVC: Memuat naik data. app, uncompressed size, data: <<your application pakej>>,
…
gmp_version: 18200