Servicio de estado de auditoría de dominio

Artículo
05/18/2024

El servicio de estado de auditoría de dominio le permite comprobar si los dominios específicos están en la plataforma Xandr y, si lo están, cómo los ha clasificado Xandr. Este servicio es especialmente útil para los vendedores que están interesados en migrar dominios a la plataforma, pero primero quieren asegurarse de que Xandr no haya rechazado los dominios. Además, dado que los dominios auditados suelen ver más relleno, los vendedores pueden usar este servicio para identificar los dominios que ya están en la plataforma que les gustaría que Xandr auditase.

Aquí se muestra cómo funciona:

Un POST archivo JSON que contiene los dominios que le interesan. El formato JSON debe tener el siguiente formato:
```
{"urls": ["URL1.com","URL2.com","URL3.de"]}
```
Nota:

Xandr no almacena el prefijo "https://" o "www." para dominios. Dado que este servicio buscará los dominios exactamente tal como se escriben en el JSON, por lo tanto, es mejor no incluir estos prefijos en los dominios que desea comprobar.
La respuesta muestra si cada dominio está en la plataforma Xandr y, si es así, cómo lo ha auditado Xandr. Para obtener la lista completa de detalles proporcionados sobre cada dominio en la respuesta, consulte Campos JSON a continuación.

API de REST

Http (método)	Endpoint	Description
`POST`	`https://api.appnexus.com/url-audit-search`	Visualización del estado de auditoría de uno o varios dominios Nota: Se trata de un servicio de solo lectura. Aunque es `POST` un archivo JSON, no se crea ningún objeto en el sistema.

Campos JSON

En el caso de los dominios de la plataforma Xandr, todos los campos siguientes se mostrarán en la respuesta. En el caso de los dominios que no están en la plataforma Xandr, solo se mostrarán los url campos y found (con un valor de false) en la respuesta.

Campo	Tipo	Description
`audit_datetime`	Timestamp	Fecha y hora en que Xandr auditó el dominio.
`audit_status`	enumeración	Estado de auditoría del dominio. Posibles valores: - `audited` - El dominio ha superado la auditoría de Xandr. - `rejected` - La aplicación de dominio ha producido un error en la auditoría de Xandr (debido a infracciones de directiva de Xandr). - `unaudited` - No se auditó el dominio. - `unauditable` - El dominio no se puede auditar. - `pending` - La auditoría Xandr sigue pendiente para el dominio (valor predeterminado). - `is_adserver` - El dominio no se auditó y se detectó como un dominio de servidor de anuncios.
`content_category_id`	Entero	Categoría de contenido del dominio, determinada por Xandr. Si `audit_status` es `"rejected"`, será `null`. Puede usar el servicio de categoría de contenido de solo lectura para ver más detalles sobre categorías de contenido específicas.
`found`	booleano	Si `true`es , el dominio está en la plataforma Xandr.
`id`	Entero	Identificador Xandr del dominio.
`intended_audience`	enumeración	Audiencia prevista del dominio, según lo determinado por Xandr. Posibles valores: - `"mature"` - `"young_adult"` - `"children"` - `"general"`. Si `audit_status` es `"rejected"`, será `null`.
`reason`	string	Si `audit_status` es `"rejected"` o `"unauditable"`, el motivo proporcionado por Xandr. Cualquier otro estado, este campo estará en blanco.
`url`	string	Dominio.

Ejemplos

Visualización de información sobre dos dominios en la plataforma

$ cat urls
{
    "urls": ["goodurl.com","badurl.com"]
}
$ curl -b cookies -c cookies -X POST -d @urls 'https://api.appnexus.com/url-audit-search'
{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": 0,
        "num_elements": 100,
        "urls": [
            {
                "id": 3456,
                "url": "goodurl.com",
                "reason": null,
                "content_category_id": 8380,
                "intended_audience": "general",
                "audit_status": "audited",
                "audit_datetime": null,
                "found": true
            },
            {
                "id": 2194,
                "url": "badurl.com",
                "reason": "Landing page contains an excessive number or density of units",
                "content_category_id": null,
                "intended_audience": null,
                "audit_status": "rejected",
                "audit_datetime": null,
                "found": true
            }
        ]
    }
}

Ver información sobre dos dominios que no están en la plataforma

$ cat urls
{
    "urls": ["not-there1.com","not-there2.com"]
}
$ curl -b cookies -c cookies -X POST -d @urls 'https://api.appnexus.com/url-audit-search'
{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": null,
        "num_elements": null,
        "urls": [
            {
                "url": "not-there1.com",
                "found": false
            },
            {
                "url": "not-there2.com",
                "found": false
            }
        ]
    }
}

Determinar qué dominios de una lista se han auditado

En este ejemplo, se buscan dos dominios (auditedurl.com y notauditedurl.com). Ambos dominios están en la plataforma, pero la información solo se devuelve para el que cumple los criterios de cadena de consulta (audit_status=audited). El dominio que no cumple los criterios de consulta se sigue devolviendo en los resultados, pero con un found valor de false porque no se encontró con la consulta especificada.

$ cat urls
{
    "urls": ["auditedurl.com","notauditedurl.com"]
}
$ curl -b cookies -c cookies -X POST -d @urls 'https://api.appnexus.com/url-audit-search?audit_status=audited'
{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": 0,
        "num_elements": 100,
        "urls": [
            {
                "id": 3456,
                "url": "auditedurl.com",
                "reason": null,
                "content_category_id": 8380,
                "intended_audience": "general",
                "audit_status": "audited",
                "audit_datetime": null,
                "found": true
            },
            {
                "id": 7890,
                "found": false
            }
        ]
    }
}

Compartir a través de