라이트 팝업 광고

라이트 팝업 광고 형태 소개

화면 위에 팝업 형태로 노출되는 광고 유형입니다.
8초 후에 자동으로 닫히게 됩니다. 인터스티셜이나, 리워드 비디오보다 ux를 해치지 않고 광고를 보여줄 수 있습니다.
Android 라이트팝업 예시

iOS 라이트팝업 예시

패키지별 구현하기

react-native-daro
react-native-daro-m

react-native-daro 1.0.16 이상에서는 라이트 팝업 광고를 Hook API로 사용할 수 있습니다. 컴포넌트 내부에서 useLightPopupAd를 사용하면 로딩 상태와 광고 커스터마이징 옵션을 함께 관리할 수 있습니다.

기존의 정적 API(LightPopupAd.loadAd 등)는 deprecated입니다. 정적 리스너(LightPopupAd.addAdLoadedEventListener 등)는 Hook이나 인스턴스 API로 로드한 광고의 이벤트를 받지 못하니, 광고 로드를 새 API로 옮길 때 이벤트 리스너도 함께 옮겨주세요.

import { Button } from "react-native";
import { useLightPopupAd } from "react-native-daro";

function LightPopupAdButton({ adUnitId }) {
  const { isLoaded, isLoading, load, show, isAdReady } = useLightPopupAd(
    adUnitId,
    {
      onLoaded: (adInfo) => {
        // 광고 로드 성공
      },
      onLoadFailed: (errorInfo) => {
        // 광고 로드 실패
      },
      onHidden: (adInfo) => {
        // 광고 닫힘
      },
      onImpressionRecorded: (adInfo) => {
        // 광고 impression 기록
      },
    }
  );

  const handlePress = async () => {
    if (await isAdReady()) {
      show();
      return;
    }

    load({
      configuration: {
        closeButtonText: "Close AD",
        ctaButtonBackgroundColor: "#4CAF50",
      },
    });
  };

  return (
    <Button
      disabled={isLoading}
      title={isLoaded ? "Show LightPopup" : "Load LightPopup"}
      onPress={handlePress}
    />
  );
}

react-native-daro-m에서는 Static API로 라이트 팝업 광고를 구현합니다. LightPopupAd.loadAd(unitId)를 통해서 광고를 로드할 수 있습니다.

import { Platform } from "react-native";
import { LightPopupAd } from "react-native-daro-m";

const LIGHT_POPUP_AD_UNIT_ID = Platform.select({
  ios: "YOUR_IOS_LIGHT_POPUP_AD_UNIT_ID",
  android: "YOUR_ANDROID_LIGHT_POPUP_AD_UNIT_ID",
  default: ''
});

LightPopupAd.loadAd(LIGHT_POPUP_AD_UNIT_ID);

광고 보여주기

LightPopupAd.showAd(unitId)를 통해서 로드한 광고를 보여줄 수 있습니다.

const isReady = await LightPopupAd.isAdReady(LIGHT_POPUP_AD_UNIT_ID);

if (isReady) {
  LightPopupAd.showAd(LIGHT_POPUP_AD_UNIT_ID);
}

구현 예시

`LightPopupAd` 구현 예시입니다.

import { useEffect, useRef, useState } from "react";
import { StyleSheet } from "react-native";
// import문은 위의 탭 참조
import { AdDisplayFailedInfo, AdInfo, AdLoadFailedInfo, AdRevenueInfo, LightPopupAd } from "react-native-daro-m";
import { ThemedButton } from "../ThemedButton";
enum AdLoadState {
  notLoaded = 'NOT_LOADED',
  loading = 'LOADING',
  loaded = 'LOADED',
}

type Props = {
  adUnitId: string;
  isInitialized: boolean;
  log: (str: string) => void;
};

const MAX_EXPONENTIAL_RETRY_COUNT = 3;

