Atribusi Undangan Pengguna

Sekilas: Beri atribut dan catat pemasangan baru yang berasal dari pengguna yang sudah ada yang mengundang teman mereka untuk menggunakan aplikasi Anda.

Invite_Attribution_new.png

 Pembaruan iOS 14

Atribusi undangan pengguna tidak menggunakan IDFA, jadi iOS 14 tidak memengaruhinya dengan cara apa pun.

Atribusi undangan pengguna gratis untuk semua paket akun.

Ikhtisar atribusi undangan pengguna

Mengapa atribusi undangan pengguna berguna?

  • Dapatkan informasi tentang pengguna perujuk terbaik:
    Pengguna yang merujuk teman mereka ke aplikasi Anda adalah pengguna dengan interaksi bernilai tinggi, yang mungkin ingin Anda pertahankan, targetkan ulang, atau berikan insentif.
  • Gunakan informasi pengguna perujuk untuk mempersonalisasi pengalaman pertama kali bagi pengguna baru:
    Alih-alih pesan sambutan umum, Anda dapat memiliki pesan yang dipersonalisasi, yang lebih melibatkan pengguna baru. Misalnya: "Selamat datang, John! Bergabunglah dengan teman Anda Marsha dalam pertempuran epik setelah Anda menyelesaikan tutorial".
  • Ketahui biaya dan ROI undangan pengguna untuk hasil yang lebih baik:
    Apakah undangan pengguna gratis? Tidak juga. Mereka menggunakan "real estate" iklan aplikasi Anda, yang secara bergantian dapat memberi Anda pendapatan yang dihasilkan iklan. Apakah undangan pengguna memberi Anda ROI positif, dibandingkan dengan alternatifnya? Dalam beberapa kasus mereka melakukannya, dan dalam kasus lain, mereka tidak melakukannya.

Anda dapat menggunakan parameter biaya AppsFlyer untuk menetapkan biaya pemasangan undangan pengguna, berdasarkan alternatifnya.

 Contoh

Sebuah spanduk memberi Anda $5 RPM dengan tampilan iklan (inilah cara yang bagus untuk mengukurnya). Rata-rata, dengan tingkat konversi 2% dari tampilan ke undangan, dan dengan tingkat konversi 10% dari undangan untuk menginstal, Anda mendapatkan 2 pengguna baru dari setiap 1.000 tampilan. Oleh karena itu, menggunakan ruang spanduk yang sama untuk mempromosikan undangan dikenakan biaya 5$/2=$2,5 per install. Tambahkan nilai af_cost_value=2.5 untuk mencerminkan biaya ini di dashboard.


Dikombinasikan dengan peristiwa dalam aplikasi pelaporan pendapatan, Anda dapat melihat kampanye undangan pengguna mana yang memberikan hasil terbaik atau terburuk, dan saluran undangan mana yang terbaik untuk tujuan Anda.

Bagaimana cara kerja pengatribusian undangan pengguna?

Penginstalan yang diatribusikan ke tautan undangan muncul di dashboard di bawah sumber media af_app_invites .

Saluran yang digunakan untuk mengirim undangan melalui email, SMS, Facebook, dll., muncul di bawah pengelompokan Kanal di bawah sumber media af_app_invites .

Invite_Attribution_2.png

Memilih sumber media af_app_invites, dan mengelompokkan menurut Channel, menampilkan klik dan penginstalan dari undangan pengguna yang berasal dari Gmail dan Facebook

Panduan pengembang

Mengatur OneLink

Atribusi undangan menggunakan OneLink untuk mengarahkan pengguna yang diundang ke app store yang relevan. OneLink juga memungkinkan Anda menggunakan deferred deep linking. Deferred deep linking (Tautan langsung tertunda) membuka aktivitas tertentu saat pengguna meluncurkan aplikasi. OneLink juga mengatur konten yang disesuaikan untuk menjaga pengguna tetap dalam konteks penginstalan setelah undangan.

