Referência do script de lances personalizados

É possível usar as funções e os indicadores descritos neste tópico para criar um script de lances personalizados que representa com precisão os indicadores principais de desempenho (KPIs) que você quer melhorar ao informar seu modelo de lances personalizados.

Tópicos deste artigo

• Regras de sintaxe
• Funções e indicadores disponíveis
  • Funções
  • Indicadores
• Limitações

Regras de sintaxe

É possível melhorar os valores de impressão usando dados próprios para definir os scripts de lances personalizados. O Display & Video 360 é compatível com os dados próprios das seguintes origens:

• Floodlights: para saber mais, consulte exemplos de scripts que usam dados do Floodlight.
• Dados no nível da impressão: para saber mais, consulte exemplos de scripts que usam dados no nível da impressão.
• Google Analytics: para saber mais, consulte exemplos de scripts que usam dados do Google Analytics.

Ao criar um script de lances personalizados, você usará as seguintes regras de sintaxe:

• Coloque todos os critérios entre colchetes [ ].
• Uma vírgula , também representa "e".

Exemplo

Nesta amostra de script, criteria1 vai retornar "true" somente se criteria_a e criteria_b forem true. No entanto, criteria2 vai retornar true se criteria_a for true.

return aggregate_function([

([criteria_a, criteria_b], score), #criteria1
([criteria_a], score) #criteria2
])

Comentários

É possível usar comentários para adicionar contexto ao script. Por exemplo, você pode adicionar comentários para comunicar a intenção do seu script.

Você pode usar a seguinte sintaxe para os comentários:

• Para adicionar um comentário de linha única, use #.
• Para adicionar um comentário de várias linhas, coloque o comentário entre """ ou '''.

Exemplo

# Este é um comentário de linha única

"""

Este é um comentário de várias linhas

