Digital Platform API - Carrier サービス

  • [アーティクル]

携帯電話会社は、ワイヤレス 通信事業者またはモバイル ネットワークオペレーターとも呼ばれ、モバイル デバイスのユーザーにワイヤレス 通信サービスを販売および提供するために必要なすべての要素を所有または制御します。 読み取り専用の携帯電話会社サービスを使用すると、当社のシステムに登録されている携帯電話会社を確認できます。 このサービスを使用すると、モバイル キャンペーンでターゲット設定を行う通信事業者の ID を取得できます。

注:

モバイル デバイスの作成とモデルに基づいて、モバイル キャンペーンをターゲットにすることもできます。 詳細については、「 Device Make Service 」および「 Device Model Service」を参照してください。

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 各オブジェクトには、次のフィールドが含まれています。

フィールド 種類 説明
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}