概要
ターゲティング設定により、特定のユーザーグループにカスタマイズされた広告を表示できます。Adrop SDKは2つのターゲティング方式を提供しています:- オーディエンスターゲティング: ユーザーのプロパティ(属性)に基づいて広告を表示します。
- コンテキストターゲティング: コンテンツの文脈(カテゴリ、トピックなど)に基づいて広告を表示します。SDK 1.17.0以降で使用できます。
ターゲティングデータを収集するには、広告ロード前にプロパティを設定する必要があります。
UIDの設定(オプション)
ユーザー識別子(UID)を設定して、プラットフォーム間でターゲティングデータを共有できます。UIDはオプションであり、プロパティベースおよびイベントベースのターゲティングには必要ありません。使い方
パラメータ
ログアウト時は空の文字列(
'')を渡してUIDを初期化してください。オーディエンスターゲティング
ユーザーの属性情報(プロパティ)を収集して、特定のユーザーグループに広告を表示します。プロパティの設定
AdropMetrics.setProperty()メソッドを使用してユーザーの属性情報を収集します。
パラメータ
デフォルトプロパティ
Adrop SDKはターゲティング用のデフォルトプロパティを提供しています。年齢 (生年月日)
生年月日情報を渡すと、自動的に年齢が計算されます。性別
年齢を直接設定
生年月日の代わりに年齢を直接設定することもできます。BIRTHとAGEのいずれか一方のみ設定すればよいです。両方設定された場合、BIRTHが優先されます。カスタムプロパティ
サービスに合ったカスタムプロパティを設定できます。カスタムプロパティはAd Controlコンソールのプロパティメニューで最初に定義する必要があります。コンテキストターゲティング
コンテンツの文脈(カテゴリ、トピックなど)に応じて広告を表示します。 バナー広告とネイティブ広告を作成するときに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を送信しません。これらの枠を含む広告商品にコンテキストターゲティングを接続すると、その枠ではコンテキストの含む条件を満たせないためキャンペーンは表示されず、コンテキストの除外条件も適用されません。
バナー広告
ネイティブ広告
- コンテキストIDは大文字小文字を区別し、コンソールのコンテキストターゲティングで、ターゲティングオプションの条件に入力した値と正確に一致する必要があります。
- コンテキストIDにはカンマ(,)を含めないでください。コンソールでも広告リクエストでも、カンマは複数の値の区切りとして使われます。広告をリクエストする際は、前後に空白を入れず、コンソールに入力した値とまったく同じ値を渡してください。
- 1回のリクエストで複数のコンテキストにマッチさせる場合は、
hiking,outdoorのようにカンマで区切って渡します。先頭から5件まで使用され、含むより除外が優先されます。詳細なルールは複数のコンテキストIDを渡すをご確認ください。 - コンテキストIDを渡さない場合や、コンソールに登録されていない値を渡した場合でも、エラーは発生しません。この場合、コンテキストターゲティングのキャンペーンのみが配信対象から外れ、その他の広告は引き続き表示される場合があります。
イベント送信
ユーザー行動を追跡するためにイベントを送信できます。イベントを送信する
パラメータ
1つのイベントに最大20個のパラメータを設定できます。
プロパティの照会
保存されたすべてのプロパティを照会できます。使用例
ログイン時にプロパティを設定
ログアウト時に初期化
プロパティの更新
ベストプラクティス
1. 広告ロード前にプロパティを設定
2. 変更されるたびにプロパティを更新
3. ログアウト時にプロパティを初期化
関連ドキュメント
オーディエンスターゲティングの作成
コンソールでオーディエンスターゲティングを作成する
ターゲティング販売
ターゲティングカテゴリーの販売設定
バナー広告
バナー広告を実装する
ネイティブ広告
ネイティブ広告を実装する
FAQ
UIDを設定しないとターゲティング広告が表示されませんか?
UIDを設定しないとターゲティング広告が表示されませんか?
UIDはオプションです。UIDを設定しなくても、プロパティベースおよびイベントベースのターゲティングは正常に動作します。UIDは複数のプラットフォーム間でターゲティングデータを共有する場合にのみ必要です。
プロパティを設定したのにコンソールにデータが表示されません。
プロパティを設定したのにコンソールにデータが表示されません。
プロパティデータは収集後、最大24時間以内にコンソールに反映されます。データが表示されない場合:
- コンソールでプロパティが正しく定義されているか確認してください。
- SDKから渡すプロパティキーがコンソールと正確に一致しているか確認してください(大文字小文字を区別)。
AdropMetrics.setProperty()が広告ロード前に呼び出されているか確認してください。
プロパティ値を削除するにはどうすればよいですか?
プロパティ値を削除するにはどうすればよいですか?
プロパティ値に
nullを渡すと、そのプロパティが削除されます:プロパティ値のタイプ制限はありますか?
プロパティ値のタイプ制限はありますか?
サポートされているタイプは
String、int、double、boolです。配列や複雑なオブジェクトはサポートされていません。必要な場合は文字列に変換して渡してください。