Servicio de oferta

El Servicio de Ofertas permite a los compradores, vendedores y licitadores externos configurar y administrar ofertas negociadas. Las ofertas pueden proporcionar a los compradores:

• Precios preferenciales en inventario
• Acceso a inventario exclusivo
• Reducción de la competencia en el inventario
• Otras oportunidades

Cada oferta es válida para un solo comprador.

API de REST

Campos JSON

Vendedor

El seller objeto contiene los siguientes campos:

Comprador

El objeto comprador se puede establecer en , POSTpero no se puede actualizar con un PUTobjeto . Si desea cambiar el comprador, debe crear una nueva oferta.

El buyer objeto contiene los siguientes campos:

Ejemplo del buyer objeto

"buyer": {
                "bidder_id": 2,
                "bidder_name": "Microsoft Invest",
                "id": 9155,
                "name": "Hearts & Science (AT&T)"
            },
"buyer_seats": null

Compradores postores

El buyer_bidders objeto se puede establecer en un POST, y se puede actualizar con un PUT. Cuando un vendedor está habilitado para ofertas de varios compradores. El buyer_bidders objeto se puede establecer en combinación con buyer_seats and buyer_members.

El buyer_bidders objeto contiene los siguientes campos:

Ejemplo del buyer_bidders objeto

"buyer_bidders": [{
    "bidder_id": 1,
    "bidder_name": "Example Bidder"
}],

Miembros compradores

El buyer_members objeto se puede establecer en un POST, y se puede actualizar con un PUT. Cuando un vendedor está habilitado para ofertas de varios compradores, el buyer_members objeto se puede establecer en combinación con buyer_seats y buyer_bidders.

El buyer_members objeto contiene los siguientes campos:

Ejemplo del buyer_members objeto

"buyer_members": [{
    "bidder_id": 1,
    "bidder_name": "Example Bidder",
    "id": "456",
    "name": "Example Buyer Member"
}],

Puestos de comprador

Los acuerdos con asientos se pueden configurar utilizando el buyer_seats objeto a través de la API.

Cuando se configura un nuevo trato a través de, la API se rellenará con el buyer_seats objeto. Puede utilizar el ID de miembro del comprador de Invest en el code campo, así como bidder_id. Los nuevos acuerdos con DSP externos también se pueden configurar con ID de asiento de comprador. Puede comprobar qué DSP externos utilizan los ID de asiento de comprador aquí.

El buyer_seats objeto contiene los siguientes campos:

Ejemplo del buyer_seats objeto

"buyer": null,
"buyer_seats": [
                {
                    "bidder_id": 2,
                    "bidder_name": "",
                    "code": "9155",
                    "name": "Hearts & Science (AT&T)"
                }
            ],

Tipo

El type objeto contiene los siguientes campos:

Tipo de subasta

El auction_type objeto contiene los siguientes campos:

Marcas

Cada brands objeto contiene los siguientes campos:

Tipos de medios permitidos

Puede usar esta matriz para limitar el tipo de medios, el estilo de visualización general de las creatividades, que pueden servir en las ubicaciones que forman parte de este trato.

Si se especifica, la oferta solo se agrega a las subastas en las que el tipo de medios seleccionado está disponible.

Algunas subastas admiten varios tipos de medios. Si el tipo de contenido multimedia seleccionado es compatible con la subasta, la oferta es apta para participar.

Cada allowed_media_types objeto contiene los siguientes campos:

Subtipos de medios permitidos

Puede usar esta matriz para limitar el subtipo de medio, el estilo de visualización específico de las creatividades, que pueden servir en las ubicaciones que forman parte de este trato. Si se especifica, la oferta solo participa en las subastas en las que el subtipo de medios seleccionado está disponible.

Algunas subastas admiten varios tipos y subtipos de medios. Si el subtipo de medio especificado es compatible con la subasta, la oferta es elegible para participar.

Puede crear una oferta a través de la API sin establecer allowed_media_types y especificando solo allowed_media_subtypes. En este caso, la oferta participa en las subastas que admiten el subtipo multimedia especificado.

