Servicio de red mediada

Nota:

Solo está disponible para los clientes de Microsoft Monetize Ad Server.

Este servicio se usa para crear y mantener redes mediadas. Use este servicio para definir la integración con una red externa.

API de REST

Http (método)	Endpoint	Description
POST	https://api.appnexus.com/mediated-network (+ Carga json)	Adición de una nueva red mediada
PUT	https://api.appnexus.com/mediated-network?id=ID (+ Carga json)	Modificación de una red mediada
GET	https://api.appnexus.com/mediated-network	Visualización de todas las redes mediadas
GET	https://api.appnexus.com/mediated-network?id=ID	Visualización de una red mediada específica
DELETE	https://api.appnexus.com/mediated-network?id=ID	Eliminación de una red mediada
GET	https://api.appnexus.com/mediated-network/meta	Averigüe por qué campos puede filtrar y ordenar

Campos JSON

Campo	Tipo	Description
id	Entero	Identificador único generado por el sistema para esta red. Obligatorio activado: PUT
name	string	Nombre de la red, tal como lo proporciona el usuario. Obligatorio activado: POST
credentials	string	Solo lectura. Valor único generado por el sistema que identifica la red de forma segura. Las credenciales se cifran después de o POSTPUT y no se pueden descifrar.
advertiser_id	Entero	Solo lectura. Identificador único generado por el sistema del anunciante asociado a esta red mediada.
member_id	Entero	Solo lectura. Cada objeto anunciante de nuestro sistema está asociado a un miembro primario. Identificador único generado por el sistema del miembro al que pertenece el anunciante descrito por advertiser_id . (Y por extensión, esta red mediada también).
active	booleano	Las redes de mediación activas dirigen y compran medios en subastas. Valor predeterminado: false
is_data_integration_active	booleano	Si los datos de informes se están extrayendo actualmente de los sistemas de esta red en el nuestro. Valor predeterminado: false
creative_custom_request_partner_id	Entero	El asociado de solicitud personalizada creativa al que está asociada esta red mediada. Obligatorio activado: POST
default_bid_currency	string	Moneda que se va a usar para las pujas de esta red. Valor predeterminado: USD
processed_on	date	Solo lectura. Fecha y hora a la que se actualizó el elemento de línea asociado de esta red mediada con métricas (ingresos, imps, clics) extraídas del sistema de informes de la red externa.
last_modified	date	Solo lectura. Fecha y hora a la que se modificó por última vez el objeto de red mediado.
network_type	string	El tipo de red mediada es este. Valores permitidos: - mobile: esta red se centra en la compra de inventario de dispositivos móviles (desde la aplicación). - banner: esta red se centra en la compra de inventario web. Valor predeterminado: mobile

Ejemplos

Adición de una red mediada

$ cat add-network
{
    "mediated-network": {
        "name": "JMS Test 2",
        "creative_custom_request_partner_id": 1
    }
} 

$ curl -b cookies -c cookies -X POST -d @add-network.json 'https://api.appnexus.com/mediated-network

{
    "response":{
        "status":"OK",
        "count":1,
        "id":371,
        "start_element":0,
        "num_elements":100,
        "mediated-network":{
            "id":371,
            "name":"JMS Test 2",
            "credentials":null,
            "advertiser_id":110692,
            "member_id":4209,
            "active":true,
            "is_data_integration_active":false,
            "creative_custom_request_partner_id":1,
            "default_bid_currency": "USD",
            "processed_on":"1970-01-01 00:00:01",
            "last_modified":"2014-04-28 14:59:11",
            "bid_count":0,
            "network_type":"mobile"
        }
    }
}

Actualización de una red mediada

$ cat add-network

{
    "mediated-network": {
        "id": 368,
      "active": false   
    }
}

$ curl -b cookies -c cookies -X PUT -d @update-network.json 'https://sand.api.appnexus.com/mediated-network?member_id=4209' | json-pp

