iOS 앱 추천

개요

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

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

사용자 초대 구현

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

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

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

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

Set up invite link generation

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

  1. 다음을 가져오십시오: AppsFlyerLib:

    import com.appsflyer.AppsFlyerLib;
    
  2. In AppDelegate에서, 다음을 사용하여 원링크 템플릿을 설정 appInviteOneLinkID (템플릿 ID는 마케터가 제공한 것입니다):

    AppsFlyerLib.shared().appInviteOneLinkID = "H5hv" // Set the OneLink template ID for userinvitation links
    

    📘

    참고

    • 다음을 설정하십시오: appInviteOneLinkID 호출 전에 start
    • 원링크 템플릿은 앱과 관련되어야 합니다.
  3. 통화 AppsFlyerShareInviteHelper.generateInviteUrl 를 호출하고 그것을 AppsFlyerLinkGenerator 과 다음에 보내십시오. 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")
                }
            }
    )
    

    사용자와 마케터가 달성하고자 하는 사용자 흐름에 따라 다음과 같이 generator 를 구성합니다:

    • setter를 사용하여 어트리뷰션 파라미터를 설정합니다.
    • 다음을 사용하여 딥링킹 파라미터를 설정합니다: AppsFlyerLinkGenerator.addParameterValue:
      • deep_link_value: 추천된 사용자가 딥링크해야 하는 앱 환경입니다.
      • deep_link_sub1: 맞춤설정 가능한 파라미터입니다. 이 예에서는 초대받은 사람이 받은 프로모션 코드를 전달하는 데 사용됩니다.
      • deep_link_sub2: 리퍼러의 식별자. 리퍼러를 보상하는 데 사용할 수 있습니다.
  4. 다음 completionHandler에서 URL이 성공적으로 생성되었는 지 확인하고(url 이 아니라 nil), 생성된 사용자 초대 링크를 검색합니다.

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

Set the shortlink ID

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

generator.addParameterValue(<value>, forKey:"af_custom_shortlink")

Log invite link creation events

선택 가능
초대 링크 생성 이벤트를 기록하려면 :
사용자가 다음 메서드를 사용하여 초대 링크를 생성했음을 나타내는 이벤트를 보냅니다:logInvite:

AppsFlyerShareInviteHelper.logInvite(<CHANNEL>, parameters: [
    "campaign" : "summer_sale",
    "referrerId" : <REFERRER_ID>,
]);

logInvite 결과를 이용하여 af_invite 초대를 기록합니다.

📘

참고

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

Set up UDL for user invite attribution

선택 가능
사용자 초대 어트리뷰션을 위한 UDL을 설정하려면:

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

  2. In DeepLinkDelegate.didResolveDeepLink, 링크 생성 단계에서 생성된 딥링킹 파라미터를 검색합니다. 이 예에서는 다음 속성을 검색합니다:

    • 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

시나리오: 사용자 B가 사용자 A의 초대 링크를 통해 앱을 인스톨합니다.
사용자 A의 ID는 UDL에서 볼 수 있습니다: didResolveDeepLink (본 예시에서는 DeepLink.clickEvent["deep_link_sub2"]아래). ID를 검색하면 그것을 리워드를 받을 리퍼러 ID 목록에 추가합니다. 목록을 저장하고 검색하는 방법은 사용자에게 달려 있습니다.

Reward referrers on in-app events

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

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

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