Servicio de relación de miembros

Artículo
05/17/2024

Nota:

Este servicio está disponible actualmente para un conjunto limitado de clientes y empleados de Microsoft. Esto incluye tanto clientes como asociados, así como compradores y vendedores individuales. Por ejemplo, un miembro comprador puede querer configurar una relación de compensación directa con un miembro del vendedor en lugar de borrar a través de nuestra plataforma.

Además, el apply_bid_landscape_priority campo permite a los vendedores que son clientes de fuentes horizontales de pujas ver todas las ofertas de un comprador específico en su fuente de panorama de pujas.

Nota:

La member_relation tabla de base de datos, en la que se basa este servicio de API, reemplaza la funcionalidad de la tabla heredada member_clearing . La member_clearing tabla ya no se usa.
Debe pasar por Las operaciones de ventas para configurar o editar una relación clara directa porque hay un impacto en la facturación y los contratos del cliente. La configuración o edición de una relación clara directa sin permiso de Sales Ops podría hacer que Xandr se metiera en problemas financieros o legales con los clientes. Si Sales Ops ha dado luz verde, Justin Pines o un IC harán la actualización.

API de REST

Http (método)	Endpoint	Description
`GET`	`https://api.appnexus.com/member-relation?buyer_member_id=MEMBER_ID`	Vea todas las relaciones financieras de un miembro como comprador con otros vendedores.
`GET`	`https://api.appnexus.com/member-relation?seller_member_id=MEMBER_ID`	Vea todas las relaciones financieras de un miembro como vendedor con otros compradores.
`GET`	`https://api.appnexus.com/member-relation?id=1,2,3`	Vea varios objetos de relación de miembro por identificador mediante una lista separada por comas.
`GET`	`https://api.appnexus.com/member-relation?member_id=100&id=1`	Ver una relación financiera de miembro específica:.
`PUT`	`https://api.appnexus.com/member-relation?member_id=100&id=1`	Actualice una relación financiera de miembro específica.
`POST`	`https://api.appnexus.com/member-relation?member_id=100`	Create una relación financiera de miembro específica.
`GET`	`https://api.appnexus.com/member-relation/meta`	Averigüe por qué campos puede filtrar y ordenar.

Campos JSON

Nombre	Tipo	Description
`id`	Entero	Identificador del sistema de este objeto.
`buyer_member_id`	Entero	Identificador de miembro de un miembro comprador que tiene una relación con este miembro. Obligatorio activado: `POST`
`seller_member_id`	Entero	Identificador de miembro de un miembro vendedor que tiene una relación con este miembro. Obligatorio activado: `POST`
`expose_inventory_sources`	booleano	Este campo no se usa. Valor predeterminado: `true`
`clear_direct`	booleano	Ya sea que Xandr recopile el costo de los medios o pague el pago del vendedor por las transacciones entre este par comprador-vendedor. De forma más precisa: - Si `true`es , Xandr no recopila el costo de los medios ni paga el pago del vendedor por las transacciones entre este par comprador-vendedor. Xandr solo cobra una cuota clara directa del comprador en función del valor de `member_contract.direct_clear_fee` para toda la actividad despejada directa en el mes. - Si `false`es , Xandr recopila el costo de los medios y paga el pago del vendedor por las transacciones entre este par comprador-vendedor. Xandr recopila una deducción o cuota del servicio de subasta de compradores o una deducción del vendedor en toda la actividad determinada por los contratos. Valor predeterminado: `false`
`apply_bid_landscape_priority`	booleano	Si incluir las ofertas de este comprador en la fuente de panorama de ofertas para el vendedor. De forma más precisa: Si `true`es , incluya siempre las ofertas del comprador en la fuente del panorama de la oferta para el vendedor, incluso si las ofertas de este comprador no estaban en el top 15 ni en la puja ganadora en la subasta. Si `false`es , trate el panorama de pujas del vendedor como lo haríamos normalmente. Valor predeterminado: `true`

Ejemplos

Ver una relación financiera específica

En este ejemplo, se ve una relación financiera determinada por identificador.

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

Ver todas las relaciones financieras de un miembro donde actúa como comprador (o vendedor)

En este ejemplo, vemos todas las relaciones de un miembro donde actúa como comprador de otros vendedores; para ver todas las relaciones en las que actúa como vendedor para otros miembros de compra, cambie el parámetro a seller_member_id :

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

Actualización de un objeto de relación de miembro específico

$ 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 nuevo objeto de relación de miembro

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

Compartir a través de