Compartir a través de


Licitadores: servicio de acceso de comprador de paquetes

Este servicio de solo lectura permite a los compradores ver información sobre los paquetes de los vendedores. Un paquete es una oferta que un vendedor está preparado para ofrecer a cualquier comprador. Los compradores exploran los paquetes disponibles y luego usan el servicio Deal From Package para generar ofertas por sí mismos.

API de REST

Http (método) Endpoint Description
GET https://api.adnxs.com/package-buyer-access Ver todos los paquetes disponibles.
GET https://api.adnxs.com/package-buyer-access?member_id=SELLER_MEMBER_ID Ver todos los paquetes ofrecidos por un vendedor específico.
GET https://api.adnxs.com/package-buyer-access?id=PACKAGE_ID Ver un paquete específico.
GET https://api.adnxs.com/package-buyer-access?id=1,2,3 Vea varios paquetes por identificador mediante una lista separada por comas.
GET https://api.adnxs.com/package-buyer-access?sizes=WIDTHxHEIGHT,WIDTHxHEIGHT Vea todos los paquetes, incluidos los tamaños específicos.
GET https://api.adnxs.com/package-buyer-access?search=PACKAGE_ID o NAME Busque un paquete por nombre o identificador.
GET https://api.adnxs.com/package/meta Averigüe por qué campos puede filtrar y ordenar.

Campos JSON

Nombre Tipo Descripción
active booleano Si truees , el paquete está activo. Si falsees , no puede generar ofertas a partir del paquete y todas las ofertas asociadas dejarán de servir.
allow_creative_add_on_click true Todavía no se admite.
allow_creative_add_on_view booleano Todavía no se admite.
data_protected booleano Todavía no se admite.
default_ask_price double Precio de solicitud que se aplicará a todas las ofertas generadas a partir del paquete.

Nota: Este campo solo es relevante si default_use_deal_floor es true.
default_currency string La moneda del precio ask que se aplicará a todas las ofertas generadas a partir del paquete.
default_deal_type object Tipo de oferta que se aplicará a todas las ofertas generadas a partir del paquete. Para obtener más información, consulte Tipo de oferta predeterminado a continuación.
default_use_deal_floor booleano Si truees , default_ask_price se aplicará a las ofertas generadas a partir del paquete.

Propina: Cuando default_use_deal_floor es true, el precio de solicitud de la oferta invalida cualquier otro piso que el vendedor pueda tener, es decir, en colocaciones o perfiles de administración de rendimiento.
description string Descripción del paquete. Por lo general, los vendedores usan esto para proporcionar a los compradores una mayor información sobre la oferta.
id Entero Identificador del paquete.
last_modified Timestamp Día y hora en que se modificó por última vez el paquete.
name string Nombre del paquete.
seller object El nombre y el identificador del vendedor que ofrece el paquete. Para obtener más información, consulte Vendedor a continuación.
seller_rank Entero Clasificación del vendedor para el paquete. Este controla dónde aparecerá el paquete en la lista completa de paquetes del vendedor en . Intervalo permitido: 1 - 65355, donde 1 es la clasificación más alta.
setting object Tipo de contenido incluido en el paquete. Para obtener más información, consulte Configuración a continuación.
sizes matriz de objetos Los tamaños creativos incluidos en el paquete. Para obtener más información, vea Tamaños a continuación.
visibility_profile_id Entero Todavía no se admite.

Vendedor

El seller objeto contiene los campos siguientes.

Campo Tipo Description
id Entero Id. de miembro del vendedor.
name string Nombre del miembro del vendedor.

Tipo de oferta predeterminado

El default_deal_type objeto contiene los campos siguientes. De forma predeterminada, todos los paquetes generarán ofertas con un tipo de oferta de subasta abierta.

Campo Tipo Description
id Entero Identificador que representa el tipo de transacción. Valores posibles: 1 (Subasta abierta) o 2 (Subasta privada). Para obtener más información sobre las subastas abiertas y privadas, consulte el servicio Deal.
name string Solo lectura. Nombre del tipo de transacción. Valores posibles: "Open Auction" o "Private Auction".

Configuración

Esta información se usa para proporcionar a los compradores una comprensión general del inventario incluido en el paquete. El setting objeto contiene los campos siguientes.

Campo Tipo Descripción
has_inventory booleano Si truees , el paquete incluye destinos de categoría de publicador, ubicación, sitio o contenido.
has_segments booleano Si truees , el paquete incluye destinos de segmento.
has_sizes booleano Si truees , el paquete incluye destinos de tamaño. Para conocer los tamaños específicos incluidos, consulte la sizes matriz.
inventory_description string Si has_inventory se establece en true, este campo proporciona una descripción del inventario incluido en el paquete.
segments_description string Si has_segments se establece en true, este campo proporciona una descripción de los segmentos incluidos en el paquete.

Atributos técnicos

Cada technical_attribute objeto contiene los campos siguientes:

