안드로이드 앱 추천

개요

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

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

사용자 초대 구현

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

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

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

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

Set up invite link generation

사용자가 친구를 앱에 초대할 수 있도록 하려면 사용자 초대 링크를 생성하는 방법이 필요합니다. 이것은 다음을 사용하여 완료됩니다 LinkGenerator.
사용자 초대 링크 생성을 설정하려면:

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

    import com.appsflyer.AppsFlyerLib;
    import com.appsflyer.CreateOneLinkHttpTask;
    import com.appsflyer.share.LinkGenerator;
    import com.appsflyer.share.ShareInviteHelper;
    
  2. 다음을 사용하여 원링크 템플릿을 설정 setAppInviteOneLink() (템플릿 ID는 마케터가 제공한 것입니다):

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

    📘

    참고

    • 호출하십시오 setAppInviteOneLink() 호출 전에 start.
    • 원링크 템플릿은 앱과 관련되어야 합니다.
  3. QR 코드를 LinkGenerator using ShareInviteHelper.generateInviteUrl().

    LinkGenerator linkGenerator = ShareInviteHelper.generateInviteUrl(getApplicationContext());
    
  4. 달성하려는 사용자 흐름에 따라 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 코드를 LinkGenerator.ResponseListener 를 사용하여 다음 파라미터를 추가하여 사용자 초대 링크를 사용할 수 있을 때 검색합니다:

    LinkGenerator.ResponseListener listener = new LinkGenerator.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");
                }
             
    };
    

    📘

    참고

    Since SDK v6.9.0 LinkGenerator.ResponseListener replaced CreateOneLinkHttpTask.ResponseListener

  • onResponse() 사용자 초대가 성공적으로 생성되면 호출됩니다.
  • onResponseError() 링크 생성이 실패할 때 호출됩니다.
  1. 전달 listener to linkGenerator.generateLink():
    linkGenerator.generateLink(getApplicationContext(), listener);
    

Set the shortlink ID

선택 가능
The shortlink ID can be determined by the developer, by adding the paramter af_custom_shortlink 변경 대상 LinkGenerator instance.

linkGenerator.addParameter("af_custom_shortlink", <value>);

Log invite link creation events

선택 가능
초대 링크 생성 이벤트를 기록하려면 :
인앱이벤트에서 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 결과를 이용하여 af_invite 초대를 기록합니다.

📘

참고

채널을 사용하고 싶지 않다면 logEvent 를 대신 사용할 수 있습니다.

Set up UDL for user invite attribution

선택 가능
사용자 초대 어트리뷰션을 위한 UDL을 설정하려면:
통합 딥링킹(UDL)을 설정합니다. 에 DeepLinkListener.onDeepLinking(), 링크 생성 단계에서 생성된 딥링킹 파라미터를 검색합니다. 이 예에서는 다음 속성을 검색합니다:

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

코드 참조: Java.

리워드 추천인

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

Reward referrers on install

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

사용자 A의 ID는 DeepLinkListener.onDeepLinking() 에서 사용할 수 있으며, 이 예에서는 DeepLink.getStringValue("deep_link_sub2")를 사용하여 검색됩니다. ID를 검색하면 그것을 리워드를 받을 리퍼러 ID 목록에 추가합니다. 목록을 저장하고 검색하는 방법은 사용자에게 달려 있습니다.

Reward referrers for user actions

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

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

  1. 사용자 A의 리퍼러 ID를 검색하여 사용자 정의 가능한 인앱이벤트 파라미터 중 하나에 추가합니다(예를 들어, 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단계가 구현되는 방식에 따라 달라집니다.
  • 구매 이벤트는 예시일 뿐입니다. 이는 모든 유형의 인앱 이벤트에 적용됩니다.