Licitadores: servicio de acceso de comprador de paquetes

Artículo
05/18/2024

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 `true`es , el paquete está activo. Si `false`es , 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 `true`es , `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 `true`es , el paquete incluye destinos de categoría de publicador, ubicación, sitio o contenido.
`has_segments`	booleano	Si `true`es , el paquete incluye destinos de segmento.
`has_sizes`	booleano	Si `true`es , 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
    }
  }
}

Compartir a través de