Campo Tipo Description
id Entero Identificador del atributo técnico que es apto para el paquete. Puede usar el Servicio de atributos técnicos para recuperar identificadores de atributo técnico.
name string Nombre del atributo técnico que es apto para el paquete.
override Booleano Si se establece en true, un atributo técnico puede servir para un paquete incluso si el perfil de calidad del anuncio lo hubiera bloqueado.

Tamaños

Cada objeto de la sizes matriz contiene los campos siguientes.

Campo Tipo Descripción
height string El alto de la creatividad.
width string Ancho de la creatividad.

Ejemplos

Ver todos los paquetes disponibles

$ curl -b cookies -c cookies "https://api.adnxs.com/package-buyer-access"
{
  "response": {
    "status": "OK",
    "count": 102,
    "packages": [
      {
        "id": 1,
        "name": "Test Pkg",
        "description": "this is a test package",
        "active": true,
        "default_ask_price": 2.5,
        "default_currency": "USD",
        "default_use_deal_floor": true,
        "last_modified": "2014-05-30 15:02:33",
        "seller_rank": 100,
        "seller": {
          "id": 5581,
          "name": "AppNexus University"
        },
        "default_deal_type": {
          "id": 1,
          "name": "Open Auction"
        },
        "setting": null,
        "sizes": null
      },
      {
        "id": 2,
        "name": "High Performance & Viewability!",
        "description": "This is an artisanal, hand-picked collection of extremely high performing placements that are visible at least 90% of the time. Viewability audit performed daily by our proprietary View-O-Matic technology and verified by a trusted 3rd party.",
        "active": true,
        "default_ask_price": 8.8,
        "default_currency": "USD",
        "default_use_deal_floor": true,
        "last_modified": "2014-06-26 22:12:31",
        "seller_rank": 100,
        "seller": {
          "id": 55570,
          "name": "Seller ABC"
        },
        "default_deal_type": {
          "id": 1,
          "name": "Open Auction"
        },
        "setting": {
          "has_inventory": true,
          "inventory_description: "Description of inventory.",
          "has_segments": true,
          "segment_description": "Description of segments.",
          "has_sizes": true
        },
        "sizes": [
          {
            "width": "120",
            "height": "600"
          },
          {
            "width": "160",
            "height": "600"
          },
          {
            "width": "300",
            "height": "250"
          },
          {
            "width": "468",
            "height": "60"
          },
          {
            "width": "480",
            "height": "80"
          },
          {
            "width": "640",
            "height": "360"
          }
        ]
      },
      ...
    ]
  }
}

Ver todos los paquetes ofrecidos por un vendedor específico

$ curl -b cookies -c cookies "https://sand.api.adnxs.com/package-buyer-access?member_id=55586"
{
  "response": {
    "status": "OK",
    "count": 2,
    "packages": [
      {
        "id": 108,
        "name": null,
        "description": null,
        "active": true,
        "default_ask_price": 1,
        "default_currency": "USD",
        "default_use_deal_floor": true,
        "last_modified": "2014-07-16 20:49:30",
        "seller_rank": 100,
        "seller": {
          "id": 55586,
          "name": "Tyroo Media Pvt. Ltd."
        },
        "default_deal_type": {
          "id": 1,
          "name": "Open Auction"
        },
        "setting": {
          "has_inventory": true,
          "inventory_description: "Description of inventory.",
          "has_segments": true,
          "segment_description": "Description of segments.",
          "has_sizes": false
        },
        "sizes": null
      }
    ],
    {
        "id": 5,
        "name": "Package of inventory with data",
        "description": "This package includes inventory X and data X.",
        "active": false,
        "default_ask_price": 11.26,
        "default_currency": "USD",
        "default_use_deal_floor": true,
        "last_modified": "2014-06-06 18:10:47",
        "seller_rank": 100,
        "seller": {
          "id": 55586,
          "name": "Tyroo Media Pvt. Ltd."
        },
        "default_deal_type": {
          "id": 1,
          "name": "Open Auction"
        },
        "setting": {
          "has_inventory": true,
          "inventory_description: "Description of inventory.",
          "has_segments": true,
          "segment_description": "Description of segments.",
          "has_sizes": true
        },
        "sizes": [
          {
            "width": "160",
            "height": "600"
          },
          {
            "width": "300",
            "height": "50"
          }
        ]
      },
  }
}

Visualización de un paquete específico

$ curl -b cookies -c cookies "https://api.adnxs.com/package?id=109"
{
  "response": {
    "status": "OK",
    "count": 1,
    "package": {
      "id": 109,
      "name": "Updated Package 1",
      "description": null,
      "active": true,
      "default_ask_price": 1,
      "default_currency": "USD",
      "default_use_deal_floor": true,
      "last_modified": "2014-07-21 17:14:16",
      "seller_rank": 100,
      "seller": {
        "id": 5558,
        "name": "TMP Ltd."
      },
      "default_deal_type": {
        "id": 1,
        "name": "Open Auction"
      },
      "setting": {
        "has_inventory": true,
        "inventory_description: "Description of inventory.",
        "has_segments": true,
        "segment_description": "Description of segments.",
        "has_sizes": false
      },
      "sizes": null
    }
  }
}