Device Model Targeting API

Version 1.0 / January 2016

Device Model Targeting APIは、キャンペーンの対象または対象外とする端末モデルのセットを作成する広告主のお客様向けの機能です。

device targeting API一覧

List –現在の端末リストまたは指定のリストの特定の端末を一覧化

Create  –新規の端末リストを作成する

Append  –既存リストに新たな端末を追加する

Delete  –指定の端末リストを削除する

Delete Device  –特定のリストから指定の端末を削除する

認証

このAPIでは、リクエストのクエリパラメータとしてAPI Keyを提出する必要があります。Audience APIとDevice Model APIの認証で使われるManagement Keyは広告主のお客様のアカウントページの'Keys'のタブにあります。Management Keyが表示されない場合は、お手数ですがサポートチーム（adsupport@applovin.com）までご連絡ください。

https://api.applovin.com/devices/list?api_key=<API_KEY>

エラー

エラー表示にはHTTPステータスコードが使用されています。

作成

アプリリストを提出するにはまず新しいリストを作成します。新規リスト作成には以下のHTTPリクエストを送信してください。

https://api.applovin.com/devices/create?api_key=<API_KEY>

create APIは、URLエンコードのクエリパラメータとして次のフィールドを受理します。

レスポンスのフォーマットはJSONです。

リクエスト例：

curl "https://api.applovin.com/devices/create?name=My%20Devices&api_key=<API_KEY>"

レスポンス例：

{"device_list_id" : "fce0b41a0849706bd0fbbe181e61f419"}

リスト

全ての最新の端末リストの一覧を入手するには、次のList APIリクエストを送ってください。  

https://api.applovin.com/devices/list?api_key=<API_KEY>

レスポンスのフォーマットはJSONです。

リクエスト例：

curl "https://api.applovin.com/devices/list?api_key=<API_KEY>"

レスポンス例：

{
"code": 200,
"device_lists": [
{
"device_list_id": "dab2d1297d35592597b0eee016e92baa",
"name": "List Test",
"description": "Test Custom Device List",
"device_count": 3
}
],
"count": 1
}

リスト（端末リストIDで指定）

指定の端末リストにある端末の一覧を入手するには、次のHTTPリクエストをdevice_list_id parameterを含めてList APIに送ってください。

https://api.applovin.com/devices/update?api_key=<API_KEY>&device_list_id=<DEVICE_LIST_ID> 

クエリパラメータ

レスポンスのフォーマットはJSONです。

リクエスト例：

curl "https://api.applovin.com/devices/list?api_key=<API_KEY>&device_list_id=fce0b41a0849706bd0fbbe181e61f419"

レスポンス例：

{
"code": 200,
"devices": [
{
"device":"SM-G900F"
},
{
"device":"SM-G900FD"
}
],
"count": 2
}

追加

既存リストに端末を追加するには、次のHTTP POSTを送ってください

https://api.applovin.com/devices/append?api_key=<API_KEY>&device_list_id=<DEVICE_LIST_ID>

注：端末名は特定のフォーマットにする必要があります。フォーマットの一覧はこちらをご覧ください。

クエリパラメータ

Post Body: Append APIはPOSTリクエストによる行区切りのIDのリストを受理します

レスポンスのフォーマットはJSONです。

リクエスト例：

curl -X POST --data-binary @devices.txt "https://api.applovin.com/devices/append?device_list_id=<DEVICE_LIST_ID>&api_key=<API_KEY>"

devices.txtは次のような形式で記載されます。

SM-J100H
HUAWEI Y520-U03

レスポンス例：

{ "device_list_id" : “dab2d1297d35592597b0eee016e92baa”, "processed_devices" : 2, "failed_devices" : 0 }

削除

端末リストを削除するには、次のようなHTTPリクエストを送ってください。

https://api.applovin.com/devices/delete?api_key=<API_KEY>&device_list_id=<DEVICE_LIST_ID> 

クエリパラメータ

Delete APIのレスポンス本文はありません。成功した場合は、HTTPレスポンスコードの200が返ってきます。

リクエスト例：

curl "https://api.applovin.com/devices/delete?device_list_id=<DEVICE_LIST_ID>&api_key=<API_KEY>"

端末を削除する（リストから端末を削除）

既存リストから端末を削除するには、次のようなHTTP POSTを送ってください。

https://api.applovin.com/devices/deleteDevices?api_key=<API_KEY>&device_list_id=<DEVICE_LIST_ID>

クエリパラメータ

Post Body：Append APIは行区切りのIDのリストを受理します

レスポンスのフォーマットはJSONです。

リクエスト例：

curl -X POST --data-binary @devices.txt "https://api.applovin.com/devices/deleteDevices?device_list_id=<DEVICE_LIST_ID>&api_key=<API_KEY>"

devices.txtは次のような形で記載されます。

SM-J100H
HUAWEI Y520-U03

レスポンス例：

{ "device_list_id" : “dab2d1297d35592597b0eee016e92baa”, "processed_devices" : 2, "failed_devices" : 0 }

端末リストにキャンペーンをターゲティングする

端末リストが作成されると、全てのキャンペーンに関してターゲットを編集するオプションが選べるようになります。

• AppLovin Device API.postman_collection.json4 KB