Partager via

Soumissionnaires - Service de recherche créative

Ce service en lecture seule vous permet de rechercher des créations en fonction de critères spécifiques tels que les status d’audit, l’ID, la taille, etc. Pour ajouter des créations au système, consultez le Service créatif.

Avertissement

Étant donné que ce service recherche tous les éléments créatifs sur la plateforme de Xandr (pas seulement la vôtre), une recherche trop large peut entraîner une erreur. Pour vous assurer que vous obtenez des résultats, veuillez affiner votre recherche autant que possible.

Implémentation

API REST

Méthode HTTP Point de fin Description
POST [https://api..com/creative-search](https://api..com/creative-search) (creative_search JSON) Pour rechercher des créatifs.
POST [https://api..com/creative-search?sort=FIELD_NAME.ASC_OR_DESC](https://api..com/creative-search?sort=FIELD_NAME.ASC_OR_DESC) (creative_search JSON) Recherchez des créations et triez les résultats.
Remarque : Les champs utilisés pour rechercher des créations ne sont pas exactement les mêmes que les champs retournés. Cela est dû au fait que les objets retournés sont dessinés à partir du service créatif et mis en forme en conséquence. Ce service recherche uniquement les créations actives.

Champs JSON

Champ Type Sorte? Utilisation
ad_profile_id int Non Doit être utilisé avecbrand_status. Recherchez un créatif par l’ID de son profil publicitaire.
audit_status tableau d’énumération Oui Recherchez des créatifs par leur status d’audit. Valeurs possibles : « no_audit », « en attente », « rejeté », « audité ».
brand_ids tableau d’entiers Non Recherchez des créatifs par les ID de leurs marques.
brand_status tableau d’énumération Non Doit être utilisé avecad_profile_id. Recherchez des créatifs par leur marque status. Par exemple, si ce paramètre est défini sur « approuvé », toutes les marques approuvées dans les profils publicitaires spécifiés dans ad_profile_id seront retournées dans la réponse. Valeurs possibles : « approuvé », « cas par cas », « interdit ». Le champ marque status est retourné uniquement dans la réponse lorsque vous utilisez ce filtre.
click_url string Oui Pas un filtre. Trier les résultats dans l’ordre de clic alphabétique croissant/décroissant de l’URL.
creative_ids tableau d’entiers Oui, utilisez « id » dans la chaîne de requête. Recherchez des créatifs par leur ID.
description string Non Recherchez des créatifs par termes dans leurs descriptions.
formats tableau d’énumération Oui, utilisez « format » dans la chaîne de requête. Recherchez des créatifs par leur format. Valeurs possibles : « url-html », « url-js », « flash », « image », « raw-js », « raw-html », « iframe-html », « url-vast », « text ».
landing_page_url string Oui Pas un filtre. Trie les résultats dans l’ordre croissant/décroissant de l’URL de la page d’accueil alphabétique.
media_content string Non Recherchez un créatif par les données dans son champ original_content (voir Creative Service).
media_subtype tableau d’énumération Non Déconseillé, utilisezmedia_subtype_ids à la place. Recherchez des créatifs selon leurs sous-types de médias. Valeurs possibles : « Bannière », « Popup », « Popunder ».
media_subtype_ids tableau d’entiers Oui, utilisez « media_subtype_id » dans la chaîne de requête. Recherchez des créatifs par leur sous-type de média via l’ID. Vous pouvez utiliser le service de sous-type multimédia pour rechercher les ID souhaités.
media_url string Oui Recherchez un créatif par son URL.
member_action enum Non Doit être utilisé avecmember_ids. Si cette valeur est définie sur « exclure », vous excluez les membres spécifiés dans de member_ids la recherche. Sinon, les ID spécifiés sont inclus.
member_ids tableau d’entiers Oui, utilisez « member_id » dans la chaîne de requête. Doit être utilisé avecmember_action. Recherchez des créatifs par les ID de leurs membres.
modified_since Timestamp Non Recherchez les créations qui ont été modifiées depuis cette date. Format : « AAAA-MM-JJ HH :MM :SS ».
review_status tableau d’énumération Non Recherchez des créatifs en fonction de leur révision status (à partir des profils publicitaires associés). Valeurs possibles : « révisé », « non révisé ». Le champ révision status est retourné uniquement dans la réponse lorsque vous utilisez ce filtre.
size_in_bytes string Oui Pas un filtre. Le tri entraîne l’ordre croissant/décroissant de la taille.
sizes tableau de chaînes Oui, utilisez « width » et « height » dans la chaîne de requête. Recherchez des créatifs en fonction de leur taille, par exemple, « 728 x 90 ».
template_id int Oui Recherchez des créatifs par leurs ID de modèle créatif.
uploaded_since Timestamp Non Recherchez les créations qui ont été chargées depuis cette date. Format : « AAAA-MM-JJ HH :MM :SS ».

Exemples

Rechercher toutes les bannières créatives qui ont réussi l’audit de Xandr

$ cat creative_search
{
   "creative_search": {
      "audit_status": [
         "audited"
      ],
      "media_subtype": [
         "banner"
      ]
   }
}

$ curl -b cookies -c cookies -X POST -d @creative_search 'https://api.adnxs.com/creative-search'
{
   "response": {
      "status": "OK",
      "creatives": [
         {
            "id": "48652",
            "width": "300",
            "height": "250",
            "media_url": "https:\/\/cdn.adnxs.com\/p\/05\/d1\/cd\/fe\/05d1cxxxxxx221db2ba8b.png",
            "content": null,
            "format": "image",
            "member_id": "408",
            "brand_id": "1",
            "click_url": "https:\/\/www.sample.com",
            "audit_status": "audited",
            "size_in_bytes": "14545",
            "landing_page_url": null,
            "last_activity": "2010-07-23 16:40:41",
            "created_on": "2010-04-30 07:20:23",
            "media_subtypes": [
               "banner"
            ],
            "pop_values": null
            },
         {
            "id": "73163",
            "width": "300",
            "height": "250",
            "media_url": null,
            "content": "<iframe src=\"https:\/\/xxxx.net\/udm\/img.fetch?sid=2773;tid=2;ev=1;dt=1;\" width=300
             height=250 Marginwidth=0 Marginheight=0 Hspace=0 Vspace=0 Frameborder=0 Scrolling=No><\/iframe>
             <noscript><a href=\"https:\/\/fletcher.net\/udm\/clk.cpx?sid=2773;ev=2;tid=2;dt=3\"><img src=\
             "https:\/\/sample.net\/udm\/img.fetch?sid=2773;ev=1;tid=2;dt=3\" width=300 height=250 border=0>
             <\/a><\/noscript>",
            "format": "iframe-html",
            "member_id": "333",
            "brand_id": "17",
            "click_url": "",
            "audit_status": "audited",
            "size_in_bytes": "0",
            "landing_page_url": "https:\/\/www.appleblueberry.com",
            "last_activity": "2010-09-07 23:33:45",
            "created_on": "2010-08-25 16:31:43",
            "media_subtypes": [
               "banner"
            ],
            "pop_values": null
         },
         ...
      ]
   }
}

Rechercher toutes les créations flash qui ont été chargées depuis 2012-01-01 00 :00 :00

$ cat creative_search
{
   "creative_search": {
      "formats": [
         "flash"
      ],
      "uploaded_since": "2012-01-01 00:00:00"
   }
}

$ curl -b cookies -c cookies -X POST -d @creative_search 'https://api.adnxs.com/creative-search'
{
   "response": {
      "status": "OK",
      "creatives": [
         {
            "id": "1207858",
            "width": "160",
            "height": "600",
            "media_url": "https:\/\/cdn.adnxs.com\/p\/c7\/6d\/5b\/bd\/c76d5bbdxxxxx8b9e1507c07cbe61.swf",
            "content": null,
            "format": "flash",
            "member_id": "326",
            "brand_id": "4467",
            "click_url": "https:\/\/clickclick.com\/witness\/p=28xxx96\/c=6sxd3",
            "audit_status": "audited",
            "size_in_bytes": "40077",
            "landing_page_url": "https:\/\/www.destination.com",
            "last_activity": "2012-01-01 15:56:59",
            "created_on": "2012-01-01 02:34:14",
            "media_subtypes": [
               "banner"
            ],
            "pop_values": null
         },
         {
            "id": "1207859",
            "width": "160",
            "height": "600",
            "media_url": "https:\/\/cdn.adnxs.com\/p\/3b\/d6\/f6\/1d\/3bd6f61dkdh4473djfb579430ed.swf",
            "content": null,
            "format": "flash",
            "member_id": "326",
            "brand_id": "4467",
            "click_url": "https:\/\/clickclick.com\/witness\/p=2ddssd6\/c=3423",
            "audit_status": "audited",
            "size_in_bytes": "32094",
            "landing_page_url": "https:\/\/www.destination.com",
            "last_activity": "2012-01-01 15:57:36",
            "created_on": "2012-01-01 02:35:52",
            "media_subtypes": [
               "banner"
            ],
            "pop_values": null
         },
         ...
      ]
   }
}

Rechercher toutes les créations d’images 728x90 et 300x250 appartenant au membre 333

$ cat creative_search
{
   "creative_search": {
      "sizes": [
         "728x90",
         "300x250"
      ],
      "formats": [
         "image"
      ],
      "member_ids": [
         333
      ]
   }
}

$ curl -b cookies -c cookies -X POST -d @creative_search 'https://api.adnxs.com/creative-search'
{
   "response": {
      "status": "OK",
      "creatives": [
         {
            "id": "61967",
            "width": "300",
            "height": "250",
            "media_url": "https://cdn.adnxs.com/p/c8/fb/12/56/c8fb125634xxxx2e67a783d91cf.png",
            "content": null,
            "format": "image",
            "member_id": "333",
            "brand_id": "1",
            "click_url": "https://www.clickplace.com/",
            "audit_status": "no_audit",
            "size_in_bytes": "29433",
            "landing_page_url": null,
            "last_activity": "2011-05-13 02:34:47",
            "created_on": "2010-07-28 20:44:22",
            "media_subtypes": [
               "banner"
            ],
            "pop_values": null
         },
         {
            "id": "291801",
            "width": "728",
            "height": "90",
            "media_url": "https://cdn.adnxs.com/p/54/62/87/d1/546287aasxxx8e6431960ad2b1fb.png",
            "content": null,
            "format": "image",
            "member_id": "333",
            "brand_id": "2450",
            "click_url": "https://thatplace.com/careers",
            "audit_status": "audited",
            "size_in_bytes": "24091",
            "landing_page_url": "https://thatplace.com/careers",
            "last_activity": "2011-05-13 03:30:00",
            "created_on": "2011-04-05 18:28:29",
            "media_subtypes": [
               "banner"
            ],
            "pop_values": null
         },
         ...
      ]
   }
   }
  • Last updated on