API de plataforma digital: servicio de país

El servicio de país de solo lectura le permite ver información sobre los países/regiones registrados en el sistema Xandr. Puede utilizar este servicio para recuperar el identificador de segmentación en las campañas (ver country_targets en el Servicio de perfiles).

API de REST

Método HTTP Endpoint Description
GET https://api.appnexus.com/country Ver todos los países o regiones.
GET https://api.appnexus.com/country?id=ID Ver un país o región específicos por identificador.
GET https://api.appnexus.com/country?name=NAME Ver un país o región específicos por NOMBRE.
GET https://api.appnexus.com/country?code=CODE Ver un país/región específico por CÓDIGO.
GET https://api.appnexus.com/country/meta Obtenga información sobre los campos por los que puede filtrar y ordenar.

Campos JSON

Campo Tipo Descripción
id Entero El identificador del país o región.
name string Nombre del país/región.
code string El código ISO del país o la región.
active Booleano Si es verdadero, el país o la región están disponibles para la segmentación. Si es falso, no hay datos de geolocalización para el país o región, por lo que no es posible la entrega.

Ejemplos

Ver todos los países o regiones

$ curl -b cookies -c cookies 'https://api.appnexus.com/country'
{
    "response": {
        "status": "OK",
        "count": 250,
        "start_element": null,
        "num_elements": null,
        "countries": [
            {
                "id": 1,
                "name": "Anonymous Proxy",
                "code": "A1",
                "active": true
            },
            {
                "id": 2,
                "name": "Satellite Provider",
                "code": "A2",
                "active": true
            },
            {
                "id": 3,
                "name": "Other Country",
                "code": "O1",
                "active": true
            },
            ...
        ]
    }
}

Ver un país o región específicos por identificador

$ curl -b cookies -c cookies 'https://api.appnexus.com/country?id=59'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": null,
        "num_elements": null,
        "country": {
            "id": 59,
            "name": "Germany",
            "code": "DE",
            "active": true
        }
    }
}

Ver un país o región específico por código

$ curl -b cookies -c cookies 'https://api.appnexus.com/country?code=DE'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": null,
        "num_elements": null,
        "countries": [
            {
                "id": 59,
                "name": "Germany",
                "code": "DE",
                "active": true
            }
        ]
    }
}

Ver todos los países o regiones que contienen "Unidos" en sus nombres

$ curl -b cookies -c cookies 'https://api.appnexus.com/country?like_name=United'
{
    "response": {
        "status": "OK",
        "count": 5,
        "start_element": null,
        "num_elements": null,
        "countries": [
            {
                "id": 5,
                "name": "United Arab Emirates",
                "code": "AE",
                "active": true
            },
            {
                "id": 80,
                "name": "United Kingdom",
                "code": "GB",
                "active": true
            },
            {
                "id": 229,
                "name": "Tanzania, United Republic of",
                "code": "TZ",
                "active": true
            },
            {
                "id": 232,
                "name": "United States Minor Outlying Islands",
                "code": "UM",
                "active": true
            },
            {
                "id": 233,
                "name": "United States",
                "code": "US",
                "active": true
            }
        ]
    }
}
  • Last updated on