Android용 커스텀 어댑터 빌드

필수 조건

1. 커스텀 어댑터 등록 양식 작성
2. 사용 가능한 정보가 다음과 같습니다.
   • 어댑터 패키지 이름
   • 어댑터 클래스명
   • 네트워크 설정 키
3. 최신 레벨플레이 SDK 다운로드 여기
4. 보상형 비디오 및 인터스티셜 광고 유닛에 필요한 최소 레벨플레이 SDK 버전은 7.1.13입니다.

중요

• 코드의 일부로 메인 스레드 요구 사항을 처리해야 합니다.
• 예기치 않은 오류로부터 앱 보호하기 위해 코드 보호 및 예외 처리를 추가해야 합니다.

네트워크용 어댑터 만드는 방법

네트워크 지지대 어댑터 만들기

패키지 <YourNetworkName>com.ironsource.adapters.custom;public class <YourNetworkName>CustomAdapter extends BaseAdapter {   // Your class implementation}

네트워크 SDK 초기화

void init(@NotNull AdData adData, @NotNull Context context, @Nullable NetworkInitializationListener listener){   ...   if (init-success-condition) {      // Initialization completed successfully      listener.onInitSuccess();   } else {     // Initialization failed     listener.onInitFailed(AdapterErrors.ADAPTER_ERROR_MISSING_PARAMS, error);   }}

SDK 및 어댑터 버전 제공

@Nullable String getNetworkSDKVersion();@NotNull String getAdapterVersion();

인터스티셜 광고 유닛에 대한 지원 추가

인터스티셜 광고 유닛 클래스 생성

package com.ironsource.adapters. 커스텀[YourNetworkName];public class SampleCustomInterstitial extends BaseInterstitial<SampleCustomAdapter> implements SampleNetworkInterstitialAdListener {public class <YourNetworkName>CustomInterstitial extendsBaseInterstitial <<YourNetworkNameCustomAdapter>> {...}

광고 유닛 생성자 구현

public <YourNetworkName>CustomInterstitial(NetworkSettings networkSettings) {   super(networkSettings);}

인터스티셜 광고 요청

public void loadAd(AdData adData, Activity activity, InterstitialAdListener listener) {   // Load your ad}

이용 가능한 광고 여부 확인

public boolean isAdAvailable(AdData adData) {   return isAdAvailable;}

인터스티셜 광고 표시

public void showAd(AdData adData, InterstitialAdListener listener) {   // check your ad load status   if (isAdLoaded)  {      // show your ad   } else {      listener.onAdShowFailed(adatperErrorCode, adapterErrorMsg);   }}

InterstitialAdListener 콜백을 보고합니다.

필수 콜백

// Indicates that interstitial ad was loaded successfullyvoid onAdLoadSuccess();// The interstitial ad failed to load. Ironsource ErrorTypes 사용(보여줄 광고 없음(no fill)void onAdLoadFailed(@NotNull AdapterErrorType adapterErrorType, int errorCode, @Nullable String errorMessage);// The interstitial ad is displayed successfully to the user. 노출을 나타냅니다.void onAdOpened();// User closed the interstitial advoid onAdClosed();// The ad could not be displayedvoid onAdShowFailed(int errorCode, @Nullable String errorMessage);

콜백(선택 사항)

// Indicates the network differentiates between show-success and ad-open (impression)void onAdShowSuccess();// Indicates an ad was clickedvoid onAdClicked();

지지대 어댑터 데이터를 가져오는 방법(선택 사항)

// example of data retrieved from your network level adapterSampleCustomAdapter networkAdapter = getNetworkAdapter();if (networkAdapter != null) {   // call network level method   String extraData = networkAdapter.sampleAppLevelData();}

보상형 비디오 광고 유닛에 대한 지원 추가

보상형 비디오 광고 유닛 클래스 생성

package com.ironsource.adapters. 커스텀[YourNetworkName];import com.ironsource.mediationsdk.adunit.adapter.BaseRewardedVideo;import com.ironsource.mediationsdk.adunit.adapter.listener.RewardedVideoAdListener;import com.ironsource.mediationsdk.adunit.adapter.utility.AdData;import com.ironsource.mediationsdk.adunit.adapter.utility.AdapterErrorType;import com.ironsource.mediationsdk.adunit.adapter.utility.AdapterErrors;import com.ironsource.mediationsdk.model.NetworkSettings;

public class SampleCustomRewardedVideo extends BaseRewardedVideo<SampleCustomAdapter> implements SampleNetworkRewardedVideoListener {   // Add your adapter code here}

광고 유닛 생성자 구현

public <YourCustomNetwork>CustomRewardedVideo(NetworkSettings networkSettings) {        super(networkSettings);}

보상형 비디오 광고 요청

public void loadAd(@NotNull AdData adData, @NotNull Activity activity, @NotNull RewardedVideoAdListener rewardedVideoAdListener) {   // Load your ad}

이용 가능한 광고 여부 확인

public boolean isAdAvailable(AdData adData) {   return isAdAvailable;}

보상형 비디오 광고 표시

public void showAd(AdData adData, RewardedVideoAdListener rewardedVideoAdListener) {   // check your ad load status   if (isAdLoaded)  {      // show your ad   } else {      AdapterErrors adapterErrorCode = AdapterErrors.<ERROR CODE>;      문자열 어댑터ErrorMsg = "ERROR 메시지"; 보상VideoAdListener.onAdShowFailed(adatperErrorCode, adapterErrorMsg);   }}

RewardedVideoAdListener 콜백을 보고합니다.

필수 콜백

// Indicates that rewarded video ad was loaded successfullyvoid onAdLoadSuccess();// The rewarded video ad failed to load. Ironsource ErrorTypes 사용(보여줄 광고 없음(no fill)void onAdLoadFailed(@NotNull AdapterErrorType adapterErrorType, int errorCode, @Nullable String errorMessage);// The rewarded video ad is displayed successfully to the user. 이는 Ironsource 플랫폼에서 노출을 나타냅니다.void onAdOpened();// User closed the rewarded video advoid onAdClosed();// The ad could not be displayedvoid onAdShowFailed(int errorCode, @Nullable String errorMessage);// The ad was rewarded successfullyvoid onAdRewarded();

콜백(선택 사항)

// Indicates an ad was clickedvoid onAdClicked();// Indicates an ad was displayed on foregroundvoid onAdVisible();// Indicates an ad playable startedvoid onAdStarted();// Indicates an ad playable endedvoid onAdEnded();

배너 광고 유닛에 대한 지원 추가(Android 개발 앱 해당)

단계 1. 배너 광고 유닛 클래스 만들기

2단계. 광고 유닛 생성자 구현

public <YourNetworkName>CustomBanner(NetworkSettings networkSettings) {   super(networkSettings);}

배너 크기

3단계. 배너 광고 요청

public void loadAd(@NotNull AdData adData, @NotNull Activity activity, @NotNull ISBannerSize bannerSize, @NotNull BannerAdListener bannerAdListener) { // Load your ad}

4단계. 배너 파괴

 public void destroyAd(@NotNull AdData adData) {    }

5단계 BannerAdListener 콜백을 보고합니다.

필수 콜백

// Indicates that a banner ad was loaded successfullyvoid onAdLoadSuccess(@NotNull View adView, @NotNull FrameLayout.LayoutParams frameLayoutParams)// The banner ad failed to load. Ironsource ErrorTypes 사용(보여줄 광고 없음(no fill)void onAdLoadFailed(@NotNull AdapterErrorType adapterErrorType, int errorCode, @Nullable String errorMessage)// The banner ad is displayed successfully to the user. 이는 Ironsource 플랫폼에서 노출을 나타냅니다.void onAdOpened()// Indicates an ad was clickedvoid onAdClicked()

• 실제 배너 크기의 너비와 높이 전달.
• 중력 프로퍼티 중력.CENTER로 정의합니다.

콜백(선택 사항)

//Should be invoked after a click, and before the user is taken out of the appvoid onAdLeftApplication()// Should be invoked after the ad view presents fullscreen contentvoid onAdScreenPresented()// Should be invoked after the fullscreen content is dismissedvoid onAdScreenDismissed()

어댑터 사용하여 퍼블리셔 입력 액세스, 접근.

// Get Publisher setup parametersfinal String appLevelParam1 = adData.getString(<YourAppLevelParam1>);final String instanceLevelParam1 = adData.getString(<YourInstanceLevelParam1>);final String instanceLevelParam2 = adData.getString(<YourInstanceLevelParam2>);

Ironsource 오류 코드 및 오류 유형 사용

오류 유형

ADAPTER_ERROR_TYPE_NO_FILL

ADAPTER_ERROR_TYPE_INTERNAL

오류 코드

ADAPTER_ERROR_MISSING_PARAMS

ADAPTER_ERROR_AD_EXPIRED

ADAPTER_ERROR_INTERNAL

어댑터 디버깅(선택 사항)

public class <YourNetworkName>CustomAdapter extends BaseAdapter {   @Override   public void setAdapterDebug(boolean adapterDebug) {      this.adapterDebug = adapterDebug;   }}