본문으로 건너뛰기

인라인 광고 삽입

본 가이드는 Flower SDK를 사용하여 웹페이지 또는 앱 내 콘텐츠 영역에 인라인 광고를 삽입하는 전체 과정을 안내합니다. 광고 연동은 다음 단계를 따릅니다:

  1. 광고 UI 선언: 광고를 표시하기 위해 화면에 FlowerAdView를 배치합니다.
  2. 광고 이벤트 수신 구현: 광고 재생 및 완료 시점의 로직 처리를 위해 FlowerAdsManagerListener를 구현합니다.
  3. 추가 파라미터 설정 (extraParams): 광고 타겟팅에 필요한 추가 정보를 구성합니다.
  4. 인라인 광고 요청 (requestAd): 광고 태그 URL 등의 정보를 전달하여 인라인 광고를 요청합니다.
  5. 정리 작업 수행: 광고 완료 후 stop() 및 removeListener()를 호출하여 리소스를 정리합니다.

단계별 상세 설명​

1. 광고 UI 선언​

광고 UI 선언은 광고 삽입 메뉴 > 광고 UI 선언 섹션을 참고하세요.

2. 광고 이벤트 수신 - FlowerAdsManagerListener​

인라인 광고 삽입 시 적절한 광고 시작 및 종료 시점에 처리할 수 있도록, SDK는 광고 이벤트 수신 인터페이스 FlowerAdsManagerListener를 제공합니다. 아래는 구현 예시입니다.

val adsManagerListener = object : FlowerAdsManagerListener {
    override fun onPrepare(adDurationMs: Int) {
        flowerAdView.adsManager.play()
    }
    override fun onPlay() {
        // TODO GUIDE: need nothing for interstitial ad
    }
    override fun onCompleted() {
        // TODO GUIDE: stop FlowerAdsManager
        flowerAdView.adsManager.stop()
        flowerAdView.adsManager.removeListener(adsManagerListener)
    }
    override fun onError(error: FlowerError?) {
        // TODO GUIDE: stop FlowerAdsManager
        flowerAdView.adsManager.stop()
        flowerAdView.adsManager.removeListener(adsManagerListener)
    }
}
flowerAdView.adsManager.addListener(adsManagerListener)

3. 광고 요청 시 추가 파라미터 - extraParams​

Flower SDK를 사용하여 광고를 요청할 때 추가 매개변수를 전달하면, SDK가 가장 적합한 광고를 제공하는 데 도움이 됩니다. 모바일 웹 앱의 경우 SDK가 자체적으로 광고 제공 컨텍스트를 판단할 수 없으므로, 광고 요청 시 이러한 매개변수를 SDK에 반드시 전달해야 합니다.

파라미터 목록​

키
(* 표시는 웹앱 필수)		값예시
serviceId*앱의 패키지 이름"tv.anypoint.service"
os*앱이 실행되는 기기의 OS"Android"
adId*앱이 실행되는 기기의 광고 식별자Android: 구글의 GAID 값

4. 인라인 광고 API​

FlowerAdsManager.requestAd()​

인라인 광고를 요청하는 데 사용하는 함수입니다. 다음은 매개변수에 대한 설명입니다:

매개변수유형설명
adTagUrlstringFlower 백엔드 시스템에서 발급된 광고 태그 URL.
Anypoint Media에 요청하여 adTagUrl을 발급받아야 합니다.
extraParamsmap(Optional) 타겟팅을 위해 사전 협의된 추가 정보.
adTagHeadersmap(Optional) 광고 요청 시 추가할 HTTP 헤더 정보.

FlowerAdsManager.stop()​

인라인 광고를 종료할 때 사용하는 API입니다. 매개변수는 없습니다.

인라인 광고 요청 예시​

// TODO GUIDE: request inline ad
// arg0: adTagUrl, url from flower system.
//       You must file a request to Anypoint Media to receive a adTagUrl.
// arg1: extraParams, values you can provide for targeting
// arg2: adTagHeaders, (Optional) values included in headers for ad request
flowerAdView.adsManager.requestAd(
    "https://ad_request",
    mapOf(),
    mapOf("custom-ad-header" to "custom-ad-header-value")
)