Compartir a través de


Ofertas para licitadores

Xandr ofrece la posibilidad de pujar por ofertas con nuestros vendedores de plataforma. Esta página le guiará por el proceso de licitación.

Sugerencia

Una subasta de ofertas puede ser abierta o privada, dependiendo de cómo el vendedor definió la oferta. Para obtener información sobre cómo funcionan estos diferentes tipos de subastas, consulte Mecánica de subastas de ofertas.

Nota:

El miembro no se puede cambiar una vez creada una oferta.

Inventario de la oferta de compra

Paso 1. Configuración del sistema para controlar las ofertas

Asegúrese de que el sistema está configurado para leer los identificadores de la oferta en la solicitud de puja y dar formato a una respuesta de puja específica de la oferta adecuada. Para obtener más información, vea La cadena de solicitud y respuesta de ejemplo. Por favor, asegúrese también de revisar La mecánica de subastas de ofertas para comprender cómo Xandr lleva a cabo la subasta en diferentes situaciones.

Paso 2. Póngase en contacto con su representante de Xandr.

Una vez que haya configurado el sistema para controlar correctamente las solicitudes y respuestas del identificador de la oferta, póngase en contacto con el representante de Xandr para habilitarlo para las ofertas en Xandr. La habilitación para ofertas puede implicar lo siguiente:

  • Validación de cómo decide y responde a las solicitudes de trato
  • Hacer que sea visible para los vendedores en nuestro sistema

Paso 3. Indicar a los compradores que empiecen a negociar ofertas

Sus compradores negociarán directamente los tratos con los vendedores. Xandr no participa en el proceso. Este es el proceso que deben seguir los compradores:

  1. El comprador negocia un acuerdo con un vendedor fuera de línea.
  2. El comprador proporciona su id. de miembro de Xandr al vendedor. Si no conocen su identificador de miembro, debe ayudarle a identificarlo.
  3. El vendedor configura un acuerdo con el comprador dentro de la interfaz de usuario
  4. El vendedor proporciona el identificador de la oferta al comprador.
  5. El comprador escribe el id. de la oferta en el sistema del postor para la selección de destino.  

Paso 4. Validar las ofertas de los compradores

Una vez que un comprador haya configurado una oferta con un vendedor de Xandr, debe asegurarse de que sus perfiles de pujador no bloquean ninguno de los parámetros que se aplican al inventario de la oferta. Por ejemplo, si un perfil filtra el vendedor, el tamaño de la creatividad u otro parámetro que se aplica al inventario de la oferta, no recibirá esas solicitudes de puja. Para obtener más información sobre cómo actualizar o crear perfiles de licitador, consulte el Servicio de perfil de licitador heredado.

Nota:

Se recomienda usar el servicio Deal Buyer Access para validar que la oferta existe en el sistema de Xandr. Esto le ayudará a evitar tener como destino una oferta que esté inactiva o no sea lo que esperaba.

Ejemplo:

$ curl -b cookies -c cookies  'https://api.adnxs.com/deal-buyer-access?id=63'
{
     "response" : {
         "status" :  "OK" ,
         "count" : 1,
         "deal" : 
         "deals" : {
             "id" : 63,
             "code" :  null ,
             "name" :  "Private deal for buyer 1085 with floor of $2.50" ,
             "description" :  null ,
             "active" :  false ,
             "start_date" :  "2013-12-01 00:00:00" ,
             "end_date" :  "2013-12-31 23:59:59" ,
             "floor_price" : 2.5,
             "currency" :  "USD" ,
             "use_deal_floor" :  true ,
             "last_modified" :  "2013-12-04 20:39:57" ,
             "seller" : {
                 "id" : 100006,
                 "name" :  "Seller 456"
             },
             "buyer" : {
                 "id" : 100007,
                 "bidder_id" : 2,
                 "name" :  "Buyer 456"
             },
             "type" : {
                 "id" : 2,
                 "name" :  "Private Auction"
             },
             "brands" : [
                 {
                     "id" : 1
                 }
 
             ],
             "ask_price" : 2.75,
             "suggested_min_bid_price" : 3
         }
     }
}

