No momento, estamos migrando um subconjunto de tipos de relatório dos relatórios off-line para os instantâneos. Depois da migração de um usuário, as respostas do queries.list incluirão os relatórios instantâneos atuais. Confira nossa postagem do blog para mais informações.
Esses tipos definem os campos aninhados em algumas tabelas. esses campos não têm tabelas próprias.
Tipo de Numeric Id
Escalar
Descrição
integer
Um número de identificação numérico usado como um identificador de entidades. Os IDs não devem ser tratados como universalmente únicos. Por exemplo, pode haver o mesmo valor de ID usado para uma campanha que também é usada para um pixel.
Tipo de Enum
Escalar
Descrição
integer
Uma enumeração de várias opções possíveis. As diferentes opções são descritas em mais detalhes no tipo principal.
Tipo de Time
Escalar
Descrição
integer
Um horário Unix em microssegundos (1/1.000.000 segundo), por exemplo, 1330403779608570 representa terça-feira, 28 de fevereiro de 2012, 04:36:19.608570.
Tipo de Currency Micro
Escalar
Descrição
integer
O valor específico da moeda em micros (1/1.000.000 de uma unidade monetária). Por exemplo,se a moeda fosse EUR,75000000 significa € 75 ou, se a moeda fosse USD, 250000 significaria USD 0, 25. Não há conversão de ou para valores em dólares.
Tipo de Percentage Milli
Escalar
Descrição
integer
Uma porcentagem mostrada em milissegundos (1/1.000 de porcentagem), por exemplo, 100 significa 0,1%.
Tipo de FileSummary
Nome do campo
Tipo
Descrição
name
string
O nome do arquivo (sem incluir o nome do bucket ou diretório).
num_records
integer
O número de entidades no arquivo.
version
integer
O número da versão principal do arquivo. Esse número poderá mudar se novas versões do formato de dados da entidade forem criadas no futuro.
ID exclusivo em cada tipo de entidade. Por exemplo, no caso de entidades de parceiro, esse ID seria o ID do parceiro, para anunciantes, seria o ID do anunciante e assim por diante.
name
string
O nome visível para a interface da entidade.
active
boolean
Status conforme definido pelo usuário: a entidade pode não estar em veiculação por outros motivos, como um orçamento esgotado, fora de veiculação etc.
Número máximo de impressões por intervalo de ritmo definido pelo pacing_type. Se esse campo estiver ausente, não haverá limite de impressões.
pacing_max_spend_advertiser_micros
integer
Gasto máximo (em micros na moeda do anunciante) por intervalo de ritmo definido pelo pacing_type. Se esse campo estiver ausente, não haverá limite de gastos.
O valor da receita em micros atuais do anunciante. Esse valor só será definido se o tipo for CPM.
media_cost_markup_percent_millis
integer
A marcação de porcentagem de receita em Percentage Milli. Esse valor só será definido se o tipo for MEDIA_COST_MARKUP ou TOTAL_MEDIA_COST_MARKUP.
post_view_conversion_tracking_fraction
float
Fração de conversões pós-visualização a serem contabilizadas para o acompanhamento de conversões. Se for 0, apenas as conversões pós-clique serão contadas; Se 1,0, todas as conversões são rastreadas.
O ID do pixel de rastreamento. Dois CostTrackingPixels podem compartilhar o mesmo pixel_id, mas ter valores de visualização ou janela de clique diferentes.
Esse valor pode ser combinado com Pixel.common_data.id.
view_window_minutes
integer
O número de minutos em que as conversões pós-visualização serão procuradas.
click_window_minutes
integer
O número de minutos em que as conversões pós-clique devem ser buscadas.
Um Target que indica a posição do anúncio no
página do editor. Os valores Target.criteria_id
são 0=ALL_POSITIONS 1=ABOVE_THE_FOLD
2=BELOW_THE_FOLD 3=UNKNOWN_POSITION Target.parameter é indefinido.
Uma Target indicando a velocidade da rede.
Os valores Target.criteria_id são: 0=ALL_CONNECTION_SPEEDS e 1=BROADBAND (2,0 mbps e superior). 2=DIALUP (56 kbps e mais lenta). 3=UNKNOWN_CONNECTION_SPEED 4=EDGE (Dados aprimorados para o GSM Evolution (2G). 57 kbps e superior). 5=UMT (Sistema Universal de Telecomunicações Móveis (3G). 384 kbps e superior). 6=DSL (linha digital para assinante. 768 kbps e superior). 7=HSDPA (Acesso ao pacote de downlink de alta velocidade (3,5G). 1,8 Mbps e superior).
Significa "(A OR B) AND (C OR D) AND NOT (E OR F)".
Target.criteria_id pode ser mesclada com
UserList.id e
Target.parameter é o valor de recência do pixel em microssegundos.
Se esse valor estiver ausente, significa segmentar todos os públicos-alvo.
Matriz de tipos de Target para sites.
Target.criteria_id pode ser mesclada com
UniversalSite.id ou não será definido se o site for
não em UniversalSite. Target.parameter
é um site como google.com, mas não é necessariamente encontrado em
UniversalSite
O ID do objeto do parceiro principal. Mesclável com Partner.common_data.id.
currency_code
string
Código de moeda de três letras do ISO 4217, por exemplo, USD para dólares americanos.
timezone_code
string
O código de fuso horário canônico, por exemplo, "America/Los_Angeles". Se dfa_configuration for definido como NORMAL ou HYBRID, esse valor será o mesmo que o fuso horário do anunciante associado do Campaign Manager.
landing_page_url
string
O URL da página de destino padrão.
available_channel_ids
[integer]
Matriz de números inteiros que contém os canais disponíveis associados a esse anunciante. Mesclável com UniversalChannel.id.
blacklist_channel_id
[integer]
Matriz de números inteiros que contém os canais da lista de proibições desse anunciante. Mesclável com UniversalChannel.id.
Indicador principal de desempenho. Use esse campo para acompanhar a métrica principal que você usará para avaliar o sucesso da campanha.
Os valores possíveis são: 1 = IMPRESSIONS 2 = VIEWABLE_IMPRESSIONS e 3 = CPM 4 = CPV 5 = UNIQUES 6 = GRP 7 = TRP 8 = VCR 9 = CPA 10 = ROAS 11 = CTR 12 = CPC 13 = CVR 14 = CPI 15 = VIEWABLE_PERCENT 16 = CPIAVC 17 = OTHER
objective_description
String
Quando a métrica é OTHER, essa é a breve descrição dela.
0=Not Expandable 1=Expanding Up 2=Expanding Down 3=Expanding Left 4=Expanding Right 5=Expanding Up Left 6=Expanding Up Right 7=Expanding Down Left 8=Expanding Down Right 9=Expanding Up or Down 10=Expanding Left or Right 11=Expanding Any Diagonal
O ID do Floodlight do Campaign Manager associado a este pixel.
allow_google_redirect
boolean
allow_rm_redirect
boolean
Quando definido como true, o pixel será ativado para recuperação de/para a Right Media.
remarketing_enabled
boolean
Quando definido como true, esse pixel será ativado para uso na segmentação. Esse valor só vai estar presente se o dfa_configuration do anunciante pai estiver definido como NONE.
is_secure
boolean
Quando definido como true, esse pixel usará HTTPS. Esse valor só vai estar presente se o dfa_configuration do anunciante pai estiver definido como NONE.
Quando definido como true, todo o inventário não classificado será incluído.
inventory_name
string
O nome da origem de inventário, conforme mostrado na interface. Este campo pode estar ausente. Se inventory_name estiver ausente e unclassified for verdadeiro, isso se refere ao inventário não classificado da troca. Se estiver ausente e unclassified for falso, a origem de inventário será o inventário no nível da troca.
Uma matriz de IDs de anunciantes, mescláveis com Advertiser.common_data.id, com permissão para usar essa origem de inventário.
Observação: se uma origem de inventário estiver disponível para TODOS os anunciantes, esse campo não estará presente.
external_id
string
É o ID externo atribuído a essa origem de inventário e definido pela troca. Normalmente, é chamado de ID da transação ou do vendedor. Este campo pode estar ausente.
min_cpm_micros
integer
O preço mínimo efetivo desta origem de inventário em micros de moeda.
min_cpm_currency_code
string
O código de moeda ISO 4217 de três letras usado para min_cpm_micros.
Uma matriz de IDs de anunciantes, que podem ser combinados com Advertiser.common_data.id, com permissão para usar este canal.
Observação: se um canal estiver disponível para TODOS os anunciantes, esse campo não vai estar presente.
is_deleted
boolean
Quando definido como true, nenhum item de linha novo poderá segmentar este canal, mas os itens de linha existentes que já segmentam esse canal continuarão a fazer isso.
is_brand_safe_channel
boolean
Quando definido como true, este canal poderá ser usado para filtragem de brand safety. No momento, esse valor só é válido para true nas quatro camadas integradas de brand safety.
Chave exclusiva para este critério do dispositivo.
is_mobile
boolean
Se verdadeiro, esse critério abrange apenas dispositivos móveis. Se for falso, essa entrada abrangerá apenas dispositivos não móveis, mesmo que o nome (por exemplo, "Outro") não indica isso.
Se verdadeiro, esse critério abrange apenas dispositivos móveis. Se for falso, essa entrada abrangerá apenas dispositivos não móveis, mesmo que o nome (por exemplo, "Outro") não indica isso.
name
string
O nome conhecido do navegador, por exemplo, Safari 5. Ele não inclui a string completa do user agent.
Chave exclusiva desse provedor de acesso à Internet.
is_mobile
boolean
Se verdadeiro, esse critério abrange apenas dispositivos móveis. Se for falso, essa entrada abrangerá apenas dispositivos não móveis, mesmo que o nome (por exemplo, "Outro") não indica isso.
name
string
O nome desse provedor de acesso à Internet.
secondary_criteria_id
integer
ID alternativo opcional que pode ser usado para identificar a entidade.