メインコンテンツへスキップ

​
概要

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

​
UID設定

ユーザーを識別するためのユーザー識別子（UID）を設定します。UIDはターゲット広告の基盤となります。

​
使用方法

import Adrop from 'adrop-ads-react-native'

// ユーザーログイン後
Adrop.setUID("user_123")

// ユーザーログアウト時
Adrop.setUID("")

​
パラメータ

パラメータタイプ説明
uidstring一意のユーザー識別子（例：サービス会員ID）
UIDはSHA-256でハッシュ化されて送信されます。個人情報（メール、電話番号など）を直接渡さないでください。
ログアウト時に空文字列（""）を渡すとUIDがリセットされます。

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

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

​
プロパティの設定

AdropMetrics.setProperty()メソッドを使用してユーザー属性情報を収集します。 
import AdropMetrics from 'adrop-ads-react-native/src/metrics/AdropMetrics'

// 文字列プロパティ
AdropMetrics.setProperty("membership_level", "premium")

// 数値プロパティ
AdropMetrics.setProperty("booking_count", 15)

// ブールプロパティ
AdropMetrics.setProperty("is_subscriber", true)

// null値を渡す（プロパティを削除）
AdropMetrics.setProperty("membership_level", null)

​
パラメータ

パラメータタイプ説明
keystringプロパティキー（最大64文字）
valueanyプロパティ値（string, number, boolean, null）
  • プロパティキーは最大64文字まで設定できます。
  • 文字列値は最大256文字まで設定できます。
  • 数値は最大9007199254740991まで設定できます。
  • 最大256個のプロパティを設定できます。

​
組み込みプロパティ

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

​
年齢（生年月日）

生年月日情報を渡すと、年齢が自動的に計算されます。 
import AdropMetrics from 'adrop-ads-react-native/src/metrics/AdropMetrics'
import { AdropProperties } from 'adrop-ads-react-native/src/metrics/Property'

// 年のみ (yyyy)
AdropMetrics.setProperty(AdropProperties.BIRTH, "1990")

// 年と月 (yyyyMM)
AdropMetrics.setProperty(AdropProperties.BIRTH, "199003")

// 完全な日付 (yyyyMMdd)
AdropMetrics.setProperty(AdropProperties.BIRTH, "19900315")
日付フォーマット
フォーマット例説明
yyyy”1990”年のみ
yyyyMM”199003”年と月
yyyyMMdd”19900315”完全な日付

​
性別

import AdropMetrics from 'adrop-ads-react-native/src/metrics/AdropMetrics'
import { AdropProperties, AdropGender } from 'adrop-ads-react-native/src/metrics/Property'

// 男性
AdropMetrics.setProperty(AdropProperties.GENDER, AdropGender.MALE)

// 女性
AdropMetrics.setProperty(AdropProperties.GENDER, AdropGender.FEMALE)

// その他
AdropMetrics.setProperty(AdropProperties.GENDER, AdropGender.OTHER)

// 不明
AdropMetrics.setProperty(AdropProperties.GENDER, AdropGender.UNKNOWN)
性別定数
定数値説明
AdropGender.MALE"M"男性
AdropGender.FEMALE"F"女性
AdropGender.OTHER"O"その他
AdropGender.UNKNOWN"U"不明

​
年齢を直接設定

生年月日の代わりに年齢を直接設定することもできます。 
import AdropMetrics from 'adrop-ads-react-native/src/metrics/AdropMetrics'
import { AdropProperties } from 'adrop-ads-react-native/src/metrics/Property'

AdropMetrics.setProperty(AdropProperties.AGE, 30)
BIRTHまたはAGEのいずれかを設定すれば十分です。両方が設定されている場合、BIRTHが優先されます。

​
カスタムプロパティ

サービス用のカスタムプロパティを設定できます。カスタムプロパティは最初に広告管理コンソールのターゲティングメニューで定義する必要があります。 
import AdropMetrics from 'adrop-ads-react-native/src/metrics/AdropMetrics'

// ローカルアクティビティアプリの例
AdropMetrics.setProperty("region", "Tokyo")
AdropMetrics.setProperty("booking_count", 5)

