Servicio de uso compartido de datos de miembros

El Servicio de intercambio de datos de miembros le permite compartir sus segmentos con otros miembros de la plataforma. Aquí se muestra cómo funciona:

  1. Le pide al comprador que le habilite a usted (el proveedor de datos) en Microsoft Invest. La configuración que deben usar para hacer esto se encuentra en Microsoft Invest Segment Manager, en Administrar proveedores de datos.
  2. Usted crea un registro de uso compartido para un miembro con el que desea compartir segmentos.
  3. En el registro de uso compartido, especifique si desea compartir todos los segmentos o una lista específica de segmentos.
  4. El miembro con el que ha compartido sus segmentos puede dirigirse a sus segmentos en las campañas (o en el caso de los ofertantes, se le enviarán los datos del segmento con cada solicitud de oferta).

Nota:

Cuando se quita un segmento de un registro de uso compartido, el miembro no puede agregar el segmento al perfil de segmentación de ninguna campaña nueva o existente. Sin embargo, si el miembro ya está segmentando el segmento en una campaña existente, la campaña seguirá segmentando el segmento hasta que lo quite manualmente del perfil de segmentación de la campaña. Una vez quitado el segmento, el miembro no podrá volver a agregarlo al perfil de segmentación de la campaña.

  • Los segmentos a nivel de anunciante no se pueden compartir. Solo se pueden compartir segmentos de nivel de miembro/red. Para mover segmentos del anunciante al nivel de red, puede establecerlos advertiser_idNULL a través del Servicio de segmentos.
  • No puede compartir segmentos con miembros compradores que pertenezcan a DSP integrados externamente.
  • El servicio de intercambio de datos de miembros ahora 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 con api.appnexus.com para aquellos clientes que tienen 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 impresión.

API de REST

Método HTTP 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_ID
where data_member_id = su ID de miembro y buyer_member_id = el ID 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
(compartir JSON)

Nota: El objeto member-data-sharing no puede ser una matriz si está 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
(compartir JSON)

Nota: El objeto member-data-sharings (plural) debe ser una matriz si está en plural.		 Cree varios registros de uso compartido para compartir segmentos con varios miembros.
PUT https://api.adnxs.com/member-data-sharing?id=RECORD_ID

Nota:
- Este método elimina todos los segmentos existentes, reemplazándolos solo con la lista recién especificada.
- Para eliminar uno o más segmentos de una lista, debe reemplazar toda la lista con los segmentos deseados.		 Reemplazar la lista de segmentos compartidos dentro de un registro de uso compartido.
PUT https://api.adnxs.com/member-data-sharing?id=RECORD_ID&append=true

Nota: Los segmentos solo se pueden agregar a la lista con la marca "append" y no se pueden eliminar.		 Anexar segmentos de una lista de segmentos compartidos dentro de un registro de uso compartido.
DELETE https://api.adnxs.com/member-data-sharing?id=RECORD_ID Eliminar 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 llamados "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 un formato exacto, consulta los ejemplos siguientes.

Campos JSON

Campo Tipo (longitud) Descripción
id Entero Id. del registro de uso compartido.
Valor predeterminado: Número generado automáticamente
Requerido en:PUT/DELETE, en la cadena de consulta
data_member_id Entero Solo lectura. Su ID de miembro.
buyer_member_id Entero El identificador del miembro con el que está compartiendo segmentos.
Requerido en:POST
segment_exposure enumeración Si comparte todos los segmentos o una lista de segmentos específicos con el miembro. Valores posibles: "all" o "list". Si lo 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.
Requerido en:POST

Nota: Los proveedores de datos en Data Market Place no deben crear registros de uso compartido eligiendo segment_exposure el valor como "all". Si existe algún registro de este tipo, actualice el valor e "list" incluya la lista de segmentos adecuada.
segments matriz de objetos Si segment_exposure es "list", la lista de segmentos que está compartiendo con el miembro. Vea el primer ejemplo a continuación para el formato.
Requerido 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": {
            ...
        }
    }
    }

Actualizar el registro de uso compartido del miembro 104

En este ejemplo, la PUT solicitud agrega 121179 de segmento al registro de uso compartido 55 (el registro de uso compartido del 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": {
            ...
        }
    }
}

Ver 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": {
            ...
        }
    }
}
  • Last updated on