본문으로 건너뛰기

자주 하는 질문

이 페이지에서는 BuzzAd Android용 SDK를 연동한 후 추가할 수 있는 사용자 편의 기능, SDK 용량 등 자주 묻는 질문에 대한 정보를 확인할 수 있습니다.

어두운 테마(Dark theme) 설정

BuzzAd Android용 SDK는 앱의 테마 설정에 따라 자동으로 어두운 테마가 적용됩니다.

어두운 테마 비활성화하기

ApplicationonCreate에서 앱의 테마를 밝은 테마(Light theme)로 고정하세요.

✏️  참고
버즈빌의 모든 SDK 제품과 앱 전체에 적용됩니다.

public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();

// 아래 코드 추가
AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO);
}
}

액션형 광고의 사용자 문의 기능 추가하기

BuzzAd Android용 SDK는 동영상 시청, 앱 설치, 페이스북 페이지의 ‘좋아요’ 클릭 등 다양한 사용자 액션에 리워드를 지급하는 액션형 광고를 제공합니다. 액션형 광고에 참여한 사용자가 포인트 적립에 실패하는 경우, BuzzAd Android용 SDK에서는 문의(이하 VOC) 접수와 처리를 자동화하는 서비스를 제공합니다. VOC 기능을 추가하려면 다음의 절차를 따르세요.

  1. VOC 처리 페이지를 불러오기 위한 UI(아이콘 또는 탭)을 디자인하세요.
  2. 1번 단계에서 디자인한 UI를 클릭하면, BuzzAdBenefit.getInstance().showInquiryPage(Context, YOUR_UNIT_ID)를 호출하세요.
  • 이때, YOUR_UNIT_ID 인자는 필수로 설정해야 합니다.각 지면에 맞는 Unit ID 값을 사용하세요.

동영상 광고 재생 조건 변경하기

동영상 광고는 기본적으로 사용자 기기가 Wi-Fi를 통해 인터넷에 연결되어 있을 때에만 자동 재생되도록 설정되어 있습니다. 동영상 광고를 자동으로 재생하는 조건은 다음 중 한 가지로 설정할 수 있습니다.

  • 사용자 기기가 Wi-Fi를 통해 인터넷에 연결되어 있을 때에만 자동 재생 (초기 설정 값)
  • 사용자 기기의 인터넷 연결 방식과 상관없이 항상 자동 재생
  • 사용자 기기의 인터넷 연결 방식과 상관없이 자동 재생하지 않음

다음의 예시를 참고하여 동영상 광고의 자동 재생 조건을 변경하세요.

final UserPreferences userPreferences = new UserPreferences.Builder(BuzzAdBenefit.getUserPreferences())
.autoplayType(AutoplayType.ON_WIFI) // Wi-Fi 환경에서만 동영상 광고를 자동 재생합니다.
// .autoplayType(AutoplayType.DISABLED) // 동영상 광고를 항상 자동 재생합니다.
// .autoplayType(AutoplayType.ENABLED) // 동영상 광고를 자동으로 재생하지 않습니다.
.build();
BuzzAdBenefit.setUserPreferences(userPreferences);

광고 타입 확인하기

피드와 네이티브 지면의 광고 타입을 알고 싶은 경우 NativeAd 에서 제공하는 함수를 통해 확인할 수 있습니다.

 중요
이 기능은 BuzzAd Android용 SDK v3.11.x부터 추가할 수 있습니다. v3.11.x 미만의 버전을 연동한 경우 이 기능을 탑재하려면 v3.11.x 이상으로 업데이트하세요.

NativeAd 에서 광고 타입을 확인하는 함수는 다음과 같습니다.

함수설명리턴 값
NativeAd.getRevenueTyperevenueType을 string으로 반환합니다.
  • cpinsta: 인스타그램 계정을 팔로우하면 포인트를 주는 광고입니다.
  • cpa: 회원가입, 보험료 조회 등 특정 액션을 완료하면 포인트를 주는 광고입니다.
  • cpe: 앱을 설치하고 실행하면 포인트를 주는 광고입니다.
  • cpi: 앱을 설치하면 포인트를 주는 광고입니다.
  • cpl: 페이스북 계정을 팔로우하면 포인트를 주는 광고입니다.
  • cps: 물품 구매를 완료하면 포인트를 주는 광고입니다.
  • cpyoutube: 유튜브 채널을 구독하면 포인트를 주는 광고입니다.
  • cptiktok: 틱톡 계정을 팔로우하면 포인트를 주는 광고입니다.
  • cpnstore: 네이버 스마트스토어를 찜하면 포인트를 주는 광고입니다.
  • cpq: 퀴즈를 맞추면 포인트를 주는 광고입니다.
  • cpqlite: 퀴즈를 맞추면 포인트를 주는 광고입니다.
  • cpk: 카카오 페이지를 추가하면 포인트를 주는 광고입니다.
  • cpc: 클릭을 통해 광고주 페이지에 랜딩하면 포인트를 주는 광고입니다.
  • cpm: 광고가 1,000번 노출되면 광고주가 비용을 지급하는 광고입니다.
  • cpy: 유튜브 채널을 구독하고 영상을 좋아하면 포인트를 주는 광고입니다.
  • cpv: 영상 시청을 완료하면 포인트를 주는 광고입니다.
  • -cps: cps를 제외한 광고입니다.
NativeAd.isActionType액션형(cpa) 광고 여부를 boolean 값으로 반환합니다.
  • true: cpa 광고입니다.
  • false: cpa 광고가 아닙니다.
NativeAd.isCps쇼핑형(cps) 광고 여부를 boolean 값으로 반환합니다.
  • true: cps 광고입니다.
  • false: cps 광고가 아닙니다.

다음은 NativeAd 에서 광고 타입을 확인하는 예제입니다.

public class CustomAdsAdapter extends AdsAdapter<AdsAdapter.NativeAdViewHolder> {
@Override
public AdsAdapter.NativeAdViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
...
}

@Override
public void onBindViewHolder(NativeAdViewHolder holder, NativeAd nativeAd) {
...
boolean isActionType = nativeAd.isActionType();
boolean isCps = nativeAd.isCps();
String revenueType = nativeAd.getRevenueType();
}
}