Cada allowed_media_subtypes objeto contiene los siguientes campos:

Tamaños permitidos

Cada permitted_sizes objeto contiene los siguientes campos:

Metadatos externos

El external_metadata objeto es aplicable a las ofertas garantizadas mediante programación.

Cada external_metadata objeto contiene los siguientes campos:

Recursos nativos

Cada native_assets objeto contiene los siguientes campos:

Categories

Cada categories objeto contiene los siguientes campos:

Idiomas

Cada languages objeto contiene los siguientes campos:

Atributos técnicos

Cada technical_attribute objeto contiene los siguientes campos:

Recursos creativos

La creatives matriz está limitada a 100 creativos. Cada creatives objeto contiene los siguientes campos:

Listas de servidores de anuncios

Cada adserver_lists objeto contiene los siguientes campos.

Segmentación restringida del vendedor

Un acuerdo puede especificar a qué atributos puede apuntar un comprador de Invest al mismo tiempo que apunta a este acuerdo. Las opciones son:

• Sin restricciones: los compradores de Invest pueden apuntar a todos los atributos en su línea de pedido mientras apuntan a esta oferta.
• Algunas restricciones: los compradores de inversiones pueden apuntar a ciertos atributos en su línea de pedido.
• todas las restricciones: los compradores de Invest no pueden apuntar a ningún otro atributo mientras apuntan a este trato.

Es posible que tu miembro esté configurado para usar una de estas opciones de forma predeterminada cuando se creen nuevas ofertas.

Si un trato está configurado para algunas restricciones, el perfil de visibilidad asociado con el trato (consulte el visibility_profile_id campo en la sección Campos JSON ) determina la selección de atributos a los que se puede apuntar un comprador. Los siguientes campos de perfil de visibilidad se pueden usar para restringir la segmentación permitida de un comprador:

Ejemplos

Añada un acuerdo de subasta privada con un mínimo de 2,50 USD

$ cat new_deal
 
{
    "deal": {
        "name": "Private deal for buyer 1234 with floor of $2.50",
        "active": false,
        "start_date": "2016-12-01 00:00:00",
        "end_date": "2016-12-31 23:59:59",
        "floor_price": 2.5,
        "currency": "USD",
        "use_deal_floor": true,
        "buyer": {
                "id": 1234
        },
        "type": {
                "id": 2
        },
        "brands": [
                {
                        "id": 1
                }
            ]
    }
}
 
$ curl -b cookies -c cookies -X POST -d @new_deal.json 'https://api.appnexus.com/deal'
 
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 63,
        "start_element": 0,
        "num_elements": 100,
        "deal": {
            "id": 63,
            "code": null,
            "name": "Private deal for buyer 1234 with floor of $2.50",
            "description": null,
            "active": false,
            "seller_member_id": 2345,
            "start_date": "2013-12-01 00:00:00",
            "end_date": "2013-12-31 23:59:59",
            "profile_id": null,
            "package_id": null,
            "floor_price": 2.5,
            "currency": "USD",
            "use_deal_floor": true,
            "last_modified": "2013-12-04 20:39:57",
            "seller": {
                "id": 1066,
                "name": "Seller 123"
            },
            "buyer": {
                "id": 1234,
                "bidder_id": 6,
                "name": "Buyer 456"
            },
            "type": {
                "id": 2,
                "name": "Private Auction"
            },
            "brands": [
                {
                    "id": 1,
                                        "name": "Example Brand"
                }
            ],
            "ask_price": 0,
            "size_preference": null
        }
    }
}

Agregar una oferta de subasta privada sin piso

$ cat new_deal_nofloor
 
{
    "deal": {
        "name": "Private deal for buyer 1234 with no floor",
        "active": false,
        "start_date": "2016-12-01 00:00:00",
        "end_date": "2016-12-31 23:59:59",
        "floor_price": 0,
        "use_deal_floor": false,
        "buyer": {
                "id": 1234
        },
        "type": {
                "id": 2
        },
        "brands": [
                {
                        "id": 1
                }
            ]
    }
}
 
