Skip to content

Latest commit

 

History

History
133 lines (99 loc) · 6.69 KB

BIZBOARDAD.md

File metadata and controls

133 lines (99 loc) · 6.69 KB
Raw

비즈보드 광고 시작하기

비즈보드 광고는 네이티브 광고를 기반으로 AdFit SDK에서는 비즈보드 광고 소재에 적합한 템플릿 레이아웃을 제공하고 있습니다.

비즈보드 광고를 시작하기 위해 먼저 카카오애드핏 플랫폼에서 자신의 매체를 등록한 후,
네이티브 광고유형의 광고단위 ID를 발급받아야 합니다.

AdFit SDK 연동

비즈보드 광고 요청을 위해서는 우선 AdFit SDK 연동이 필요합니다. 해당 내용은 AdFit 시작하기 내용을 참조 부탁드립니다.

비즈보드 광고 요청하기

비즈보드 광고는 네이티브 광고를 기반으로 AdFit SDK에서는 비즈보드 광고 소재에 적합한 템플릿 레이아웃을 제공하고 있습니다.
비즈보드 광고 요청에 대한 내용은 네이티브 광고 요청하기 내용을 참조 부탁드립니다.

비즈보드 광고 템플릿 레이아웃 구성

비즈보드 광고는 서비스에서 직접 광고 레이아웃을 구현할 필요 없이
AdFit SDK에서는 비즈보드 광고 소재에 적합한 템플릿 레이아웃으로 AdFitBizBoardAdTemplateLayout을 제공하고 있습니다.

사용방법은 아래와 같이 너비는 match_parent로 높이는 wrap_content로 설정하시면
높이를 단말 화면비율에 따라 "1029:258" 비율에 맞춰 조정합니다.

필요에 따라 좌우 여백(marginHorizontal)을 추가해서 사용하시면 됩니다. (여백 설정은 필수가 아닙니다.)

<?xml version="1.0" encoding="utf-8"?>
<com.kakao.adfit.ads.na.AdFitBizBoardAdTemplateLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

배경 색상 조정

비즈보드 광고 템플릿 레이아웃은 기본적으로 #f3f3f3 색상 배경으로 처리되어 있습니다.
배경 색상을 조정하기 위해서는 아래와 같이 adfit_backgroundColor 설정이 필요합니다. 

<?xml version="1.0" encoding="utf-8"?>
<com.kakao.adfit.ads.na.AdFitBizBoardAdTemplateLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:adfit_backgroundColor="#f3f3f3" />

배경 모서리 라운드 처리 조정

비즈보드 광고 템플릿 레이아웃은 기본적으로 radius="5dp"로 설정된 둥근 모서리를 가진 배경으로 처리되어 있습니다.
배경의 모서리 라운드 처리를 조정하기 위해서는 아래와 같이 adfit_backgroundCornerRadius 설정이 필요합니다. 

<?xml version="1.0" encoding="utf-8"?>
<com.kakao.adfit.ads.na.AdFitBizBoardAdTemplateLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:adfit_backgroundCornerRadius="5dp" />

직각 모서리를 원하신다면 아래와 같이 adfit_backgroundCornerRadius="0dp"로 처리하시면 됩니다.

<?xml version="1.0" encoding="utf-8"?>
<com.kakao.adfit.ads.na.AdFitBizBoardAdTemplateLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:adfit_backgroundCornerRadius="0dp" />

높이 비율 조정하기

비즈보드 광고 템플릿 레이아웃은 기본적으로 단말 화면비율에 따라 높이를 "1029:258" 비율에 맞춰 조정합니다.
높이 비율을 조정하기 위해서는 아래와 같이 adfit_contentAspectRatio 설정이 필요합니다. 

<?xml version="1.0" encoding="utf-8"?>
<com.kakao.adfit.ads.na.AdFitBizBoardAdTemplateLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:adfit_contentAspectRatio="1029:258" />

해당 속성은 비율 처리를 지원하지 않는 레이아웃 내에서 사용하는 경우를 위해 제공 중인 기능입니다.
ConstraintLayout과 같이 비율 처리를 지원하는 레이아웃 내에서 사용하실 경우에는 layout_constraintDimensionRatio와 같이
해당 레이아웃에서 제공하는 기능을 사용하시기 바랍니다.

높이를 고정된 수치로 처리 경우, 해당 기능이 동작하지 않을 수 있습니다.

최대 높이 제한하기

비즈보드 광고 템플릿 레이아웃은 기본적으로 최대 높이는 없으며, 단말 화면비율에 따라 조정됩니다.
비즈보드 광고 영역이 너무 커지는 것을 방지하기 위해 최대 높이 제한하기 위해서는 아래와 같이 adfit_contentMaxHeight 설정이 필요합니다. 

<?xml version="1.0" encoding="utf-8"?>
<com.kakao.adfit.ads.na.AdFitBizBoardAdTemplateLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:adfit_contentMaxHeight="82dp" />

해당 속성은 최대 높이 제한 처리를 지원하지 않는 레이아웃 내에서 사용하는 경우를 위해 제공 중인 기능입니다.
ConstraintLayout과 같이 최대 높이 제한 처리를 지원하는 레이아웃 내에서 사용하실 경우에는 layout_constraintHeight_max와 같이
해당 레이아웃에서 제공하는 기능을 사용하시기 바랍니다.

높이를 고정된 수치로 처리 경우, 해당 기능이 동작하지 않을 수 있습니다.

비즈보드 광고 노출 및 해제

응답 받은 AdFitNativeAdBinder를 AdFitBizBoardAdTemplateLayout에 적용하여 비즈보드 광고를 노출할 수 있습니다.

val nativeAdBinder: AdFitNativeAdBinder
val bizBoardAdTemplateLayout: AdFitBizBoardAdTemplateLayout

// 광고 노출 및 측정 시작
nativeAdBinder.bind(bizBoardAdTemplateLayout)

// 광고 노출 해제 및 측정 중단
nativeAdBinder.unbind()
  • bind() 호출 시, AdFitBizBoardAdTemplateLayout에 광고 소재를 적용합니다.
  • bind() 호출 시부터 AdFitBizBoardAdTemplateLayout의 노출 상태를 측정하며, unbind()가 호출되면 측정을 중단합니다.
  • unbind() 호출은 필수 사항이 아닙니다.