iOS user invite attribution
개요
기존 사용자가 다른 사용자에게 앱을 추천할 때 사용자 초대 링크를 구현하고 어트리뷰트합니다.
소개는 사용자 초대를 참조하십시오.
전체 예제를 보시겠습니까? 레시피를 확인하십시오:
사용자 초대 구현
시작하기 전에: 마케터와 협력히여 링크에 대해 원하는 정확한 사용 사례를 찾고 구현하려는 파라미터 목록을 가져옵니다.
사용자 초대 어트리뷰션을 구현하려면 다음 단계를 완료하십시오:
- 초대 링크 생성을 설정하여 초대 링크를 생성합니다.
- 선택 가능 초대 링크 생성 기록.
- 통합 딥링킹(UDL) 설정
- 선택 가능 사용자 초대 링크에서 리퍼러 데이터를 검색합니다.
- 선택 사항 추천인 보상을 설정합니다.
다음 코드는 마케터 예제를 기반으로 합니다.
Set up invite link generation
To enable users to invite their friends to your app, you need a way to generate invitation links. This is done using AppsFlyerLinkGenerator
.
To set up invite link generation:
-
Make sure you import
AppsFlyerLib
:import com.appsflyer.AppsFlyerLib;
-
In
AppDelegate
, set a OneLink template usingappInviteOneLinkID
(The template ID is provided by the marketer):AppsFlyerLib.shared().appInviteOneLinkID = "H5hv" // Set the OneLink template ID for userinvitation links
참고
- Make sure to set
appInviteOneLinkID
before callingstart
- 원링크 템플릿은 앱과 관련되어야 합니다.
- Make sure to set
-
Call
AppsFlyerShareInviteHelper.generateInviteUrl
and pass it anAppsFlyerLinkGenerator
and acompletionHandler
: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") } } )
Depending on the user flow you and the marketer want to achieve, configure
generator
as follows:- setter를 사용하여 어트리뷰션 파라미터를 설정합니다.
- Set deep linking parameters, using
AppsFlyerLinkGenerator.addParameterValue
:deep_link_value
: 추천된 사용자가 딥링크해야 하는 앱 환경입니다.deep_link_sub1
: 맞춤설정 가능한 파라미터입니다. 이 예에서는 초대받은 사람이 받은 프로모션 코드를 전달하는 데 사용됩니다.deep_link_sub2
: 리퍼러의 식별자. 리퍼러를 보상하는 데 사용할 수 있습니다.
-
In the
completionHandler
, check if the URL was created successfully (url
notnil
), and retrieve the generated user invite link. -
사용자가 생성된 링크를 공유할 수 있습니다. 예를 들어 클립보드에 복사합니다.
Log invite link creation events
선택 가능
To log the invite link creation event:
Send an event indicating that a user has generated an invite link using logInvite
:
AppsFlyerShareInviteHelper.logInvite(<CHANNEL>, parameters: [
"campaign" : "summer_sale",
"referrerId" : <REFERRER_ID>,
]);
logInvite
results in an af_invite
in-app event.
참고
If you don't want to use a channel, you can use
logEvent
instead.
Set up UDL for user invite attribution
선택 가능
사용자 초대 어트리뷰션을 위한 UDL을 설정하려면:
-
통합 딥링킹(UDL)을 설정합니다.
-
In
DeepLinkDelegate.didResolveDeepLink
, retrieve the deep linking parameters created during the link generation step. In this example, the following properties are retrieved:deep_link_value
, 사용DeepLink.deeplinkValue
deep_link_sub1
, 사용DeepLink.clickEvent["deep_link_sub1"]
deep_link_sub2
, 사용DeepLink.clickEvent["deep_link_sub2"]
코드 참조: Swift.
-
리퍼러 ID를 검색하면 저장 및 사용 방법은 사용자에게 달려 있습니다.
리워드 추천인
선택 가능
다음 시나리오에서 사용자 A는 사용자 B를 앱에 초대합니다.
Reward referrers on install
Scenario: User B installs your app via User A's invite link.
User A's referrer ID is available in the UDL didResolveDeepLink
(in this example, under DeepLink.clickEvent["deep_link_sub2"]
). Once you retrieve the ID, add it to the list of referrer IDs to be rewarded. It's up to you how to store and retrieve the list.
Reward referrers on in-app events
시나리오: 사용자 B가 구매합니다. 처음에 앱을 사용자 B에게 추천한 사용자 A에게 해당 행동에 대해 보상하려고 합니다.
사용자 B의 행동에 대해 사용자 A에게 보상하려면:
- Retrieve user A's referrer ID and add it to one of the customizble in-app event parameters (for example,
af_param_1
):AppsFlyerLib.shared().logEvent(AFEventPurchase, withValues: [ AFEventParamRevenue: 200, AFEventParamCurrency:"USD", AFEventParam1: <REFERRER_ID> ]);
- 백엔드에서 인앱이벤트 데이터 검색.
- 보상을 받을 사용자 목록에 찾은 리퍼러 ID를 추가합니다.
- 사용자 A가 앱을 실행하면 리워드를 받을 사용자 목록에 자신의 리퍼러 ID가 있는지 확인하고 있으면 리워드를 제공합니다.
참고
- 2~3단계는 모바일 개발자가 수행하지 않습니다. 4단계는 2-3단계가 구현되는 방식에 따라 달라집니다.
- 구매 이벤트는 예시일 뿐입니다. 이는 모든 유형의 인앱 이벤트에 적용됩니다.
최신 데이터 23일 전