Referência do script de lances personalizados

bool

bool(x)

Retorna um valor booleano: true ou false.

float

float(x)

Converte um tipo de dados de string ou número: retorna um ponto flutuante.

Exemplo: float(1) retorna 1.0.

int

int(x)

Converte um tipo de dados de string ou número e retorna um número inteiro.

Exemplo: int(1.0) retorna 1.

str

str(object)

Converte um tipo de dados e retorna uma string.

Exemplo: str(1) retorna "1".

log

log(x[, base])

Com um argumento: retorna o logaritmo natural de x (para a base e).

Com dois argumentos: retorna o logaritmo de x de uma base específica, calculado como log(x)/log(base).

advertiser_id

Número inteiro

É o identificador do anunciante do Display & Video 360.

insertion_order_id

Número inteiro

É o identificador do pedido de inserção do Display & Video 360.

line_item_id

Número inteiro

É o identificador do item de linha do Display & Video 360.

data

Número inteiro

É a data em que a impressão foi feita.

Formato: aaaammdd.

day_of_week

Número inteiro

É o código numérico do dia da semana em que a impressão foi feita.

• 0 para domingo
• 1 para segunda-feira
• 2 para terça-feira
• 3 para quarta-feira
• 4 para quinta-feira
• 5 para sexta-feira
• 6 para sábado

hour_of_day

Número inteiro

É o horário em que a impressão foi feita no fuso horário local do navegador, no formato de 24 horas.

Entradas válidas: 0 a 23.

utc_date

Número inteiro

É a data em que a impressão foi feita usando o horário universal coordenado (UTC).

Formato: aaaammdd.

utc_hour_of_day

Número inteiro

É a hora em que a impressão foi feita usando o horário universal coordenado (UTC), no formato de 24 horas.

Entradas válidas: 0 a 23.

city_id

Número inteiro

É o identificador da cidade.

É possível gerar o city_id usando a API Display & Video 360 ou baixando os metadados do SDF.

country_code

String

É o código do país ou da região.

Você pode fazer o download de um PDF com os mapeamentos de códigos de país ou região.

country_id

Número inteiro

É o identificador do país ou da região.

Você pode fazer o download de um PDF com os mapeamentos de IDs de país ou região.

dma_id

Número inteiro

É o identificador da Área designada do mercado (DMA).

Faça o download do planilha de ID dos lances personalizados (formato .xlsx) para esses IDs.

zip_postal_code

String

É o CEP ou código postal.

É possível encontrar uma lista de CEPs ou códigos postais disponíveis usando a API Display & Video 360 ou baixando os metadados do SDF.

ad_type

Número inteiro

É o código numérico que representa o formato do anúncio:

• 0 para display
• 1 para vídeo
• 2 para áudio

creative_height

Número inteiro

É a altura do criativo em pixels.

Observação: somente para criativos de display.

creative_id

Número inteiro

É o ID do criativo, como exibido no Display & Video 360.

creative_width

Número inteiro

É a largura do criativo em pixels.

Observação: somente para criativos de display.

browser_id

Número inteiro

É o identificador do navegador.

Faça o download do planilha de ID dos lances personalizados (formato .xlsx) para esses IDs.

browser_timezone_offset_minutes

Número inteiro

É a diferença em minutos entre o fuso horário ativo no navegador e o GMT-12.

Exemplo:

1320 representa um fuso horário do navegador de GMT+10.

device_type

Número inteiro

É o código numérico que representa o tipo de dispositivo:

• 0 para computador
• 1 para desconhecido
• 2 para smartphone
• 3 para tablet
• 4 para smart TV
• 5 para smart TV
• 6 para conversor
• 7 para dispositivo conectado

environment

Número inteiro

É o código numérico que representa o ambiente de veiculação do seu anúncio.

• 10 para Web otimizada para dispositivos
• 11 para a Web não otimizada para dispositivos
• 12 para app

isp_id

Número inteiro

É o identificador do provedor de acesso à Internet (ISP).

Faça o download do planilha de ID dos lances personalizados (formato .xlsx) para esses IDs.

language

String

É a configuração de idioma do navegador.

Faça o download do planilha de ID dos lances personalizados (formato .xlsx) para esses IDs.

mobile_make_id

