Servicio de partner de solicitud personalizada de Creative
Nota:
La mediación solo está disponible para los clientes de Microsoft Monetize Ad Server.
Para obtener contexto sobre la mediación, vea Vender su inventario a través de la mediación.
Los asociados de mediación, también conocidos como asociados de solicitud personalizados, se pueden identificar y definir a través de este servicio. Estos asociados se asignan a redes específicas del cliente a través de la interfaz de usuario o el servicio de red mediada.
Cada asociado también está asociado a plantillas definidas en el servicio de plantilla de solicitud personalizada creativa.
API de REST
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/creative-custom-request-partner | Ver todos los asociados. |
GET |
https://api.appnexus.com/creative-custom-request-partner?id=NETWORK_ID | Ver un asociado específico. |
POST |
https://api.appnexus.com/creative-custom-request-partner | Cree un nuevo asociado. |
PUT |
https://api.appnexus.com/creative-custom-request-partner?id=NETWORK_ID | Actualizar un asociado. |
DELETE |
https://api.appnexus.com/creative-custom-request-partner?id=NETWORK_ID | Eliminar un asociado. |
Campos JSON
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | Número de identificación único del asociado personalizado. |
name |
string | Nombre del asociado. Obligatorio activado: POST |
macro_type |
string | Indica el tipo de macros que se usan para definir el asociado. Valores permitidos: - standard: la integración no se realiza a través de una red personalizada definida por el usuario y tiene acceso a nuestras macros creativas estándar para compilar la solicitud. Esto puede incluir integraciones de SDK admitidas.- customsdk: la integración se realiza con una red móvil personalizada creada por el usuario.- customweb: la integración se realiza con una red web personalizada creada por el usuario.- customvideo: la integración se realiza con una red de vídeo personalizada creada por el usuario.Predeterminado: standard Obligatorio activado: POST |
member_id |
Entero | Determina quién puede usar este asociado de solicitud creativa personalizada. Un valor de 0 indica que cualquier miembro puede integrarse con (es decir, usar la mediación para vender a) este asociado. Si el valor es un identificador de miembro distinto de cero determinado, el asociado solo está disponible para ese miembro.Predeterminado: 0 |
last_modified |
datetime | Solo lectura. Fecha y hora en que se cambió por última vez este registro. |
creative_custom_request_templates |
matriz | Esta matriz contiene detalles sobre las macros que usará este asociado personalizado. Esto puede ser null si no se requiere información de macro. Para obtener más información, consulte Creative Custom Request Template Service. |
Ejemplos
Ver todos los asociados personalizados
{code}$ curl -b cookies -c cookies 'https://api.appnexus.com/creative-custom-request-partner'
{
"response":{
"status":"OK",
"count":19,
"start_element":0,
"num_elements":100,
"creative-custom-request-partners":[
{
"id":1,
"name":"unknown",
"macro_type":"standard",
"member_id":null,
"last_modified":"2014-03-21 21:43:33",
"creative_custom_request_templates":[
{
"id":14,
"name":null,
"type_id":6,
"creative_custom_request_partner_id":1,
"member_id":0,
"hostname":null,
"uri":null,
"port":80,
"is_post":false,
"content":"[ { \"tag\":\"#{TAG}\" } ] ",
"timeout_ms":0,
"is_client":true,
"last_modified":"2014-03-18 13:30:44",
"macros":[
{
"id":68,
"template_id":14,
"code":"TAG",
"name":"TAG",
"type":"string",
"is_required":false,
"last_modified":"2014-03-18 13:30:44"
}
]
},
{
"id":39,
"name":null,
"type_id":6,
"creative_custom_request_partner_id":1,
"member_id":0,
"hostname":null,
"uri":null,
"port":80,
"is_post":false,
"timeout_ms":0,
"is_client":true,
"last_modified":"2014-04-29 20:25:04",
"macros":null
},
{
"id":40,
"name":"Millennial Media Async",
"type_id":6,
"creative_custom_request_partner_id":1,
"member_id":0,
"hostname":null,
"uri":null,
"port":80,
"is_post":false,
"content":"[ { \"tag\":\"document.write('window.async = true; var cb = function(adFilled) { window.async = false; if (!adFilled) ADNXSMediation.noAd(); setTimeout(function(){ ADNXSMediation.next() }, 0); } ; window.mmAPI.placeAd({ containerElementId: \\\"adContainer\\\", apid: \\\"#{APID} \\\", placementType: \\\"inline\\\", width: ${WIDTH}, height: ${HEIGHT}, allowLocation: #{LOC} }, cb);');\" } ] ",
"timeout_ms":0,
"is_client":true,
"last_modified":"2014-05-27 19:45:45",
"macros":[
{
"id":118,
"template_id":40,
"code":"APID",
"name":"APID",
"type":"string",
"is_required":true,
"last_modified":"2014-05-27 19:45:45"
},
{
"id":119,
"template_id":40,
"code":"LOC",
"name":"Allow Location",
"type":"true_false",
"is_required":true,
"last_modified":"2014-05-27 19:45:45"
}
]
},
{
"id":41,
"name":"Millennial Media Async",
"type_id":6,
"creative_custom_request_partner_id":1,
"member_id":0,
"hostname":null,
"uri":null,
"port":80,
"is_post":false,
"content":"[ { \"tag\": \"http:\/\/s3.amazonaws.com\/APN-test\/millennial-web-2.js\", \"vars\":\"var APN={ } ;APN.apid='#{APID} ';APN.w=${WIDTH} ;APN.h=${HEIGHT} ;APN.loc=#{ LOC } ;\", \"width\":${WIDTH}, \"height\":${HEIGHT} } ] ",
"timeout_ms":0,
"is_client":true,
"last_modified":"2014-05-30 13:28:41",
"macros":[
{
"id":120,
"template_id":41,
"code":"APID",
"name":"APID",
"type":"string",
"is_required":true,
"last_modified":"2014-05-27 20:09:25"
},
{
"id":121,
"template_id":41,
"code":"LOC",
"name":"Allow Location",
"type":"true_false",
"is_required":true,
"last_modified":"2014-05-27 20:09:25"
}
]
},
{
"id":42,
"name":"Millennial Media Async",
"type_id":6,
"creative_custom_request_partner_id":1,
"member_id":0,
"hostname":null,
"uri":null,
"port":80,
"is_post":false,
"content":"[ { \"tag\": \"document.write(\\\" window.async = true; var cb = function(adFilled) { window.async = false; if (!adFilled) ADNXSMediation.noAd(); setTimeout(function(){ ADNXSMediation.next() }, 0); } ; window.mmAPI.placeAd({ containerElementId: \\\\\"adContainer\\\\\", apid: \\\\\"#{APID} \\\\\", placementType: \\\\\"inline\\\\\", width: #{WIDTH}, height: #{HEIGHT}, allowLocation: #{LOC} }, cb);\\\");\" } ] ",
"timeout_ms":0,
"is_client":true,
"last_modified":"2014-05-27 21:31:29",
"macros":[
{
"id":122,
"template_id":42,
"code":"APID",
"name":"APID",
"type":"string",
"is_required":true,
"last_modified":"2014-05-27 21:31:29"
},
{
"id":123,
"template_id":42,
"code":"LOC",
"name":"Allow Location",
"type":"true_false",
"is_required":true,
"last_modified":"2014-05-27 21:31:29"
}
]
}
]
},
{
"id":17,
"name":"inMobi",
"macro_type":"standard",
"member_id":null,
"last_modified":"2014-04-23 22:24:46",
"creative_custom_request_templates":null
},
}
{code}
Visualización de asociados personalizados asociados a un miembro específico
{code}
$ curl -b cookies -c cookies 'https://api.appnexus.com/creative-custom-request-partner?id=17'
{
"response":{
"status":"OK",
"count":1,
"start_element":0,
"num_elements":100,
"creative-custom-request-partner":{
"id":17,
"name":"inMobi",
"macro_type":"standard",
"member_id":null,
"last_modified":"2014-04-23 22:24:46",
"creative_custom_request_templates":null
}
}
}
}
{code}
Creación de un asociado personalizado
{code}$ cat create-custom-creative-request-partner-service.json
{
"creative-custom-request-partner": {
"name": "Fred's Company",
"macro_type": "standard"
}
}
$ curl -b cookies -c cookies -X POST -d @custom-creative-request-partner-service.json 'https://api.appnexus.com/creative-custom-request-partner'
{
"response":{
"status":"OK",
"count":1,
"id":49,
"start_element":0,
"num_elements":100,
"creative-custom-request-partner":{
"id":49,
"name":"Fred's Company",
"macro_type":"standard",
"member_id":null,
"last_modified":"2014-06-02 17:55:27",
"creative_custom_request_templates":null
}
}
}
{code}
Edición de un asociado personalizado
{code}$ cat edit-custom-creative-request-partner-service.json
{
"creative-custom-request-partner":{
"member_id": 3261
}
}
$ curl -b cookies -c cookies -X PUT -d @edit-ccr-partner-service.json 'https://api.appnexus.com/creative-custom-request-partner?id=17'
{
"response":{
"status":"OK",
"count":1,
"id":"17",
"start_element":0,
"num_elements":100,
"creative-custom-request-partner":{
"id":17,
"name":"inMobi",
"macro_type":"standard",
"member_id":3261,
"last_modified":"2014-06-03 14:36:49",
"creative_custom_request_templates":null
}
}
}
{code}
Eliminación de un asociado personalizado
{code}$ curl -b cookies -c cookies -X DELETE 'https://api.appnexus.com/creative-custom-request-partner?id=49'
{
"response": {
"status":"OK",
...
}
}
{code}