ターゲティング設定

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

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

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が自動的に収集するデバイス属性です。

フィールド	説明
`sdkv`	SDKバージョン
`deviceWidth`	デバイス画面幅
`deviceHeight`	デバイス画面高さ
`osVersion`	OSバージョン
`webViewUserAgent`	ブラウザユーザーエージェント
`platform`	プラットフォーム (web)

カスタム属性

コンソールで追加登録した属性を設定できます。値はAdropコンソールで定義したタイプに合わせて渡す必要があります。プロパティ名は、小文字の英字・数字・アンダースコア（_）のみを使用した3～64文字にする必要があります。詳しくはプロパティ命名規則を参照してください。

await adrop.metrics
  .setUserProperties({
    membership: 'premium',
    last_purchase_date: '2024-01-15',
    favorite_category: 'electronics'
  })
  .commit();

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

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

1. ターゲティング作成

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

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

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

2. 広告枠に値を設定

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

Context IDは大文字小文字を区別し、コンソールのコンテキストターゲティングで、ターゲティングオプションの条件に入力した値と正確に一致する必要があります。
Context IDにはカンマ（,）を含めないでください。コンソールでも広告リクエストでも、カンマは複数の値の区切りとして使われます。広告をリクエストする際は、前後に空白を入れず、コンソールに入力した値とまったく同じ値を渡してください。
1回のリクエストで複数のコンテキストにマッチさせる場合は、hiking,outdoor のようにカンマで区切って渡します。先頭から5件まで使用され、含むより除外が優先されます。詳細なルールは複数のコンテキストIDを渡すをご確認ください。
Context IDを渡さない場合や、コンソールに登録されていない値を渡した場合でも、エラーは発生しません。この場合、コンテキストターゲティングのキャンペーンのみが配信対象から外れ、その他の広告は引き続き表示される場合があります。

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

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

SDKガイド

AI

Android

iOS

React Native

Flutter

Web

REST API

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

1. ターゲティング作成

ターゲティングを作成

2. ユーザーID設定

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

基本提供属性

アプリ属性

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

カスタム属性

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

1. ターゲティング作成

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

2. 広告枠に値を設定

Data Attributes方式

renderAd方式

動的コンテキスト設定

関連ドキュメント

リファレンス > AdropConfig

リファレンス > AdropAdRequest

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

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

ターゲティングを作成

​2. ユーザーID設定

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

​基本提供属性

​アプリ属性

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

​カスタム属性

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

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

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

​2. 広告枠に値を設定

​Data Attributes方式

​renderAd方式

​動的コンテキスト設定

​関連ドキュメント

リファレンス > AdropConfig

リファレンス > AdropAdRequest

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

1. ターゲティング作成

2. ユーザーID設定

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

基本提供属性

アプリ属性

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

カスタム属性

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

1. ターゲティング作成

2. 広告枠に値を設定

Data Attributes方式

renderAd方式

動的コンテキスト設定

関連ドキュメント