リファレンス

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;