딥링크 - API로 리퍼럴 캠페인에 사용할 공유 링크 만들기

트래킹 링크 생성 API를 활용하여 프로모션 공유 캠페인, 친구 초대 캠페인 등 리퍼럴 캠페인에 공유 링크로 사용할 트래킹 링크를 만들 수 있습니다. 이 공유 링크로 수집한 데이터를 리포트에서 확인할 수 있습니다.

리퍼럴 캠페인 시나리오

아래는 트래킹 링크를 공유 링크로 활용한 리퍼럴 캠페인의 일반적인 시나리오입니다.

유저 B가 ‘서비스 공유하기’, ‘친구 초대하기’ 등 CTA 버튼을 클릭합니다. 그러면 트래킹 링크 생성 API를 통해 생성된 트래킹 링크가 유저 B에게 공유 링크로 전달됩니다.
유저 B가 이메일, 메신저 등을 통해 유저 A에게 공유 링크를 전달합니다.
유저 A가 공유 링크를 클릭합니다. 유저 A는 앱 설치 여부에 따라 앱 마켓 또는 앱 페이지로 이동합니다. 이때 유저 A가 앱을 실행하거나 특정 이벤트를 발생시키면 유저 B에게 보상을 지급할 수 있습니다.

리퍼럴 캠페인 성과 분석 방법

아래 순서에 따라 리퍼럴 캠페인에 사용할 공유 링크를 만들고 성과를 확인하세요.

공유 링크 만들기

개발 작업이 필요합니다. 개발자에게 도움을 요청하세요.

유저가 CTA 버튼을 클릭하면 트래킹 링크 생성 API를 통해 트래킹 링크가 생성되도록 개발해 주세요. 트래킹 링크는 트래킹 링크 생성 API에 요청된 파라미터대로 생성됩니다. CTA 버튼이 클릭됐을 때 파라미터 값으로 채널 이름, 캠페인 이름, 딥링크 등을 포함해 트래킹 링크 생성 API에 요청하세요. 아래는 트래킹 링크 생성 API에 요청할 때 전달해야 하는 필수 항목입니다.

파라미터	설명
`channel`	리퍼럴 캠페인을 운영한 채널의 이름입니다.
`campaignParams`	캠페인 정보입니다. `campaign`, `ad_group`, `content`, `term`, `sub_id` 등 하위 파라미터로 구성됩니다.
`deeplinkURL`	유저를 보낼 특정 앱 페이지 URL입니다.

트래킹 링크 API를 요청하는 코드를 에어브릿지 가이드와 함께 참고하세요.

예시) 트래킹 링크 API 요청

$ curl -d '{
  {
  "channel": "in_app_referral",
  "campaignParams": {
    "campaign": "referral-01",
    "ad_group": "referral",
    "ad_creative": "invitation"
  },
  "isReengagement": "Off",
  "deeplinkUrl": "ablog://good-product-growth-team?referrer_id=1668",
  "deeplinkOption": {
    "showAlertForInitialDeeplinkingIssue": true
  },
  "fallbackPaths": {
    "option": {
      "ios": "itunes-appstore",
      "android": "google-play"
    }
  },
  "ogTag": {
    ...
  }
}
}' -X POST "'https://api.airbridge.io/v1/tracking-links" -H "Authorization:{AIRBRIDGE-API-TOKEN} -H "Content-Type: application/json

channel 값은 리퍼럴 캠페인을 운영할 채널의 이름입니다. 예시 코드에서는 in_app_referral입니다.
campaignParams 값은 리퍼럴 캠페인 관련 정보입니다. 예시 코드에서 campaign 값은 referral-01, ad_group 값은referral, ad_creative 값은 invitation입니다.
deeplinkURL값은 이 트래킹 링크를 클릭한 유저를 보낼 특정 앱 페이지 URL입니다. 예시 코드에서는 ablog://good-product-growth-team?referrer_id=1688입니다.

이때 예시 코드 안의 referrer_id=1688처럼 유저 ID 등 추가로 활용하고 싶은 정보가 있다면 아래 예시 코드처럼 파싱해 사용하세요.

Android

