אחת הדרכים היעילות ביותר להשיג משתמשים חדשים היא באמצעות הפניות משתמשים. אתה יכול להשתמש בקישורים דינמיים יחד עם מסד נתונים בזמן אמת ופונקציות ענן עבור Firebase כדי לעודד את המשתמשים שלך להזמין את חבריהם על ידי הצעת תגמולים בתוך האפליקציה עבור הפניות מוצלחות הן למפנה והן לנמען.
יתרונות מרכזיים
- האץ את הצמיחה על ידי מתן תמריץ למשתמשים שלך להזמין את חבריהם.
- קישורי הזמנות פועלים על פני פלטפורמות.
- משתמשים חדשים שפותחים את האפליקציה שלך בפעם הראשונה מקבלים חוויית הפעלה ראשונה שתתאים אישית עבורם. לדוגמה, אתה יכול לחבר אותם אוטומטית עם החבר שהזמין אותם.
- אפשר לדחות את מתן התגמולים עד שמשתמשים חדשים ישלימו משימת היכרות כלשהי, כגון השלמת הדרכה.
הנה איך להתחיל!
הגדר את Firebase ואת ה-SDK של Dynamic Links
הגדר פרויקט Firebase חדש והתקן את ה-SDK של Dynamic Links באפליקציה שלך. ( iOS , Android , C++ , Unity ). התקנת ה-SDK של Dynamic Links מאפשרת ל-Firebase להעביר נתונים על הקישור הדינמי לאפליקציה, כולל לאחר שהמשתמש מתקין את האפליקציה. ללא ה-SDK, אין דרך לחבר משתמש לאחר ההתקנה בלחיצה מוקדמת להתקנה.
צור קישורי הזמנה
כדי ליצור הזמנה, צור תחילה את הקישור שהנמען פותח כדי לקבל את ההזמנה. בהמשך תכלול קישור זה בטקסט ההזמנה. כאשר מקבל ההזמנה מתקין את האפליקציה שלך על ידי פתיחת הקישור, הוא יכול לקבל חווית הפעלה ראשונה מותאמת אישית, כולל קבלת תגמול בתוך האפליקציה.
קישור הזמנה זה הוא קישור דינמי עם ערך פרמטר link המציין שהוא מהמשתמש הקיים שלך.
ישנן דרכים רבות שבהן תוכל לעצב את מטענים אלה של פרמטרי link ולקשור אותם לאפליקציה שלך. דרך פשוטה אחת היא לציין את מזהה חשבון המשתמש של השולח בפרמטר שאילתה כמו בדוגמה הבאה:
https://mygame.example.com/?invitedby=SENDER_UID
לאחר מכן, כדי ליצור קישורים דינמיים המתאימים להכללה בהזמנה, תוכל להשתמש בממשק ה-API של בונה קישורים דינמיים:
מָהִיר
guard let uid = Auth.auth().currentUser?.uid else { return }
let link = URL(string: "https://mygame.example.com/?invitedby=\(uid)")
let referralLink = DynamicLinkComponents(link: link!, domain: "example.page.link")
referralLink.iOSParameters = DynamicLinkIOSParameters(bundleID: "com.example.ios")
referralLink.iOSParameters?.minimumAppVersion = "1.0.1"
referralLink.iOSParameters?.appStoreID = "123456789"
referralLink.androidParameters = DynamicLinkAndroidParameters(packageName: "com.example.android")
referralLink.androidParameters?.minimumVersion = 125
referralLink.shorten { (shortURL, warnings, error) in
if let error = error {
print(error.localizedDescription)
return
}
self.invitationUrl = shortURL
}
Kotlin+KTX
val user = Firebase.auth.currentUser!!
val uid = user.uid
val invitationLink = "https://mygame.example.com/?invitedby=$uid"
Firebase.dynamicLinks.shortLinkAsync {
link = Uri.parse(invitationLink)
domainUriPrefix = "https://example.page.link"
androidParameters("com.example.android") {
minimumVersion = 125
}
iosParameters("com.example.ios") {
appStoreId = "123456789"
minimumVersion = "1.0.1"
}
}.addOnSuccessListener { shortDynamicLink ->
mInvitationUrl = shortDynamicLink.shortLink
// ...
}Java
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
String uid = user.getUid();
String link = "https://mygame.example.com/?invitedby=" + uid;
FirebaseDynamicLinks.getInstance().createDynamicLink()
.setLink(Uri.parse(link))
.setDomainUriPrefix("https://example.page.link")
.setAndroidParameters(
new DynamicLink.AndroidParameters.Builder("com.example.android")
.setMinimumVersion(125)
.build())
.setIosParameters(
new DynamicLink.IosParameters.Builder("com.example.ios")
.setAppStoreId("123456789")
.setMinimumVersion("1.0.1")
.build())
.buildShortDynamicLink()
.addOnSuccessListener(new OnSuccessListener<ShortDynamicLink>() {
@Override
public void onSuccess(ShortDynamicLink shortDynamicLink) {
mInvitationUrl = shortDynamicLink.getShortLink();
// ...
}
});שלח את ההזמנות
כעת לאחר שיצרת את הקישור, תוכל לכלול אותו בהזמנה. ההזמנה יכולה להיות אימייל, הודעת SMS או כל אמצעי אחר, תלוי מה הכי מתאים לאפליקציה ולקהל שלכם.
לדוגמה, כדי לשלוח הזמנה בדוא"ל:
מָהִיר
guard let referrerName = Auth.auth().currentUser?.displayName else { return }
let subject = "\(referrerName) wants you to play MyExampleGame!"
let invitationLink = invitationUrl?.absoluteString
let msg = "<p>Let's play MyExampleGame together! Use my <a href=\"\(invitationLink)\">referrer link</a>!</p>"
if !MFMailComposeViewController.canSendMail() {
// Device can't send email
return
}
let mailer = MFMailComposeViewController()
mailer.mailComposeDelegate = self
mailer.setSubject(subject)
mailer.setMessageBody(msg, isHTML: true)
myView.present(mailer, animated: true, completion: nil)
Kotlin+KTX
val referrerName = Firebase.auth.currentUser?.displayName
val subject = String.format("%s wants you to play MyExampleGame!", referrerName)
val invitationLink = mInvitationUrl.toString()
val msg = "Let's play MyExampleGame together! Use my referrer link: $invitationLink"
val msgHtml = String.format("<p>Let's play MyExampleGame together! Use my " +
"<a href=\"%s\">referrer link</a>!</p>", invitationLink)
val intent = Intent(Intent.ACTION_SENDTO).apply {
data = Uri.parse("mailto:") // only email apps should handle this
putExtra(Intent.EXTRA_SUBJECT, subject)
putExtra(Intent.EXTRA_TEXT, msg)
putExtra(Intent.EXTRA_HTML_TEXT, msgHtml)
}
intent.resolveActivity(packageManager)?.let {
startActivity(intent)
}Java
String referrerName = FirebaseAuth.getInstance().getCurrentUser().getDisplayName();
String subject = String.format("%s wants you to play MyExampleGame!", referrerName);
String invitationLink = mInvitationUrl.toString();
String msg = "Let's play MyExampleGame together! Use my referrer link: "
+ invitationLink;
String msgHtml = String.format("<p>Let's play MyExampleGame together! Use my "
+ "<a href=\"%s\">referrer link</a>!</p>", invitationLink);
Intent intent = new Intent(Intent.ACTION_SENDTO);
intent.setData(Uri.parse("mailto:")); // only email apps should handle this
intent.putExtra(Intent.EXTRA_SUBJECT, subject);
intent.putExtra(Intent.EXTRA_TEXT, msg);
intent.putExtra(Intent.EXTRA_HTML_TEXT, msgHtml);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}אחזר מידע הפניה באפליקציה שלך
כאשר מקבל ההזמנה יפתח את קישור ההפניה, הוא יופנה ל-App Store או Play Store כדי להתקין את האפליקציה שלך אם היא עדיין לא מותקנת. לאחר מכן, כאשר הם פותחים את האפליקציה שלך בפעם הראשונה, תוכל לאחזר את פרטי ההפניה שכללת בקישור הדינמי ולהשתמש בו כדי להחיל את הפרס.
בדרך כלל, אתה רוצה להעניק תגמולי הפניה רק לאחר שמקבל ההזמנה נרשם, או אפילו רק לאחר שהמשתמש החדש ישלים משימה כלשהי. עד עמידה בקריטריונים של התגמול, עליך לעקוב אחר מידע התגמול שקיבלת מהקישור הדינמי.
דרך אחת לעקוב אחר מידע זה היא להיכנס למשתמש באופן אנונימי ולאחסן את הנתונים ברשומת מסד הנתונים בזמן אמת של החשבון האנונימי. כאשר הנמען נרשם והחשבון האנונימי מומר לחשבון קבוע, לחשבון החדש יהיה אותו UID כמו החשבון האנונימי, וכתוצאה מכך תהיה לו גישה למידע על התגמול.
לדוגמה, כדי לשמור את ה-UID של המפנה לאחר שהנמען פותח את האפליקציה שלך:
מָהִיר
struct MyApplication: App {
var body: some Scene {
WindowGroup {
VStack {
Text("Example text")
}
.onOpenURL { url in
if DynamicLinks.dynamicLinks()?.shouldHandleDynamicLink(fromCustomSchemeURL: url) ?? false {
let dynamicLink = DynamicLinks.dynamicLinks()?.dynamicLink(fromCustomSchemeURL: url)
handleDynamicLink(dynamicLink)
}
// Handle incoming URL with other methods as necessary
// ...
}
}
}
}
func handleDynamicLink(_ dynamicLink: DynamicLink?) {
guard let dynamicLink = dynamicLink else { return false }
guard let deepLink = dynamicLink.url else { return false }
let queryItems = URLComponents(url: deepLink, resolvingAgainstBaseURL: true)?.queryItems
let invitedBy = queryItems?.filter({(item) in item.name == "invitedby"}).first?.value
let user = Auth.auth().currentUser
// If the user isn't signed in and the app was opened via an invitation
// link, sign in the user anonymously and record the referrer UID in the
// user's RTDB record.
if user == nil && invitedBy != nil {
Auth.auth().signInAnonymously() { (user, error) in
if let user = user {
let userRecord = Database.database().reference().child("users").child(user.uid)
userRecord.child("referred_by").setValue(invitedBy)
if dynamicLink.matchConfidence == .weak {
// If the Dynamic Link has a weak match confidence, it is possible
// that the current device isn't the same device on which the invitation
// link was originally opened. The way you handle this situation
// depends on your app, but in general, you should avoid exposing
// personal information, such as the referrer's email address, to
// the user.
}
}
}
}
}
Kotlin+KTX
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// ...
Firebase.dynamicLinks
.getDynamicLink(intent)
.addOnSuccessListener(this) { pendingDynamicLinkData ->
// Get deep link from result (may be null if no link is found)
var deepLink: Uri? = null
if (pendingDynamicLinkData != null) {
deepLink = pendingDynamicLinkData.link
}
//
// If the user isn't signed in and the pending Dynamic Link is
// an invitation, sign in the user anonymously, and record the
// referrer's UID.
//
val user = Firebase.auth.currentUser
if (user == null &&
deepLink != null &&
deepLink.getBooleanQueryParameter("invitedby", false)) {
val referrerUid = deepLink.getQueryParameter("invitedby")
createAnonymousAccountWithReferrerInfo(referrerUid)
}
}
}
private fun createAnonymousAccountWithReferrerInfo(referrerUid: String?) {
Firebase.auth
.signInAnonymously()
.addOnSuccessListener {
// Keep track of the referrer in the RTDB. Database calls
// will depend on the structure of your app's RTDB.
val user = Firebase.auth.currentUser
val userRecord = Firebase.database.reference
.child("users")
.child(user!!.uid)
userRecord.child("referred_by").setValue(referrerUid)
}
}Java
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// ...
FirebaseDynamicLinks.getInstance()
.getDynamicLink(getIntent())
.addOnSuccessListener(this, new OnSuccessListener<PendingDynamicLinkData>() {
@Override
public void onSuccess(PendingDynamicLinkData pendingDynamicLinkData) {
// Get deep link from result (may be null if no link is found)
Uri deepLink = null;
if (pendingDynamicLinkData != null) {
deepLink = pendingDynamicLinkData.getLink();
}
//
// If the user isn't signed in and the pending Dynamic Link is
// an invitation, sign in the user anonymously, and record the
// referrer's UID.
//
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
if (user == null
&& deepLink != null
&& deepLink.getBooleanQueryParameter("invitedby", false)) {
String referrerUid = deepLink.getQueryParameter("invitedby");
createAnonymousAccountWithReferrerInfo(referrerUid);
}
}
});
}
private void createAnonymousAccountWithReferrerInfo(final String referrerUid) {
FirebaseAuth.getInstance()
.signInAnonymously()
.addOnSuccessListener(new OnSuccessListener<AuthResult>() {
@Override
public void onSuccess(AuthResult authResult) {
// Keep track of the referrer in the RTDB. Database calls
// will depend on the structure of your app's RTDB.
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
DatabaseReference userRecord =
FirebaseDatabase.getInstance().getReference()
.child("users")
.child(user.getUid());
userRecord.child("referred_by").setValue(referrerUid);
}
});
}לאחר מכן, כאשר מקבל ההזמנה מחליט ליצור חשבון, תוכל להעביר את פרטי ההפניה מהחשבון האנונימי לחשבון החדש של מקבל ההזמנה.
ראשית, קבל אובייקט AuthCredential באמצעות שיטת הכניסה בה המוזמן רוצה להשתמש. לדוגמה, כדי להיכנס עם כתובת דוא"ל וסיסמה:
מָהִיר
let credential = EmailAuthProvider.credential(withEmail: email, password: password)
Kotlin+KTX
val credential = EmailAuthProvider.getCredential(email, password)
Java
AuthCredential credential = EmailAuthProvider.getCredential(email, password);
לאחר מכן, קשר את האישור הזה לחשבון האנונימי:
מָהִיר
if let user = Auth.auth().currentUser {
user.link(with: credential) { (user, error) in
// Complete any post sign-up tasks here.
}
}
Kotlin+KTX
Firebase.auth.currentUser!!
.linkWithCredential(credential)
.addOnSuccessListener {
// Complete any post sign-up tasks here.
}Java
FirebaseAuth.getInstance().getCurrentUser()
.linkWithCredential(credential)
.addOnSuccessListener(new OnSuccessListener<AuthResult>() {
@Override
public void onSuccess(AuthResult authResult) {
// Complete any post sign-up tasks here.
}
});לחשבון החדש, הקבוע, יש גישה לכל נתוני התגמול שהוספת לחשבון האנונימי.
הענק תגמולים למפנה ולנמען
כעת, לאחר שאחזרת ושמרת את נתוני ההזמנה מהקישור הדינמי, תוכל להעניק את תגמולי ההפניה למפנה ולנמען בכל פעם שהתקיימו הקריטריונים שאתה רוצה לדרוש.
למרות שאתה יכול לכתוב למסד הנתונים בזמן אמת מאפליקציית הלקוח שלך, לעתים קרובות תרצה לאפשר רק גישת קריאה לנתונים כמו מטבע בתוך האפליקציה מהאפליקציות שלך, ולבצע פעולות כתיבה רק מהחלק האחורי שלך. הקצה האחורי הזה יכול להיות כל מערכת שמסוגלת להריץ את Firebase Admin SDK, אבל לרוב זה הכי קל להשתמש בפונקציות ענן לביצוע משימות אלה.
לדוגמה, נניח שיש לך משחק ואתה רוצה להעניק פרס של מטבע במשחק לנמען לאחר שהנמען נרשם, ולמפנה לאחר שהנמען יגיע לרמה 5.
כדי להעניק את התגמול על ההרשמה, פרסו פונקציה שצופה אחר מפתח ספציפי של מסד נתונים בזמן אמת שייווצר, ומעניקה את התגמול כאשר הוא קיים. לדוגמה:
const functions = require('firebase-functions');
const admin = require('firebase-admin');
admin.initializeApp(functions.config().firebase);
exports.grantSignupReward = functions.database.ref('/users/{uid}/last_signin_at')
.onCreate(event => {
var uid = event.params.uid;
admin.database().ref(`users/${uid}/referred_by`)
.once('value').then(function(data) {
var referred_by_somebody = data.val();
if (referred_by_somebody) {
var moneyRef = admin.database()
.ref(`/users/${uid}/inventory/pieces_of_eight`);
moneyRef.transaction(function (current_value) {
return (current_value || 0) + 50;
});
}
});
});
לאחר מכן, כאשר משתמש חדש נרשם, הפעל את הפונקציה הזו על ידי יצירת מפתח מסד הנתונים בזמן אמת. לדוגמה, הפעל את הפונקציה במאזין ההצלחה של linkWithCredential , שיצרת בשלב הקודם:
מָהִיר
if let user = Auth.auth().currentUser {
user.link(with: credential) { (user, error) in
// Complete any post sign-up tasks here.
// Trigger the sign-up reward function by creating the "last_signin_at" field.
// (If this is a value you want to track, you would also update this field in
// the success listeners of your Firebase Authentication signIn calls.)
if let user = user {
let userRecord = Database.database().reference().child("users").child(user.uid)
userRecord.child("last_signin_at").setValue(ServerValue.timestamp())
}
}
}
Kotlin+KTX
Firebase.auth.currentUser!!
.linkWithCredential(credential)
.addOnSuccessListener {
// Complete any post sign-up tasks here.
// Trigger the sign-up reward function by creating the
// "last_signin_at" field. (If this is a value you want to track,
// you would also update this field in the success listeners of
// your Firebase Authentication signIn calls.)
val user = Firebase.auth.currentUser!!
val userRecord = Firebase.database.reference
.child("users")
.child(user.uid)
userRecord.child("last_signin_at").setValue(ServerValue.TIMESTAMP)
}Java
FirebaseAuth.getInstance().getCurrentUser()
.linkWithCredential(credential)
.addOnSuccessListener(new OnSuccessListener<AuthResult>() {
@Override
public void onSuccess(AuthResult authResult) {
// Complete any post sign-up tasks here.
// Trigger the sign-up reward function by creating the
// "last_signin_at" field. (If this is a value you want to track,
// you would also update this field in the success listeners of
// your Firebase Authentication signIn calls.)
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
DatabaseReference userRecord =
FirebaseDatabase.getInstance().getReference()
.child("users")
.child(user.getUid());
userRecord.child("last_signin_at").setValue(ServerValue.TIMESTAMP);
}
}); כדי להעניק פרס למפנה כאשר הנמען מגיע לרמה 5, הפעל פונקציה שעוקבת אחר שינויים בשדה level ברשומות המשתמש שלך. אם משתמש עבר מרמה 4 לרמה 5, ולמשתמש רשום מפנה, הענק את הפרס:
const functions = require('firebase-functions');
const admin = require('firebase-admin');
admin.initializeApp(functions.config().firebase);
exports.rewardReferrals = functions.database.ref('/users/{uid}/level')
.onUpdate(event => {
var level = event.data.val();
var prev_level = event.data.previous.val();
if (prev_level == 4 && level == 5) {
var referrerRef = event.data.ref.parent.child('referred_by');
return referrerRef.once('value').then(function(data) {
var referrerUid = data.val();
if (referrerUid) {
var moneyRef = admin.database()
.ref(`/users/${referrerUid}/inventory/pieces_of_eight`);
return moneyRef.transaction(function (current_value) {
return (current_value || 0) + 50;
});
}
});
}
});
גם המפנה וגם המשתמש החדש שלך קיבלו כעת את התגמולים שלהם.