본문으로 건너뛰기
:docs

버즈배너(BuzzBanner)

Markdown 보기

버즈배너(BuzzBanner)는 사용자 경험을 고려한 동시에 인벤토리 수익을 증대할 수 있는 비보상형 광고 상품입니다. 버즈배너는 피드와 광고 참여 안내 페이지 아래 영역에 연동할 수 있으며, 이 외에도 원하는 위치 어디에나 연동할 수 있습니다.

버즈배너 연동하기

피드, 광고 참여 안내 페이지 하단에 연동하기

피드와 광고 참여 안내 페이지 아래 영역에 코드 수정 없이 쉽고 버즈배너를 연동할 수 있습니다. 연동을 위해서는 버즈빌 담당자에게 연락하시기 바랍니다.

원하는 위치에 버즈배너 연동하기

원하는 위치에 버즈배너를 연동하려면 다음의 절차를 따르세요.

  1. 원하는 버즈배너 사이즈를 결정하세요.

버즈배너 사이즈

SizeEnum
Banner 320 x 50BuzzBannerSize.w320h50
Banner 320 x 100BuzzBannerSize.w320h100
Banner dynamicBuzzBannerSize.dynamic
Banner 300 x 250BuzzBannerSize.w300h250
  1. 버즈빌 담당자에게 연락하여 연동을 위한 Placement ID, Banner Size 를 받으세요.
ID 유형설명
Placement Id각 광고 지면을 구분하게 하는 고유 ID 입니다. 배너의 사이즈와 PlacementId 가 제대로 매칭되어야 광고 할당 및 노출이 정상적으로 이루어집니다.
Banner Size노출되는 버즈배너의 사이즈를 결정해주는 값입니다.
  1. 원하는 위치에 BuzzBannerView 를 추가하세요.
Swift
import UIKit
import BuzzvilSDK

final class ViewController: UIViewController {
  private lazy var bannerView: BuzzBannerView = {
    let bannerView = BuzzBannerView(frame: .zero)
    bannerView.delegate = self
    return bannerView
  }()

  override func viewDidLoad() {
    super.viewDidLoad()

    let config = BuzzBannerConfig.Builder(placementId: "YOUR_PLACEMENT_ID")
      .setSize(.w320h50)
      .build()
    bannerView.setConfig(rootViewController: self, config: config)

    view.addSubview(bannerView)

    // ...
  }

  override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)

    bannerView.requestAd()
  }

  override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)

    bannerView.removeAd()
  }
}

extension ViewController: BuzzBannerViewDelegate {
  func bannerView(_ bannerView: BuzzBannerView, didLoadApid: String) {
    // Banner에 광고가 할당 되었을 때 호출 됩니다.
  }
  
  func bannerView(_ bannerView: BuzzBannerView, didFailApid: String, error: Error) {
    // Banner에 광고 할당이 실패했을 때 호출 됩니다.
  }
  
  func bannerView(_ bannerView: BuzzBannerView, didClickApid: String) {
    // Banner가 클릭되었을 때 호출 됩니다.
  }
  
  func bannerView(_ bannerView: BuzzBannerView, didRemoveApid: String) {
    // Banner가 제거되었을 떄 호출 됩니다.
  }
}

버즈배너 수익 증대를 위한 ADN 추가 연동

버즈배너의 매출 극대화를 위해 추가 연동 가능한 Ad Network 연동 가이드입니다.

AdFit (Kakao)

  1. Adapter 다운로드 후 adfit 디렉토리의 파일들을 어플리케이션 프로젝트에 넣어주세요.

  2. Podfile에 AdFit 의존성을 추가하세요.

코드
pod 'AdFitSDK', '= 3.18.3'
  1. 초기화 코드는 별도로 필요하지 않습니다.

GAM (Google AdMob)

  1. Adapter 다운로드 후 admob 디렉토리의 파일들을 어플리케이션 프로젝트에 넣어주세요.

  2. Podfile에 GAM SDK 의존성을 추가하세요.