const LightPopupAdExample = ({ adUnitId, isInitialized, log }: Props) => {
  const [adLoadState, setAdLoadState] = useState<AdLoadState>(AdLoadState.notLoaded);
  const retryAttempt = useRef(0);

  useEffect(() => {

    LightPopupAd.addAdLoadedEventListener((adInfo: AdInfo) => {
      setAdLoadState(AdLoadState.loaded);
      retryAttempt.current = 0;
      log(`LightPopup ad loaded`);
    });

    LightPopupAd.addAdImpressionRecordedListener((adInfo: AdInfo) => {
      log(`LightPopup ad revenue paid`);
    });

    LightPopupAd.addAdClickedEventListener((adInfo: AdInfo) => {
      log(`LightPopup ad clicked`);
    });

    // Handle ad load failure
    LightPopupAd.addAdLoadFailedEventListener((errorInfo: AdLoadFailedInfo) => {
      setAdLoadState(AdLoadState.notLoaded);

      if (retryAttempt.current > MAX_EXPONENTIAL_RETRY_COUNT) {
        log('LightPopup ad failed to load with code ' + errorInfo.code);
        return;
      }

      // LightPopup ad failed to load
      // We recommend retrying with exponentially higher delays up to a maximum delay (in this case 64 seconds)
      retryAttempt.current += 1;

      const retryDelay = Math.pow(2, Math.min(MAX_EXPONENTIAL_RETRY_COUNT, retryAttempt.current));
      log('LightPopup ad failed to load with code ' + errorInfo.code + ' - retrying in ' + retryDelay + 's');

      setTimeout(() => {
        setAdLoadState(AdLoadState.loading);
        log('LightPopup ad retrying to load...');
        LightPopupAd.loadAd(adUnitId);
      }, retryDelay * 1000);
    });

    LightPopupAd.addAdDisplayedEventListener((adInfo: AdInfo) => {
      log(`LightPopup ad displayed`);
    });

    LightPopupAd.addAdFailedToDisplayEventListener?.((adInfo: AdDisplayFailedInfo) => {
      setAdLoadState(AdLoadState.notLoaded);
      log(`LightPopup ad failed to display`);
    });

    LightPopupAd.addAdHiddenEventListener?.((adInfo: AdInfo) => {
      setAdLoadState(AdLoadState.notLoaded);
      log(`LightPopup ad hidden`);
    });

    LightPopupAd.setLightPopupAdConfiguration(adUnitId, {
      backgroundColor: 'blue',
      cardViewBackgroundColor: 'yellow',
      adMarkLabelTextColor: 'red',
      adMarkLabelBackgroundColor: '#FFD700',
      closeButtonText: 'Close AD',
      closeButtonTextColor: 'rgba(0, 255, 255, 0.42)',
      titleTextColor: 'rgba(0, 128, 255, 0.42)',
      bodyTextColor: '#333333',
      ctaButtonTextColor: 'blue',
      ctaButtonBackgroundColor: '#4CAF50',
    });

  }, [adUnitId]);

  const getLightPopupButtonTitle = () => {
    if (adLoadState === AdLoadState.notLoaded) {
      return 'Load LightPopup';
    } else if (adLoadState === AdLoadState.loading) {
      return 'Loading...';
    } else {
      return 'Show LightPopup'; // adLoadState.loaded
    }
  };
  return (
    <AppButton style={styles.button} enabled={isInitialized && adLoadState !== AdLoadState.loading} title={getLightPopupButtonTitle()} onPress={async () => {
      const isLightPopupReady = await LightPopupAd.isAdReady(adUnitId);
      if (isLightPopupReady) {
        LightPopupAd.showAd(adUnitId);
      } else {
        log('Loading LightPopup ad...');
        setAdLoadState(AdLoadState.loading);
        LightPopupAd.loadAd(adUnitId);
      }
    }} />
  );
}

const styles = StyleSheet.create({
  button: {
    margin: 5,
  },
});

export default LightPopupAdExample;

광고 커스터마이징

LightPopupAd.setLightPopupAdConfiguration(adUnitId, options)를 통해서 색상, 텍스트 등 UI 요소를 커스터마이징할 수 있습니다.

LightPopupAd.setLightPopupAdConfiguration(adUnitId, {
  backgroundColor: 'blue', // 전체 배경색
  cardViewBackgroundColor: 'yellow', // 카드 배경색
  adMarkLabelTextColor: 'red', // 광고 마크 텍스트 색상
  adMarkLabelBackgroundColor: '#FFD700', // 광고 마크 배경색
  closeButtonText: 'Close AD', // 닫기 버튼 텍스트
  closeButtonTextColor: 'rgba(0, 255, 255, 0.42)', // 닫기 버튼 텍스트 색상
  titleTextColor: 'rgba(0, 128, 255, 0.42)', // 타이틀 색상
  bodyTextColor: '#333333', // 본문 색상
  ctaButtonTextColor: 'blue', // CTA 버튼 텍스트 색상
  ctaButtonBackgroundColor: '#4CAF50', // CTA 버튼 배경색
});

다로 시작하기

SDK 통합하기

DARO 사용하기

FAQ

라이트 팝업 광고