Servicio de uso compartido de datos de miembros
El servicio de uso compartido de datos de miembros le permite compartir sus segmentos con otros miembros de la plataforma. Aquí se muestra cómo funciona:
- Pida al comprador que le habilite (el proveedor de datos) en Microsoft Invest. La configuración que deben usar para hacerlo se encuentra en Microsoft Invest Segment Manager, en Administrar proveedores de datos.
- Se crea un registro de uso compartido para un miembro con el que desea compartir segmentos.
- En el registro de uso compartido, especifique si desea compartir todos los segmentos o una lista específica de segmentos.
- El miembro con el que ha compartido los segmentos puede dirigirse a los segmentos en campañas (o, en el caso de los licitadores, se les enviarán los datos del segmento con cada solicitud de puja).
Nota:
Al quitar un segmento de un registro de uso compartido, el miembro no puede agregar el segmento al perfil de destino de ninguna campaña nueva o existente. Sin embargo, si el miembro ya tiene como destino el segmento de una campaña existente, la campaña seguirá dirigiendo el segmento hasta que el miembro lo quite manualmente del perfil de destino de la campaña. Una vez quitado el segmento, el miembro no podrá agregarlo de nuevo al perfil de destino de la campaña.
- Los segmentos de nivel de anunciante no se pueden compartir. Solo se pueden compartir segmentos de nivel de miembro o de red. Para mover segmentos del anunciante al nivel de red, puede establecer en
advertiser_idaNULLtravés del servicio segment. - No puede compartir segmentos con miembros compradores que pertenezcan a proveedores de servicios integrados externamente.
- El servicio de uso compartido de datos de miembros ahora funciona en la API de Xandr (api.appnexus.com), así como en la API del bus de impresiones (api.adnxs.com). Aunque solo se usa api.adnxs.com a continuación, se puede reemplazar por api.appnexus.com para aquellos clientes que tengan acceso a la API de Xandr. Solo los miembros que están en Xandr tendrán acceso a la API. La mayoría de los proveedores de datos solo pueden acceder a la API del bus de impresiones.
API de REST
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.adnxs.com/member-data-sharing |
Ver todos los registros de uso compartido existentes. |
GET |
https://api.adnxs.com/member-data-sharing?id=RECORD_ID |
Ver un registro de uso compartido específico. |
GET |
https://api.adnxs.com/member-data-sharing?data_member_id=MEMBER_ID&buyer_member_id=CLIENT_MEMBER_IDwhere data_member_id = el identificador de miembro y buyer_member_id = el identificador de miembro del destinatario |
Recupere el identificador de registro de uso compartido mediante los identificadores de miembro. |
POST |
https://api.adnxs.com/member-data-sharing?data_member_id=MEMBER_ID (uso compartido de JSON) Nota: El objeto member-data-sharing no puede ser una matriz si es singular. |
Cree un registro de uso compartido para compartir segmentos con un miembro. |
POST |
https://api.adnxs.com/member-data-sharings?data_member_id=MEMBER_ID(uso compartido de JSON) Nota: El objeto member-data-sharings (plural) debe ser una matriz si es plural. |
Cree varios registros de uso compartido para compartir segmentos con varios miembros. |
PUT |
https://api.adnxs.com/member-data-sharing?id=RECORD_IDNota: - Este método quita todos los segmentos existentes, reemplazando los segmentos solo por la lista recién especificada. - Para quitar uno o varios segmentos de una lista, debe reemplazar toda la lista por los segmentos previstos. |
Reemplace la lista de segmentos compartidos dentro de un registro de uso compartido. |
PUT |
https://api.adnxs.com/member-data-sharing?id=RECORD_ID&append=trueNota: Los segmentos solo se pueden agregar a la lista con la marca "anexar" y no eliminarse. |
Anexar segmentos de la lista de segmentos compartidos dentro de un registro de uso compartido. |
DELETE |
https://api.adnxs.com/member-data-sharing?id=RECORD_ID |
Elimine un registro de uso compartido. |
Sugerencia
Estructura JSON:
Al agregar o actualizar un único registro de uso compartido, debe estructurar el json como un único objeto denominado "member_data_sharing". Al agregar POST varios registros de uso compartido, debe estructurar el JSON como una matriz de objetos denominados "member_data_sharings" (tenga en cuenta el plural) y colocar los datos de uso compartido en una matriz. No se pueden actualizar (PUT) varios registros de uso compartido al mismo tiempo. Para obtener el formato exacto, consulte los ejemplos siguientes.
Campos JSON
| Campo | Tipo (longitud) | Descripción |
|---|---|---|
id |
Entero | Identificador del registro de uso compartido. Predeterminado: Número generado automáticamente Obligatorio on: PUT/DELETE, en la cadena de consulta |
data_member_id |
Entero | Solo lectura. Su id. de miembro. |
buyer_member_id |
Entero | Identificador del miembro con el que comparte segmentos. Obligatorio activado: POST |
segment_exposure |
enumeración | Ya sea que comparta todos los segmentos o una lista de segmentos específicos con el miembro. Valores posibles: "all" o "list". Si elige "all", los segmentos recién creados se compartirán automáticamente con el miembro comprador. Si crea segmentos personalizados que solo deben ser accesibles para determinados compradores, debe usar la "list" exposición.Obligatorio activado: POST |
segments |
matriz de objetos | Si segment_exposure es "list", la lista de segmentos que va a compartir con el miembro. Consulte el primer ejemplo siguiente para obtener formato.Obligatorio en: POST/PUT, si segment_exposure es "list". |
Ejemplos
Compartir segmentos con los miembros 103 y 104
$ cat data_share_multiple
{
"member_data_sharings": [
{
"buyer_member_id": 103,
"segment_exposure": "all"
},
{
"buyer_member_id": 104,
"segment_exposure": "list",
"segments": [
{
"id": 121175
},
{
"id": 121176
},
{
"id": 121177
},
{
"id": 121178
}
]
}
]
}
$ curl -b cookies -c cookies -X POST -d @data_share_multiple 'https://api.adnxs.com/member-data-sharing?data_member_id=1432'
{
"response": {
"status": "OK",
"count": 2,
"start_element": null,
"num_elements": null,
"id": [
54,
55
],
"member_data_sharings": {
"54": {
"id": 54,
"data_member_id": 1432,
"buyer_member_id": 103,
"segment_exposure": "all",
"segments": null
},
"55": {
"id": 55,
"data_member_id": 1432,
"buyer_member_id": 104,
"segment_exposure": "list",
"segments": [
{
"id": 121175,
"name": "Segment share 1"
},
{
"id": 121176,
"name": "Segment share 2"
},
{
"id": 121177,
"name": "Segment share 3"
},
{
"id": 121178,
"name": "Segment share 4"
}
]
}
},
"dbg": {
...
}
}
}
Compartir segmentos con el miembro 105
$ cat data_share_single
{
"member_data_sharing": {
"buyer_member_id": 105,
"segment_exposure": "all"
}
}
$ curl -b cookies -c cookies -X POST -d @data_share_single 'https://api.adnxs.com/member-data-sharing?data_member_id=1432'
{
"response": {
"status": "OK",
"count": 1,
"start_element": null,
"num_elements": null,
"id": "56",
"member_data_sharing": {
"id": 56,
"data_member_id": 1432,
"buyer_member_id": 105,
"segment_exposure": "all",
"segments": null
},
"dbg": {
...
}
}
}
Actualización del registro de uso compartido para el miembro 104
En este ejemplo, la PUT solicitud agrega 121179 de segmento al registro de uso compartido 55 (el registro de uso compartido para el miembro 104).
$ cat data_share_update
{
"member_data_sharing": {
"segments": [
{
"id": 121175
},
{
"id": 121176
},
{
"id": 121177
},
{
"id": 121178
},
{
"id": 121179
}
]
}
}
$ curl -b cookies -c cookies -X PUT -d @data_share_update 'https://api.adnxs.com/member-data-sharing?id=55'
{
"response": {
"status": "OK",
"count": 1,
"start_element": null,
"num_elements": null,
"id": 55,
"member_data_sharing": {
"id": 55,
"data_member_id": 1432,
"buyer_member_id": 104,
"segment_exposure": "list",
"segments": [
{
"id": 121175,
"name": "test for sharing"
},
{
"id": 121176,
"name": "test for sharing2"
},
{
"id": 121177,
"name": "test for sharing3"
},
{
"id": 121178,
"name": "test for sharing4"
},
{
"id": 121179,
"name": "test for sharing4"
}
]
},
"dbg": {
...
}
}
}
Ver todos los registros de uso compartido
$ curl -b cookies -c cookies 'https://api.adnxs.com/member-data-sharing'
{
"response": {
"status": "OK",
"count": 5,
"start_element": null,
"num_elements": null,
"member_data_sharings": [
{
"id": 46,
"data_member_id": 1432,
"buyer_member_id": 100,
"segment_exposure": "all",
"segments": null
},
{
"id": 52,
"data_member_id": 1432,
"buyer_member_id": 101,
"segment_exposure": "all",
"segments": null
},
{
"id": 53,
"data_member_id": 1432,
"buyer_member_id": 102,
"segment_exposure": "all",
"segments": null
},
{
"id": 54,
"data_member_id": 1432,
"buyer_member_id": 103,
"segment_exposure": "all",
"segments": null
},
{
"id": 55,
"data_member_id": 1432,
"buyer_member_id": 104,
"segment_exposure": "list",
"segments": [
{
"id": 121175,
"name": "Segment share 1"
},
{
"id": 121176,
"name": "Segment share 2"
},
{
"id": 121177,
"name": "Segment share 3"
},
{
"id": 121178,
"name": "Segment share 4"
},
{
"id": 121179,
"name": "Segment share 5"
}
]
},
{
"id": 56,
"data_member_id": 1432,
"buyer_member_id": 105,
"segment_exposure": "all",
"segments": null
}
],
"dbg": {
...
}
}
}
Visualización del registro de uso compartido 55
$ curl -b cookies -c cookies 'https://api.adnxs.com/member-data-sharing?id=55'
{
"response": {
"status": "OK",
"count": 1,
"start_element": null,
"num_elements": null,
"member_data_sharing": {
"id": 55,
"data_member_id": 1432,
"buyer_member_id": 104,
"segment_exposure": "list",
"segments": [
{
"id": 121175,
"name": "Segment share 1"
},
{
"id": 121176,
"name": "Segment share 2"
},
{
"id": 121177,
"name": "Segment share 3"
},
{
"id": 121178,
"name": "Segment share 4"
},
{
"id": 121179,
"name": "Segment share 5"
}
]
},
"dbg": {
...
}
}
}