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 ID numérico usado como identificador de entidades. Os IDs não devem ser tratados como universalmente exclusivos. Por exemplo, pode haver o mesmo valor de ID usado para uma campanha que também é usado 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 com mais detalhes no tipo pai.
Tipo de Time
Escalar
Descrição
integer
Um tempo 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 for EUR, 75000000 vai significar €75. Se a moeda for USD, 250000 vai significar US $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 um por cento). Por exemplo,100 significa 0,1%.
Tipo de FileSummary
Nome do campo
Tipo
Descrição
name
string
O nome do arquivo (sem o nome do bucket ou do 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 pode mudar se novas versões do formato de dados de 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 definido pelo usuário: a entidade pode não estar veiculando por outros motivos, como orçamento esgotado, fora do período 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 gasto.
O valor da receita em micros atuais do anunciante. Esse valor só é 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ó é 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 contabilizadas.Se for 1,0, todas as conversões serão acompanhadas.
O ID do pixel de rastreamento: dois CostTrackingPixels podem compartilhar o mesmo pixel_id, mas ter valores diferentes de visualização ou janela de clique.
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 são analisadas.
click_window_minutes
integer
O número de minutos em que as conversões pós-clique são analisadas.
Um Target que indica a posição do anúncio na página do editor. Os valores de Target.criteria_id
são 0=ALL_POSITIONS 1=ABOVE_THE_FOLD
2=BELOW_THE_FOLD 3=UNKNOWN_POSITION Target.parameter é indefinido.
Um Target indicando a velocidade da rede.
Os valores Target.criteria_id são: 0=ALL_CONNECTION_SPEEDS 1=BROADBAND (2,0 mbps e superior). 2=DIALUP (56 kbps e mais lenta). 3=UNKNOWN_CONNECTION_SPEED 4=EDGE (Enhanced Data for GSM Evolution (2G). 57 kbps e mais rápido). 5=UMT (Sistema Universal de Telecomunicações Móveis (3G). 384 kbps e mais rápido). 6=DSL (linha de assinante digital. 768 kbps e mais rápidas). 7=HSDPA (High-Speed Downlink Packet Access (3.5G). 1,8 Mbps e superior).
pode ser "(A OR B) AND (C OR D) AND NOT (E OR F)".
Target.criteria_id pode ser combinada 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 Target para sites.
Target.criteria_id pode ser mesclado com UniversalSite.id ou não será definido se o site não estiver em UniversalSite. Target.parameter
é um site como google.com, mas não é encontrado necessariamente em
UniversalSite.
O ID do objeto pai do parceiro. Pode ser combinada com Partner.common_data.id.
currency_code
string
O código de moeda de três letras ISO 4217, por exemplo, USD para dólares americanos.
timezone_code
string
O código de fuso horário canônico, por exemplo, "América/Los_Angeles". Se o dfa_configuration for definido como NORMAL ou HYBRID, esse valor será o mesmo que o fuso horário do anunciante associado da DFA.
landing_page_url
string
O URL da página de destino padrão.
available_channel_ids
[integer]
Matriz de números inteiros com 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ção para esse anunciante. Mesclável com UniversalChannel.id.
Indicador principal de desempenho. Use esse campo para acompanhar a métrica principal que você vai usar para avaliar o sucesso da sua campanha.
Os valores possíveis são: 1 = IMPRESSIONS 2 = VIEWABLE_IMPRESSIONS 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 descrição resumida 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
Quando definido como true, o pixel é ativado para redirecionamento para/de mídias certas.
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 principal estiver definido como NONE.
is_secure
boolean
Quando definido como true, esse pixel vai usar o 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 do inventário mostrado na interface. Esse campo pode estar ausente. Se inventory_name estiver ausente e unclassified for verdadeiro, ele 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 de troca.
Uma matriz de IDs de anunciantes, que pode ser combinada 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 vai estar presente.
external_id
string
O ID externo atribuído a essa origem de inventário e definido pela troca, geralmente conhecido como ID da transação ou do vendedor. Esse campo pode estar ausente.
min_cpm_micros
integer
O preço mínimo efetivo dessa fonte 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 combinadas 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 esse canal, mas os itens de linha atuais que já segmentam esse canal vão continuar fazendo isso.
is_brand_safe_channel
boolean
Quando definido como true, esse canal pode ser usado para filtrar a brand safety. No momento, o true é usado apenas para as quatro camadas de brand safety integradas.
Chave exclusiva para esses critérios de dispositivo.
is_mobile
boolean
Se verdadeiro, esse critério abrange apenas dispositivos móveis. Se for falso, essa entrada vai abranger apenas dispositivos não móveis, mesmo que o nome (por exemplo, "Outros") 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 se o nome (por exemplo, "Outros") 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 para esse provedor de acesso à Internet.
is_mobile
boolean
Se verdadeiro, esse critério abrange apenas dispositivos móveis. Se for falso, essa entrada vai abranger apenas dispositivos não móveis, mesmo que o nome (por exemplo, "Outros") não indica isso.
name
string
O nome do provedor de acesso à Internet.
secondary_criteria_id
integer
ID alternativo opcional que pode ser usado para identificar a entidade.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-11-15 UTC."],[[["Entity Read Files, providing data on advertisers, campaigns, and other entities, will be sunset on October 31, 2024, requiring migration to the Display & Video 360 API."],["Shared data types like `Numeric Id`, `Enum`, `Time`, and custom types like `Budget` and `FrequencyCap` are used across various entities to represent specific attributes."],["Data is organized into tables like `Advertiser`, `Campaign`, `LineItem`, and `Creative`, each containing specific fields relevant to their respective entities."],["Tables are interconnected via joinable fields, enabling linking and analysis of data across entities, such as joining `Advertiser` and `Campaign` using `advertiser_id`."],["The `InventorySource` table provides details about ad inventory, including its source, accessibility for advertisers, and associated costs."]]],[]]