Actualiza los datos del público y actualiza los anuncios

Cuando creas un público personalizado, puedes especificar algunos o todos los metadatos del público personalizado. Esta información se puede pasar directamente cuando se crea un objeto CustomAudience. El CustomAudience.Builder también admite un campo dailyUpdateUri que puede proporcionar y actualizar los metadatos. La plataforma ejecutará un trabajo en segundo plano cada 24 horas para recuperar los metadatos actualizados de dailyUpdateUri, o cada cuatro horas si el público personalizado aún no tiene el objeto AdData necesario para participar en una subasta. La plataforma puede actualizar los siguientes elementos de los metadatos del público personalizado:

  • Indicadores de ofertas del usuario
  • Datos de ofertas de confianza
  • Lista AdData

Para actualizar estos metadatos, un proceso diario de actualización en segundo plano consulta el dailyUpdateUri definido en el público personalizado, que puede devolver una respuesta JSON.

  • La respuesta JSON puede contener cualquiera de los campos de metadatos admitidos que deben actualizarse.
  • Cada campo JSON se valida de forma independiente. El cliente ignora los campos con formato incorrecto, por lo que la respuesta no se actualizará en ese campo en particular.
  • Una respuesta HTTP vacía o un objeto JSON vacío "{}" no generan actualizaciones de metadatos.
  • El tamaño del mensaje de respuesta debe limitarse a 10 KB.
  • Todos los URIs son obligatorios para usar HTTPS.
  • trusted_bidding_uri debe compartir el mismo ETLD+1 que el comprador.

Ejemplo: Respuesta JSON para una actualización diaria en segundo plano

{
    "user_bidding_signals" : { ... },  // Valid JSON object
    "trusted_bidding_data" : {
        "trusted_bidding_uri" : "example-dsp1-key-value-service.com",
        "trusted_bidding_keys" : [ "campaign123", "campaign456", ... ]
    },
    "ads" : [
        {
            "render_uri" : "www.example-dsp1.com/.../campaign123.html",
            "metadata" : { ... }  // Valid JSON object
        },
        {
            "render_uri" : "www.example-dsp1.com/.../campaign456.html",
            "metadata" : { ... }  // Valid JSON object
        },
        ...
    ]
}

Consulta esta definición de servidor simulado para ver un ejemplo del tipo de datos que se podrían incluir en la respuesta.