// ショッピングモールアプリの例
AdropMetrics.setProperty("membership_tier", "gold")
AdropMetrics.setProperty("total_purchase_amount", 1500000)

// メディアアプリの例
AdropMetrics.setProperty("favorite_genre", "drama")
AdropMetrics.setProperty("is_premium_subscriber", true)
カスタムプロパティ名はコンソールで定義した名前と完全に一致する必要があります。大文字小文字を区別します。

​
プロパティ使用例

アプリにユーザーがログインした際のプロパティ設定例です。 
import React, { useEffect } from 'react'
import Adrop from 'adrop-ads-react-native'
import AdropMetrics from 'adrop-ads-react-native/src/metrics/AdropMetrics'
import { AdropProperties, AdropGender } from 'adrop-ads-react-native/src/metrics/Property'

const ProfileScreen = () => {
  useEffect(() => {
    // ユーザー情報を取得
    const user = getUserInfo()

    // UIDを設定
    Adrop.setUID(user.id)

    // 組み込みプロパティを設定
    AdropMetrics.setProperty(AdropProperties.BIRTH, user.birthDate)
    AdropMetrics.setProperty(AdropProperties.GENDER, user.gender)

    // カスタムプロパティを設定
    AdropMetrics.setProperty("membership_level", user.membershipLevel)
    AdropMetrics.setProperty("total_booking_count", user.bookingCount)
  }, [])

  return (
    // 画面コンポーネント
  )
}

export default ProfileScreen

​
ベストプラクティス

​
1. 広告ロード前にUIDを設定

// 正しい
Adrop.setUID("user_123")
// 広告をロード...

// 間違い
// 広告をロード...
Adrop.setUID("user_123") // 広告ロード後に設定するとターゲティングが適用されない

​
2. プロパティ変更時に更新

import AdropMetrics from 'adrop-ads-react-native/src/metrics/AdropMetrics'

const App = () => {
  useEffect(() => {
    // アプリ起動時に初期プロパティを設定
    updateUserProperties()
  }, [])

  const onUserPurchaseComplete = (purchaseAmount: number) => {
    // 購入完了時にプロパティを更新
    const currentTotal = getCurrentTotalPurchase()
    AdropMetrics.setProperty("total_purchase_amount", currentTotal + purchaseAmount)
  }

  const onMembershipUpgrade = (newTier: string) => {
    // メンバーシップアップグレード時にプロパティを更新
    AdropMetrics.setProperty("membership_tier", newTier)
  }

  // ...
}

​
3. ログアウト時にUIDをリセット

import Adrop from 'adrop-ads-react-native'
import AdropMetrics from 'adrop-ads-react-native/src/metrics/AdropMetrics'

const onUserLogout = () => {
  // UIDをリセット
  Adrop.setUID("")

  // 必要に応じてプロパティをリセット
  AdropMetrics.setProperty("membership_level", null)
  AdropMetrics.setProperty("total_booking_count", null)
}

​
関連ドキュメント

オーディエンスターゲティングの作成

コンソールでオーディエンスターゲティングを作成

ターゲティング販売

ターゲティングカテゴリ販売の設定

バナー広告

バナー広告の実装

ネイティブ広告

ネイティブ広告の実装

​
FAQ

UIDを設定しなくても広告は表示されますが、オーディエンスターゲティングは適用されません。デフォルトのターゲティング（国、言語など）のみが使用されます。正確なターゲティングにはUID設定が不可欠です。
プロパティデータは収集後24時間以内にコンソールに反映されます。データが表示されない場合：
  1. コンソールでプロパティが正しく定義されているか確認してください。
  2. SDKから渡されるプロパティキーがコンソールと完全に一致しているか確認してください（大文字小文字を区別）。
  3. 広告をロードする前にAdropMetrics.setProperty()が呼び出されているか確認してください。
プロパティ値にnullを渡すと削除できます：
AdropMetrics.setProperty("membership_level", null)
React Native SDKは現在、配列タイプを直接サポートしていません。必要に応じて、文字列に変換するか、複数の個別プロパティに分割してください。