メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.adrop.io/llms.txt

Use this file to discover all available pages before exploring further.

​
オーディエンスターゲティング

ユーザー属性に基づいて広告をターゲティングできます。

​
1. ターゲティング作成

まずAdropコンソールでオーディエンスターゲティングを作成してください。

ターゲティングを作成

コンソールでオーディエンスターゲティング作成方法を確認

​
2. ユーザーID設定

広告レンダリング前にappKeyとuidを設定する必要があります。 
Adrop.instance().setConfig({
  appKey: 'YOUR_APP_KEY',
  uid: 'USER_ID'
});
ターゲティング広告が正常に動作するには、広告枠レンダリング前に設定を完了してください。

​
3. ユーザープロパティ設定

ユーザー属性を設定すると、より精密なターゲティングが可能になります。 
const adrop = Adrop.instance();

await adrop.metrics
  .setUserProperties({
    // 基本提供属性
    adid: 'ADVERTISING_ID',
    birth: '19931225',        // YYYY, YYYYMM, YYYYMMDD
    gender: 'M',              // M, F, U
    locale: 'ko_KR',          // ISO 639
    timeZone: 'Asia/Seoul',   // ISO 8601

    // カスタム属性（コンソールで登録が必要）
    membership: 'premium',
    interests: 'tech,gaming'
  })
  .setAppProperties({
    appName: 'com.example.app',
    appVersion: '1.0.0',
    appBundleVersion: 100
  })
  .commit();
commit()を呼び出すと属性がサーバーに保存されます。既存データとマージされずに上書きされるため、更新時はすべての属性を一緒に送信してください。

​
基本提供属性

フィールド説明形式
adid広告ID文字列
birth生年月日YYYY, YYYYMM, YYYYMMDD
gender性別M, F, U
localeロケールISO 639 (ko_KR)
timeZoneタイムゾーンISO 8601 (Asia/Seoul)

​
アプリ属性

フィールド説明
appNameアプリパッケージID
appVersionアプリバージョン (1.0.0)
appBundleVersionアプリビルド番号

​
デバイス属性（自動収集）

SDKが自動的に収集するデバイス属性です。
フィールド説明
sdkvSDKバージョン
deviceWidthデバイス画面幅
deviceHeightデバイス画面高さ
osVersionOSバージョン
webViewUserAgentブラウザユーザーエージェント
platformプラットフォーム (web)

​
カスタム属性

コンソールで追加登録した属性を設定できます。値はAdropコンソールで定義したタイプに合わせて渡す必要があります。 
await adrop.metrics
  .setUserProperties({
    membership: 'premium',
    lastPurchaseDate: '2024-01-15',
    favoriteCategory: 'electronics'
  })
  .commit();

​
コンテキストターゲティング

ページやコンテンツのコンテキストに応じて広告をターゲティングできます。

​
1. ターゲティング作成

まずAdropコンソールでコンテキストターゲティングを作成してください。

コンテキストターゲティングを作成

コンソールでコンテキストターゲティング作成方法を確認

​
2. 広告枠に値を設定

コンソールで設定したContext Valueを広告リクエスト時に渡します。

​
Data Attributes方式

<div
  data-adrop-unit="YOUR_UNIT_ID"
  data-adrop-context-id="sport">
</div>

​
renderAd方式

const container = document.getElementById('ad-container');
const adrop = Adrop.instance();

adrop.renderAd(container, {
  unit: 'YOUR_UNIT_ID',
  contextId: 'sport'
});

​
動的コンテキスト設定

ページやコンテンツに応じて動的にコンテキストを設定できます。 
<div id="news-ad" data-adrop-unit="NEWS_BANNER"></div>

<script>
  // ページカテゴリに応じてコンテキストを設定
  const category = document.body.getAttribute('data-category'); // 'sport', 'tech', etc.
  const container = document.getElementById('news-ad');

  Adrop.instance().renderAd(container, {
    unit: 'NEWS_BANNER',
    contextId: category
  });
</script>

​
関連ドキュメント

リファレンス > AdropConfig

初期化オプション定義

リファレンス > AdropAdRequest

広告リクエストパラメータ定義