Airbridge.getDeeplink(getIntent(), new AirbridgeCallback<Uri>() {
    @Override
    public void onSuccess(Uri result) {
        // Parse the {result} parameter to get the referrer_id or any other parameter.
    }
}

Airbridge.getDeeplink(intent, object : AirbridgeCallback<Uri> {
    override fun onSuccess(result: Uri) {
        // Parse the {result} parameter to get the referrer_id or any other parameter.
    }
}

iOS

[AirBridge.deeplink setDeeplinkCallback:^(NSString * _Nonnull result) {
    // Parse the {result} parameter to get the referrer_id or any other parameter.
}];

AirBridge.deeplink().setDeeplinkCallback { result in
    // Parse the {result} parameter to get the referrer_id or any other parameter.
}

React Native

Airbridge.setOnDeeplinkReceived((result) => {
    // Parse the {result} parameter to get the referrer_id or any other parameter.
})

Flutter

Airbridge.setOnDeeplinkReceived((result) {
    // Parse the {result} parameter to get the referrer_id or any other parameter.
});

Cordova

Airbridge.setOnDeeplinkReceived(function (deeplink) {
    // Parse the {deeplink} parameter to get the referrer_id or any other parameter.
});

Unity

Airbridge.SetOnDeeplinkReceived((string result)  =>
{
    // Parse the {result} parameter to get the referrer_id or any other parameter.
});

Unreal

FAirbridge::SetOnDeeplinkReceived([](const FString& result)
{
    // Parse the {result} parameter to get the referrer_id or any other parameter.
});

CTA 버튼을 클릭한 유저에게 트래킹 링크가 공유 링크로 제공되도록 개발합니다. 이때 1번의 API 요청으로 생성된 트래킹 링크 중에 trackingLink.shortURL값을 공유 링크로 제공하는 것을 권장합니다. 아래 코드를 에어브릿지 가이드와 함께 참고하세요.

예시) 트래킹 링크 API 응답

trackingLink.shortURL 값을 공유 링크로 제공하는 것을 권장합니다. 예시에서는https://abr.ge/6nwx4w입니다. 기본 도메인인 abr.ge 대신에 다른 도메인을 사용하려면 커스텀 도메인을 설정하세요.

{
    "data": {
        "trackingLink": {
            "id": 77281,
            "link": {
                "click": "https://abr.ge/@airbridge/my-channel?...",
            },
            "shortID": "6nwx4w",
            "shortURL": "https://abr.ge/6nwx4w",
            "trackingTemplateID": "706f9839a7b50d87ab917dbb1b9fa7f3",
            "channelType": "custom"
        }
    },
    "at": 1585104275
}

캠페인 결과 분석하기

리포트에서 공유 링크가 수집한 캠페인 데이터를 확인할 수 있습니다. 아래 그룹바이를 활용해 캠페인 결과를 분석해 보세요.

그룹바이	설명
Channel	리퍼럴 캠페인을 운영한 채널의 이름입니다. 트래킹 링크 생성 API 요청 시 코드에 입력된 `channel` 값입니다.
Campaign	운영한 리퍼럴 캠페인의 이름입니다. 트래킹 링크 생성 API 요청 시 코드에 입력된 `campaign` 값입니다.
Ad Group	운영한 리퍼럴 캠페인의 광고 대상입니다. 트래킹 링크 생성 API 요청 시 코드에 입력된 `ad_group`값입니다.
Ad reative	운영한 리퍼럴 캠페인의 광고 소재입니다. 트래킹 링크 생성 API 요청 시 코드에 입력된 `ad_creative` 값입니다.

주의사항

아래 사항을 주의해 주세요.

캠페인 파라미터 설정

리퍼럴 캠페인을 상세하게 분석하기 위해 트래킹 링크 생성 API를 요청할 때 campaignParams 파라미터의 하위 파라미터를 모두 입력하는 것을 권장합니다.

유저 ID 활용

유저 ID를 활용할 경우 유저 ID는 유저가 서비스에 가입할 때 제공하는 정보나 계정 등 유저를 식별할 수 있는 고유 ID를 활용해 주세요. 에어브릿지에서는 이러한 유저 ID를 관리하지 않습니다.

​리퍼럴 캠페인 시나리오

​리퍼럴 캠페인 성과 분석 방법

​공유 링크 만들기

​캠페인 결과 분석하기

​주의사항

리퍼럴 캠페인 시나리오

리퍼럴 캠페인 성과 분석 방법

공유 링크 만들기

캠페인 결과 분석하기

주의사항