Adrop SDKは2種類のターゲティングをサポートしています:
- オーディエンスターゲティング: ユーザー属性(性別、年齢、興味など)に基づいて広告をターゲティング
- コンテキストターゲティング: コンテンツや画面のコンテキストに応じて広告をターゲティング
ターゲティングを活用すると、ユーザーにより関連性の高い広告を表示でき、広告主は望む対象に効果的に広告を配信できます。
オーディエンスターゲティング
ユーザー属性に基づいて広告をターゲティングできます。
1. ターゲティングの作成
まずAdropコンソールでオーディエンスターゲティングを作成してください。
ターゲティングの作成
コンソールでオーディエンスターゲティングを作成する方法を確認
2. ユーザーIDの設定
広告レンダリング前にユーザー識別子を設定する必要があります。
import AdropAds
// ログイン後にユーザーIDを設定
Adrop.setUID("user_id")
ターゲティング広告が正常に動作するには、広告枠に入る前にUIDを設定してください。
3. ユーザープロパティの設定
ユーザー属性を設定すると、より精密なターゲティングが可能になります。
import AdropAds
// 基本提供属性の設定
AdropMetrics.setProperty(key: AdropKey.GENDER, value: AdropValue.AdropGender.MALE)
AdropMetrics.setProperty(key: AdropKey.AGE, value: 30)
AdropMetrics.setProperty(key: AdropKey.BIRTH, value: "19931225")
// カスタム属性の設定 (コンソールで登録が必要)
AdropMetrics.setProperty(key: "membership", value: "premium")
AdropMetrics.setProperty(key: "interest_tech", value: true)
AdropMetrics.setProperty(key: "last_purchase_date", value: "2024-01-15")
プロパティ値は単一値(String, Int, Bool)のみサポートします。配列や辞書はサポートしていません。
基本提供属性
SDKは一般的に使用される属性に対する事前定義キーを提供します。
AdropKey
| キー | 説明 | 値タイプ |
|---|
AdropKey.GENDER | 性別 | AdropValue.AdropGender |
AdropKey.AGE | 年齢 | Int |
AdropKey.BIRTH | 生年月日 | String (YYYY, YYYYMM, YYYYMMDD) |
AdropValue
性別に対する事前定義値:
| 値 | 説明 |
|---|
AdropValue.AdropGender.MALE | 男性 |
AdropValue.AdropGender.FEMALE | 女性 |
AdropValue.AdropGender.OTHER | その他 |
AdropValue.UNKNOWN | 不明 |
// 性別設定
AdropMetrics.setProperty(key: AdropKey.GENDER, value: AdropValue.AdropGender.MALE)
AdropMetrics.setProperty(key: AdropKey.GENDER, value: AdropValue.AdropGender.FEMALE)
AdropMetrics.setProperty(key: AdropKey.GENDER, value: AdropValue.AdropGender.OTHER)
// 年齢設定
AdropMetrics.setProperty(key: AdropKey.AGE, value: 25)
// 生年月日設定
AdropMetrics.setProperty(key: AdropKey.BIRTH, value: "1999") // 年のみ
AdropMetrics.setProperty(key: AdropKey.BIRTH, value: "199903") // 年月
AdropMetrics.setProperty(key: AdropKey.BIRTH, value: "19990315") // 全体
イベントロギング
ユーザー行動をイベントとして記録し、より精密なターゲティングができます。
import AdropAds
// パラメータなしのイベント
AdropMetrics.logEvent(name: "tutorial_complete")
// パラメータありのイベント
AdropMetrics.logEvent(
name: "purchase",
params: [
"item_id": "SKU_12345",
"price": 9.99,
"currency": "USD"
]
)
// ゲームイベント例
AdropMetrics.logEvent(
name: "level_complete",
params: [
"level": 5,
"score": 1500,
"time_spent": 180
]
)
コンテキストターゲティング
コンテンツや画面のコンテキストに応じて広告をターゲティングできます。
1. ターゲティングの作成
まずAdropコンソールでコンテキストターゲティングを作成してください。
コンテキストターゲティングの作成
コンソールでコンテキストターゲティングを作成する方法を確認
2. 広告枠に値を設定
コンソールで設定したContext IDを広告読み込み時に渡します。
バナー広告
import AdropAds
let banner = AdropBanner(unitId: "YOUR_UNIT_ID")
banner.contextId = "sport" // コンテキストIDの設定
banner.load()
ネイティブ広告
import AdropAds
class ViewController: UIViewController {
private var adLoader: AdropNativeAdLoader?
func loadAd() {
adLoader = AdropNativeAdLoader(unitId: "YOUR_UNIT_ID")
adLoader?.contextId = "tech" // コンテキストIDの設定
adLoader?.delegate = self
adLoader?.loadAd()
}
}
ベストプラクティス
1. UIDの設定タイミング
ユーザーがログインしたらすぐにUIDを設定してください。
// ログイン成功時
func didLoginSuccessfully(userId: String) {
Adrop.setUID(userId)
// ユーザー属性も一緒に設定
AdropMetrics.setProperty(key: "is_logged_in", value: true)
}
// ログアウト時
func didLogout() {
Adrop.setUID("") // UIDの初期化
AdropMetrics.setProperty(key: "is_logged_in", value: false)
}
2. プロパティの一貫性維持
ユーザープロパティは、アプリ実行時または値が変更されるたびに設定してください。
class UserManager {
func updateUserProfile(profile: UserProfile) {
// プロフィール情報更新時にプロパティを同期
AdropMetrics.setProperty(key: AdropKey.AGE, value: profile.age)
AdropMetrics.setProperty(key: "membership", value: profile.membershipLevel)
AdropMetrics.setProperty(key: "interest_\(profile.mainInterest)", value: true)
}
}
次のステップ