Número inteiro

É o identificador da marca do dispositivo móvel.

Faça o download do planilha de ID dos lances personalizados (formato .xlsx) para esses IDs.

É o identificador do modelo do dispositivo móvel.

Faça o download do planilha de ID dos lances personalizados (formato .xlsx) para esses IDs.

net_speed

Número inteiro

É o código numérico que representa a velocidade da rede detectada quando a impressão foi feita:

• 1 para banda larga/4G (2 mbps e superior)
• 2 para discada (56 kbps e mais lenta)
• 3 para velocidade de conexão desconhecida
• 4 para EDGE/2G (57 kbps e superior)
• 5 para UMTS/3G (384 kbps e superior)
• 6 para DSL básico (768 kbps e superior)
• 7 para HSDPA/3.5G (1,8 mbps e superior)

operating_system_id

Número inteiro

É o identificador do sistema operacional.

Faça o download do planilha de ID dos lances personalizados (formato .xlsx) para esses IDs.

ad_position

Número inteiro

É o código numérico que representa o posicionamento do anúncio:

• 0 para posição desconhecida
• 1 para acima da dobra
• 2 para abaixo da dobra

adx_page_categories

Lista de números inteiros

É o identificador da categoria da página.

Acesse os mapeamentos completos de IDs de categoria na Referência da API AdWords.

channels

Lista de números inteiros

É o identificador do canal do Display & Video 360.

domain

String

Observação: os domínios não são compatíveis com itens de linha de smart TV. Para esses itens, use site_id.

É o nome do domínio raiz que consiste no nome do domínio e no domínio de nível superior.

Exemplo: no URL http://www.domain.com, o domínio raiz é domain.com.

exchange_id

Número inteiro

É o identificador da troca.

Faça o download do planilha de ID dos lances personalizados (formato .xlsx) para esses IDs.

site_id

Número inteiro

É o identificador do site.

active_view_measurable

booleano

Retorna 1 para "true" se a impressão era mensurável pelo Active View quando o anúncio foi veiculado.

Alguns fatores podem impedir que as impressões sejam contabilizadas. Se a impressão não era mensurável, retorna 0 para "false".

active_view_viewed

booleano

click

booleano

Retorna 1 para "true" se o anúncio foi clicado. Caso contrário, retorna 0 para "false".

time_on_screen_seconds

Número inteiro

É o tempo de exibição do anúncio na tela em segundos.

audible

booleano

Observação: compatível apenas com vídeos de lances em tempo real (RTB).

Retorna 1 para "true" se o som do vídeo estava ATIVADO quando visualizado. Caso contrário, retorna 0 para "false".

completed_in_view_audible

booleano

Observação: compatível apenas com vídeos de lances em tempo real (RTB).

Retorna 1 para "true" se o vídeo estava com o som ATIVADO quando visualizado. Caso contrário, retorna 0 para "false".

video_completed

booleano

Observação: só se aplica a tipos de anúncio em vídeo. As impressões que não forem de vídeo não serão rotuladas.

Retorna 1 para "true" se o vídeo tiver sido concluído. Caso contrário, retorna 0 para "false".

video_player_height_start

Número inteiro

É a altura do player de vídeo no primeiro frame em pixels.

video_player_size

Número inteiro

É o código numérico que representa o inventário de vídeo para segmentação com base no tamanho do player de vídeo.

• 0 para desconhecido
• 1 para pequeno
• 2 para grande
• 3 para alta definição (HD)

Para saber mais, acesse Segmentação por vídeo.

video_player_width_start

Número inteiro

É a largura do player de vídeo no primeiro frame em pixels.

video_resized

Binário

Retorna 1 para "true" se o player de vídeo foi redimensionado durante a reprodução. Caso contrário, retorna 0 para "false".

viewable_on_complete

booleano

Observação: compatível apenas com vídeos de lances em tempo real (RTB).

Retorna 1 para "true" se o vídeo foi visualizado até o fim. Caso contrário, retorna 0 para "false".

Observação: só se aplica a tipos de anúncio em vídeo. As impressões que não forem de vídeo não serão rotuladas.

O código numérico que representa o intervalo do vídeo, usado para categorizar vídeos com base na duração. O limite superior do intervalo é excluído.

