Skip to main content

概要

ターゲティング設定を通じて、特定のユーザーグループにカスタマイズされた広告を表示できます。Adrop SDKは2つのターゲティング方式を提供します:
  • オーディエンスターゲティング:ユーザーの属性(プロパティ)に基づいて広告を表示します。
  • コンテキストターゲティング:コンテンツの文脈(カテゴリ、トピックなど)に基づいて広告を表示します。
ターゲティングデータを収集するには、広告ロード前にUIDとプロパティを設定する必要があります。

UID設定

ユーザー識別子(UID)を設定してユーザーを区別します。UIDはターゲット広告の基盤となります。

使い方

パラメータ

UIDはSHA-256でハッシュされて送信されます。個人情報(メール、電話番号など)を直接渡さないでください。

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

ユーザーの属性情報(プロパティ)を収集して、特定のユーザーグループに広告を表示します。

プロパティ設定

AdropMetrics.setProperty()メソッドを使用してユーザーの属性情報を収集します。

パラメータ

  • プロパティキーは最大64文字までです。
  • 文字列値は最大256文字までです。
  • 数値は最大9007199254740991までです。
  • 最大256個のプロパティを設定できます。

デフォルトプロパティ

Adrop SDKはターゲティング用のデフォルトプロパティを提供します。AdropKeyAdropValueクラスを使用して値を設定します。

年齢(生年月日)

生年月日情報を渡すと自動的に年齢が計算されます。
日付フォーマット定数

性別

性別値定数

年齢を直接設定

生年月日の代わりに年齢を直接設定することもできます。
BIRTHAGEのどちらか一方だけ設定すれば十分です。両方設定された場合はBIRTHが優先されます。

カスタムプロパティ

サービスに合わせたカスタムプロパティを設定できます。カスタムプロパティはAdropコンソールターゲティングメニューで先に定義する必要があります。
カスタムプロパティ名はコンソールで定義した名前と正確に一致する必要があります。大文字小文字を区別します。

プロパティ使用例

ユーザーがアプリの特定の画面に入った時にプロパティを更新する例です。

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

コンテンツの文脈(カテゴリ、トピックなど)に応じて広告を表示します。バナー広告とネイティブ広告でcontextId属性を使用します。

バナー広告

XMLで設定

コードで設定

ネイティブ広告

ネイティブ広告はコンストラクタでcontextIdを設定できます。

Context ID使用例

ニュースアプリで記事カテゴリに応じて広告を表示する例です。
Context IDはコンソールで定義したコンテキストターゲティングカテゴリと一致する必要があります。

イベントトラッキング

ユーザー行動イベントを追跡して、ユーザーアクションに基づくオーディエンスを構築できます。AdropMetrics.sendEvent()を使用してイベントを送信します。
logEvent()は非推奨です。sendEvent()を使用してください。

イベント送信

マルチアイテムイベント

複数アイテムを含むイベント(例:purchase、begin_checkout)の場合、putItems()を使用してアイテムリストを追加します。

サポートされるイベント例

  • イベント名は1〜64文字である必要があります。
  • パラメータキーは1〜64文字である必要があります。
  • 文字列パラメータ値は最大1024文字までです。
  • 同じ名前とパラメータを持つ重複イベントは500ms以内の送信が制限されます。

ベストプラクティス

1. 広告ロード前にUIDを設定

2. 意味のあるContext IDを使用

3. 変更があるたびにプロパティを更新


関連ドキュメント

オーディエンスターゲティングを作成

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

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

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

ターゲティングを販売

ターゲティングカテゴリの販売設定

バナー広告

バナー広告を実装

ネイティブ広告

ネイティブ広告を実装

リファレンス

クラス、リスナー、エラーコード

FAQ

UIDを設定しなくても広告は表示されますが、オーディエンスターゲティングが適用されません。基本ターゲティング(国、言語など)のみ使用されます。精密なターゲティングにはUID設定が必須です。
プロパティデータは収集後最大24時間以内にコンソールに反映されます。データが表示されない場合:
  1. コンソールでプロパティが正しく定義されているか確認してください。
  2. SDKから渡すプロパティキーがコンソールと正確に一致するか確認してください(大文字小文字を区別)。
  3. AdropMetrics.setProperty()が広告ロード前に呼び出されているか確認してください。
Context IDはコンテンツの文脈を表す意味のある文字列である必要があります。例えば:
  • ニュースアプリ:"article_sports""article_tech""article_entertainment"
  • ショッピングアプリ:"category_fashion""category_electronics"
  • 動画アプリ:"video_drama""video_comedy"
コンソールで定義したコンテキストターゲティングカテゴリと一致するように設定してください。
いいえ、配列値は直接サポートされていません。setPropertyはString、Int、Double、Long、Boolean、null値のみ受け付けます。複数の値を保存するにはJSON文字列を使用してください:
プロパティ値にnullを渡すとそのプロパティが削除されます: