사용자 초대 어트리뷰션

개요

기존 사용자가 다른 사용자에게 앱을 추천할 때 사용자 초대 링크를 구현하고 어트리뷰트합니다.
소개는 사용자 초대를 참조하십시오.

전체 예제를 보시겠습니까? 레시피를 확인하십시오:

사용자 초대 구현

시작하기 전에: 마케터와 협력히여 링크에 대해 원하는 정확한 사용 사례를 찾고 구현하려는 파라미터 목록을 가져옵니다.

사용자 초대 어트리뷰션을 구현하려면 다음 단계를 완료하십시오:

  1. 초대 링크 생성을 설정하여 초대 링크를 생성합니다.
  2. 선택 가능 초대 링크 생성 기록.
  3. 통합 딥링킹(UDL) 설정
  4. 선택 가능 사용자 초대 링크에서 리퍼러 데이터를 검색합니다.
  5. 선택 사항 추천인 보상을 설정합니다.

다음 코드는 마케터 예제를 기반으로 합니다.

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:

  1. Make sure you import AppsFlyerLib:

    import com.appsflyer.AppsFlyerLib;
    
  2. In AppDelegate, set a OneLink template using appInviteOneLinkID (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 calling start
    • 원링크 템플릿은 앱과 관련되어야 합니다.
  3. Call AppsFlyerShareInviteHelper.generateInviteUrl and pass it an AppsFlyerLinkGenerator and a 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")
                }
            }
    )
    

    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: 리퍼러의 식별자. 리퍼러를 보상하는 데 사용할 수 있습니다.
  4. In the completionHandler, check if the URL was created successfully (url not nil), and retrieve the generated user invite link.

  5. 사용자가 생성된 링크를 공유할 수 있습니다. 예를 들어 클립보드에 복사합니다.

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을 설정하려면:

  1. 통합 딥링킹(UDL)을 설정합니다.

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

  3. 리퍼러 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에게 보상하려면:

  1. 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>
      ]);
    
  2. 백엔드에서 인앱이벤트 데이터 검색.
  3. 보상을 받을 사용자 목록에 찾은 리퍼러 ID를 추가합니다.
  4. 사용자 A가 앱을 실행하면 리워드를 받을 사용자 목록에 자신의 리퍼러 ID가 있는지 확인하고 있으면 리워드를 제공합니다.

📘

참고

  • 2~3단계는 모바일 개발자가 수행하지 않습니다. 4단계는 2-3단계가 구현되는 방식에 따라 달라집니다.
  • 구매 이벤트는 예시일 뿐입니다. 이는 모든 유형의 인앱 이벤트에 적용됩니다.