• 0 para desconhecido
• 1 para 0 a 1 minuto
• 2 para 1 a 5 minutos
• 3 para 5 a 15 minutos
• 4 para 15 a 30 minutos
• 5 para 30 a 60 minutos
• 7 para mais de 60 minutos

Observação: só se aplica a tipos de anúncio em vídeo. As impressões que não forem de vídeo não serão rotuladas.

Representa uma lista de IDs de gênero de vídeo para segmentar anúncios com base em grupos relacionados de inventário de áudio e vídeo.

Saiba mais sobre a segmentação por gênero.

Observação: só se aplica a tipos de anúncio em vídeo. As impressões que não forem de vídeo não serão rotuladas.

total_conversion_count(Floodlight Activity ID, Attribution Model ID)

Duplo

É o número total de eventos de conversão para o par de IDs. Use um modelo próprio ou insira 0 para que o ID do modelo use a atribuição de último toque.

total_conversion_value(
Floodlight Activity ID, Attribution Model ID)

Duplo

Recebe o valor da receita de atividades rastreadas pelas tags de vendas do Floodlight. Use um modelo próprio ou insira 0 para que o ID do modelo use a atribuição de último toque.

total_conversion_quantity( FloodlightActivity ID, Attribution Model ID)

Duplo

É a quantidade total de conversões atribuídas a determinado par de IDs. Use um modelo próprio ou insira 0 para que o ID do modelo use a atribuição de último toque.

conversion_custom_variable(
Floodlight Activity ID, Attribution Model ID, Custom Variable Index)

String

É o valor da string da variável personalizada da última conversão atribuída à impressão. Caso contrário, retorna None (se não houver conversão ou o valor não estiver definido). Use um modelo próprio ou insira 0 para que o ID do modelo use a atribuição de último toque.

conversion_variable_num(
FloodlightActivity ID, Attribution Model ID)

Número inteiro

Recebe a conversão mais recente com crédito positivo para recuperar a variável do Floodlight "num" se ela existir, quando "count_micros" for positivo. Do contrário, retorna None.

conversion_variable_ord(Floodlight Activity ID, Attribution Model ID)

String

Recebe a conversão mais recente com crédito positivo para recuperar a variável do Floodlight "ord" se ela existir, quando count_micros for positivo. Caso contrário, retorna None.

ID do gênero

Nome do gênero

2

/Adulto

3

/Artes e entretenimento

317

/Artes e entretenimento/Quadrinhos e animação/Anime e mangá

319

/Artes e entretenimento/Quadrinhos e animação/Desenhos animados

1108

/Artes e entretenimento/Indústria do entretenimento/Indústria de cinema e TV/Prêmios de TV e filmes

569

/Artes e entretenimento/Eventos e listagens

1273

/Artes e entretenimento/Eventos e listagens/Eventos esportivos ao vivo

895

/Artes e entretenimento/Humor/Comédia ao vivo

1097

/Artes e entretenimento/Filmes/Filmes de ação e aventura

1099

/Artes e entretenimento/Filmes/Filmes de ação e aventura/Filmes de faroeste

1095

/Artes e entretenimento/Filmes/Filmes de comédia

615

/Artes e entretenimento/Filmes/Filmes de terror

1105

/Artes e entretenimento/Filmes/Filmes musicais

1310

/Artes e entretenimento/Filmes/Filmes românticos

616

/Artes e entretenimento/Filmes/Filmes de ficção científica e fantasia

1096

/Artes e entretenimento/Filmes/Filmes de suspense, crime e mistério

35

/Artes e entretenimento/Música e áudio

449

/Artes e entretenimento/Conteúdo excêntrico/Ocultismo e paranormalidade

23

/Artes e entretenimento/Artes cênicas

894

/Artes e entretenimento/Artes cênicas/Artes cênicas e teatro

581

/Artes e entretenimento/Artes cênicas/Dança

1185

/Artes e entretenimento/Artes cênicas/Ópera

358

/Artes e entretenimento/TV e vídeo/Programas de TV

1047

/Artes e entretenimento/TV e vídeo/Programas de TV/Programas de TV de comédia

1411

/Artes e entretenimento/TV e vídeo/Programas de TV/Documentários de TV e não ficção

