Microsoft Invest: asignación de id. de usuario con getUID y mapUID
Es posible que tenga datos internos sin conexión sobre los usuarios que necesite insertar en la Tienda de cookies del lado de Microsoft Advertising Server para que estén disponibles para la toma de decisiones. Si es así, primero debemos asignar los identificadores de usuario internos y los identificadores de usuario de Microsoft Advertising para poder coincidir con los identificadores de usuario en futuras solicitudes. En función de si almacenará la asignación en el sistema o en el nuestro, hay dos maneras de hacerlo a través de llamadas a píxeles: mapUID y getUID.
El servicio getUID recupera el identificador de Microsoft Advertising para que pueda coordinarlo con su propio servidor de id. interno o en su propio espacio de cookies. A continuación, puede pasar una fuente de distribución de datos sin conexión que diga", "actualice el abc del usuario de Microsoft Advertising con los siguientes datos de segmento". El servicio mapUID nos pasa su identificador interno para asignarlo al identificador de Microsoft Advertising en el almacén de cookies de Microsoft Advertising.
Nota:
Tenga en cuenta que la macro id. de usuario de Microsoft Advertising que se describe a continuación es $UID. A diferencia de muchas de nuestras otras macros, no tiene llaves.
Ejemplo de asignación básica
| Id. de usuario de Prostarr | PS123 |
| Id. de usuario de Microsoft Advertising | 2894234234 |
| Id. de segmento del comprador de calzado | 0005 |
Si el anunciante Prostarr nos dice que el usuario PS123 está en el segmento 0005, esto no significará nada para nosotros. En su lugar, tienen que indicarnos que el usuario 2894234234 está en el segmento 0005.
Para ello, Prostarr ha realizado una asignación anterior de todos los identificadores de usuario de Microsoft Advertising y Prostarr Sportswear mediante el servicio GetUID y ha almacenado esa asignación en su base de datos interna. Una llamada getUID tiene el aspecto de
https://ib.adnxs.com/getuid?URL
donde la dirección URL es la a la que desea que se dirija la asignación. Este píxel se coloca en las páginas web de Prostarr y, cuando se activa, el Bus de impresiones inserta el identificador de usuario de Microsoft Advertising en la dirección URL reemplazando la $UID macro.
Sugerencia
Para obtener un tutorial detallado de cómo funciona esto, consulte el objeto visual de asignación de usuario y el tutorial.
El servicio getUID
Una dirección URL de su elección recibirá una llamada del lado cliente con el identificador de usuario de Microsoft Advertising como parámetro querystring. Durante la llamada al anuncio, Microsoft Advertising redirige al usuario a la dirección URL deseada del miembro. El Bus de impresiones inserta el identificador de usuario de Microsoft Advertising en la dirección URL, ya sea reemplazando una $UID macro o anexándola al final de la dirección URL. Cuando el usuario no tiene una cookie de Microsoft Advertising, "0" se devuelve y Microsoft Advertising intenta crear una. Sin embargo, si el usuario encuentra la llamada getuid por primera vez, "0" no se devolverá.
Código
El formato del servicio getUID es bastante sencillo:
https://ib.adnxs.com/getuid?URL
La versión segura usa este formato:
https://secure.adnxs.com/getuid?URL
Los usuarios sin cookies o usuarios que hayan optado por no participar se le redirigirán con un identificador de usuario de 0. Si prefiere no recibir identificadores de usuario de 0, use este formato:
https://ib.adnxs.com/getuidnb?URL
Si necesita que la dirección URL permanezca codificada con URI, use este formato:
https://ib.adnxs.com/getuidu?URL
Compatibilidad con JSON
Para devolver el identificador de usuario de Microsoft Advertising en una respuesta JSON con compatibilidad con CORS, use el formato:
https://ib.adnxs.com/getuidj
Recibirá una respuesta con formato JSON como esta:
{"uid":1680598911678123849}
Para devolver una respuesta JSONP con compatibilidad con CORS:
https://ib.adnxs.com/getuidp?callback=ABC
donde callback es la función de devolución de llamada tal como se define en la cadena de consulta. Recibirá una respuesta con formato JSONP como esta:
ABC({"uid":1680598911678123849})
Ejemplo de getUID
En la mayoría de los casos, será necesario pasar el identificador de usuario a un parámetro especificado dentro de la cadena de consulta de la dirección URL. Para ello, puede usar la $UID macro:
https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&geo=35&referrer=https://www.website.com
La $UID macro se reemplazará por el identificador de usuario de Microsoft Advertising por el bus de impresiones y el usuario se dirigirá a la siguiente dirección URL:
https://ad.adserver.com/pixel?adnxs_uid=19241908471992&geo=35&referrer=https://www.website.com
Caso de uso: piggyback en una llamada de píxel
Una manera sencilla de crear esta asignación es quitar el servicio getUID de una de las llamadas de píxeles existentes. Puede ajustar el píxel para que, cuando se realice la llamada de píxel, haya una redirección inmediata al servicio getUID de Microsoft Advertising, que devolverá el identificador de usuario dentro de la dirección URL indicada por Microsoft Invest.
Por ejemplo, supongamos que el siguiente píxel existe actualmente en un sitio del publicador:
<img src="media/pixel?id=234123" width=1 height=1/>
En su lugar, active el píxel getUID de Microsoft Advertising y proporcione la dirección URL del píxel adserver.com:
https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?id=234123&adnxs_uid=$UID
El servicio getUID redirige a la dirección URL especificada con el identificador de usuario de Microsoft Advertising en lugar de la $UID macro:
https://ad.adserver.com/pixel?id=234123&adnxs_uid=19241908471992
Cuando adserver.com recibe esta llamada, el identificador de usuario de Microsoft Advertising se puede insertar en el adserver.comalmacén de datos de usuario del lado servidor, donde esta asignación de identificadores de usuario se puede usar en futuras llamadas de impresión y píxeles a través del Bus de impresiones de Microsoft Advertising.
El servicio mapUID
Sugerencia
El servicio mapUID tiene cargos asociados. Si está interesado en usar esta opción, hable con su representante de Microsoft Advertising.
El servicio mapUID inserta el identificador interno en el Almacén de cookies del lado de Microsoft Advertising Server.
El formato de un píxel del lado cliente que asigna el identificador al nuestro en nuestro sistema es
https://ib.adnxs.com/mapuid?member=MEMBER_ID&user=USER_UD
donde el id. de miembro es el id. asignado a su empresa por Microsoft Advertising y es el USER_ID identificador de usuario de su empresa. Si no conoce el identificador de miembro, puede averiguarlo si realiza una GET solicitud al Servicio para miembros.
Si tiene más de un identificador de usuario, puede separarlos con punto y coma; por ejemplo:
https://ib.adnxs.com/mapuid?member=123&user=ABC;DEF;GHI
Expiración de asignaciones
El promedio de tiempo de vida (TTL) para las asignaciones de mapUID es de aproximadamente 2,5 semanas. Por lo tanto, es muy importante que active el píxel mapUID con la mayor frecuencia posible y en tantas páginas como sea posible para mantener las asignaciones activas.
Piggybacking a segment call off of a mapUID call
Puede agregar identificadores de usuario a uno o varios segmentos en el almacén de cookies de Microsoft Advertising al mismo tiempo que asigna su identificador al nuestro.
Esta es la sintaxis:
https://ib.adnxs.com/mapuid?member=[MEMBER_ID]&user=[USER_ID]&seg=[SEG_ID],[SEG_ID],[SEG_ID]
https://ib.adnxs.com/mapuid?member=123&user=12abc34565&seg=1,2,3
Para pasar valores para cada segmento, use dos puntos. En este ejemplo se usan códigos de segmento en lugar de identificadores.
https://ib.adnxs.com/mapuid?member=123&user=[USER_ID]&seg_code=[code1]:[code1value],[code2]:[code2value],[code3]:[code3value]
Enviarnos los datos del segmento sin conexión
Para obtener más información sobre cómo enviarnos los datos del segmento sin conexión, consulte el servicio batch segment de la API.