Cadena de solicitud/respuesta de ejemplo

Nota:

Este ejemplo es para la integración de Xandr del Protocolo de licitación de AppNexus.

Solicitud de puja

{
    "bid_request": {
        "timestamp": "2014-04-18 17:00:57",
        "bidder_timeout_ms": 2000,
        "members": [
            {
                "id": 1417
            },
            {
                "id": 1625
            }
        ],
        "test": true,
        "member_ad_profile_id": 555216,
        "excluded_attributes": [
            2033
        ],
        "tags": [
            {
                "auction_id_64": 5555508250840350700,
                "size": "300x250",
                "sizes": [
                    "300x250"
                ],
                "smaller_sizes_allowed": false,
                "position": "unknown",
                "tag_format": "iframe",
                "site_id": 555526,
                "creative_formats_map": "111111111011",
                "creative_formats": [
                    "unknown",
                    "html-url",
                    "js-url",
                    "flash",
                    "image",
                    "js-raw",
                    "html-raw",
                    "html-iframe",
                    "vast-url",
                    "unknown",
                    "unknown"
                ],
                "ad_profile_id": 555180,
                "visibility_profile_id": 5553,
                "venue_id": 407258,
                "pop_max_width": 300,
                "pop_max_height": 250,
                "pop_is_prepop": false,
                "allowed_media_types": [
                    1
                ],
                "media_subtypes": [
                    "banner"
                ],
                "estimated_clear_price": 0.913,
                "estimated_average_price": 0.456,
                "id": 5555354,
                "deals": [
                    {
                        "id": 555664,
                        "member_id": 1625,
                        "floor_cpm": 0.5,
                                                "sizes": [
                                                        "300x250", 
                                                        "300x600"
                                                ]
                    }
                ]
            }
        ],
        "bid_info": {
            "user_id_64": 5555037017052493000,
            "no_cookies": false,
            "payment_rule_id": 555018,
            "selling_member_id": 55578,
            "no_flash": false,
            "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/34.0.1847.116 Safari/537.36",
            "browser": 8,
            "operating_system": 11,
            "operating_system_extended": 81,
            "operating_system_family": 4,
            "carrier": 1,
            "device_type": 1,
            "language": 1,
            "accepted_languages": "en-US",
            "session_freq": 1,
            "pub_session_freq": 1,
            "ip_address": "555.1.12.54",
            "country": "US",
            "within_iframe": false,
            "device_ids": {
                "sha1udid": "d55555c2314f3789198685914c01425034b5d502",
                "md5udid": "caf55557c5b39fb4ad68dabc9808bda1"
            },
            "publisher_id": 555547,
            "userdata_json": "{}",
            "segments": [
                {
                    "id": 1,
                    "member_id": 0,
                    "code": "cookie_birthday",
                    "provider": "Xandr",
                    "last_seen_min": 23274134
                }
            ]
        }
    }
}

Respuesta de la oferta

{
   "bid_response":{
      "responses":[
         {
            "member_id":1625,
            "price":0.75,
            "creative_id":11,
            "auction_id_64": 5555508250840350700,
            "deal_id": 555664
         }
      ]
   }
}

Códigos de error de solicitud de notificación

Códigos de error específicos de la oferta, consulte Códigos de error de puja.

Error Id. **Descripción
NEC_DEAL_NOT_AVAILABLE 308 La oferta que especificó en la respuesta no está activa actualmente.
NEC_DEAL_NO_MEMBER 309 La oferta que especificó en la respuesta no está disponible para su miembro.
NEC_DEAL_BELOW_FLOOR 310 Su oferta no se consideró en la subasta porque está por debajo del precio de la oferta.
NEC_DEAL_BRAND_BANNED 311 La marca asociada a su creatividad no es una marca válida para esta oferta.