O Google disponibiliza listas de configurações agregadas do editor para fazer upload delas em um bucket do Google Cloud Storage específico da conta (em um projeto que pertence ao Google). É possível fazer o download deles para usar na segmentação que não pode ser feita no momento do lance. Fale com o gerente técnico de contas para ativar esse recurso na sua conta.
É possível fazer o download dos arquivos que contêm as configurações do editor de maneira programática usando a API Cloud Storage, manualmente, usando a IU do Console do desenvolvedor do Google ou a ferramenta de linha de comando gsutil. Consulte a documentação do Google Cloud Storage para ver mais detalhes sobre como acessar os dados armazenados no Google Cloud Storage.
O arquivo é compactado em gzip de acordo com a RFC 1952 (em inglês). Para extrair o arquivo da linha de comando, execute gzip -d <filename>
. Para extrair o arquivo de maneira programática, use o zlib ou uma biblioteca de compactação semelhante com suporte ao formato gzip. O resultado é um buffer de protocolo serializado, semelhante ao
payload da solicitação POST em um BidRequest
, que pode ser
analisado com o snippet a seguir:
string compressed = /* the payload from the GET request */; string uncompressed = gunzip(compressed); PublisherSettingsList publisher_settings; if (publisher_settings.ParseFromString(uncompressed)) { // Process the publisher settings. }
Faça o download da definição do buffer de protocolo para PublisherSettingsList
na página de dados de referência. Você também pode solicitar um arquivo publisher-settings.pb.gz
compactado do representante da conta. Ele
contém a definição do buffer de protocolo e um exemplo de arquivo
de configurações do editor.
A ordem dos PublisherSettingsList
pode mudar a qualquer momento.
Não há garantia de ordem ou classificação específica. Cada entrada na lista de configurações do editor contém um identificador, e várias configurações que se aplicam a BidRequests
marcadas com esse identificador. É possível adicionar um recurso aos seus sistemas de lances para verificar periodicamente se há uma nova lista de configurações do editor.
Ao receber uma impressão qualificada para lances em tempo real,
o Google inclui identificadores na solicitação de lance que correspondem às entradas na
lista de configurações do editor. O sistema de lances pode usar as configurações do editor
para filtrar os anúncios candidatos para essa impressão. Para se qualificar para uma determinada
impressão, o anúncio candidato precisa estar em conformidade com todas as entradas da configuração do editor
para as quais os identificadores foram enviados na solicitação.
Observe que as configurações do editor que faltam no arquivo ocorrem porque os identificadores não têm URLs bloqueados associados a eles.
O arquivo de configurações do editor é dividido em vários arquivos menores para reduzir
a quantidade de dados que precisam ser transferidos por download em uma única transação. Os arquivos
são divididos em aproximadamente 5 MB de partes e nomes como
publisher-settings.0.pb.gz
a
publisher-settings.n.pb.gz
(em que n é o número de
arquivos menos um). Entre em contato com seu representante de conta para receber esses
arquivos.