Skip to main content

概要

ターゲティング設定により、特定のユーザーグループにパーソナライズされた広告を表示できます。Adrop SDKはオーディエンスターゲティングを提供しています。
  • オーディエンスターゲティング:ユーザー属性(プロパティ)に基づいて広告を表示
ターゲティングデータを収集するには、広告をロードする前にプロパティを設定する必要があります。

UIDの設定(オプション)

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

使用方法

パラメータ

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

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

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

プロパティの設定

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

プロパティの取得

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

パラメータ

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

組み込みプロパティ

Adrop SDKはターゲティング用の組み込みプロパティを提供しています。AdropPropertiesAdropGender列挙型を使用して値を設定します。

年齢(生年月日)

生年月日情報を渡すと、年齢が自動的に計算されます。
日付フォーマット

性別

性別定数

年齢を直接設定

生年月日の代わりに年齢を直接設定することもできます。
BIRTHまたはAGEのいずれかを設定すれば十分です。両方が設定されている場合、BIRTHが優先されます。

カスタムプロパティ

サービス用のカスタムプロパティを設定できます。カスタムプロパティは最初に広告管理コンソールターゲティングメニューで定義する必要があります。
カスタムプロパティ名はコンソールで定義した名前と完全に一致する必要があります。大文字小文字を区別します。

プロパティ使用例

アプリにユーザーがログインした際のプロパティ設定例です。

イベントトラッキング

ユーザー行動イベントを追跡して、ユーザーアクションに基づくオーディエンスを構築できます。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は現在、配列タイプを直接サポートしていません。必要に応じて、文字列に変換するか、複数の個別プロパティに分割してください。