Panduan

iOS user invite

Sarankan Pengeditan

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:

✍️
Undangan pengguna OneLink di iOS
Buka Metode (Cara)

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. Siapkan PenautanLangsung Terpadu (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 perlu cara untuk membuat tautan undangan. Hal ini dilakukan dengan menggunakan AppsFlyerLinkGenerator.
Untuk menyiapkan pembuatan tautan undangan:

  1. Pastikan Anda mengimpor AppsFlyerLib:

    import com.appsflyer.AppsFlyerLib;

  2. In AppDelegate, atur templat OneLink menggunakan appInviteOneLinkID (ID templat disediakan oleh pemasar):

    AppsFlyerLib.shared().appInviteOneLinkID = "H5hv" // Set the OneLink template ID for userinvitation links

    📘

    Catatan

    • Pastikan untuk mengatur appInviteOneLinkID sebelum memanggil start
    • Template OneLink harus terkait dengan aplikasi.

  3. Panggil AppsFlyerShareInviteHelper.generateInviteUrl dan meneruskan AppsFlyerLinkGenerator dan suatu completionHandler:

    AppsFlyerShareInviteHelper.generateInviteUrl(
    linkGenerator: {
        (_ generator: AppsFlyerLinkGenerator) -> AppsFlyerLinkGenerator in
            generator.addParameterValue(<TARGET_VIEW>, forKey: "deep_link_value")
            generator.addParameterValue(<PROMO_CODE>, forKey: "deep_link_sub1")
            generator.addParameterValue(<REFERRER_ID>, forKey: "deep_link_sub2")
            // Optional; makes the referrer ID available in the installs raw-data report
            generator.addParameterValue(<REFERRER_ID>, forKey: "af_sub1")
            generator.setCampaign("summer_sale")
            generator.setChannel("mobile_share")
      		// Optional; Set a branded domain name:
      		generator.brandDomain = "brand.domain.com"
            return generator
    },
    completionHandler: {
        (_ url: URL?) -> Void in
            if url != nil {
                NSLog("[AFSDK] AppsFlyer share-invite link: \(url!.absoluteString)")
            }        
            else {
                print("url is nil")
            }
        }
)

    Tergantung dari alur pengguna yang Anda dan pemasar ingin capai, konfigurasikan generator sebagai berikut:

    • Tetapkan parameter atribusi menggunakan setter .
    • Atur parameter deep linking menggunakan AppsFlyerLinkGenerator.addParameterValue:
      • deep_link_value: Pengalaman aplikasi tujuan deep link bagi pengguna yang dirujuk.
      • deep_link_sub1: Parameter yang dapat disesuaikan. Dalam contoh ini, digunakan untuk memberikan kode promo yang diterima oleh orang yang diundang.
      • deep_link_sub2: Pengenal perujuk. Dapat digunakan untuk memberi reward kepada perujuk.

  4. Di completionHandler, cek apakah URL sudah dibuat dengan sukses (url tidak nil), dan dapatkan kembali tautan undangan pengguna yang dihasilkan.

  5. Memungkinkan pengguna untuk membagikan tautan yang dihasilkan. Misalnya, salin ke clipboard mereka.

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.

generator.addParameterValue(<value>, forKey:"af_custom_shortlink")

Log invite link creation events

OPSIONAL
Untuk mencatat event pembuatan tautan undangan:
Kirim event yang menunjukkan bahwa pengguna telah membuat tautan undangan menggunakan logInvite:

AppsFlyerShareInviteHelper.logInvite(<CHANNEL>, parameters: [
    "campaign" : "summer_sale",
    "referrerId" : <REFERRER_ID>,
]);

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:

  1. Siapkan Deeplinking Terpadu (UDL).

  2. In DeepLinkDelegate.didResolveDeepLink, ambil parameter deep linking yang dibuat selama langkah pembuatan link. Dalam contoh ini, properti berikut diambil:

    • deep_link_value, menggunakan DeepLink.deeplinkValue
    • deep_link_sub1, menggunakan DeepLink.clickEvent["deep_link_sub1"]
    • deep_link_sub2, menggunakan DeepLink.clickEvent["deep_link_sub2"]

    Lihat kode: Swift.

  3. Setelah Anda mengambil ID referrer, terserah bagaimana Anda ingin ID tersebut disimpan dan digunakan.

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 pengacu pengguna A tersedia di UDL didResolveDeepLink (di contoh ini, di bawah DeepLink.clickEvent["deep_link_sub2"]). Setelah Anda mengambil kembali ID, tambahkan ke daftar ID pengacu untuk mendapatkan hadiah. Terserah bagaimana Anda ingin menyimpan dan mengambil daftar tersebut itu.

Reward referrers on in-app events

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 kembali ID pengacu pengguna A dan tambahkan ke salah satu parameter event dalam aplikasi yang dapat disesuaikan (misalnya, af_param_1): 
    AppsFlyerLib.shared().logEvent(AFEventPurchase, 
  withValues: [
		AFEventParamRevenue: 200,
		AFEventParamCurrency:"USD",
        AFEventParam1: <REFERRER_ID>
  ]);
  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.

Diperbarui sekitar 2 bulan yang lalu