인앱 광고 공통 타입·객체

GoogleAdMob

지원환경: React NativeWebView

실행환경: Toss App

GoogleAdMob는 Google AdMob 광고 관련 함수를 모아둔 객체예요.

시그니처

GoogleAdMob: {
    /**
     * @deprecated 곧 제거될 예정이에요. 대신 `loadAppsInTossAdMob`을 사용해주세요.
     */
    loadAdMobInterstitialAd: typeof loadAdMobInterstitialAd;

    /**
     * @deprecated 곧 제거될 예정이에요. 대신 `showAppsInTossAdMob`을 사용해주세요.
     */
    showAdMobInterstitialAd: typeof showAdMobInterstitialAd;

    /**
     * @deprecated 곧 제거될 예정이에요. 대신 `loadAppsInTossAdMob`을 사용해주세요.
     */
    loadAdMobRewardedAd: typeof loadAdMobRewardedAd;

    /**
     * @deprecated 곧 제거될 예정이에요. 대신 `showAppsInTossAdMob`을 사용해주세요.
     */
    showAdMobRewardedAd: typeof showAdMobRewardedAd;

    loadAppsInTossAdMob: typeof loadAppsInTossAdMob;
    showAppsInTossAdMob: typeof showAppsInTossAdMob;
}

프로퍼티

• loadAdMobInterstitialAdtypeof loadAdMobInterstitialAd
  

  (Deprecated) 곧 제거될 예정이에요.
  대신 loadAppsInTossAdMob를 사용해주세요.
  
  전면 광고를 로드하는 함수예요. 자세한 내용은 loadAdMobInterstitialAd를 참고하세요.

• showAdMobInterstitialAdtypeof showAdMobInterstitialAd
  

  (Deprecated) 곧 제거될 예정이에요.
  대신 showAppsInTossAdMob를 사용해주세요.
  
  로드한 전면 광고를 보여주는 함수예요. 자세한 내용은 showAdMobInterstitialAd를 참고하세요.

• loadAdMobRewardedAdtypeof loadAdMobRewardedAd
  

  (Deprecated) 곧 제거될 예정이에요.
  대신 loadAppsInTossAdMob를 사용해주세요.
  
  보상형 광고를 로드하는 함수예요. 자세한 내용은 loadAdMobRewardedAd를 참고하세요.

• showAdMobRewardedAdtypeof showAdMobRewardedAd
  

  (Deprecated) 곧 제거될 예정이에요.
  대신 showAppsInTossAdMob를 사용해주세요.
  
  로드한 보상형 광고를 보여주는 함수예요. 자세한 내용은 showAdMobRewardedAd를 참고하세요.

• loadAppsInTossAdMobtypeof loadAppsInTossAdMob
  

  광고를 로드하는 함수예요. 자세한 내용은 loadAppsInTossAdMob를 참고하세요.

• showAppsInTossAdMobtypeof showAppsInTossAdMob
  

  로드한 광고를 보여주는 함수예요. 자세한 내용은 showAppsInTossAdMob를 참고하세요.

AdMobFullScreenEvent

지원환경: React Native

실행환경: Toss App

AdMobFullScreenEvent는 앱 화면을 덮는 광고(예: 전면 광고, 보상형 광고)를 사용하는 경우에 발생하는 이벤트 타입이에요.

시그니처

type AdMobFullScreenEvent = AdClicked | AdDismissed | AdFailedToShow | AdImpression | AdShow;

예제

광고 이벤트 처리하기

function handleEvent(event: AdMobFullScreenEvent) {
  switch (event.type) {
    case 'clicked':
      console.log('광고가 클릭됐어요.');
      break;

    case 'dismissed':
      console.log('광고가 닫혔어요.');
      break;

    case 'failedToShow':
      console.log('광고가 보여지지 않았어요.');
      break;

    case 'impression':
      console.log('광고가 노출됐어요.');
      break;

    case 'show':
      console.log('광고가 보여졌어요.');
      break;
  }
}

AdNetworkResponseInfo

지원환경: React Native

실행환경: Toss App

AdNetworkResponseInfo 는 광고 네트워크 응답 정보를 담고 있는 객체예요.

시그니처

interface AdNetworkResponseInfo {
  adSourceId: string;
  adSourceName: string;
  adSourceInstanceId: string;
  adSourceInstanceName: string;
  adNetworkClassName: string | null;
}

프로퍼티

• adSourceId필수 · string
  

  광고 소스 ID예요.

• adSourceName필수 · string
  

  광고 소스 이름이예요.

• adSourceInstanceId필수 · string
  

  광고 소스 인스턴스 ID예요.

• adSourceInstanceName필수 · string
  

  광고 소스 인스턴스 이름이예요.

• adNetworkClassName필수 · string | null
  

  광고 네트워크 클래스 이름이예요.

AdNetworkResponseInfo

지원환경: React Native

실행환경: Toss App

AdNetworkResponseInfo 는 광고 네트워크 응답 정보를 담고 있는 객체예요.

시그니처

interface AdNetworkResponseInfo {
  adSourceId: string;
  adSourceName: string;
  adSourceInstanceId: string;
  adSourceInstanceName: string;
  adNetworkClassName: string | null;
}

프로퍼티

• adSourceId필수 · string
  

  광고 소스 ID예요.

• adSourceName필수 · string
  

  광고 소스 이름이예요.

• adSourceInstanceId필수 · string
  

  광고 소스 인스턴스 ID예요.

• adSourceInstanceName필수 · string
  

  광고 소스 인스턴스 이름이예요.

• adNetworkClassName필수 · string | null
  

  광고 네트워크 클래스 이름이예요.