Servicio de uso compartido de datos de miembros (solo contextual)

Artículo
05/18/2024

Sugerencia

Para que la documentación de uso compartido de datos de miembros sea más clara, hemos creado esta página que solo tiene las llamadas que son pertinentes para los proveedores de datos con una integración en tiempo real (es decir, los proveedores de datos que tienen un licitador).

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:

Le pide al comprador que le habilite (el proveedor de datos) en Invest DSP. La configuración que deben usar para hacerlo se encuentra en Invest DSP 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 has compartido tus segmentos puede dirigirte a tus segmentos en campañas.

Nota:

En el caso de los licitadores, los segmentos compartidos se enviarán con cada solicitud de puja. Depende del postor exponer el segmento a sus miembros pertinentes. No puede compartir segmentos con licitadores externos.

Tenga en cuenta que 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.

Sugerencia

Si tiene segmentos personalizados destinados a miembros específicos, debe establecer segment_exposure en "lista" en cada registro de uso compartido y usar la segments matriz para identificar los segmentos a los que cada miembro debe tener acceso.

Nota:

El servicio de uso compartido de datos de miembros funciona tanto en la API de Xandr (api.appnexus.com) 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
DELETE	https://api.adnxs.com/member-data-sharing?id=RECORD_ID https://api.adnxs.com/member-data-sharing/RECORD_ID	Eliminación de un registro de uso compartido
GET	https://api.adnxs.com/member-data-sharing	Ver todos los registros de uso compartido
GET	https://api.adnxs.com/member-data-sharing?id=RECORD_ID https://api.adnxs.com/member-data-sharing/RECORD_ID Si no conoce el identificador de registro, puede usar el punto de conexión siguiente. https://api.adnxs.com/member-data-sharing?data_member_id=MEMBER_ID& buyer_member_id=CLIENT_MEMBER_ID	Visualización de un registro de uso compartido específico
POST	https://api.adnxs.com/member-data-sharing?data_member_id=MEMBER_ID (uso compartido de JSON)	Adición de un registro de uso compartido Nota: El objeto member-data-sharing no puede ser una matriz si es singular.
POST	https://api.adnxs.com/member-data-sharings?data_member_id=MEMBER_ID (uso compartido de JSON)	Adición de varios registros de uso compartido Nota: El objeto member-data-sharings debe ser una matriz si es plural.
PUT	https://api.adnxs.com/member-data-sharing?id=RECORD_ID (uso compartido de JSON) https://api.adnxs.com/member-data-sharing/RECORD_ID (uso compartido de JSON)	Modificación de un registro de uso compartido

Nota:

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 varios registros de uso compartido (POST), debe estructurar el JSON como una matriz de objetos denominados "member_data_sharings" (anote 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)	Description
buyer_member_id	Entero	Identificador del miembro con el que comparte segmentos. Obligatorio activado: POST
data_member_id	Entero	Solo lectura. Su id. de miembro.
id	Entero	Identificador del registro de uso compartido. Valor predeterminado: número generado automáticamente Obligatorio activado: PUT/DELETE, en la cadena de consulta
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 exposición de "lista". Obligatorio activado: POST
segments	matriz de objetos	Si segment_exposure es "lista", 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

Nota:

En este ejemplo, la solicitud PUT 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/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/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": {
         ...
        }
    }
}

Compartir a través de

API de REST

Campos JSON

Ejemplos

Recursos adicionales

Compartir a través de

Servicio de uso compartido de datos de miembros (solo contextual)

Servicio de uso compartido de datos de miembros (para proveedores de datos en tiempo real)

API de REST

Campos JSON

Ejemplos

Recursos adicionales