携帯電話会社は、無線通信事業者またはモバイル ネットワーク運営者とも呼ばれ、モバイル デバイスのユーザーに無線通信サービスを販売および提供するために必要なすべての要素を所有または管理します。 読み取り専用の携帯電話会社サービスでは、どの携帯電話会社がシステムに登録されているかを確認できます。 このサービスを使用すると、モバイル キャンペーンでターゲティングを行う通信事業者の ID を取得できます。
注:
モバイル デバイスのメーカーやモデルに基づいてモバイル キャンペーンをターゲットとすることもできます。 詳細については、 デバイス作成サービス および デバイス モデル サービスを参照してください。
REST API
| HTTP メソッド | エンドポイント | 説明 |
|---|---|---|
GET |
https://api.appnexus.com/carrier | すべての通信事業者の表示。 |
GET |
https://api.appnexus.com/carrier?country_code=COUNTRY_CODE | 特定の国または地域のすべての通信事業者を表示します。 |
GET |
https://api.appnexus.com/carrier?id=CARRIER_ID | 特定の通信事業者を表示します。 |
GET |
https://api.appnexus.com/carrier/meta | フィルター処理と並べ替えの基準にされるフィールドを確認します。 |
JSON フィールド
| フィールド | 種類 | 説明 |
|---|---|---|
id |
int | 携帯電話会社の ID。 |
name |
string | 携帯電話会社の名前。 |
country_code |
列挙 | 運送業者が運航する国または地域の ISO コード 。 |
country_name |
string | 通信事業者が運航する国または地域の名前。 |
codes |
オブジェクトの配列 | 携帯電話会社のサード パーティの代理。 詳細については、以下の Codes オブジェクト を参照してください。 |
Codes オブジェクト
codes 配列の各オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 |
|---|---|---|
id |
int | 通信事業者コードの ID。 |
code |
string | 通信事業者のサード パーティの代理。 |
notes |
string | サード パーティに関する識別情報。 |
carrier_id |
int | 通信事業者の ID。 (これは、上記の id フィールドと同じです。) |
例
すべての携帯電話会社を表示
{code}$ curl -b cookies -c cookies 'https://api.appnexus.com/carrier'
{
"response": {
"status": "OK",
"count": 143,
"start_element": null,
"num_elements": 10,
"carriers": [
{
"id": 1,
"name": "WIFI",
"country_code": "",
"is_aggregated": false,
"codes": null
},
{
"id": 2,
"name": "Verizon - AR",
"country_code": "AR",
"is_aggregated": true,
"codes": null
},
{
"id": 3,
"name": "Verizon - AU",
"country_code": "AU",
"is_aggregated": true,
"codes": null
},
{
"id": 4,
"name": "Verizon - CA",
"country_code": "CA",
"is_aggregated": true,
"codes": null
},
{
"id": 5,
"name": "Verizon - DE",
"country_code": "DE",
"is_aggregated": true,
"codes": null
},
{
"id": 6,
"name": "Verizon - FR",
"country_code": "FR",
"is_aggregated": true,
"codes": null
},
{
"id": 7,
"name": "Verizon - GB",
"country_code": "GB",
"is_aggregated": true,
"codes": null
},
...
],
}
}
{code}
米国内のすべての携帯電話会社を表示
{code}$ curl -b cookies -c cookies 'https://api.appnexus.com/carrier?country_code=US'
{
"response": {
"status": "OK",
"count": 7,
"start_element": null,
"num_elements": null,
"carriers": [
{
"id": 14,
"name": "Verizon - US",
"country_code": "US",
"is_aggregated": true,
"codes": null
},
{
"id": 26,
"name": "Sprint - US",
"country_code": "US",
"is_aggregated": true,
"codes": null
},
{
"id": 40,
"name": "Orange - US",
"country_code": "US",
"is_aggregated": true,
"codes": null
},
{
"id": 55,
"name": "T-Mobile - US",
"country_code": "US",
"is_aggregated": true,
"codes": null
},
{
"id": 60,
"name": "AT&T - US",
"country_code": "US",
"is_aggregated": true,
"codes": null
},
{
"id": 90,
"name": "Vodafone - US",
"country_code": "US",
"is_aggregated": true,
"codes": null
},
{
"id": 108,
"name": "Telefonica - US",
"country_code": "US",
"is_aggregated": true,
"codes": null
}
]
}
}
{code}
特定の携帯電話会社を表示する
{code}
$ curl -b cookies -c cookies 'https://api.appnexus.com/carrier?id=1'
{
"response": {
"status": "OK",
"count": 1,
"start_element": null,
"num_elements": null,
"carriers": [
{
"id": 1,
"name": "WIFI",
"country_code": null,
"codes": null
}
]
}
}
{code}