Partager via

Service de relations avec les membres

Remarque

Ce service est actuellement disponible pour un ensemble limité de clients et d’employés Microsoft uniquement. Cela inclut à la fois les clients et les partenaires, ainsi que les acheteurs et les vendeurs individuels. Par exemple, un membre acheteur peut souhaiter établir une relation de compensation directe avec un membre vendeur plutôt que d’effectuer une compensation via notre plateforme.

En outre, le apply_bid_landscape_priority champ permet aux vendeurs qui sont des clients de flux de paysage d’enchères de voir toutes les offres d’un acheteur spécifique dans leur flux de paysage d’enchères.

Remarque

  • La member_relation table de base de données, sur laquelle ce service d’API est basé, remplace les fonctionnalités de la table héritée member_clearing . La member_clearing table n’est plus utilisée.
  • Vous devez passer par Sales Ops pour configurer ou modifier une relation claire directe, car il y a un impact sur la facturation et les contrats des clients. La configuration et/ou la modification d’une relation claire directe sans l’autorisation des opérations commerciales peut entraîner des problèmes financiers ou juridiques avec les clients. Si Sales Ops a donné le feu vert, Justin Pines ou un IC effectuera la mise à jour.

API REST

HTTP, méthode Endpoint Description
GET https://api.appnexus.com/member-relation?buyer_member_id=MEMBER_ID Voir toutes les relations financières d’un membre en tant qu’acheteur avec d’autres vendeurs.
GET https://api.appnexus.com/member-relation?seller_member_id=MEMBER_ID Voir toutes les relations financières d’un membre en tant que vendeur avec d’autres acheteurs.
GET https://api.appnexus.com/member-relation?id=1,2,3 Afficher plusieurs objets de relation de membre par ID à l’aide d’une liste séparée par des virgules.
GET https://api.appnexus.com/member-relation?member_id=100&id=1 Afficher une relation financière de membre spécifique :.
PUT https://api.appnexus.com/member-relation?member_id=100&id=1 Mettre à jour une relation financière de membre spécifique.
POST https://api.appnexus.com/member-relation?member_id=100 Create une relation financière de membre spécifique.
GET https://api.appnexus.com/member-relation/meta Découvrez les champs que vous pouvez filtrer et trier.

Champs JSON

Nom Type Description
id int ID système de cet objet.
buyer_member_id int ID de membre d’un membre acheteur qui a une relation avec ce membre.

Obligatoire sur : POST
seller_member_id int ID de membre d’un membre vendeur qui a une relation avec ce membre.

Obligatoire sur : POST
expose_inventory_sources valeur booléenne Ce champ n’est pas utilisé.

Par défaut : true
clear_direct valeur booléenne Indique si Xandr perçoit le coût du média ou paie le paiement du vendeur pour les transactions entre cette paire acheteur-vendeur. Plus précisément :

- Si true, Xandr ne perçoit pas le coût du média ni ne paie le paiement vendeur pour les transactions entre cette paire acheteur-vendeur. Xandr ne perçoit que des honoraires clairs directs de l’acheteur en fonction de la valeur de member_contract.direct_clear_fee pour toutes les activités directes effacées dans le mois.

- Si false, Xandr collecte le coût du média et paie le paiement vendeur pour les transactions entre cette paire acheteur-vendeur. Xandr perçoit soit une déduction ou des frais de service de vente aux enchères de l’acheteur, soit une déduction du vendeur sur toutes les activités déterminées par les contrats.

Par défaut : false
apply_bid_landscape_priority valeur booléenne Indique s’il faut inclure les offres de cet acheteur dans le flux d’enchères pour le vendeur. Plus précisément :

Si truela valeur est , incluez toujours les enchères de l’acheteur dans le flux d’enchères pour le vendeur, même si les enchères de cet acheteur ne figuraient pas dans le top 15 ni dans l’enchère gagnante.

Si falsela valeur est , traitez le paysage des enchères du vendeur comme nous le ferions normalement.

Par défaut : true

Exemples

Afficher une relation financière spécifique

Dans cet exemple, nous affichons une relation financière particulière par ID.

$ curl -b cookies https://api.appnexus.com/member-relation?member_id=100&id=1
{
    "response": {
        "dbg_info": {
            "member_last_modified_age": 1436,
            "s1ave_lag": 0,
            "version": "1.13.8.16",
            "start_microtime": 1358438257.7108,
            "time": 30.287027359009,
            "warnings": [],
            "awesomesauce_cache_used": false,
            "db": "06.mysql.sand-08.nym2",
            "s1ave_hit": true,
            "instance": "11.hbapi.sand-08.nym1"
        },
        "member_relation": {
            "apply_bid_landscape_priority": false,
            "clear_direct": true,
            "expose_inventory_sources": true,
            "seller_member_id": 1,
            "buyer_member_id": 2,
            "id": 1
        },
        "num_elements": "",
        "start_element": "",
        "count": 1,
        "status": "OK"
    }
}

