Para poner a disposición las listas de configuración de publicadores agregadas, Google las sube a un bucket de Google Cloud Storage específico de la cuenta (en un proyecto que le pertenece a Google). Puede descargarlos para usarlos en la segmentación que no se puede realizar durante la oferta. Comunícate con tu administrador técnico de cuentas para habilitar esta función en tu cuenta.
Los archivos que contienen la configuración del editor se pueden descargar de manera programática mediante la API de Cloud Storage, de forma manual a través de la IU de Google Developers Console o mediante la herramienta de línea de comandos de gsutil. Consulta la documentación de Google Cloud Storage para obtener más detalles sobre cómo acceder a los datos almacenados en Google Cloud Storage.
El archivo está comprimido en gzip de acuerdo con RFC 1952. Para extraer el archivo de la línea de comandos, ejecuta gzip -d <filename>. Para extraer el archivo de manera programática, puedes usar zlib o una biblioteca de compresión similar que sea compatible con el formato gzip. El resultado es un búfer de protocolo serializado, similar a la carga útil de la solicitud POST en una BidRequest, que se puede analizar con el siguiente fragmento:
string compressed = /* the payload from the GET request */;
string uncompressed = gunzip(compressed);
PublisherSettingsList publisher_settings;
if (publisher_settings.ParseFromString(uncompressed)) {
// Process the publisher settings.
}
La definición del búfer de protocolo para PublisherSettingsList se puede descargar desde la página de datos de referencia. También puedes solicitar un archivo comprimido publisher-settings.pb.gz al representante de tu cuenta. Contiene la definición del búfer de protocolo, así como un archivo de configuración del publicador de ejemplo.
El orden de PublisherSettingsList puede cambiar en cualquier momento.
No se garantiza un orden o clasificación específicos. Cada entrada en la lista de configuración del publicador contiene un identificador y varias opciones de configuración que se aplican a BidRequests etiquetadas con ese identificador. Puede agregar una función a sus sistemas de ofertas para verificar periódicamente si hay una nueva lista de configuración del publicador.
Cuando Google recibe una impresión apta para ofertas en tiempo real, Google incluye identificadores en la solicitud de oferta que corresponden a las entradas de la lista de configuración del publicador. Su sistema de ofertas puede usar la configuración del publicador para filtrar los anuncios candidatos para esa impresión. A fin de ser apto para una impresión determinada, el anuncio candidato debe cumplir con todas las entradas de configuración del publicador para las que se enviaron los identificadores en la solicitud.
Ten en cuenta que la configuración del editor que falta en el archivo se debe a que los identificadores no tienen URL asociadas asociadas.
El archivo de configuración del publicador se divide en varios archivos más pequeños para reducir la cantidad de datos que se deben descargar en una sola transacción. Los archivos se dividen en aproximadamente 5 MB y nombres como publisher-settings.0.pb.gz a publisher-settings.n.pb.gz (donde n es la cantidad de archivos menos uno). Comunícate con tu representante de cuenta para obtener estos archivos.