As linhas que não forem agregadas corretamente para proteger a privacidade do usuário final ou que não atenderem a outras verificações de privacidade do Ads Data Hub serão descartadas dos resultados das consultas. É possível configurar um resumo de linha filtrada em consultas de análise para retornar uma única linha que inclui constantes e somas de linhas descartadas. Assim, é possível evitar discrepâncias nos valores dos dados, como o total de impressões ou a contagem de cliques. Um resumo de linha filtrada é ativado por padrão para novas consultas de análise criadas na IU. Esses resumos não são usados em consultas de público-alvo. As consultas criadas na API não têm um resumo de linha filtrada ativado por padrão.
Exemplo
No exemplo abaixo, as linhas que contêm as campanhas 124 e 125 são filtradas, já que não atendem ao requisito de agregação de 50 usuários.
| ID da campanha | Usuários |
|---|---|
| 123 | 400 |
| 124 | 45 |
| 125 | 6 |
No entanto, usando um resumo de linha filtrada, os dados filtrados podem ser combinados para atender ao requisito de agregação de 50 usuários. Este exemplo usa uma soma para calcular os dados filtrados e uma constante para identificar a linha:
- Uma soma que agrega dados filtrados da coluna
Users. - Uma constante, usada para identificar o resumo de linha filtrada, definida como "Resumo da linha filtrada" na coluna
Campaign ID.
| ID da campanha | Usuários |
|---|---|
| Resumo da linha filtrada | 51 |
| 123 | 400 |
Modo automático
Por padrão, o Ads Data Hub ativa e configura um resumo de linha filtrada para novas consultas criadas na IU. Quando você edita a consulta, o ADH ajusta a configuração com base nas colunas selecionadas.
- Acesse as configurações definidas de forma automática em Propriedades > Resumo da linha filtrada. A configuração é exclusiva para leitura.
- Para desativar o modo automático, clique no botão Automático. A configuração atual é mantida, e o modo automático é desabilitado.
- Para ativar o modo automático, clique no botão Automático. Na caixa de diálogo Mudar para automático? que aparece, clique em Sim, redefinir. A configuração atual é removida, e o modo automático é ativado.
- Para habilitar o modo automático pela API, use
generateFilteredRowSummaryAutomatically.
Modo manual
Para adicionar um resumo de linha filtrada a uma consulta salva ou após desativar o modo automático:
- Identifique a coluna que você quer agregar.
- Clique em Adicionar regra em Propriedades > Resumo da linha filtrada no lado direito do Editor de consultas.
- Insira o nome da coluna que você quer agregar no campo Nome da coluna.
- Escolha Soma no menu suspenso Tipo. Se a soma estiver abaixo dos limites de agregação, o resumo da linha filtrada vai ser descartado.
- Opcional: adicione mais regras, como você fez nas etapas anteriores.
- Opcional: adicione um identificador para o resumo da linha filtrada usando uma constante.
A constante precisa ser um tipo de dado válido para a linha escolhida.
- Insira o nome da coluna no campo Nome da coluna.
- Selecione Constante no menu suspenso Tipo.
- Insira um identificador para a linha no campo Especificar constante.
- Para remover uma regra, clique em Excluir.
- Para remover todas as regras, clique em Remover tudo.
Se você estiver exportando várias tabelas usando a sintaxe in-sql introduzida em Como exportar várias tabelas, adicione um resumo de linha filtrada nas opções da coluna:
CREATE TABLE `myproject.mydataset.mytable` (
campaign_id INT64 OPTIONS(merge_constant=0),
ct INT64 OPTIONS(merge_type="SUM")
)
OPTIONS(privacy_checked_export=true) AS
SELECT campaign_id, COUNT(*) AS ct GROUP BY campaign_id;
Isso produz uma tabela de resultados com um resumo em que campaign_id é 0, e ct é a soma das linhas que foram filtradas do resultado devido às verificações de privacidade.
Estas são as colunas disponíveis para o resumo da linha filtrada:
merge_type="SUM": gera a soma dos valores filtrados na linha do resumo. Válido apenas para tipos numéricos.merge_constant=<value>: define um valor constante na linha do resumo. Precisa ter o mesmo tipo da coluna.- As colunas sem opção especificada mostram NULO na linha do resumo.
Só é possível especificar merge_type ou merge_constant.
Todas as regras para resumos de linhas filtradas também são usadas aqui,. ou seja, se a soma ficar abaixo dos limites de agregação, o resumo da linha filtrada vai ser descartado.