Afficher toutes les relations financières d’un membre où il agit en tant qu’acheteur (ou vendeur)

Dans cet exemple, nous examinons toutes les relations d’un membre où il agit en tant qu’acheteur auprès d’autres vendeurs ; Pour afficher toutes les relations dans lesquelles il agit en tant que vendeur par rapport à d’autres membres acheteurs, remplacez le paramètre seller_member_id par :

$ curl -b cookies https://api.appnexus.com/member-relation?buyer_member_id=100
{
    "response": {
        "dbg_info": {
            "s1ave_miss": "no_service_index",
            "version": "1.13.13",
            "start_microtime": 1360770598.1499,
            "time": 22.953033447266,
            "warnings": [],
            "awesomesauce_cache_used": false,
            "db": "master",
            "s1ave_hit": false,
            "instance": "30.bm-hbapi.prod.nym1"
        },
        "member_relations": [
            {
                "apply_bid_landscape_priority": false,
                "clear_direct": true,
                "expose_inventory_sources": true,
                "seller_member_id": 72,
                "buyer_member_id": 100,
                "id": 4
            }
        ],
        "num_elements": "",
        "start_element": "",
        "count": 1,
        "status": "OK"
    }
}

Mettre à jour un objet de relation membre spécifique

$ cat update-member-relation.json

{
    "member_relation": {
        "expose_inventory_sources": false
    }
}

$ curl -b cookies -X PUT "https://api.appnexus.com/member-relation?member_id=1309&id=1"
{
    "response": {
        "dbg_info": {
            "master_time": 417.2089099884,
            "proxy": true,
            "master_instance": "05.hbapi.sand-08.lax1",
            "version": "1.13.8.17",
            "start_microtime": 1358958675.3114,
            "time": 762.11285591125,
            "warnings": [],
            "awesomesauce_cache_used": false,
            "parent_dbg_info": {
                "version": "1.13.8.17",
                "start_microtime": 1358958675.4393,
                "time": 417.2089099884,
                "warnings": [],
                "awesomesauce_cache_used": false,
                "db": "master",
                "s1ave_hit": false,
                "instance": "05.hbapi.sand-08.lax1"
            },
            "db": "master",
            "s1ave_hit": false,
            "instance": "10.hbapi.sand-08.nym1"
        },
        "member_relation": {
            "apply_bid_landscape_priority": false,
            "clear_direct": true,
            "expose_inventory_sources": false,
            "seller_member_id": 1,
            "buyer_member_id": 2,
            "id": 1
        },
        "num_elements": "",
        "start_element": "",
        "id": "1",
        "count": 1,
        "status": "OK"
    }
}

Create un nouvel objet de relation membre

$ cat new-member-relation.json

{
    "member_relation": {
        "expose_inventory_sources": true,
        "seller_member_id": 1308,
        "buyer_member_id": 1309,
        "clear_direct": true
    }
}

$ curl -b cookies -X POST -d @new-member-relation.json "https://api.appnexus.com/member-relation?member_id=1309"
{
    "response": {
        "dbg_info": {
            "master_time": 391.0858631134,
            "proxy": true,
            "master_instance": "05.hbapi.sand-08.lax1",
            "version": "1.13.8.17",
            "start_microtime": 1358963519.9095,
            "time": 556.19502067566,
            "warnings": [],
            "awesomesauce_cache_used": false,
            "parent_dbg_info": {
                "version": "1.13.8.17",
                "start_microtime": 1358963520.0377,
                "time": 391.0858631134,
                "warnings": [],
                "awesomesauce_cache_used": false,
                "db": "master",
                "s1ave_hit": false,
                "instance": "05.hbapi.sand-08.lax1"
            },
            "db": "master",
            "s1ave_hit": false,
            "instance": "11.hbapi.sand-08.nym1"
        },
        "member_relation": {
            "apply_bid_landscape_priority": false,
            "clear_direct": true,
            "expose_inventory_sources": true,
            "seller_member_id": 1312,
            "buyer_member_id": 1309,
            "id": 65
        },
        "num_elements": "",
        "start_element": "",
        "id": "65",
        "count": 1,
        "status": "OK"
    }
    }
  • Last updated on