O Google disponibiliza listas agregadas de configurações do editor ao fazer o upload delas para um bucket do Google Cloud Storage específico da conta (em um projeto que está de propriedade do Google). É possível fazer o download desses arquivos para usar em segmentações que não podem ser feito no momento do lance. Fale com seu gerente técnico de contas para ativar esse recurso para sua conta.
É possível fazer o download dos arquivos contendo as configurações do editor de maneira programática com o Cloud Storage API, manualmente com a ferramenta Google Developers Console ou a ferramenta de linha de comando gsutil. Consulte a documentação do Storage para obter mais detalhes sobre como acessar dados armazenados em Google Cloud Storage:
O arquivo é compactado em gzip de acordo com a RFC 1952. Para extrair o arquivo de
a linha de comando, execute gzip -d <filename>
. Para extrair o
programaticamente, você pode usar zlib ou uma biblioteca de compactação semelhante que
oferece suporte ao formato gzip. O resultado é um buffer de protocolo serializado, semelhante a
o payload da solicitação POST em um BidRequest
, que pode ser
analisado com o seguinte snippet:
string compressed = /* the payload from the GET request */; string uncompressed = gunzip(compressed); PublisherSettingsList publisher_settings; if (publisher_settings.ParseFromString(uncompressed)) { // Process the publisher settings. }
A definição do buffer de protocolo para PublisherSettingsList
pode ser
baixados dos dados de referência
página. Você também pode solicitar um
publisher-settings.pb.gz
do representante da sua conta. Ela
contém a definição do buffer de protocolo, bem como um editor de exemplo
de configuração do Terraform.
A ordem de PublisherSettingsList
pode mudar a qualquer momento.
Nenhuma ordem ou classificação específica é garantida. Cada entrada no editor
lista de configurações contém um identificador e várias configurações que se aplicam a
BidRequests
marcado com esse identificador. É possível adicionar um recurso
que seus sistemas de lances verifiquem periodicamente se há uma nova lista de configurações do editor.
Quando o Google recebe uma impressão qualificada para lances em tempo real,
O Google inclui identificadores na solicitação de lance que correspondem às entradas no
à lista de configurações do editor. Seu sistema de lances pode usar as configurações do editor
para filtrar os anúncios candidatos a essa impressão. Para se qualificar para um determinado
impressão, o anúncio candidato precisa estar em conformidade com todas as entradas de configuração do editor
para os quais os identificadores foram enviados na solicitação.
Todas as configurações do editor ausentes no arquivo são 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 deve ser
baixada em uma única transação. Os arquivos
são divididos em blocos e nomes de aproximadamente 5 MB
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 o representante da conta para receber essas
.