$ curl -b cookies -c cookies -X POST -d @new_deal_nofloor.json 'https://api.appnexus.com/deal'
 
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 64,
        "start_element": 0,
        "num_elements": 100,
        "deal": {
            "id": 64,
            "code": null,
            "name": "Private deal for buyer 1234 with no floor",
            "description": null,
            "active": false,
            "start_date": "2013-12-01 00:00:00",
            "end_date": "2013-12-31 23:59:59",
            "profile_id": null,
            "package_id": null,
            "floor_price": 0,
            "currency": "USD",
            "use_deal_floor": false,
            "last_modified": "2013-12-04 20:43:44",
            "seller": {
                "id": 2345,
                "name": "Seller 123"
            },
            "buyer": {
                "id": 1234,
                "bidder_id": 6,
                "name": "Buyer 456"
            },
            "type": {
                "id": 2,
                "name": "Private Auction"
            },
            "brands": [
                {
                    "id": 1,
                    "name": "Example Brand"
                }
            ],
            "ask_price": 0,
            "size_preference": null
        }
    }
}

Modificar una oferta

En este ejemplo, agregamos otra marca apta al acuerdo y ampliamos la fecha de finalización.

$ cat deal_update
 
{
    "deal": {
        "end_date": "2017-01-31 23:59:59",
        "brands": [
                {
                        "id": 1
                },
            {
                "id": 5
            }
            ]
    }
}
 
$ curl -b cookies -c cookies -X PUT -d @deal_update.json 'https://api.appnexus.com/deal?id=64'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "64",
        "start_element": 0,
        "num_elements": 100,
        "deal": {
            "id": 64,
            "code": null,
            "name": "Private deal for buyer 1234 with no floor",
            "description": null,
            "active": false,
            "start_date": "2016-12-01 00:00:00",
            "end_date": "2016-01-31 23:59:59",
            "profile_id": null,
            "package_id": null,
            "floor_price": 0,
            "currency": "USD",
            "use_deal_floor": false,
            "last_modified": "2016-12-04 20:51:35",
            "seller": {
                "id": 2345,
                "name": "Seller 123"
            },
            "buyer": {
                "id": 1234,
                "bidder_id": 6,
                "name": "Buyer 456"
            },
            "type": {
                "id": 2,
                "name": "Private Auction"
            },
            "brands": [
                {
                    "id": 1,
                    "name": "Example Brand"
                },
                {
                    "id": 5,
                    "name": "Another Brand"
                }
            ],
            "ask_price": 0,
            "size_preference": null
        }
    }
}

Modificar un acuerdo para agregar anulaciones y prohibir determinadas creatividades

En este ejemplo, actualizamos una oferta para permitir que las creatividades de audio iniciadas automáticamente y por el usuario se publiquen siempre, independientemente de la configuración de calidad de los anuncios. También prohibimos específicamente dos identificadores creativos.

$ cat deal_override
 
{
    "deal": {
        "id": 201,
        "technical_attributes": [
            {
                "id": 7,
                "name": "Audio: user-initiated",
                "override": true
            },
            {
                "id": 8,
                "name": "Audio: auto-initiated",
                "override": true
            }
        ],
        "creatives": [
            {
                "id": 987654,
                "status": "banned"
            },
            {
                "id": 123456,
                "status": "banned"
            }
        ]
    }
}
 