Pastikan untuk mengonfigurasi OneLink dengan benar untuk aplikasi Anda:

  • Konfigurasikan pengarahan OneLink
  • Ikuti panduan tentang cara menyiapkan deferred deep linking  - mengatur deferred deep linking memberikan data yang Anda butuhkan untuk mengirim pengguna secara terprogram ke aktivitas tertentu, atau memberi reward kepada pengundang dan orang yang diundang.
  • Opsional - Konfigurasikan OneLink deep linking - Anda tidak perlu mengonfigurasi OneLink deep linking etapi ini bisa membantu dalam skenario tertentu. Contoh:
    • Anda menyiapkan kampanye di mana pengguna mengundang teman mereka untuk menginstal aplikasi. Keduanya mendapatkan poin kredit untuk digunakan dalam aplikasi. Jika yang diundang menginstal aplikasi, pengundang mendapat 50 poin kredit dan yang diundang mendapat 100 poin kredit. Jika yang diundang sudah menginstal aplikasi, pengundang mendapat 25 poin kredit dan yang diundang mendapat 50 poin kredit. Untuk membedakan kedua kasus tersebut, gunakan deep linking yang ditunda untuk kasus pertama dan deep linking untuk kasus kedua.

Setelah OneLink sepenuhnya dikonfigurasi, ambil ID template OneLink yang relevan.

