Compartir a través de

Licitadores: servicio de búsqueda creativa

  • Artículo

Este servicio de solo lectura permite buscar creatividades basadas en criterios específicos, como el estado de auditoría, el identificador, el tamaño, etc. Para agregar creatividades al sistema, consulte El servicio creativo.

Advertencia

Dado que este servicio busca todas las creatividades en la plataforma de Xandr (no solo en la suya), una búsqueda demasiado amplia podría producir un error. Para asegurarse de que obtiene resultados, limite la búsqueda tanto como sea posible.

Implementación

API de REST

Método HTTP Punto final Descripción
POST [https://api..com/creative-search](https://api..com/creative-search) (creative_search JSON) Para buscar creativos.
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) Busque creatividades y ordene los resultados.
Nota: Los campos usados para buscar creatividades no son exactamente los mismos que los campos devueltos. Esto se debe a que los objetos devueltos se extraen del Servicio creativo y tienen el formato correspondiente. Este servicio solo buscará creatividades activas.

Campos JSON

Campo Tipo ¿Ordenar? Utilice
ad_profile_id Entero No Debe usarse conbrand_status . Busque una creatividad por el identificador de su perfil de anuncio.
audit_status Matriz de enumeración Yes Busque creatividades por su estado de auditoría. Valores posibles: "no_audit", "pending", "rejected", "audited".
brand_ids matriz de enteros No Busque creativos por los identificadores de sus marcas.
brand_status Matriz de enumeración No Debe usarse conad_profile_id . Busque creativos por su estado de marca. Por ejemplo, si se establece en "trusted", todas las marcas de confianza dentro de los perfiles de anuncio especificados en ad_profile_id se devolverán en la respuesta. Valores posibles: "trusted", "case-by-case", "banned". El campo de estado de marca solo se devuelve en la respuesta cuando se usa este filtro.
click_url string Sí No es un filtro. Ordenar da como resultado un orden ascendente o descendente de la dirección URL de clic alfabética.
creative_ids matriz de enteros Sí, use "id" en la cadena de consulta. Busque creativos por sus identificadores.
description string No Busque creatividades por términos en sus descripciones.
formats Matriz de enumeración Sí, use "format" en la cadena de consulta. Busque creatividades por sus formatos. Valores posibles: "url-html", "url-js", "flash", "image", "raw-js", "raw-html", "iframe-html", "url-vast", "text".
landing_page_url string Sí No es un filtro. Ordenar da como resultado un orden ascendente o descendente de la dirección URL de la página de aterrizaje alfabética.
media_content string No Busque una creatividad por los datos en su campo de original_content (consulte Creative Service).
media_subtype Matriz de enumeración No En desuso, usemedia_subtype_ids en su lugar. Busque creatividades por sus subtipos multimedia. Valores posibles: "Banner", "Popup", "Popunder".
media_subtype_ids matriz de enteros Sí, use "media_subtype_id" en la cadena de consulta. Busque creatividades por su subtipo multimedia a través del identificador. Puede usar el servicio subtipo multimedia para buscar los identificadores deseados.
media_url string Sí Busque una creatividad por su dirección URL.
member_action enumeración No Debe usarse conmember_ids . Si se establece en "exclude", se excluyen los miembros especificados en member_ids de la búsqueda. De lo contrario, se incluyen los identificadores especificados.
member_ids matriz de enteros Sí, use "member_id" en la cadena de consulta. Debe usarse conmember_action . Busque creativos por los identificadores de sus miembros.
modified_since Timestamp No Busque las creatividades que se modificaron desde esta fecha. Formato: "AAAA-MM-DD HH:MM:SS".
review_status Matriz de enumeración No Busque creatividades en función de su estado de revisión (de los perfiles de anuncios asociados). Valores posibles: "revisado", "no revisado". El campo de estado de revisión solo se devuelve en la respuesta cuando se usa este filtro.
size_in_bytes string Sí No es un filtro. Ordenar da como resultado un orden de tamaño ascendente o descendente.
sizes matriz de cadenas Sí, use "width" y "height" en la cadena de consulta. Busque creatividades por sus tamaños, por ejemplo, "728x90".
template_id Entero Yes Busque creativos por sus identificadores de plantilla creativa.
uploaded_since Timestamp No Busque las creatividades que se cargaron desde esta fecha. Formato: "AAAA-MM-DD HH:MM:SS".

Ejemplos

Búsqueda de todas las creatividades de banner que han superado la auditoría 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
         },
         ...
      ]
   }
}

Buscar todas las creatividades flash que se han cargado desde 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
         },
         ...
      ]
   }
}

Busque todas las creatividades de imágenes de 728x90 y 300x250 que pertenecen al miembro 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
         },
         ...
      ]
   }
   }