Partager via


Service réseau médiaté

Remarque

Disponible uniquement pour les clients Microsoft Monetize Ad Server.

Ce service est utilisé pour créer et gérer des réseaux médiés. Utilisez ce service pour définir votre intégration à un réseau externe.

API REST

HTTP, méthode Endpoint Description
POST https://api.appnexus.com/mediated-network
(+ charge utile JSON)
Ajouter un nouveau réseau médié
PUT https://api.appnexus.com/mediated-network?id=ID
(+ charge utile JSON)
Modifier un réseau médié
GET https://api.appnexus.com/mediated-network Afficher tous les réseaux médiés
GET https://api.appnexus.com/mediated-network?id=ID Afficher un réseau médié spécifique
DELETE https://api.appnexus.com/mediated-network?id=ID Supprimer un réseau médié
GET https://api.appnexus.com/mediated-network/meta Découvrez les champs que vous pouvez filtrer et trier par

Champs JSON

Champ Type Description
id int ID unique généré par le système pour ce réseau.

Obligatoire sur : PUT
name string Nom du réseau, tel que fourni par l’utilisateur.

Obligatoire sur : POST
credentials string En lecture seule. Valeur unique générée par le système qui identifie en toute sécurité le réseau. Les informations d’identification sont chiffrées après un POST ou et PUT ne peuvent pas être déchiffrées.
advertiser_id int En lecture seule. ID unique généré par le système de l’annonceur associé à ce réseau médié.
member_id int En lecture seule. Chaque objet annonceur dans notre système est associé à un membre parent. ID unique généré par le système du membre auquel appartient l’annonceur décrit par advertiser_id . (Et par extension, ce réseau médié ainsi.)
active valeur booléenne Les réseaux de médiation actifs ciblent et achètent des médias dans les enchères.

Par défaut : false
is_data_integration_active valeur booléenne Indique si les données de rapport sont actuellement extraites des systèmes de ce réseau dans les nôtres.

Par défaut : false
creative_custom_request_partner_id int Le partenaire de demande personnalisée créative auquel ce réseau est associé.

Obligatoire sur : POST
default_bid_currency string Devise à utiliser pour les enchères de ce réseau.

Par défaut : USD
processed_on date En lecture seule. Date et heure auxquelles l’élément de ligne associé à ce réseau médiatisé a été mis à jour avec des métriques (chiffre d’affaires, imps, clics) extraites du système de rapports du réseau externe.
last_modified date En lecture seule. Date et heure de la dernière modification de l’objet réseau médié.
network_type chaîne Type de réseau médié qu’il s’agit. Valeurs autorisées :
- mobile: ce réseau est axé sur l’achat d’inventaire mobile (in-app ?).
- banner: ce réseau est axé sur l’achat d’inventaire web.

Par défaut : mobile

Exemples

Ajouter un réseau médié

$ 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"
        }
    }
}

Mettre à jour un réseau médié

$ 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"
        }
    }
}

Afficher tous les réseaux médiés

$ 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"
            }
      ]
  }
}

Afficher un réseau médié spécifique

$ 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"
        }
    }
}

Supprimer un réseau médié

$ 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
    }
}