Sebelum memanggil metode start (mulai( di aplikasi Anda, atur OneLink yang dipanggil sesuai dengan ID template OneLink (OPSz dalam contoh ini):

OL_template_id_en-us.jpg

 Catatan

Pastikan ID template OneLink yang benar digunakan. Jika tidak, tautan atribusi yang dibuat akan rusak.

Android iOS Unity V4
AppsFlyerLib.getInstance().setAppInviteOneLink("ymod");

Membuat tautan

Di Android, pastikan untuk mengimpor lib berikut:

import com.appsflyer.share.ShareInviteHelper;
import com.appsflyer.share.LinkGenerator;

Kelas LinkGenerator membangun URL undangan menurut berbagai metode penyetel yang memungkinkan meneruskan informasi tambahan pada klik. Informasi ini tersedia melalui onConversionDataSuccess saat pengguna baru menerima undangan dan menginstal aplikasi. Selain itu, parameter kampanye dan saluran terlihat di Dashboard AppsFlyer.

Tautan undangan yang dibuat SDK memiliki TTL 180 hari.

Jika karena alasan tertentu API tidak dapat dijangkau, LinkGenerator mengembalikan tautan yang panjang.

Android iOS Objective-C iOS Swift Unity V4
LinkGenerator linkGenerator = ShareInviteHelper.generateInviteUrl(MainActivity.this);
linkGenerator.setChannel("Gmail");
linkGenerator.addParameter("af_cost_value","2.5");
linkGenerator.addParameter("af_cost_currency","USD");
// optional - set a brand domain to the user invite link
linkGenerator.setBrandDomain("brand.domain.com");
CreateOneLinkHttpTask.ResponseListener listener = new CreateOneLinkHttpTask.ResponseListener() {
	@Override
	public void onResponse(String s) {
		Log.d("Invite Link", s);
    // write logic to let user share the invite link
	}

	@Override
	public void onResponseError(String s) {
		// handle response error
	}
};
linkGenerator.generateLink(MainActivity.this, listener);

 Catatan

  • onResponse dan onResponseError adalah metode panggilan balik untuk menghasilkan URL OneLink. Mereka adalah bagian dari CreateOneLinkHttpTask.ResponseListener dan harus diimplementasikan. Mereka digunakan untuk menghasilkan tautan undangan yang dapat Anda masukkan ke dalam berbagai tampilan di aplikasi.
  • Anda dapat menambahkan salah satu parameter tautan atribusi ini ke tautan yang dihasilkan.
  • Karakter khusus dalam nilai parameter perlu dikodekan saat diteruskan ke fungsi LinkGenerator.
     

Semua pengatur pembuat tautan

Android iOS
Nama API Deskripsi Penggunaan

setChannel(String channel)

Channel yang digunakan untuk mengirim undangan (mis. Facebook/Gmail/dll.)

Disarankan

setCampaign(String campaign)

Nama kampanye

OPSIONAL

setReferrerName(String referrerName)

Nama pengguna yang merujuk

OPSIONAL

setReferrerImageURL(String referrerImageURL)

URL ke avatar pengguna yang merujuk

OPSIONAL

setReferrerCustomerId(String referrerCustomerID)

Tetapkan customer_user_id dari pengguna perujuk

OPSIONAL

addParameter(String key, String value)

Parameter khusus nilai kode tunggal

OPSIONAL

addParameters(Map<String, String> parameters)

Beberapa parameter khusus nilai kode

OPSIONAL

setBrandDomain(String domain)

Nama domain merek

OPSIONAL

Membutuhkan pembuatan tautan bermerek

Merekam undangan pengirim

Disarankan untuk membuat in-app event setelah undangan dikirim untuk merekam undangan dari sudut pandang pengirim. Ini memungkinkan Anda menemukan pengguna yang cenderung mengundang teman dan sumber media yang memberi Anda pengguna tersebut.

Anda dapat mengirim acara dalam aplikasi reguler atau menggunakan logInvite sebagai gantinya. logInvite adalah in-app event siap pakai yang dikemas dalam API agar lebih mudah digunakan.

Android iOS
ShareInviteHelper.logInvite(context, channel, additionalParametersForTheEvent_optional);

Mengambil data atribusi setelah penginstalan pengguna yang diundang

Semua parameter yang diteruskan di pembuat tautan tersedia dengan memanggil onConversionDataSuccess . Ini memungkinkan Anda untuk mengambil parameter yang relevan (seperti nama perujuk dan URL avatar) dan mempersonalisasi pengalaman pertama kali bagi pengguna baru. Ini adalah contoh data atribusi yang dikembalikan oleh onConversionDataSuccess :

{
	"attribute": "is_first_launch" = "true"
	"attribute": "click_time" = "2019-04-04 08:33:05.668"
	"attribute": "af_referrer_customer_id" = "CUSTOMER_USER_ID"
	"attribute": "shortlink" = "12a3b456"
	"attribute": "af_referrer_uid" = "1234567890123-4567890123456789012"
	"attribute": "af_siteid" = "com.company.app"
	"attribute": "install_time" = "2019-04-04 08:33:45.286"
	"attribute": "cost_cents_USD" = "0"
	"attribute": "campaign" = "None"
	"attribute": "af_click_lookback" = "7d"
	"attribute": "orig_cost" = "0.0"
	"attribute": "af_status" = "Non-organic"
	"attribute": "iscache" = "true"
	"attribute": "media_source" = "af_app_invites"
}

Informasi lebih lanjut tentang menggunakan data konversi: iOS dan Android .

Menggunakan tautan undangan pengguna untuk interaksi ulang

Anda dapat menggunakan tautan undangan pengguna untuk interaksi ulang. Namun, Anda perlu memastikan bahwa pengguna yang diundang telah menginstal aplikasi. Jika pengguna yang tidak memiliki aplikasi mendapatkan tautan undangan pengguna dan menginstal aplikasi, klik akan muncul di dasbor penargetan ulang, tetapi instal muncul di dashboard ikhtisar.

Untuk menggunakan tautan undangan pengguna untuk interaksi ulang, tambahkan parameter is_retargeting dan setel ke true menggunakan metode addParameter

Android iOS Unity V4
AppsFlyerLib.getInstance().addParameter("is_retargeting", "true");

Memberi reward kepada pengguna yang mengundang

Anda dapat memberi reward kepada pengguna yang mengundang teman mereka untuk menginstal aplikasi Anda. Dengan memberi reward, Anda mendorong pengguna untuk mengundang teman mereka. Ini merupakan cara yang bagus untuk memperluas basis pengguna dan meningkatkan pendapatan Anda.

Kapan harus memberi reward

Anda dapat memberikan reward kepada pengguna saat teman mereka menginstal aplikasi Anda setelah diundang. Anda juga dapat memberikan reward kepada pengguna saat teman mereka melakukan beberapa in-app event, seperti pembelian di aplikasi Anda.

Berikan reward kepada pengguna saat menginstal

Saat pengguna yang diundang menginstal aplikasi, ID dari pengguna perujuk ditemukan dalam data konversi di SDK :

  • af_referrer_uid - adalah ID AppsFlyer dari pengguna yang mengirimkan undangan
  • af_referrer_customer_id - adalah ID pengguna pelanggan dari pengguna yang mengirim undangan. Hanya muncul di data konversi jika Anda menetapkan ID pengguna pelanggan untuk pengguna ini.

Gunakan ID perujuk untuk memberi reward saat penginstalan

Jenny mengundang Nivi untuk menginstal aplikasi Anda.

  1. Saat Nivi meluncurkan aplikasi, aplikasi mengambil ID perujuk Jenny
  2. Aplikasi mengirimkan ID perujuk ke backend Anda
  3. Di backend Anda, tambahkan ID perujuk Jenny ke daftar pengguna yang akan diberi reward
  4. Saat Jenny meluncurkan aplikasinya, periksa apakah ID perujuknya ada dalam daftar pengguna yang akan diberi hadiah
  5. Jika ya, beri dia reward

Hadiahi pengguna pada in-app event

Jika Anda ingin menghasilkan pendapatan melalui undangan pengguna, daripada hanya mendapatkan pengguna, Anda dapat menghargai peristiwa dalam aplikasi. Dalam hal ini, Anda hanya memberi penghargaan kepada pengguna perujuk saat pengguna yang diundang melakukan peristiwa dalam aplikasi seperti pembelian atau langganan.

Proses penghargaan in-app event

Jenny mengundang Nivi untuk menginstal aplikasi Anda.

Setel af_sub1 pada Tautan Undangan

  1. Saat Jenny mengundang Nivi, buat tautan undangan
  2. Di tautan undangan, masukkan parameter af_sub1=<JENNY_USER_ID>

Nivi menginstal aplikasi dan melakukan pembelian. Saat dia melakukan pembelian, in-app event dikirim ke AppsFlyer. In-app event ini memiliki  sub1=<JENNY_USER_ID> yang terkait dengannya.

Gunakan af_sub1 untuk Memperbarui Daftar Pengguna yang Akan Diberi Reward

  1. Ambil data in-app event menggunakan pull API atau dapatkan data in-app event dari push API
  2. Di data tersebut, cari event yang memiliki  af_app_invites sebagai sumber medianya
  3. Event semacam ini memiliki af_sub1 yang terkait dengannya yang berisi ID perujuk
  4. Di backend Anda, tambahkan ID perujuk Jenny ke daftar pengguna yang akan diberi reward

Berikan reward kepada Jenny

  1. Saat Jenny meluncurkan aplikasinya, periksa apakah ID perujuknya ada dalam daftar pengguna yang akan diberi reward
  2. Jika ya, beri dia reward

Tampilan dasbor kustom

Di bawah ini adalah tampilan Dashboard Kustom yang tersedia yang menunjukkan informasi undangan pengguna:

Invite_Attribution_3.png

Invite_Attribution_4.png

Batasan

Batasan Deskripsi
Versi SDK Harus memiliki SDK AppsFlyer versi 4.8.0+ dan Unity SDK versi 4.17.0+.
Laman arahan aplikasi media sosial Tautan yang dihasilkan dari undangan pengguna tidak dapat mengimplementasikan laman arahan aplikasi media sosial.