1193

/Artes e entretenimento/TV e vídeo/Programas de TV/Dramas de TV

1111

/Artes e entretenimento/TV e vídeo/Programas de TV/Dramas de TV/Programas de TV sobre crimes e o sistema jurídico

357

/Artes e entretenimento/TV e vídeo/Programas de TV/Dramas de TV/Novelas de TV

1110

/Artes e entretenimento/TV e vídeo/Programas de TV/Programas de TV voltados para a família

1050

/Artes e entretenimento/TV e vídeo/Programas de TV/Programas de jogos na TV

1049

/Artes e entretenimento/TV e vídeo/Programas de TV/Reality shows na TV

1112

/Artes e entretenimento/TV e vídeo/Programas de TV/Programas de ficção científica e fantasia na TV

1410

/Artes e entretenimento/TV e vídeo/Programas de TV/Programas de talentos e variedades na TV

1048

/Artes e entretenimento/TV e vídeo/Programas de TV/Programas de auditório na TV

24

/Artes e entretenimento/Artes visuais e design

47

/Automóveis e veículos

1191

/Automóveis e veículos/Bicicletas e acessórios

1405

/Automóveis e veículos/Bicicletas e acessórios/Mountain bikes

273

/Automóveis e veículos/Veículos motorizados por tipo/Motos

148

/Automóveis e veículos/Veículos motorizados por tipo/Veículos off-road

185

/Beleza e Fitness/Moda e estilo

94

/Beleza e Fitness/Fitness

241

/Beleza e Fitness/Fitness/Fisiculturismo

1418

/Beleza e Fitness/Fitness/Instrução para atividades físicas e treinamento pessoal

46

/Comércio e indústrias/Agricultura e silvicultura

5

/Computadores e aparelhos eletrônicos

122

/Comida e bebida/Culinária e receitas

39

/Jogos/Jogos de cartas

924

/Jogos/Jogos de cartas/Pôquer e jogos de cassino

924

/Jogos/Jogos de cartas/Pôquer e jogos de cassino

41

/Jogos/Computador e videogames

698

/Jogos/Jogos de azar/Apostas esportivas/Corridas de cavalos e cachorros

939

/Jogos/Jogos de mesa/Bilhar

940

/Jogos/Jogos de mesa/Tênis de mesa

45

/Saúde

284

/Hobbies e lazer/Artesanato

688

/Hobbies e lazer/Ao ar livre

462

/Hobbies e lazer/Ao ar livre/Pesca

461

/Hobbies e lazer/Ao ar livre/Caça e tiro esportivo

461

/Hobbies e lazer/Ao ar livre/Caça e tiro esportivo

461

/Hobbies e lazer/Ao ar livre/Caça e tiro esportivo

999

/Hobbies e lazer/Aviação recreativa

678

/Hobbies e lazer/Ocasiões especiais/Feriados e datas comemorativas

459

/Hobbies e lazer/Atividades aquáticas/Canoagem

11

/Casa e jardim

158

/Casa e jardim/Reforma de casas

966

/Lei e governo/Governo/Governo municipal e estadual

75

/Lei e governo/Jurídico

366

/Lei e governo/Militar

16

/Notícias

784

/Notícias/Notícias de negócios

396

/Notícias/Política

1201

/Notícias/Política/Opinião e comentário

1077

/Notícias/Notícias esportivas

785

/Notícias/Notícias de tecnologia

63

Notícias / Clima

113

/Pessoas e sociedade/Grupos étnicos e de identidade/Lésbicas, gays, bissexuais e transgêneros

58

/Pessoas e sociedade/Família e relacionamentos/Família/Paternidade

59

/Pessoas e sociedade/Religião e crenças

870

/Pessoas e sociedade/Autoajuda e motivação

57

/Pessoas e sociedade/Problemas sociais e advocacia/Caridade e filantropia

82

/Pessoas e sociedade/Problemas sociais e advocacia/Atitudes sustentáveis e questões ambientais

886

/Animais de estimação e animais/Animais de estimação/Cães

888

/Animais de estimação e animais/Animais de estimação/Cavalos

119

/Animais de estimação e animais/Vida selvagem

119

/Animais de estimação e animais/Vida selvagem

690

