Partager via

Service de règle de qualité des annonces

Une règle de qualité des annonces définit les paramètres de qualité des annonces qu’un réseau peut définir pour ses éditeurs managés. Un réseau peut avoir plusieurs règles de qualité publicitaire appliquées de manière conditionnelle dans l’inventaire d’un éditeur. Par instance, le trafic provenant de certains emplacements géographiques peut nécessiter des paramètres de qualité publicitaire différents.

API REST

Remarque

  • publisher_code peut être utilisé à la place de publisher_id, et ad_quality_rule_code peut être utilisé à la place de ad_quality_rule_id pour tous les appels ci-dessous.
  • Si une qualité d’annonce (AQ) est définie comme mais que "default_brand_status": "banned" la marque parente est définie sur "status": "trusted", la marque enfant remplace le paramètre dans "default_brand_status" et peut servir, sauf si elle est explicitement interdite dans la liste de remplacement de marque du profil publicitaire.
HTTP, méthode Endpoint Description
POST https://api.appnexus.com/ad-quality-rule?publisher_id=PUBLISHER_ID
(règle de paiement JSON)		 Ajoutez une règle de qualité des annonces.
PUT https://api.appnexus.com/ad-quality-rule?id=AD_QUALITY_RULE_ID&p ublisher_id=PUBLISHER_ID
(json de règle d’éditeur)		 Modifier une règle de qualité d’annonce existante.
GET https://api.appnexus.com/ad-quality-rule?publisher_id=PUBLISHER_ID Afficher toutes les règles de qualité des publicités pour un éditeur.
GET https://api.appnexus.com/ad-quality-rule?id=AD_QUALITY_RULE_ID Afficher une règle de qualité publicitaire spécifique pour un éditeur.
GET https://api.appnexus.com/ad-quality-rule?id=1,2,3 Affichez plusieurs règles de qualité des publicités par ID à l’aide d’une liste séparée par des virgules.

Paramètres JSON

Paramètre Type Description
id int Identificateur unique d’une règle de qualité publicitaire.
Par défaut: Nombre incrémenté automatiquement (c’est-à-dire 123).
Obligatoire sur :PUT
code string Code personnalisé facultatif utilisé pour référencer une règle de qualité des annonces.
Par défaut: Null
name string Nom utilisé pour décrire une règle de qualité publicitaire.
Par défaut: Aucun
Obligatoire sur :POST
description string Description facultative.
ad_profile_id int Vous devez fournir un profil publicitaire qui définit des restrictions de qualité qui doivent être appliquées à cette règle.
Obligatoire sur :POST
publisher_id int ID de l’éditeur auquel cette règle de qualité des annonces s’appliquera.
Obligatoire sur :POST Et PUT
member_id int ID du membre de l’éditeur auquel cette règle de qualité publicitaire s’applique.
profile_id int Un facultatif profile_id est utilisé pour déterminer quand appliquer une règle de qualité des annonces. Un profil est un ensemble générique de règles permettant de cibler l’inventaire, et certaines règles de qualité publicitaire peuvent s’appliquer uniquement à certaines tranches d’inventaire. Pour plus d’informations, consultez service de profil.
priority int Vous pouvez éventuellement fournir une priorité qui définit le niveau auquel cette règle doit être appliquée par rapport à d’autres règles de paiement.
Valeur par défaut : 5
last_modified Timestamp Heure de la dernière modification de cette règle de qualité publicitaire.

Exemples

Définir une règle de qualité des annonces

$ 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 règle de qualité des annonces pour un éditeur

$ 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": {
      ...
    }
  }
}

Afficher une règle de qualité des annonces spécifique

$ 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": {
      ...
    }
  }
}
  • Last updated on