メインコンテンツへスキップ
POST
https://api-v2.adrop.io
/
property
ターゲティング設定
curl --request POST \
  --url https://api-v2.adrop.io/property \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "uid": "<string>",
  "value": "<string>",
  "platform": "<string>",
  "adid": "<string>"
}
'
{
    "code": 0,
    "msg": "OK"
}
ターゲティングを使用すると、特定のユーザーグループやコンテキストに合った広告を表示できます。REST APIではオーディエンスターゲティングとコンテキストターゲティングの両方をサポートしています。

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

ユーザー属性に基づいて広告をターゲティングします。

​
リクエストパラメータ

​
Authorization
string
required
App Key（adrop_service.jsonで確認）
​
Content-Type
string
required
application/json
​
uid
string
required
ユーザー固有識別子
​
value
string
required
属性データ（JSON文字列）。プリセットおよびカスタム属性を含む
​
platform
string
プラットフォーム。例：web、android、ios
​
adid
string
広告識別子（ADID/IDFA）

​
レスポンス

​
code
integer
レスポンスコード。0は成功
​
msg
string
レスポンスメッセージ
{
    "code": 0,
    "msg": "OK"
}

​
プリセット属性

Adropで事前に定義された標準属性です。すべてのSDKとREST APIで同じ形式を使用します。

​
生年月日（BIRTH）

キー値の例形式
BIRTH2024yyyy（年のみ）
BIRTH202401yyyyMM（年月）
BIRTH20240101yyyyMMdd（完全な日付）

​
性別（GDR）

キー値意味
GDRM男性（Male）
GDRF女性（Female）
GDROその他（Other）

​
不明な値

キー値説明
*Uすべての属性で「不明」を表す場合に使用
プリセット属性キーは大文字を使用します：BIRTH、GDR

​
カスタム属性

コンソールで定義したカスタム属性を使用できます。

​
カスタム属性の設定

  1. Adropコンソールでターゲティングメニューに移動
  2. オーディエンスターゲティングタブでカスタム属性を作成
  3. APIでそのキー・値で属性を送信
const properties = {
    // プリセット属性
    BIRTH: '19931225',
    GDR: 'M',

    // カスタム属性（コンソールで定義）
    membership: 'premium',
    lastPurchaseDate: '2024-01-15',
    favoriteCategory: 'electronics'
};
カスタム属性のすべての値は文字列（STRING）タイプです。

​
コンテキストターゲティング

ページやコンテンツのコンテキストに応じて広告をターゲティングします。広告リクエスト時にcontextIdパラメータを追加します。

​
コンテキストターゲティングの設定

  1. Adropコンソールでターゲティングメニューに移動
  2. コンテキストターゲティングタブでコンテキストを作成
  3. 広告リクエスト時にcontextIdパラメータを使用

​
広告リクエストへのコンテキスト適用

GET https://api-v2.adrop.io/request?unit=YOUR_UNIT_ID&contextId=sport

const axios = require('axios');

const config = {
    method: 'get',
    baseURL: 'https://api-v2.adrop.io',
    url: '/request',
    params: {
        unit: 'YOUR_UNIT_ID',
        uid: 'USER_ID',
        pf: 'web',
        contextId: 'sport'  // コンソールで作成したコンテキストID
    },
    headers: {
        'Authorization': 'YOUR_APP_KEY'
    }
};

axios.request(config)
    .then((response) => {
        console.log(JSON.stringify(response.data));
    })
    .catch((error) => {
        console.log(error);
    });

​
ベストプラクティス

ユーザーIDの一貫性

同じユーザーには常に同じuidを使用してください。一貫したIDは正確なターゲティングの鍵です。

属性の更新

ユーザー情報が変更されたら、すぐに/propertyエンドポイントを呼び出して更新してください。

プリセット形式の遵守

BIRTHとGDR属性は、定められた形式を正確に使用する必要があります。

コンテキストの活用

ニュース、スポーツ、ショッピングなどのページ性格に合ったコンテキストターゲティングを活用してください。

​
関連ドキュメント

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

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

コンテキストターゲティング

コンソールでコンテキストターゲティングを設定