Undangan Pengguna Android
Overview
Terapkan dan atribusikan tautan undangan pengguna ketika pengguna yang ada merujuk orang lain ke aplikasi Anda.
Untuk pengenalan, lihat undangan pengguna .
Mau lihat contoh lengkapnya? lihat caranya:
Menerapkan undangan pengguna
Sebelum Anda memulai: Kerja sama dengan pemasar untuk mengetahui kasus penggunaan yang tepat yang mereka inginkan untuk tautan dan untuk mendapatkan daftar parameter yang ingin mereka terapkan.
Untuk menerapkan atribusi undangan pengguna, selesaikan langkah-langkah berikut:
- Siapkan pembuatan tautan undanganuntuk menghasilkan tautan undangan.
- OPSIONAL Catat pembuatan tautan undangan.
- Menyiapkan Deep Linking Terpadu/Unified Deep Linking (UDL)
- OPSIONAL Ambil data referrer dari tautan undangan pengguna .
- Opsional Siapkan reward referrer.
Kode berikut didasarkan pada contoh pemasar.
Set up invite link generation
Untuk memungkinkan pengguna mengundang teman mereka ke aplikasi, Anda memerlukan cara untuk membuat tautan undangan pengguna. Hal ini dilakukan dengan menggunakan LinkGenerator
Untuk menyiapkan pembuatan tautan undangan pengguna:
-
Pastikan untuk mengimpor dependensi berikut:
import com.appsflyer.AppsFlyerLib; import com.appsflyer.CreateOneLinkHttpTask; import com.appsflyer.share.LinkGenerator; import com.appsflyer.share.ShareInviteHelper;
-
Atur templat OneLink menggunakan
setAppInviteOneLink()
(ID templat disediakan oleh pemasar):AppsFlyerLib.getInstance().setAppInviteOneLink("H5hv"); // set the OneLink template ID the user invite links will be based on
Catatan
- Pastikan untuk menelepon
setAppInviteOneLink()
sebelum memanggilstart
. - Template OneLink harus terkait dengan aplikasi.
- Pastikan untuk menelepon
-
Buat sebuah
LinkGenerator
usingShareInviteHelper.generateInviteUrl()
.LinkGenerator linkGenerator = ShareInviteHelper.generateInviteUrl(getApplicationContext());
-
Bergantung pada alur pengguna yang ingin Anda capai, tambahkan parameter berikut menggunakan
linkGenerator.addParameter()
:linkGenerator.addParameter("deep_link_value", <TARGET_VIEW>); linkGenerator.addParameter("deep_link_sub1", <PROMO_CODE>); linkGenerator.addParameter("deep_link_sub2", <REFERRER_ID>); // Optional; makes the referrer ID available in the installs raw-data report linkGenerator.addParameter("af_sub1", <REFERRER_ID>);
deep_link_value
: Pengalaman aplikasi tujuan deep link bagi pengguna yang dirujuk.deep_link_sub1
: Kode promo diterima oleh yang diundang.deep_link_sub2
: Pengenal perujuk. Dapat digunakan untuk memberi reward kepada perujuk.- Catatan: Jika Anda memiliki versi SDK V6.5.2 atau lebih rendah, Anda perlu menyandikan nilai parameter apa pun dengan karakter khusus.
-
Setel parameter atribusi. (Ini akan ditampilkan di dasbor AppsFlyer dan laporan data lengkap).
linkGenerator.setCampaign("summer_sale"); linkGenerator.setChannel("mobile_share");
-
Opsional Tetapkan domain bermerek untuk tautan yang dihasilkan:
linkGenerator.setBrandDomain("brand.domain.com");
-
Buat sebuah
LinkGenerator.ResponseListener
untuk mengambil tautan undangan pengguna saat tersedia:LinkGenerator.ResponseListener listener = new LinkGenerator.ResponseListener() { @Override public void onResponse(String s) { Log.d(LOG_TAG, "Share invite link: " + s); // ... } @Override public void onResponseError(String s) { Log.d(LOG_TAG, "onResponseError called"); } };
Catatan
Since SDK v6.9.0
LinkGenerator.ResponseListener
replacedCreateOneLinkHttpTask.ResponseListener
onResponse()
dipanggil saat undangan pengguna berhasil dibuat.onResponseError()
dipanggil ketika pembuatan tautan gagal.
- teruskan
listener
tolinkGenerator.generateLink()
:linkGenerator.generateLink(getApplicationContext(), listener);
Set the shortlink ID
OPSIONAL
The shortlink ID can be determined by the developer, by adding the paramter af_custom_shortlink
to the LinkGenerator
instance.
linkGenerator.addParameter("af_custom_shortlink", <value>);
Log invite link creation events
OPSIONAL
Untuk mencatat acara pembuatan tautan undangan :
Catat undangan menggunakanlogInvite()
:
HashMap<String,String> logInviteMap = new HashMap<String,String>();
logInviteMap.put("referrerId", <REFERRER_ID>);
logInviteMap.put("campaign", "summer_sale");
ShareInviteHelper.logInvite(getApplicationContext(), "mobile_share", logInviteMap);
logInvite
menghasilkan sebuah af_invite
In-app event
Catatan
Jika Anda tidak ingin menggunakan channel, Anda dapat menggunakan
logEvent
alih-alih.
Set up UDL for user invite attribution
OPSIONAL
Untuk menyiapkan UDL untuk atribusi undangan pengguna:
Siapkan Deep linking Terpadu (UDL). Di dalam DeepLinkListener.onDeepLinking()
, ambil parameter deep linking yang dibuat selama langkah pembuatan link. Dalam contoh ini, properti berikut diambil:
deep_link_value
, menggunakanDeepLink.getDeepLinkValue()
deep_link_sub1
, menggunakanDeepLink.getStringValue()
deep_link_sub2
, menggunakanDeepLink.getStringValue()
Lihat kode: Java.
Beri reward referrer
OPSIONAL
Dalam skenario berikut, pengguna A mengundang pengguna B ke aplikasi Anda.
Reward referrers on install
Skenario: Pengguna B menginstal aplikasi Anda melalui tautan undangan Pengguna A.
ID Pengguna A tersedia di DeepLinkListener.onDeepLinking()
dan dalam contoh ini, diambil menggunakan DeepLink.getStringValue("deep_link_sub2")
. Setelah Anda mengambil ID, tambahkan ke daftar ID perujuk untuk mendapatkan hadiah. Terserah Anda bagaimana menyimpan dan mengambil daftar.
Reward referrers for user actions
Skenario: Pengguna B melakukan pembelian. Anda ingin memberi reward kepada Pengguna A, yang awalnya merujuk Pengguna B ke aplikasi Anda, untuk tindakan tersebut.
Untuk memberi reward kepada pengguna A atas tindakan pengguna B:
-
Ambil ID pengacu Pengguna A dan tambahkan ke salah satu parameter peristiwa dalam aplikasi yang dapat disesuaikan (misalnya,
af_param_1
):Map<String, Object> purchaseEventParameters = new HashMap<String, Object>(); purchaseEventParameters.put(AFInAppEventParameterName.PARAM_1, <REFERRER_ID>); purchaseEventParameters.put(AFInAppEventParameterName.CURRENCY, "USD"); purchaseEventParameters.put(AFInAppEventParameterName.REVENUE, 200); AppsFlyerLib.getInstance().logEvent(getApplicationContext(), purchaseEventParameters);
-
Di backend Anda, ambil data in-app event
-
Tambahkan ID referrer pengguna yang ditemukan ke daftar pengguna yang akan diberi reward.
-
Saat pengguna A meluncurkan aplikasi, periksa apakah ID referrer mereka ada di daftar pengguna yang akan diberi reward dan beri mereka reward jika ada.
Catatan
- Langkah 2-3 tidak dilakukan oleh pengembang seluler. Langkah 4 tergantung pada bagaimana langkah 2-3 diimplementasikan.
- Event pembelian hanya salah satu contohnya. Ini berlaku untuk semua jenis in-app event.
Diperbarui 5 bulan yang lalu