概要
ターゲティング設定を通じて、特定のユーザーグループにカスタマイズされた広告を表示できます。Adrop SDKは2つのターゲティング方式を提供します:- オーディエンスターゲティング:ユーザーの属性(プロパティ)に基づいて広告を表示します。
- コンテキストターゲティング:コンテンツの文脈(カテゴリ、トピックなど)に基づいて広告を表示します。
ターゲティングデータを収集するには、広告ロード前にUIDとプロパティを設定する必要があります。
UID設定
ユーザー識別子(UID)を設定してユーザーを区別します。UIDはターゲット広告の基盤となります。使い方
パラメータ
| パラメータ | タイプ | 説明 |
|---|---|---|
uid | String | ユーザー固有識別子(例:サービス会員ID) |
オーディエンスターゲティング
ユーザーの属性情報(プロパティ)を収集して、特定のユーザーグループに広告を表示します。プロパティ設定
AdropMetrics.setProperty()メソッドを使用してユーザーの属性情報を収集します。
パラメータ
| パラメータ | タイプ | 説明 |
|---|---|---|
key | String | プロパティキー(最大64文字) |
value | Any? | プロパティ値(String、Int、Double、Long、Boolean、null) |
デフォルトプロパティ
Adrop SDKはターゲティング用のデフォルトプロパティを提供します。AdropKeyとAdropValueクラスを使用して値を設定します。
年齢(生年月日)
生年月日情報を渡すと自動的に年齢が計算されます。| 定数 | 値 | 説明 |
|---|---|---|
AdropValue.AdropBirth.formatYear | "yyyy" | 年のみ(例:“1990”) |
AdropValue.AdropBirth.formatYearMonth | "yyyyMM" | 年月(例:“199003”) |
AdropValue.AdropBirth.formatYearMonthDay | "yyyyMMdd" | 年月日(例:“19900315”) |
性別
| 定数 | 値 | 説明 |
|---|---|---|
AdropValue.AdropGender.MALE | "M" | 男性 |
AdropValue.AdropGender.FEMALE | "F" | 女性 |
AdropValue.AdropGender.OTHER | "O" | その他 |
AdropValue.UNKNOWN | "U" | 不明 |
年齢を直接設定
生年月日の代わりに年齢を直接設定することもできます。BIRTHとAGEのどちらか一方だけ設定すれば十分です。両方設定された場合はBIRTHが優先されます。カスタムプロパティ
サービスに合わせたカスタムプロパティを設定できます。カスタムプロパティはAdropコンソールのターゲティングメニューで先に定義する必要があります。プロパティ使用例
ユーザーがアプリの特定の画面に入った時にプロパティを更新する例です。コンテキストターゲティング
コンテンツの文脈(カテゴリ、トピックなど)に応じて広告を表示します。バナー広告とネイティブ広告でcontextId属性を使用します。
バナー広告
XMLで設定
コードで設定
ネイティブ広告
ネイティブ広告はコンストラクタでcontextIdを設定できます。
Context ID使用例
ニュースアプリで記事カテゴリに応じて広告を表示する例です。Context IDはコンソールで定義したコンテキストターゲティングカテゴリと一致する必要があります。
イベントトラッキング
ユーザー行動イベントを追跡して、ユーザーアクションに基づくオーディエンスを構築できます。AdropMetrics.sendEvent()を使用してイベントを送信します。
logEvent()は非推奨です。sendEvent()を使用してください。イベント送信
マルチアイテムイベント
複数アイテムを含むイベント(例:purchase、begin_checkout)の場合、putItems()を使用してアイテムリストを追加します。
サポートされるイベント例
| イベント名 | 説明 | 主なパラメータ |
|---|---|---|
app_open | アプリを開く | — |
sign_up | 会員登録 | method |
view_item | アイテム閲覧 | item_id, item_name, price |
add_to_cart | カートに追加 | item_id, item_name, price, quantity |
add_to_wishlist | ウィッシュリストに追加 | item_id, item_name, price |
begin_checkout | チェックアウト開始 | currency, items |
purchase | 購入完了 | tx_id, currency, items |
page_view | ページ閲覧 | page_id, page_category |
click | 要素クリック | element_id, element_type |
- イベント名は1〜64文字である必要があります。
- パラメータキーは1〜64文字である必要があります。
- 文字列パラメータ値は最大1024文字までです。
- 同じ名前とパラメータを持つ重複イベントは500ms以内の送信が制限されます。
ベストプラクティス
1. 広告ロード前にUIDを設定
2. 意味のあるContext IDを使用
3. 変更があるたびにプロパティを更新
関連ドキュメント
オーディエンスターゲティングを作成
コンソールでオーディエンスターゲティングを作成
コンテキストターゲティングを作成
コンソールでコンテキストターゲティングを作成
ターゲティングを販売
ターゲティングカテゴリの販売設定
バナー広告
バナー広告を実装
ネイティブ広告
ネイティブ広告を実装
リファレンス
クラス、リスナー、エラーコード
FAQ
UIDを設定しないとターゲット広告は表示されませんか?
UIDを設定しないとターゲット広告は表示されませんか?
UIDを設定しなくても広告は表示されますが、オーディエンスターゲティングが適用されません。基本ターゲティング(国、言語など)のみ使用されます。精密なターゲティングにはUID設定が必須です。
プロパティを設定しましたがコンソールにデータが表示されません。
プロパティを設定しましたがコンソールにデータが表示されません。
プロパティデータは収集後最大24時間以内にコンソールに反映されます。データが表示されない場合:
- コンソールでプロパティが正しく定義されているか確認してください。
- SDKから渡すプロパティキーがコンソールと正確に一致するか確認してください(大文字小文字を区別)。
AdropMetrics.setProperty()が広告ロード前に呼び出されているか確認してください。
Context IDはどの形式で作成すべきですか?
Context IDはどの形式で作成すべきですか?
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を渡すとそのプロパティが削除されます: