概要
ターゲティング設定により、特定のユーザーグループにパーソナライズされた広告を表示できます。Adrop SDKは2つのターゲティング方式を提供しています:- オーディエンスターゲティング:ユーザー属性(プロパティ)に基づいて広告を表示
- コンテキストターゲティング:コンテンツの文脈(カテゴリ、トピックなど)に基づいて広告を表示(SDK 1.17.0以降)
ターゲティングデータを収集するには、広告をロードする前にプロパティを設定する必要があります。
UIDの設定(オプション)
ユーザーを識別するためのユーザー識別子(UID)を設定します。UIDはクロスプラットフォームでのターゲティング情報共有に使用されます。使用方法
パラメータ
ログアウト時に空文字列(
"")を渡すとUIDがリセットされます。オーディエンスターゲティング
ユーザー属性情報(プロパティ)を収集して、特定のユーザーグループに広告を表示します。プロパティの設定
AdropMetrics.setProperty()メソッドを使用してユーザー属性情報を収集します。
プロパティの取得
AdropMetrics.properties()を使用して、現在設定されているすべてのプロパティを取得できます。
() => Promise<Record<string, any>>
現在設定されているすべてのプロパティをキーバリューオブジェクトとして返します。プロパティが設定されていない場合、空のオブジェクトを返します。
パラメータ
組み込みプロパティ
Adrop SDKはターゲティング用の組み込みプロパティを提供しています。AdropPropertiesとAdropGender列挙型を使用して値を設定します。
年齢(生年月日)
生年月日情報を渡すと、年齢が自動的に計算されます。性別
年齢を直接設定
生年月日の代わりに年齢を直接設定することもできます。BIRTHまたはAGEのいずれかを設定すれば十分です。両方が設定されている場合、BIRTHが優先されます。カスタムプロパティ
サービス用のカスタムプロパティを設定できます。カスタムプロパティは最初に広告管理コンソールのプロパティメニューで定義する必要があります。プロパティ使用例
アプリにユーザーがログインした際のプロパティ設定例です。コンテキストターゲティング
コンテンツの文脈(カテゴリ、トピックなど)に応じて広告を表示します。 バナー広告とネイティブ広告にcontextIdを渡します。 SDK 1.17.0以降で使用できます。
まずAd Controlコンソールでコンテキストターゲティングを作成してください。詳細はコンテキストターゲティングの作成をご確認ください。
コンテキストターゲティングは、コンテキストIDを含むバナー・ネイティブ広告のリクエストにのみ適用されます(Android・iOS SDKとFlutter・React Native SDK 1.17.0以降のバナー・ネイティブ広告、Web SDK、REST API)。インタースティシャル・リワード・ポップアップ・スプラッシュ広告、および1.17.0未満のFlutter・React Native SDKはコンテキストIDを送信しません。これらの枠を含む広告商品にコンテキストターゲティングを接続すると、その枠ではコンテキストの含む条件を満たせないためキャンペーンは表示されず、コンテキストの除外条件も適用されません。
バナー広告
contextIdはマウント時の値のみ適用されます。画面のコンテキストが変わる場合は、keyも変更してバナーを再マウントしてください。
ネイティブ広告
contextIdはコンストラクタの4番目の引数です。
- コンテキストIDは大文字小文字を区別し、コンソールのコンテキストターゲティングで、ターゲティングオプションの条件に入力した値と正確に一致する必要があります。
- コンテキストIDにはカンマ(,)を含めないでください。コンソールでも広告リクエストでも、カンマは複数の値の区切りとして使われます。広告をリクエストする際は、前後に空白を入れず、コンソールに入力した値とまったく同じ値を渡してください。
- 1回のリクエストで複数のコンテキストにマッチさせる場合は、
hiking,outdoorのようにカンマで区切って渡します。先頭から5件まで使用され、含むより除外が優先されます。詳細なルールは複数のコンテキストIDを渡すをご確認ください。 - コンテキストIDを渡さない場合や、コンソールに登録されていない値を渡した場合でも、エラーは発生しません。この場合、コンテキストターゲティングのキャンペーンのみが配信対象から外れ、その他の広告は引き続き表示される場合があります。
イベントトラッキング
ユーザー行動イベントを追跡して、ユーザーアクションに基づくオーディエンスを構築できます。AdropMetrics.sendEvent()を使用してイベントを送信します。
logEvent()は非推奨です。sendEvent()を使用してください。イベント送信
マルチアイテムイベント
複数アイテムを含むイベント(例:purchase、begin_checkout)の場合、パラメータにitems配列を渡します。
サポートされるイベント例
- イベント名は1〜64文字である必要があります。
- パラメータキーは1〜64文字である必要があります。
- 文字列パラメータ値は最大1024文字までです。
ベストプラクティス
1. 広告ロード前にプロパティを設定
2. プロパティ変更時に更新
3. ログアウト時にプロパティをリセット
関連ドキュメント
オーディエンスターゲティングの作成
コンソールでオーディエンスターゲティングを作成
ターゲティング販売
ターゲティングカテゴリ販売の設定
バナー広告
バナー広告の実装
ネイティブ広告
ネイティブ広告の実装
FAQ
UIDを設定しないとターゲット広告は表示されませんか?
UIDを設定しないとターゲット広告は表示されませんか?
UIDを設定しなくても広告は表示され、プロパティベースのオーディエンスターゲティングも適用されます。UIDはオプションであり、主にクロスプラットフォーム(Web、iOS、Androidなど)間でターゲティング情報を共有するために使用されます。
プロパティを設定しましたが、コンソールにデータが表示されません。
プロパティを設定しましたが、コンソールにデータが表示されません。
プロパティデータは収集後24時間以内にコンソールに反映されます。データが表示されない場合:
- コンソールでプロパティが正しく定義されているか確認してください。
- SDKから渡されるプロパティキーがコンソールと完全に一致しているか確認してください(大文字小文字を区別)。
- 広告をロードする前に
AdropMetrics.setProperty()が呼び出されているか確認してください。
プロパティ値を削除するにはどうすればよいですか?
プロパティ値を削除するにはどうすればよいですか?
プロパティ値に
nullを渡すと削除できます:配列タイプのプロパティを設定できますか?
配列タイプのプロパティを設定できますか?
React Native SDKは現在、配列タイプを直接サポートしていません。必要に応じて、文字列に変換するか、複数の個別プロパティに分割してください。