$ curl -b cookies -c cookies -X PUT -d @deal_override.json 'https://api.appnexus.com/deal?id=64'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "64",
        "start_element": 0,
        "num_elements": 100,
        "deal": {
            "id": 201,
            "code": null,
            "name": "Private deal for buyer 1085 with no floor",
            "description": null,
            "active": false,
            "start_date": "2016-12-01 00:00:00",
            "end_date": "2017-01-31 23:59:59",
            "profile_id": null,
            "package_id": null,
            "floor_price": 0,
            "currency": "USD",
            "use_deal_floor": false,
            "last_modified": "2016-12-04 20:51:35",
            "seller": {
                "id": 2345,
                "name": "Seller 123"
            },
            "buyer": {
                "id": 1234,
                "bidder_id": 6,
                "name": "Buyer 456"
            },
            "type": {
                "id": 2,
                "name": "Private Auction"
            },
            "technical_attributes": [
                {
                    "id": 7,
                    "name": "Audio: user-initiated",
                    "override": true
                },
                {
                    "id": 8,
                    "name": "Audio: auto-initiated",
                    "override": true
                }
            ],
            "creatives": [
                {
                    "id": 987654,
                    "status": "banned"
                },
                {
                    "id": 123456,
                    "status": "banned"
                }
            ],
            "ask_price": 0,
            "size_preference": null
        }
    }
}

Ver todas las ofertas que tiene con los compradores

$ curl -b cookies -c cookies 'https://api.appnexus.com/deal'
{
    "response": {
        "status": "OK",
        "count": 7,
        "start_element": 0,
        "num_elements": 100,
        "deals": [
            {
                "id": 63,
                "code": null,
                "name": "Private deal for buyer 1234 with floor of $2.50",
                "description": null,
                "active": false,
                "seller_member_id": 2345,
                "start_date": "2016-12-01 00:00:00",
                "end_date": "2016-12-31 23:59:59",
                "profile_id": null,
                "package_id": null,
                "floor_price": 2.5,
                "currency": "USD",
                "use_deal_floor": true,
                "last_modified": "2016-12-04 20:39:57",
                "seller": {
                    "id": 2345,
                    "name": "Seller 123"
                },
                "buyer": {
                    "id": 1234,
                    "bidder_id": 6,
                    "name": "Buyer 456"
                },
                "type": {
                    "id": 2,
                    "name": "Private Auction"
                },
                "brands": [
                    {
                        "id": 1,
                        "name": "Example Brand"
                    }
                ],
                "ask_price": 3,
                "size_preference": null
            },
            {
                "id": 64,
                "code": null,
                "name": "Private deal for buyer 1234 with no floor",
                "description": null,
                "active": false,
                "start_date": "2016-12-01 00:00:00",
                "end_date": "2016-12-31 23:59:59",
                "profile_id": null,
                "package_id": null,
                "floor_price": 1.2,
                "currency": "USD",
                "use_deal_floor": false,
                "last_modified": "2016-12-04 20:43:44",
                "seller": {
                    "id": 2345,
                    "name": "Seller 123"
                },
                "buyer": {
                    "id": 1234,
                    "bidder_id": 2,
                    "name": "Buyer ABC"
                },
                "type": {
                    "id": 2,
                    "name": "Private Auction"
                },
                "brands": [
                    {
                        "id": 1,
                        "name": "Example Brand"
                    }
                ],
                "ask_price": 0,
                "size_preference": null
            }
        ]
    }
}

Ver una oferta específica

$ curl -b cookies -c cookies 'https://api.appnexus.com/deal?id=64'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "deal": {
            "id": 64,
            "code": null,
            "name": "Private deal for buyer 1234 with no floor",
            "description": null,
            "active": false,
            "start_date": "2016-12-01 00:00:00",
            "end_date": "2017-01-31 23:59:59",
            "profile_id": null,
            "package_id": null,
            "floor_price": 1,
            "currency": "USD",
            "use_deal_floor": false,
            "last_modified": "2016-12-04 20:51:35",
            "seller": {
                "id": 2345,
                "name": "Seller 123"
            },
            "buyer": {
                "id": 1234,
                "bidder_id": 2,
                "name": "Buyer ABC"
            },
            "type": {
                "id": 2,
                "name": "Private Auction"
            },
            "brands": [
                {
                    "id": 1,
                    "name": "Example Brand"
                },
                {
                    "id": 5,
                    "name": "Another Brand"
                }
            ],
            "ask_price": 1.25,
            "size_preference": null
        }
    }
}

Eliminar una oferta

$ curl -b cookies -c cookies -X DELETE 'https://api.appnexus.com/deal?id=61'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": null,
        "num_elements": null
    }
}