5. SDK 초기화 및 구현

1. Initialize 클래스

광고를 요청하기 전에 초기화가 이루어져야 합니다. 초기화 방법은 초기화를 담당하는 AdWhaleMediationSdk 클래스를 MainActivity 에서 호출해주며, 초기화 호출 결과는 return 값을 통해 통지됩니다. 자세한 구현은 아래 API와 샘플코드를 참고하여 구현하면 됩니다.

JS 혹은 TypeScript

AdWhaleMediationSdk 클래스

initialize(): Promise<number>

초기화 샘플코드

import React, {
  useEffect,
} from 'react';

const App: React.FC = () => {
  // SDK 초기화
  useEffect(() => {
    const init = async () => {
      const statusCode = await AdWhaleMediationSdk.initialize();
      if (statusCode === 100) {
        console.log(`SDK 초기화 성공`);
      } else {
        console.log(`SDK 초기화 실패`);
      }
    };
    init();
    return () => { };
  }, []);
}

2. GDPR, COPPA설정

GDPR은 유럽연합(이하 'EU')의 개인정보 보호 법령으로 서비스 제공자는 EU 사용자의 개인정보 또는 그에 준하는 정보에 대한 수집 및 활용에 대해 사용자에게 동의 여부를 확인받아야 합니다. GDPR 규정 준수 및 규정에 따른 광고네트워크 동작에 필요한 절차입니다. 유럽 경제 지역 (European Economic Area) 사용자에게 동의 여부를 선택할 수 있는 기능을 제공하며 애드몹 UMP (User Messaging Platform)에 의해서 처리됩니다.

JS 혹은 TypeScript

AdWhaleMediationSdk 클래스

requestGdprConsent(): Promise<{ isSuccess: boolean; message: string }> //GDPR 동의 선택화면 호출
resetGdprConsentStatus() //GDPR 설정 리셋

setGdpr 자체적으로 GDPR 선택창을 사용하실 경우 사용하며 AdWhale SDK 내부 GDPR 세팅을 위해 호출.

setGdpr(consent: boolean) 

파라미터 타입	파라미터 값
boolean	true : gdpr 동의 false : gdpr 비동의

setCoppa(enabled: boolean)

파라미터 타입	파라미터 값
boolean	true : coppa 동의 false : coppa 비동의

GDPR, Coppa 샘플코드

// request gdpr
const result = await AdWhaleMediationSdk.requestGdprConsent();
console.log(`GDPR Request: ${result.isSuccess ? 'Success' : 'Failed'}\n${result.message}`);

// reset consent
AdWhaleMediationSdk.resetGdprConsentStatus();

// set gdpr 
AdWhaleMediationSdk.setGdpr(true);

// set coppa
AdWhaleMediationSdk.setCoppa(true);

에러 메시지

TIME_OUT (WebView 로 consent form 을 불러오는 데 시간이 너무 오래 걸려 발생 또는 네트워크 연결에 실패한 경우)	Web view timed out
	Timed out while loading consent form
INTERNET_ERROR (네트워크 연결이 없거나, 요청이 서버까지 도달하지 못한 경우)	Failed to load consent form due to network error
	No internet connection
INTERNAL_ERROR (SDK 내부 로직이나 예외적인 상황에서 발생. 드물게 WebView 초기화 실패 등에서도 볼 수 있음)	Internal error
	An unexpected error occurred while loading the consent form
INVALID_OPERATION (아직 load 되지 않은 폼을 show 하려 하거나, 이미 표시 중인데 다시 show 호출했을 때 발생)	Invalid operation. Consent form already showing
	Invalid operation: Consent form not ready