デジタル プラットフォーム API - キャリア サービス

携帯電話会社は、無線通信事業者またはモバイル ネットワーク運営者とも呼ばれ、モバイル デバイスのユーザーに無線通信サービスを販売および提供するために必要なすべての要素を所有または管理します。 読み取り専用の携帯電話会社サービスでは、どの携帯電話会社がシステムに登録されているかを確認できます。 このサービスを使用すると、モバイル キャンペーンでターゲティングを行う通信事業者の 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}