/Referência/Referência geral/Biografias e citações

694

/Referência/Referência geral/Conteúdo especializado e "faça você mesmo"

433

/Reference/Humanities/History

1288

/Referência/Humanas/História militar

174

/Ciência

18

/Compras

64

/Compras/Antiguidades e colecionáveis

292

/Compras/Leilões

69

/Compras/Recursos para consumidores

1666

/Esportes/Esportes que envolvem animais

568

/Esportes/Esportes que envolvem animais/Equitação

515

/Esportes/Esportes de combate/Boxe

516

/Esportes/Esportes de combate/Artes marciais

1674

/Esportes/Esportes de luta/Artes marciais/Artes marciais mistas

512

/Esportes/Esportes de combate/Luta-livre

1681

/Esportes/Esportes de luta/Luta livre/Luta profissional

554

/Esportes/Esportes radicais

1206

/Esportes/Esportes radicais/Corrida de dragster e de rua

1000

/Esportes/Esportes individuais

1016

/Esportes/Esportes individuais/Boliche

458

/Esportes/Esportes individuais/Ciclismo

261

/Esportes/Esportes individuais/Golfe

519

/Esportes/Esportes individuais/Ginástica

262

/Esportes/Esportes individuais/Esportes com raquete

1376

/Esportes/Esportes individuais/Esportes com raquete/Tênis

541

Esportes/Esportes individuais/Corrida e caminhada

1126

/Esportes/Esportes individuais/Skate

518

/Esportes/Esportes individuais/Atletismo

513

/Esportes/Competições internacionais de esportes/Olimpíadas

180

/Esportes/Esportes motorizados

1595

/Esportes/Esportes motorizados/Corrida de automóveis

1596

/Esportes/Esportes motorizados/Corrida de moto

1001

/Esportes/Esportes coletivos

258

/Esportes/Esportes coletivos/Futebol americano

259

/Esportes/Esportes coletivos/Beisebol

264

/Esportes/Esportes coletivos/Basquete

534

/Esportes/Esportes coletivos/Líderes de torcida

296

/Esportes/Esportes coletivos/Críquete

1017

/Esportes/Esportes coletivos/Handebol

260

/Esportes/Esportes coletivos/Hóquei

517

/Esportes/Esportes coletivos/Rúgbi

294

/Esportes/Esportes coletivos/Futebol

699

/Esportes/Esportes coletivos/Vôlei

118

/Esportes/Esportes aquáticos

1593

/Esportes/Esportes aquáticos/Surfe

1594

/Esportes/Esportes aquáticos/Natação

265

/Esportes/Esportes de inverno

1149

/Esportes/Esportes de inverno/Patinação no gelo

1148

/Esportes/Esportes de inverno/Esqui e snowboarding

67

/Viagem e transporte

has_ga4_conversions(
property_id, conversion_event_name)

Booleano

ga4_conversions_count(
property_id, conversion_event_name)

Número inteiro

ga4_conversions_max_value(
property_id,conversion_event_name))*

Duplo

Retorna o valor mais alto atribuído a uma conversão com um ID da propriedade e um evento de conversão atribuídos à impressão especificada.

ga4_conversions_max_value_usd(
property_id, conversion_event_name)

Duplo

Observação: para contas do Google Analytics 4 que usam moeda USD.

Retorna o valor mais alto atribuído a uma conversão com um ID da propriedade e um ID de conversão atribuídos à impressão especificada.

Vai retornar 0 se o valor da conversão mais alta for 0 ou se nenhuma conversão for atribuída.

ga4_conversions_total_value(GA4 property ID, conversion_event_name)

Retorna a soma dos valores de ponderação atribuídos às conversões com um ID da propriedade e um evento de conversão atribuídos à impressão especificada.

Vai retornar 0 se o valor da conversão mais alta for 0 ou se nenhuma conversão for atribuída.

ga4_conversions_total_value_usd(
property_id, conversion_event_name)

Observação: para contas do Google Analytics 4 que usam moeda USD.

Retorna a soma dos valores de ponderação atribuídos às conversões com um ID da propriedade e um evento de conversão atribuídos à impressão especificada.

Vai retornar 0 se o valor da conversão mais alta for 0 ou se nenhuma conversão for atribuída.