코드
pod 'Google-Mobile-Ads-SDK', '= 12.14.0'
  1. 아래 초기화 코드를 호출하세요.
Swift
import GoogleMobileAds

GADMobileAds.sharedInstance().start(completionHandler: nil)

AppLovin

  1. Adapter 다운로드 후 applovin 디렉토리의 파일들을 어플리케이션 프로젝트에 넣어주세요.

  2. Podfile에 AppLovin SDK 의존성을 추가하세요.

코드
pod 'AppLovinSDK', '= 13.5.1'
  1. 연동키 발급을 위해 버즈빌 담당자(help@buzzvil.com)에게 연락하세요.

  2. 아래 초기화 코드를 호출하세요.

Swift
import AppLovinSDK

let initConfig = ALSdkInitializationConfiguration(sdkKey: "YOUR_APPLOVIN_SDK_KEY") { builder in
  builder.mediationProvider = ALMediationProviderMAX
}
ALSdk.shared().initialize(with: initConfig) { sdkConfig in }

Cauly

  1. Adapter 다운로드 후 cauly 디렉토리의 CaulyAdapter.h, CaulyAdapter.m 파일을 어플리케이션 프로젝트에 넣어주세요.

  2. Podfile에 Cauly SDK 의존성을 추가하세요.

코드
pod 'CaulySDK', :git => 'https://github.com/cauly/CaulySDK_iOS.git', :tag => '3.1.22'
  1. 연동키 발급을 위해 버즈빌 담당자(help@buzzvil.com)에게 연락하세요.

  2. 아래 초기화 코드를 호출하세요.

Swift
import CaulySDK

if let adSetting = CaulyAdSetting.global() {
  CaulyAdSetting.setLogLevel(CaulyLogLevelInfo)
  adSetting.appId = "YOUR_CAULY_APP_ID"
  adSetting.appCode = "YOUR_CAULY_APP_CODE"
  adSetting.animType = CaulyAnimNone
  adSetting.closeOnLanding = true
} else {
  print("Cauly failed")
}

FAN (Facebook Audience Network)

  1. Adapter 다운로드 후 facebook 디렉토리의 파일들을 어플리케이션 프로젝트에 넣어주세요.

  2. Podfile에 FAN SDK 의존성을 추가하세요.

코드
pod 'FBAudienceNetwork', '= 6.21.0'
  1. 초기화 코드는 별도로 필요하지 않습니다.

Pangle

  1. Adapter 다운로드 후 pangle 디렉토리의 파일들을 어플리케이션 프로젝트에 넣어주세요.

  2. Podfile에 Pangle SDK 의존성을 추가하세요.

코드
pod 'Ads-Global', '= 7.8.0.3'
  1. 연동키 발급을 위해 버즈빌 담당자(help@buzzvil.com)에게 연락하세요.

  2. 아래 초기화 코드를 호출하세요.

Swift
import PAGAdSDK

let config = PAGConfig.share()
config.appID = "YOUR_PANGLE_APP_ID"
PAGSdk.start(with: config) { success, error in
  if success {
    print("Pangle succeed")
  }
}

UnityAds

  1. Adapter 다운로드 후 unityads 디렉토리의 파일들을 어플리케이션 프로젝트에 넣어주세요.

  2. Podfile에 UnityAds SDK 의존성을 추가하세요.

코드
pod 'UnityAds', '= 4.16.4'
  1. 초기화 코드는 별도로 필요하지 않습니다.

Vungle

  1. Adapter 다운로드 후 vungle 디렉토리의 파일들을 어플리케이션 프로젝트에 넣어주세요.

  2. Podfile에 Vungle SDK 의존성을 추가하세요.

코드
pod 'VungleAds', '= 7.6.2'
  1. 연동키 발급을 위해 버즈빌 담당자(help@buzzvil.com)에게 연락하세요.

  2. 아래 초기화 코드를 호출하세요.

Swift
import VungleAdsSDK

VungleAds.initWithAppId("YOUR_VUNGLE_APP_ID") { error in
  if let error = error {
    print("Vungle failed")
  } else {
    print("Vungle succeed")
  }
}