"""

'''

Este também é um comentário de várias linhas

'''

Operadores

É possível usar os seguintes operadores no script:

• Operadores aritméticos: +, -, *, /, %, **, //
• Operadores de atribuição: =, +=, -=, *=, /=, %=, **=, //=
• Operadores de comparação: ==, !=, <, >, >=, <=
• Operadores lógicos: and, or, not
• Operadores de associação: in, not in

Operadores de associação

É possível usar os operadores de associação in e not in no script para verificar se um elemento está em um campo ou não.

• in: retorna "true" se o elemento é encontrado no campo.
• not in: retorna "true" se o elemento não é encontrado no campo.

Exemplo

Exemplo
if 123 in channel_id: #verifica se 123 está no ID do canal

return y

Operadores de comparação

É possível usar operadores de comparação para incluir ou excluir um elemento do modelo.

Exemplo 1

Exemplo 1

O script a seguir exclui uma data do seu modelo de lances personalizados:

# Exclusão de data

if date == 20180711:

return None

É possível identificar impressões que você quer excluir ao treinar o modelo de lances personalizados. Para isso, retorne None. Use uma instrução que retorne None para identificar impressões que você quer excluir ao treinar o modelo de lances personalizados.

Exemplo 2

Exemplo 2

O script a seguir exclui um tipo de anúncio do seu modelo de lances personalizados:

# Excluir uma fração (ad_type == 1 significa VÍDEO)

if ad_type != 1:

return None

Funções e indicadores disponíveis

Apresentamos a seguir uma lista de funções que podem ser usadas no script de lances personalizados. As tabelas contêm as seguintes informações:

• Campo: é o nome da função ou do indicador que você usa no script.
• Tipo: é o tipo de dados de saída. Os lances personalizados são compatíveis com os seguintes tipos de dados:
  • Booleano: contém um valor true ou false.
  • Binário: contém dados binários.
  • Duplo: contém um valor numérico flutuante. Por exemplo, 1.0 .
  • Lista de números inteiros: contém um conjunto de números inteiros.
  • Número inteiro: contém números inteiros positivos ou negativos. Por exemplo, 1 ou -1.
  • String: contém caracteres UTF-8 com um comprimento mínimo de zero ou mais. Por exemplo, country_code gera uma string "US".
• Detalhes: contém mais informações e links para exemplos.

Para mais detalhes, acesse a API Display & Video 360 ou faça o download do arquivo de dados estruturados (SDF, na sigla em inglês).

Funções

Os lances personalizados do Display & Video 360 são compatíveis com as seguintes funções:

• Agregação: funções que calculam valores agregados atribuídos a um critério.
• Conversão: funções que convertem uma variável em um tipo de dados específico para executar uma operação.
• Matemática: funções que calculam valores usando matemática avançada.

Essas funções aceitam um ou mais indicadores para representar com precisão seus indicadores principais de desempenho (KPIs) no script de lances personalizados.

Categoria	Função	Tipo	Detalhes
Funções de agregação	first_match_aggregate	Duplo	Retorna o valor de ponderação atribuído aos primeiros critérios na matriz que retornam true.
	max_aggregate	Duplo	Retorna o valor de ponderação mais alto atribuído a critérios que retornam true.
	sum_aggregate	Duplo	Retorna a soma de todos os valores atribuídos a todos os critérios que retornam true.
Funções de conversão	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".
Funções matemáticas	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).

 

Indicadores

As funções de lances personalizados do Display & Video 360 aceitam dados das seguintes categorias de indicador:

• Variáveis de dimensão: indicadores usados em scripts que pontuam com base em uma variável.
• Conversões: indicadores usados em scripts que pontuam com base em um resultado de conversão.
• Google Analytics: indicadores usados em scripts que pontuam com base em dados do Google Analytics 4 ou do Google Analytics 360.

Variáveis de dimensão

Categoria	Indicador	Tipo	Detalhes
Geral	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/hora	date	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.
Local	city_id	Número inteiro	É o identificador da cidade. É possível gerar o city_id usando a API Display & Video 360 ou fazendo o download dos 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 fazendo o download dos metadados do SDF.
Criativo (geral)	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.
Sistema de computador	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.
	mobile_model_id	Número inteiro	É 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.
Veiculação (geral)	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. É 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	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	Retorna 1 para "true" quando o Active View detecta que o anúncio foi visualizado. Caso contrário, retorna 0 para "false".
Evento	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.
Vídeo	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 etiquetadas. 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 de 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".
	video_content_duration_bucket	Número inteiro	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 etiquetadas. 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. Exemplo Vídeos com duração de 1 minuto: São categorizados no intervalo "1 a 5 minutos" Não estão no intervalo "0 a 1 minuto", já que ele exclui vídeos com 1 minuto ou mais. 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
	video_genre_ids	Lista de números inteiros	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 etiquetadas. 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.
	video_livestream	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 etiquetadas. Vai retornar true se o vídeo for uma transmissão ao vivo. Caso contrário, retorna false.

Conversões

Categoria	Indicador	Tipo	Detalhes
Indicadores de conversão	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.

Mapeamentos de gênero de vídeo

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	/Referência/Humanas/História
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

Google Analytics

Importante

Se quiser usar conversões do Google Analytics 4 ou metas do Google Analytics 360 para definir seu modelo de lances personalizados, compartilhe os dados de conversão. Saiba mais sobre como fazer isso:

• Vincular uma propriedade do Google Analytics 4 ao Display & Video 360
• Vincular sua conta do Google Analytics 360 ao Display & Video 360

Categoria	Indicador	Tipo	Detalhes
Google Analytics 4	has_ga4_conversions( property_id, conversion_event_name)	Booleano	Retorna true se determinada impressão tiver pelo menos uma conversão com um ID da propriedade e um evento de conversão atribuído. Caso contrário, retorna false.
	ga4_conversions_count( property_id, conversion_event_name)	Número inteiro	Retorna o número de conversões com um ID da propriedade e um evento de conversão atribuídos à impressão especificada.
	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. Retorna 0 se o valor da conversão mais alta for 0 ou se nenhuma conversão for atribuída.
	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. Retorna 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)	Duplo	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. Retorna 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)	Duplo	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. Retorna 0 se o valor da conversão mais alta for 0 ou se nenhuma conversão for atribuída.
Google Analytics 360	has_ga_goal(GA View ID, GA Goal ID)	Booleano	Retorna true se determinada impressão tiver pelo menos uma meta com ID da meta do GA atribuído ao ID da visualização do GA. Caso contrário, retorna false.
	ga_goals_count(GA View ID, GA Goal ID)	Número inteiro	Retorna o número de metas associadas a um ID da meta do GA e um ID da visualização do GA atribuídos à impressão especificada.
	ga_goals_max_value(GA View ID, GA Goal ID)	Número inteiro	Retorna o máximo dos valores associados a um ID da meta do GA e um ID da visualização do GA atribuídos à impressão especificada. O valor pode ser 0 se você estiver se referindo à soma real dos valores das metas registrados ou se não houver uma meta atribuída.
	ga_goals_total_value(GA View ID, GA Goal ID)	Número inteiro	Retorna a soma dos valores associados a um ID da meta do GA e um ID da visualização do GA atribuídos a uma impressão especificada. O valor pode ser 0 se você estiver se referindo à soma real dos valores das metas registrados ou se não houver uma meta atribuída.

Limitações

As seguintes ações não são compatíveis com scripts de lances personalizados:

• Transmitir argumentos nomeados, por exemplo: func(arg1 = "abc", arg2 = "def")
• Subscritos e frações, por exemplo: userlists[1:3]
• Atributos de referência, por exemplo: domain.length
• Os nomes das variáveis e funções podem vir de um conjunto predefinido
• Recursão
• Atribuições de variáveis personalizadas avançadas:
  • várias atribuições
  • atribuições aumentadas
  • atribuições com anotações

Exemplo

Apresentamos a seguir exemplos de sintaxe não compatível em atribuições de variáveis personalizadas

_a, _b = 1, 2

_a, _b = _b, _a

_a = _b = 2

_idx += 1

• Palavras-chave não compatíveis:
  • Palavras-chave global, nonlocal e exec
  • class e definições de classe
  • def e definições de função
  • Import e importação de palavras-chave
  • lambda e compatibilidade com lambdas
  • break
  • continue
  • yield
  • raise
  • assert
  • try
  • finally
  • except
  • async
  • await
  • del
  • Pass
  • ellipsis
• Loops incompatíveis:
  • Loops com for e while
• Operadores incompatíveis:
  • * e **, quando usados em instruções não aritméticas
  • Operadores de deslocamento << e >>
  • Operadores de bits
  • Decoradores @
  • Operadores de identidade is e not is