Ofertas de venta en Xandr
Nota:
Usted debe estar certificado por Xandr para vender ofertas en nuestra plataforma. Póngase en contacto con el soporte técnico o con su representante de Xandr para averiguar cómo certificarse.
Como partner de suministro, puede usar ofertas para proporcionar a los compradores de Xandr acceso especial a su inventario o datos. Por ejemplo, un acuerdo podría proporcionar precios preferenciales sobre el inventario, acceso a inventario exclusivo, competencia reducida en el inventario u otras oportunidades.
Esta página le guiará por el proceso.
Antes de empezar
Para poder agregar ofertas a Xandr y realizar transacciones con compradores, debe:
- Esté certificado para vender ofertas en la plataforma.
- Comprenda el protocolo OpenRTB para solicitar y recibir ofertas de Xandr.
- Aprenda a usar la API de Xandr. Consulte nuestro proceso de incorporación de API.
Paso 1. Create la oferta en el sistema
- Negocia el trato con el comprador de Xandr.
- Agregue la oferta a su propio sistema.
- Pida al comprador de Xandr su id. de miembro de Xandr, que necesitará en el paso siguiente.
Paso 2. Agregar la oferta a Xandr
Nota:
En este paso se muestra cómo usar la API de Xandr para agregar una oferta a Xandr manualmente. Sin embargo, se recomienda crear un mecanismo automatizado para sincronizar las ofertas con Xandr cada vez que se creen en su propio sistema.
- Autentíquese en la API de Xandr.
- Si el comprador no le dio su id. de miembro de Xandr, use el Servicio para miembros de la plataforma para encontrarlo.
Sugerencia
Puede usar el parámetro de search cadena de consulta para buscar al comprador por nombre. En el ejemplo siguiente se muestra la respuesta que se devolvería al buscar compradores con "Place" en sus nombres. Tenga en cuenta que el id campo contiene el identificador de miembro.
$curl -b cookies -c cookies 'https://api.appnexus.com/platform-member?search=Place
{
"response": {
"status": "OK",
"count": 3,
"start_element": 0,
"num_elements": 100,
"platform-members": [
{
"id": 1001,
"name": "Some Place",
"description": null,
"primary_type": "network",
"platform_exposure": "public",
"email": null,
"daily_imps_verified": null,
"daily_imps_self_audited": null,
"daily_imps_unaudited": null,
"is_iash_compliant": false,
"seller_type": "platform",
"active": true,
"last_modified": "2015-07-29 16:53:35",
"default_discrepancy_pct": null,
"bidder": {
"id": "2",
"name": "Bidder1"
},
"contact_info": [
{
"name": "Joe Smith",
"title": "VP Media Operations",
"email": "jsmith@example.com",
"phone": "",
"address": "",
"address_2": "",
"city": "New York",
"country": "US",
"region": "NY",
"postal_code": "10012",
"additional_info": "We use proprietary technology to...",
"website_url": null,
"types": [
"supply",
"demand"
]
}
],
"daily_imps_appnexus_seller_reviewed": 16542600,
"daily_imps_any_audit_status": 16542600,
"daily_imps_appnexus_reviewed": 15226100,
"has_resold": true,
"visibility_rules": {
"id": 55,
"expose_publishers": true,
"expose_tags": true,
"expose_age": true,
"expose_gender": true,
"expose_universal_categories": true,
"expose_custom_categories": "all",
"url_exposure": "full",
"custom_categories": null
}
},
...
],
"dbg_info": {...
}
}
}
- Use el servicio Deal para agregar la oferta a Xandr. En json POST, asegúrese de:
- Establezca el campo en el
codeidentificador interno de la oferta. - Establezca el
idcampo delbuyerobjeto en el identificador de miembro del comprador. - Establezca el
use_deal_floorcampo en "true" y configure un nivel de oferta estableciendo elfloor_pricecampo. Cuandouse_deal_floores cierto, el precio mínimo de la oferta invalida cualquier otro piso que pueda tener, es decir, en colocaciones o perfiles de administración de rendimiento. - Excluya siempre los campos siguientes en el archivo JSON:
profile_id,package_id,created_by,payment_type
- Se recomienda excluir los siguientes campos en json para la mayoría de las ofertas:
size_preference,audit_status_option,brand_restrict,category_restrict,language_restrict,technical_attribute_restrict,brands,categories,languages,technical_attributes,creatives,priority,allowed_media_types,allowed_media_subtypes,media_preference
- Establezca el campo en el
Paso 3. Envío de una solicitud de puja con el identificador de la oferta
Para obtener instrucciones básicas sobre cómo crear una solicitud de puja, consulte Solicitud de puja de OpenRTB. Además, tenga en cuenta los siguientes requisitos para las ofertas:
- La solicitud de puja debe contener un objeto adicional denominado
pmp. - Dentro del
pmpobjeto, también debe incluir unadealsmatriz que contenga los códigos de oferta que desea exponer. Cada código de transacción debe especificarse como el valor delidcampo de esa matriz.
A continuación se muestra un archivo JSON de ejemplo que incluye una matriz de códigos de oferta.
cat bid_deal_request.json
{
"id": "TEGY5Ate8u",
"imp": [
{
"id": "4aXAJyMUJe",
"tagid": "yvU4UdeVeT",
"banner": {
"w": 300,
"h": 250
},
"pmp": {
"deals": [
{
"id": "Deal 1"
},
{
"id": "Deal 2"
}
]
},
"minduration": 0,
"maxduration": 3600,
"w": 300,
"h": 360,
"startdelay": 0
}
}
],
"site": {
"id": "yvU4UdeVeT",
"publisher": {
"id": "AQA1udaHAB"
}
},
"member_id": 95
}
A continuación, publique el archivo con formato JSON. Asegúrese de incluir el identificador de miembro en la cadena de consulta.
$ curl -X POST -d @bid_deal_request 'https://ib.adnxs.com/openrtb?member_id=123'
Paso 4. Escuchar las respuestas de la oferta al identificador de la oferta
Asegúrese de que está escuchando el valor pertinente dealid en la respuesta de puja de OpenRTB.
{
"id": "TEGY5Ate8u",
"seatbid": [
{
"seat": "57",
"bid": [
{
"impid": "4aXAJyMUJe",
"price": 0.002000,
"id": "4715012638089865238",
"adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><VAST version=\"2.0\"><Ad id=\"38\"></Ad></VAST>",
"adomain": ["appnexus.com"],
"crid": "38",
"cid": "57",
"iurl": "https://01-impbus-test17987.envnxs.net/cr?id=38",
"adid": "38",
"dealid": "Deal 1"
}
]
}
],
"cur": "USD"
}