Compartir a través de

Servicio de búsqueda

  • Artículo

El servicio de búsqueda universal facilita la búsqueda de objetos sin especificar un tipo de objeto. Hemos detectado que muchos clientes usan códigos en la convención de nomenclatura de objetos que están asociados entre sí y que puede usar el servicio de búsqueda universal para extraer todos los objetos asociados a ese código. También puede usar el servicio de búsqueda universal para buscar objetos dentro de un tipo de objeto determinado.

Nota:

El servicio de búsqueda es diferente del servicio de búsqueda porque permite buscar objetos con un nombre, código o identificador específicos. El servicio lookup devuelve todos los objetos de un tipo determinado en la cuenta.

También puede buscar y filtrar mediante servicios individuales. Para obtener más información, consulte Semántica de API.

Uso de búsqueda sin parámetros

Si desea buscar objetos en todos los tipos de objetos que tengan el término "hairspray" en ellos, puede hacerlo publicando 'api.appnexus.com/search?q=hairspray'. Esto devolverá objetos que tengan hairspray en el nombre, el identificador o el código.

La API devolverá automáticamente los resultados de los siguientes tipos de objeto:

  • Anunciante
  • orden de inserción
  • elementos de línea
  • Campañas
  • Creativos
  • píxeles de segmento
  • píxeles de conversión
  • Editores
  • Colocaciones
  • sitios

Uso de la búsqueda con un parámetro

Si desea usar la búsqueda universal para buscar un tipo de objeto determinado, puede incluir un parámetro: "type=creative".

Resultados de la búsqueda

Cuando no se especifica un tipo de objeto determinado, se devolverán 30 objetos por tipo de objeto.

Nota:

Xandr indexa los primeros 42 caracteres de cada palabra. Si una palabra individual tiene más de 42 caracteres y busca caracteres después del 42, la búsqueda no devolverá los resultados que está buscando.

Ejemplo

Fragmento de código de ejemplo

Nota:

El "weight" parámetro es una estimación muy aproximada de la coincidencia de búsqueda, pero no es confiable y se debe omitir por ahora.

$ curl -b cookies -c cookies 'https://api.appnexus.com/search?type=advertiser&q=test'
{
    "response": {
        "status": "OK",
        "num_elements": 3,
        "start_element": 0,
        "results": {
            "advertiser": {
                "num_elements": 3,
                "results": [
                    {
                        "id": "40543",
                        "weight": "1539",
                        "name": "Test Advertiser 001",
                        "code": "",
                        "member_id": "1173",
                        "state": "active"
                    },
                    {
                        "id": "40737",
                        "weight": "1539",
                        "name": "Test Advertiser 002",
                        "code": "",
                        "member_id": "1173",
                        "state": "active"
                    },
                    {
                        "id": "41351",
                        "weight": "1539",
                        "name": "Contest Advertiser",
                        "code": "",
                        "member_id": "1173",
                        "state": "active"
                    }
                ]
            }
        }
    }
}