Compartir a través de

Servicio de reglas de calidad de anuncios

  • Artículo

Una regla de calidad de anuncios define la configuración de calidad del anuncio que una red puede definir para sus publicadores administrados. Una red puede tener más de una regla de calidad de anuncios aplicada condicionalmente en el inventario de un publicador. Por ejemplo, el tráfico que se origina desde determinadas ubicaciones geográficas puede requerir una configuración de calidad de anuncio diferente.

API de REST

Nota:

  • publisher_code se puede usar en lugar de publisher_idy ad_quality_rule_code se puede usar en lugar de ad_quality_rule_id para todas las llamadas siguientes.
  • Si una calidad de anuncio (AQ) se establece como "default_brand_status": "banned" pero la marca primaria se establece como "status": "trusted", la marca secundaria invalida la configuración en "default_brand_status" y podrá servir a menos que se prohíba explícitamente en la lista de invalidación de marca del perfil de anuncio.
Http (método) Endpoint Description
POST https://api.appnexus.com/ad-quality-rule?publisher_id=PUBLISHER_ID
(JSON de regla de pago)		 Agregue una regla de calidad de anuncios.
PUT https://api.appnexus.com/ad-quality-rule?id=AD_QUALITY_RULE_ID&p ublisher_id=PUBLISHER_ID
(JSON de regla de publicador)		 Modifique una regla de calidad de anuncios existente.
GET https://api.appnexus.com/ad-quality-rule?publisher_id=PUBLISHER_ID Ver todas las reglas de calidad de anuncios de un publicador.
GET https://api.appnexus.com/ad-quality-rule?id=AD_QUALITY_RULE_ID Ver una regla de calidad de anuncios específica para un publicador.
GET https://api.appnexus.com/ad-quality-rule?id=1,2,3 Vea varias reglas de calidad de anuncios por identificador mediante una lista separada por comas.

Parámetros JSON

Parámetro Tipo Descripción
id Entero Identificador único de una regla de calidad de anuncios.
Predeterminado: Número incrementado automáticamente (es decir, 123).
Obligatorio activado:PUT
code string Código personalizado opcional que se usa para hacer referencia a una regla de calidad de anuncios.
Predeterminado: Nulo
name string Nombre que se usa para describir una regla de calidad de anuncios.
Predeterminado: Ninguno
Obligatorio activado:POST
description string Descripción opcional.
ad_profile_id Entero Debe proporcionar un perfil de anuncio que defina las restricciones de calidad que se deben aplicar a esta regla.
Obligatorio activado:POST
publisher_id Entero Identificador del publicador al que se aplicará esta regla de calidad de anuncios.
Obligatorio activado:POST y PUT
member_id Entero Identificador del miembro del publicador para el que se aplicará esta regla de calidad de anuncios.
profile_id Entero Se usa un opcional profile_id para determinar cuándo aplicar una regla de calidad de anuncios. Un perfil es un conjunto genérico de reglas para segmentar el inventario y ciertas reglas de calidad de anuncios solo se pueden aplicar a determinados segmentos del inventario. Para obtener más información, consulte El servicio de perfiles.
priority Entero Opcionalmente, puede proporcionar una prioridad que defina el nivel en el que debe aplicarse esta regla en relación con otras reglas de pago.
Valor predeterminado: 5
last_modified Timestamp Hora de la última modificación de esta regla de calidad de anuncios.

Ejemplos

Definición de una regla de calidad de anuncios

$ cat ad-quality-rule.json
{"ad-quality-rule":
      {
        "name": "Default Ad Quality Rule",
        "description": "These quality standards will serve as the catch-all settings for this publisher",
        "active": true,
        "publisher_id": 34147,
        "ad_profile_id": 32,
        "profile_id": null,
        "priority": 1
      }
}

POST la regla de calidad de anuncios para un publicador

$ curl -s -c cookies -b cookies -X POST -d @ad-quality-rule.json "https://api.appnexus.com/ad-quality-rule?publisher_id=34147" | json_reformat
{
  "response": {
    "status": "OK",
    "id": 103679,
    "dbg_info": {
      ...
    }
  }
}

Visualización de una regla de calidad de anuncios específica

$ curl -s -c cookies -b cookies "https://api.appnexus.com/ad-quality-rule?id=103679" | json_reformat
{
  "response": {
    "status": "OK",
    "ad-quality-rule": {
      "id": 103679,
      "code": null,
      "name": "Default Ad Quality Rule",
      "description": "These quality standards will serve as the catch-all settings for this publisher",
      "active": true,
      "publisher_id": 34147,
      "ad_profile_id": 32,
      "profile_id": 0,
      "priority": 1
    },
    "dbg_info": {
      ...
    }
  }
}