Servicio participante del tipo de identidad
Nota:
Este servicio se encuentra actualmente en Alpha. Todavía está en desarrollo y puede estar sujeto a cambios sin previo aviso. Póngase en contacto con su representante de cuenta de Xandr para habilitarse.
El servicio Identity Type Participant de Identity Management Framework permite a los participantes del marco de identidad administrar permisos para todas las soluciones de identidad que están aprovechando. Con el servicio Identity Type Participant, cada participante del publicador puede:
- Elija los licitadores externos a los que se les permite acceder a su identificador.
- Determine los asociados de la plataforma que tienen derecho a recibir el valor del identificador dentro de sus fuentes de distribución de datos de registro.
API de REST
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/identity-type-participant | Ver todos los participantes en la plataforma. |
GET |
https://api.appnexus.com/identity-type-participant?id=IDENTITY_ID1 | Ver los detalles de los participantes de un identificador específico. Aquí, IDENTITY_ID1 del identificador se pasa como cadena de consulta en el método . |
GET |
https://api.appnexus.com/identity-type-participant?id=IDENTITY_ID1,IDENTITY_ID2,IDENTITY_ID3 | Ver participantes asignados a varios identificadores mediante una lista separada por comas. |
GET |
https://api.appnexus.com/identity-type-participant?id=IDENTITY_ID1&p articipant_member_id=MEMBER_ID1 | Ver participantes asignados a un identificador y filtros por un miembro. |
GET |
https://api.appnexus.com/identity-type-participant?id=IDENTITY_ID1&p articipant_member_id=MEMBER_ID1,MEMBER_ID2,MEMBER_ID3 | Ver participantes asignados a un identificador y filtros por varios miembros. |
POST |
https://api.appnexus.com/identity-type-participant?id=IDENTITY_ID1 | Agregue un participante de tipo de identidad con un identificador específico.
IDENTITY_ID1 Este es un ejemplo de un identificador del participante del publicador.Campo Solo participante y administrador de Microsoft. |
PUT |
https://api.appnexus.com/identity-type-participant?id=IDENTITY_ID1 | Actualice los detalles de un participante del tipo de identidad existente. Campo Solo participante y administrador de Microsoft. |
DELETE |
https://api.appnexus.com/identity-type-participant?id=IDENTITY_ID1&p articipant_member_id=MEMBER_ID1 | Elimine un participante de tipo de identidad existente. Campo Solo participante y administrador de Microsoft. |
Campos JSON
Campos de registro para el participante del tipo de identidad
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | Identificador creado por Microsoft del participante del tipo de identidad. Solo lectura. Obligatorio en: POST , PUTy DELETE. |
participant_member_id |
Entero | Identificador de miembro al que pertenece el participante del tipo de identidad. Obligatorio en: POST , PUTy DELETE. |
Configuración de control de un servicio de participantes de tipo de identidad
| Campo | Tipo | Descripción |
|---|---|---|
external_bidder_control |
objeto | Configuración que permite el envío de identificadores a los licitadores externos y especifica los aptos. Para obtener más información, consulte Control del licitador externo a continuación. |
lld_exposure_control |
objeto | Configuración que configura si el identificador se puede usar en datos de nivel de registro (LLD) y determinar los destinatarios autorizados. Para obtener más información, consulte Control de exposición de datos de nivel de registro a continuación. |
Control del licitador externo
La configuración maestra para controlar si el identificador se puede enviar a los licitadores externos y especifica los licitadores externos aptos. Este campo define la lista predeterminada de licitadores que recibirán el origen y el identificador recién registrados. De forma predeterminada, los participantes miembros pueden usar los licitadores definidos en el nivel de identificador.
| Campo | Tipo | Descripción |
|---|---|---|
allow_bidders |
string | Los miembros de los licitadores externos habilitados para recibir el identificador: Opciones: - “use_master_settings”- “none”- “include_subset” |
external_bidder_list |
matriz de enteros | Lista de member_id habilitados para: “include_subset”. |
Control de exposición de datos de nivel de registro
La configuración del participante para regular si el identificador se puede usar en los datos de nivel de registro (LLD) y determinar los destinatarios autorizados. Este campo define la lista de miembros que podrán ver los valores de identificador reales en la fuente LLD para el origen y el identificador recién registrados. De forma predeterminada, los participantes miembros pueden usar los miembros definidos en el nivel de identificador.
| Campo | Tipo | Descripción |
|---|---|---|
lld_exposure_allowed |
string | Miembros habilitados para recibir valores de identificador en LLD. Opciones: - “use_master_settings”- “none”- “include_subset” |
exposure_member_list |
matriz de enteros | Lista de member_id habilitados para: “include_subset”. |
Ejemplos
Creación de un participante de tipo de identidad
$ cat identity_type_participant.json
{
"identity_type_particpant": {
"id": 103,
"participant_member_id": "113",
"external_bidder_control": {
"allow_bidders": "use_master_settings",
"external_bidder_list": []
},
"lld_exposure_control": {
"lld_exposure_allowed": "include_subset",
"exposure_member_list": [
312
]
}
}
}
$ curl -b cookie -c cookie -X POST 'https://api.appnexus.com/identity-type-participant?id=IDENTITY_ID001'
{
"response": {
"status":"OK",
"id":103
}
}
Ver los detalles de un participante de tipo de identidad
$ curl -b cookie -c cookie 'https://api.appnexus.com/identity-type-participant?id=IDENTITY_ID001&participant_member_id=113'
{
"response": {
"status":"OK",
"identity_type_particpant": {
"id": 103,
"participant_member_id": "113",
"external_bidder_control": {
"allow_bidders": "use_master_settings",
"external_bidder_list": []
},
"lld_exposure_control": {
"lld_exposure_allowed": "include_subset",
"exposure_member_list": [312]
}
}
}
}