사용자 초대 어트리뷰션

사용자 초대 구현

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

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

  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 user invite links. This is done using LinkGenerator.
To set up user invite link generation:

  1. 다음 종속성을 가져와야 합니다:

    import com.appsflyer.AppsFlyerLib;
    import com.appsflyer.CreateOneLinkHttpTask;
    import com.appsflyer.share.LinkGenerator;
    import com.appsflyer.share.ShareInviteHelper;
    
  2. Set a OneLink template using setAppInviteOneLink() (The template ID is provided by the marketer):

    AppsFlyerLib.getInstance().setAppInviteOneLink("H5hv"); // set the OneLink template ID the user invite links will be based on
    

    📘

    참고

    • Make sure to call setAppInviteOneLink() before calling start.
    • 원링크 템플릿은 앱과 관련되어야 합니다.
  3. QR 코드를 LinkGenerator using ShareInviteHelper.generateInviteUrl().

    LinkGenerator linkGenerator = ShareInviteHelper.generateInviteUrl(getApplicationContext());
    
  4. Depending on the user flow you want to achieve, add the following parameters using linkGenerator.addParameter():

    linkGenerator.addParameter("deep_link_value", <TARGET_VIEW>);
    linkGenerator.addParameter("deep_link_sub1", <PROMO_CODE>);
    linkGenerator.addParameter("deep_link_sub2", <REFERRER_ID>);
    // Optional; makes the referrer ID available in the installs raw-data report
    linkGenerator.addParameter("af_sub1", <REFERRER_ID>);
    
    • deep_link_value: 추천된 사용자가 딥링크해야 하는 앱 환경입니다.
    • deep_link_sub1: 초대받은 사람이 받은 프로모션 코드입니다.
    • deep_link_sub2: 리퍼러의 식별자. 리퍼러를 보상하는 데 사용할 수 있습니다.
    • 참고 : SDK V6.5.2 이하 버전을 사용하는 경우 모든 파라미터 값을 특수 문자로 인코딩해야 합니다.
  5. 어트리뷰션 파라미터를 설정합니다. (이는 앱스플라이어 대시보드 및 로데이터 리포트에 표시됩니다).

    linkGenerator.setCampaign("summer_sale");
    linkGenerator.setChannel("mobile_share");
    
  6. 선택 사항 생성된 링크에 대해 브랜드 도메인을 설정합니다:

    linkGenerator.setBrandDomain("brand.domain.com");
    
  7. QR 코드를 CreateOneLinkHttpTask.ResponseListener to retrieve the user invite link when it's available:

    CreateOneLinkHttpTask.ResponseListener listener = new CreateOneLinkHttpTask.ResponseListener() {
                @Override
                public void onResponse(String s) {
                    Log.d(LOG_TAG, "Share invite link: " + s);
                    // ...
                }
    
                @Override
                public void onResponseError(String s) {
                    Log.d(LOG_TAG, "onResponseError called");
                }
             
    };
    
  • onResponse() 사용자 초대가 성공적으로 생성되면 호출됩니다.
  • onResponseError() 링크 생성이 실패할 때 호출됩니다.
  1. Pass listener to linkGenerator.generateLink():
    linkGenerator.generateLink(getApplicationContext(), listener);
    

Log invite link creation events

선택 가능
To log the invite link creation event:
Log the invite using logInvite():

HashMap<String,String> logInviteMap = new HashMap<String,String>();
logInviteMap.put("referrerId", <REFERRER_ID>);
logInviteMap.put("campaign", "summer_sale");

ShareInviteHelper.logInvite(getApplicationContext(), "mobile_share", logInviteMap);

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을 설정하려면:
Set up Unified Deep Linking (UDL). In DeepLinkListener.onDeepLinking(), retrieve the deep linking parameters created during the link generation step. In this example, the following properties are retrieved:

  • deep_link_value, 사용 DeepLink.getDeepLinkValue()
  • deep_link_sub1, 사용 DeepLink.getStringValue()
  • deep_link_sub2, 사용 DeepLink.getStringValue()

코드 참조: Java.

리워드 추천인

선택 가능
다음 시나리오에서 사용자 A사용자 B를 앱에 초대합니다.

Reward referrers on install

시나리오: 사용자 B가 사용자 A의 초대 링크를 통해 앱을 인스톨합니다.

User A's ID is available in DeepLinkListener.onDeepLinking() and in this example, is retrieved using DeepLink.getStringValue("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 for user actions

시나리오: 사용자 B가 구매합니다. 처음에 앱을 사용자 B에게 추천한 사용자 A에게 해당 행동에 대해 보상하려고 합니다.

사용자 B의 행동에 대해 사용자 A에게 보상하려면:

  1. Retrieve User A's referrer ID and add it to one of the customizable in-app event parameters (for example, af_param_1):

     Map<String, Object> purchaseEventParameters = new HashMap<String, Object>();
     purchaseEventParameters.put(AFInAppEventParameterName.PARAM_1, <REFERRER_ID>);
     purchaseEventParameters.put(AFInAppEventParameterName.CURRENCY, "USD");
     purchaseEventParameters.put(AFInAppEventParameterName.REVENUE, 200);
     
     AppsFlyerLib.getInstance().logEvent(getApplicationContext(), purchaseEventParameters);
    
  2. 백엔드에서 인앱이벤트 데이터 검색

  3. 보상을 받을 사용자 목록에 찾은 리퍼러 ID를 추가합니다.

  4. 사용자 A가 앱을 실행하면 리워드를 받을 사용자 목록에 자신의 리퍼러 ID가 있는지 확인하고 있으면 리워드를 제공합니다.

📘

참고

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