레퍼런스

interface AdropConfig {
  appId: string;      // 앱 ID (필수)
  uid?: string;       // 사용자 식별자
  appKey?: string;    // API 인증 키
  debug?: boolean;    // 디버그 로깅 (기본값: false)
}

interface AdropAdRequest {
  unit: string;           // 유닛 ID (필수)
  uid?: string;           // 사용자 식별자
  contextId?: string;     // 문맥 타겟팅 ID
  trackMode?: 0 | 1;      // 0: 자동, 1: 수동 (네이티브)
  isEntireClick?: boolean; // 전체 영역 클릭 (네이티브)
  theme?: AdTheme;        // 테마
}

interface AdropAdResponse {
  code: AdropErrorCode;  // 응답 코드
  msg: string;           // 응답 메시지
  result?: AdData;       // 광고 데이터 (성공 시)
}

interface AdData {
  // 공통
  format: AdFormat;       // 광고 포맷
  unit: string;           // 유닛 ID

  // 네이티브 광고 필드
  headline?: string;      // 광고 제목
  body?: string;          // 광고 설명
  callToAction?: string;  // CTA 버튼 텍스트
  asset?: string;         // 메인 이미지 URL
  destinationURL?: string; // 클릭 시 이동 URL

  // 광고주 프로필
  profile?: {
    displayLogo?: string;  // 광고주 로고 URL
    displayName?: string;  // 광고주 이름
    link?: string;         // 광고주 프로필 링크
  };

  // 추가 텍스트 항목
  extra?: Record<string, string>;
}

interface AdropEventFilter {
  unit?: string;  // 특정 유닛만 필터링
}

type AdFormat = 'banner' | 'nativeAd' | 'backfill';

type AdTheme = 'light' | 'dark';

// 광고 수신, 노출, 클릭
type AdReceivedCallback = (unit: string, adData: AdData) => void;
type AdImpressionCallback = (unit: string, adData: AdData) => void;
type AdClickedCallback = (unit: string, adData: AdData) => void;

// 광고 없음, 실패
type AdNoFillCallback = (unit: string) => void;
type AdFailedCallback = (unit: string) => void;
type AdBackfillNoFillCallback = (unit: string) => void;