메인 콘텐츠로 건너뛰기
Airbridge 연동 기능은 노티플라이 프로 플랜, 엔터프라이즈 플랜 사용시 제공하는 기능입니다.

개요

Airbridge는 모바일 어트리뷰션 분석 플랫폼입니다. Airbridge 연동을 통해 어트리뷰션 데이터를 기반으로 유저를 세그먼트하여 타겟팅된 CRM 마케팅을 실행할 수 있습니다.

어트리뷰션 데이터 필드

Airbridge에서 제공하는 어트리뷰션 데이터 필드는 다음과 같습니다:
필드명설명
attributedChannel채널
attributedCampaign캠페인
attributedAdGroup광고 그룹
attributedAdCreative광고 소재
attributedContent콘텐츠
attributedTerm키워드
attributedSubPublisher하위매체

연동 가이드

Airbridge SDK에서 어트리뷰션 결과를 받아 노티플라이 SDK의 setUserProperties 메소드를 통해 유저 속성으로 설정하는 방식으로 연동합니다.

사전 준비

  • Airbridge SDK가 설치 및 초기화되어 있어야 합니다.
  • Notifly SDK가 설치 및 초기화되어 있어야 합니다.
MainApplication.kt
import co.ab180.airbridge.Airbridge
import co.ab180.airbridge.AirbridgeOptionBuilder
import co.ab180.airbridge.listener.OnAttributionResultReceiveListener
import tech.notifly.Notifly

class MainApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        Notifly.initialize(applicationContext, "PROJECT_ID", "USERNAME", "PASSWORD")

        val option = AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
            .setOnAttributionReceived(object : OnAttributionResultReceiveListener {
                override fun onAttributionResultReceived(result: Map<String, String>) {
                    val properties = mutableMapOf<String, Any>()
                    result["attributedChannel"]?.let { properties["attributedChannel"] = it }
                    result["attributedCampaign"]?.let { properties["attributedCampaign"] = it }
                    result["attributedAdGroup"]?.let { properties["attributedAdGroup"] = it }

                    if (properties.isNotEmpty()) {
                        Notifly.setUserProperties(applicationContext, properties)
                    }
                }
            })
            .build()

        Airbridge.initializeSDK(this, option)
    }
}

캠페인 활용 예시

연동 완료 후, 노티플라이 캠페인에서 어트리뷰션 속성을 활용하여 타겟팅할 수 있습니다. 활용 예시:
  • attributedChannel이 “Facebook”인 유저에게 특별 환영 메시지 발송
  • attributedCampaign이 특정 프로모션 캠페인인 유저에게 후속 프로모션 안내
  • 오가닉 유저(어트리뷰션 속성이 없는 유저)와 광고 유입 유저를 구분하여 다른 메시지 발송

FAQ

어트리뷰션 데이터는 앱 설치 후 첫 실행 시 Airbridge SDK에서 콜백을 통해 전달됩니다. 해당 콜백이 호출되는 시점에 노티플라이 속성으로 설정됩니다.
아니요, 어트리뷰션 콜백은 앱 설치 후 최초 실행 시에만 호출됩니다. 이미 설치된 유저의 경우 Airbridge SDK 연동 전에 설치되었다면 어트리뷰션 데이터가 수집되지 않습니다.
오가닉 설치(광고를 통하지 않은 자연 유입)의 경우 어트리뷰션 데이터 필드가 null일 수 있습니다. 코드 예시에서 null 체크를 하는 이유입니다.
네, 코드 예시의 속성 이름(예: attributedChannel, attributedCampaign 등)은 원하는 대로 변경하실 수 있습니다. 다만, 노티플라이 캠페인에서 해당 속성을 사용할 때 동일한 이름을 사용해야 합니다.