Compartir a través de

Sincronización de los identificadores de usuario

  • Artículo

En esta página se proporciona una introducción a la sincronización de identificadores de usuario y detalles sobre la asignación entre los identificadores de usuario de Xandr y los identificadores de usuario comprendidos por el licitador.

La integración entre el licitador y Xandr es una integración del lado servidor. Esto significa que:

  • La comunicación se produce estrictamente entre el bus de impresión de Xandr y las instancias del licitador
  • Durante el proceso de licitación, no tendrá acceso directo a las cookies en el navegador del usuario.

Si recibimos la impresión a través de una integración del lado servidor del partner de suministro, no tendremos acceso a nuestra cookie en el explorador del usuario. Por este motivo, realizamos la sincronización de usuarios con nuestros asociados de suministro. Esto da como resultado una asignación entre el identificador de usuario de Xandr y el identificador de asociado de suministro. La asignación puede ser almacenada por Xandr, en nuestro almacén de cookies del lado servidor o por el asociado de suministro.

Hay una solución similar disponible para los licitadores y proveedores de datos. Para realizar la sincronización, primero debemos identificar dónde se va a almacenar la asignación.

Advertencia

El pujador debe establecerse en Activo El pujador o el proveedor de datos debe establecerse en activo para que se produzca esta sincronización.

Almacenamiento de la asignación con Xandr

Nota:

A partir del 22 de abril de 2019, Xandr ya no admite los userdata_javascript campos y setuid_function . Los licitadores pueden hacer la llamada setuid directamente.

Para almacenar la asignación con Xandr,

  1. Agregue la siguiente función al campo "userdata_javascript" del licitador en el Servicio del Licitador:

       function setuid(code){ ud.uid = code; }

  2. A continuación, establezca el campo "setuid_function" en el Servicio del licitador de la siguiente manera:

    setuid

  3. Ahora, puede usar la siguiente dirección URL dentro de una llamada de píxel para insertar el identificador de usuario en la cookie del usuario y en el almacén de cookies del lado servidor Xandr:

    https://ib.adnxs.com/setuid?entity=[BIDDER_ID]&code=[USER_ID]

  4. Reemplace [BIDDER_ID] por el identificador del licitador (disponible en el Servicio del Licitador) y [USER_ID] por el identificador de usuario que ha almacenado para ese usuario.

    En caso de que las señales TCF estén disponibles en la página, los parámetros "rgpd" y "gdpr_consent", GET deben incluirse al final de la dirección URL de /setuid:

    https://ib.adnxs.com/setuid?entity=[BIDDER_ID]&code=[UID]&gdpr=[GDPR_APPLIES]&gdpr_consent=[GDPR_CONSENT_STRING]

    Advertencia

    A partir del 22 de abril de 2019, Xandr ya no admite el "userdata_json" campo en la solicitud de puja. Puede recibir su identificador de usuario único a través del campo "buyeruid" .

    Recibirá el identificador de usuario como parte del campo de la solicitud de "userdata_json" puja, como en el ejemplo siguiente:

{
  "bid_request": {
      ...
      "bid_info": {
          ...,
          "userdata_json": "{\"global_freq\":3,\"last_seen\":1237220391,\"uid\":\"HeVQkH6inotalk0Livh8Vw\"}",
          ...
      },
      ...
  }
}

Recibirá el identificador de usuario como parte del campo "buyeruid" de la solicitud de puja, como en el ejemplo siguiente:

{
    "request": {
        ...
        "user": {
            ...,
            "buyeruid": "HeVQkH6inotalk0Livh8Vw",
            ...
        },
        ...
    }
}

ejemplo setUID

https://ib.adnxs.com/setuid?entity=123&code=HeVQkH6inotalk0Livh8Vw&gdpr=1&gdpr_consent=CPaPwEAPaPwEAACAKAFRBWCgAP_AAH_AAAqIHttf_X__b3_j-_59__t0eY1f9_7_v-0zjhfdt

Asignación almacenada del proveedor de pujas/proveedor de datos

Para extraer el identificador de usuario de Xandr para cualquier usuario determinado, dirigirá al usuario a nuestro servicio getUID a través de una llamada de píxel. El bus de impresiones redirigirá al usuario a la dirección URL especificada en la llamada a getUID, reemplazando una macro de identificador de usuario por el identificador que hemos almacenado para ese usuario. Este proceso nos da acceso a nuestra cookie en el explorador de ese usuario y nos permite leer el identificador.

El formato del servicio getUID es:

https://ib.adnxs.com/getuid?[REDIRECT_URL]

La redirección debe contener la macro de id. de usuario, en el formato $UID, con el identificador que tenemos para ese usuario. La llamada de ejemplo siguiente dará como resultado lo siguiente:

  1. Dirigir al usuario a https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID
  2. Reemplace la macro $UID por a9f4072b-ec2d-42cb-8930-e3388a7d47c2
  3. Redirigir al usuario a https://ad.adserver.com/pixel?adnxs_uid=a9f4072b-ec2d-42cb-8930-e3388a7d47c2

En caso de que las señales TCF estén disponibles en la página , "rgpd" y "gdpr_consent", los parámetros GET deben incluirse al final de la dirección URL de /getuid:

https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&gdpr=[GDPR_APPLIES]&gdpr_consent=[GDPR_CONSENT_STRING]

Ejemplo de getUID

https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&gdpr=1&gdpr_consent=CPaPwEAPaPwEAACAKAFRBWCgAP_AAH_AAAqIHttf_X__b3_j-_59__t0eY1f9_7_v-0zjhfdt

Paso siguiente: Recepción de una solicitud de notificación

Consideración de privacidad

Nota:

En ambos puntos de conexión, si se pasan parámetros TCF en la dirección URL de redireccionamiento, Xandr usará estos parámetros para determinar si se puede realizar una sincronización de cookies. Si las señales recibidas se interpretan como insuficientes, Xandr no podrá procesar la solicitud de sincronización de cookies y devolverá el siguiente mensaje de error: "Error de solicitud debido a señales de privacidad". Además, si no se pueden proporcionar señales TCF al llamar a nuestras direcciones URL, los asociados deben anexar el parámetro de consentimiento a la dirección URL. El parámetro consent acepta valores binarios: 1 si el usuario ha dado su consentimiento y 0 si se ha denegado el consentimiento. Este parámetro debe incluirse para realizar sincronizaciones de usuario en determinadas áreas geográficas.

Consulte los ejemplos siguientes para ver cómo usar el parámetro de consentimiento en direcciones URL:

https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&consent=1


https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&consent=0


https://ib.adnxs.com/setuid?entity=[BIDDER_ID]&code=[UID]&consent=1

Ejemplo de una setuid llamada sin el consentimiento del usuario

https://ib.adnxs.com/setuid?entity=[BIDDER_ID]&code=[UID]&consent=0