Partager via

Service de recherche

Le service de recherche universelle facilite la recherche d’objets sans spécifier de type d’objet. Nous avons constaté que de nombreux clients utilisent des codes dans la convention de nommage des objets qui sont associés les uns aux autres et vous pouvez nous utiliser le service de recherche universel afin d’extraire tous les objets associés à ce code. Vous pouvez également utiliser le service de recherche universel pour rechercher des objets dans un certain type d’objet.

Remarque

Le service de recherche est différent du service de recherche, car il vous permet de rechercher des objets avec un nom, un code ou un ID spécifique. Le service de recherche retourne tous les objets d’un certain type dans votre compte.

Vous pouvez également rechercher et filtrer à l’aide de services individuels. Pour plus d’informations, consultez Sémantique de l’API.

Utilisation de la recherche sans paramètre

Si vous souhaitez rechercher des objets dans tous les types d’objets qui contiennent le terme « hairspray », vous pouvez le faire en publiant 'api.appnexus.com/search?q=hairspray'. Cette opération retourne les objets dont le nom, l’ID ou le code ont la raie de cheveux.

L’API retourne automatiquement les résultats pour les types d’objets suivants :

  • Annonceur
  • ordre d’insertion
  • éléments de ligne
  • Campagnes
  • Créatifs
  • segment pixels
  • pixels de conversion
  • Éditeurs
  • placements
  • sites

Utilisation de la recherche avec un paramètre

Si vous souhaitez utiliser la recherche universelle pour rechercher un certain type d’objet, vous pouvez inclure un paramètre : "type=creative".

Résultats de la recherche

Lorsque vous ne spécifiez pas un certain type d’objet, nous renvoyons 30 objets par type d’objet.

Remarque

Xandr indexe les 42 premiers caractères de chaque mot. Si un mot comporte plus de 42 caractères et que vous recherchez des caractères après le 42e, votre recherche ne renvoie pas les résultats que vous recherchez.

Exemple

Exemple d’extrait de code

Remarque

Le "weight" paramètre est une estimation très approximative de la correspondance de recherche, mais n’est pas fiable et doit être ignoré pour l’instant.

$ 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"
                    }
                ]
            }
        }
    }
}
  • Last updated on