{
    "response":{
        "status":"OK",
        "count":1,
        "id":368,
        "start_element":0,
        "num_elements":100,
        "mediated-network":{
            "id":368,
            "name":"Integration Test TEST1398457680380",
            "credentials":"OlkWxzZaQjVpgMRd\/\/o6cbUgjuNYkrP\/toKzFRdR9gnpQ2upKNhDu5mQrr871RCjBbjsNlyO6hN2fVNg4VV
             LiMix2mrky38F\/M30uEIVo0zQzmVJ8K4Uz0UyLVagVwdsgNPx9sAN0LZD+ZskyXQx6R4dZCjQD9mKHLT+nJ2Usfs=",
            "advertiser_id":110648,
            "member_id":4209,
            "active":false,
            "is_data_integration_active":false,
            "creative_custom_request_partner_id":1,
            "default_bid_currency": "USD",
            "processed_on":"1970-01-01 00:00:01",
            "last_modified":"2014-04-28 14:56:48",
            "bid_count":0,
            "network_type":"mobile"
        }
    }
}

Visualización de todas las redes mediadas

$ curl -b cookies -c cookies 'https://api.appnexus.com/mediated-network

{
    "response":{
        "status":"OK",
        "count":20,
        "start_element":0,
        "num_elements":100,
        "mediated-networks":[
            {
                "id":89,
                "name":"Doubleclick for Publishers",
                "credentials":null,
                "advertiser_id":110021,
                "member_id":4209,
                "active":false,
                "is_data_integration_active":false,
                "creative_custom_request_partner_id":28,
                "default_bid_currency": "USD",
                "processed_on":"1970-01-01 00:00:01",
                "last_modified":"2014-04-18 23:37:01",
                "bid_count":0,
                "network_type":"mobile"
            },
            {
                "id":90,
                "name":"Tim's Custom Network",
                "credentials":null,
                "advertiser_id":110022,
                "member_id":4209,
                "active":false,
                "is_data_integration_active":false,
                "creative_custom_request_partner_id":22,
                "default_bid_currency": "EUR",
                "processed_on":"1970-01-01 00:00:01",
                "last_modified":"2014-04-18 23:37:01",
                "bid_count":0,
                "network_type":"mobile"
            },
            {
                "id":210,
                "name":"Amazon",
                "credentials":null,
                "advertiser_id":110203,
                "member_id":4209,
                "active":false,
                "is_data_integration_active":false,
                "creative_custom_request_partner_id":25,
                "default_bid_currency": "EUR",
                "processed_on":"1970-01-01 00:00:01",
                "last_modified":"2014-04-18 23:32:36",
                "bid_count":1,
                "network_type":"mobile"
            }
      ]
  }
}

Visualización de una red mediada específica

$ curl -b cookies -c cookies 'https://api.appnexus.com/mediated-network?id=368' | json-pp

{
    "response":{
        "status":"OK",
        "count":1,
        "start_element":0,
        "num_elements":100,
        "mediated-network":{
            "id":368,
            "name":"Integration Test TEST1398457680380",
            "credentials":"OlkWxzZaQjVpgMRd\/\/o6cbUgjuNYkrP\/toKzFRdR9gnpQ2upKNhDu5mQrr871RCjBbjsNlyO6hN2fVNg4VVL
             iMix2mrky38F\/M30uEIVo0zQzmVJ8K4Uz0UyLVagVwdsgNPx9sAN0LZD+ZskyXQx6R4dZCjQD9mKHLT+nJ2Usfs=",
            "advertiser_id":110648,
            "member_id":4209,
            "active":true,
            "is_data_integration_active":false,
            "creative_custom_request_partner_id":1,
            "default_bid_currency": "USD",
            "processed_on":"1970-01-01 00:00:01",
            "last_modified":"2014-04-25 20:28:07",
            "bid_count":0,
            "network_type":"mobile"
        }
    }
}

Eliminación de una red mediada

$ curl -b cookies -c cookies -X DELETE 'https://api.appnexus.com/mediated-network?id=371

{
    "response":{
        "status":"OK",
        "count":1,
        "start_element":null,
        "num_elements":null
    }
}

Temas relacionados

• Semántica de API
• Procedimientos recomendados de API
• Servicio de pujas mediadas