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:

  1. Siapkan pembuatan tautan undanganuntuk menghasilkan tautan undangan.
  2. OPSIONAL Catat pembuatan tautan undangan.
  3. Menyiapkan Deep Linking Terpadu/Unified Deep Linking (UDL)
  4. OPSIONAL Ambil data referrer dari tautan undangan pengguna .
  5. 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:

  1. Pastikan untuk mengimpor dependensi berikut:

    import com.appsflyer.AppsFlyerLib;
    import com.appsflyer.CreateOneLinkHttpTask;
    import com.appsflyer.share.LinkGenerator;
    import com.appsflyer.share.ShareInviteHelper;
    
  2. 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 memanggil start.
    • Template OneLink harus terkait dengan aplikasi.
  3. Buat sebuah LinkGenerator using ShareInviteHelper.generateInviteUrl().

    LinkGenerator linkGenerator = ShareInviteHelper.generateInviteUrl(getApplicationContext());
    
  4. 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.
  5. Setel parameter atribusi. (Ini akan ditampilkan di dasbor AppsFlyer dan laporan data lengkap).

    linkGenerator.setCampaign("summer_sale");
    linkGenerator.setChannel("mobile_share");
    
  6. Opsional Tetapkan domain bermerek untuk tautan yang dihasilkan:

    linkGenerator.setBrandDomain("brand.domain.com");
    
  7. 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 replaced CreateOneLinkHttpTask.ResponseListener

  • onResponse() dipanggil saat undangan pengguna berhasil dibuat.
  • onResponseError() dipanggil ketika pembuatan tautan gagal.
  1. teruskan listener to linkGenerator.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, menggunakan DeepLink.getDeepLinkValue()
  • deep_link_sub1, menggunakan DeepLink.getStringValue()
  • deep_link_sub2, menggunakan DeepLink.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:

  1. 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);
    
  2. Di backend Anda, ambil data in-app event

  3. Tambahkan ID referrer pengguna yang ditemukan ke daftar pengguna yang akan diberi reward.

  4. 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.