Skip to main content

概要

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

UIDの設定(オプション)

ユーザーを識別するためのユーザー識別子(UID)を設定します。UIDはクロスプラットフォームでのターゲティング情報共有に使用されます。

使用方法

パラメータ

UIDはSHA-256でハッシュ化されて送信されます。個人情報(メール、電話番号など)を直接渡さないでください。
ログアウト時に空文字列("")を渡すとUIDがリセットされます。

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

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

プロパティの設定

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

プロパティの取得

AdropMetrics.properties()を使用して、現在設定されているすべてのプロパティを取得できます。
() => Promise<Record<string, any>>
現在設定されているすべてのプロパティをキーバリューオブジェクトとして返します。プロパティが設定されていない場合、空のオブジェクトを返します。

パラメータ

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

組み込みプロパティ

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はオプションであり、主にクロスプラットフォーム(Web、iOS、Androidなど)間でターゲティング情報を共有するために使用されます。
プロパティデータは収集後24時間以内にコンソールに反映されます。データが表示されない場合:
  1. コンソールでプロパティが正しく定義されているか確認してください。
  2. SDKから渡されるプロパティキーがコンソールと完全に一致しているか確認してください(大文字小文字を区別)。
  3. 広告をロードする前にAdropMetrics.setProperty()が呼び出されているか確認してください。
プロパティ値にnullを渡すと削除できます:
React Native SDKは現在、配列タイプを直接サポートしていません。必要に応じて、文字列に変換するか、複数の個別プロパティに分割してください。