Resumo da linha filtrada

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. Isso pode ajudar a 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 usando a interface. Esses resumos não são usados em consultas de público-alvo. As consultas criadas usando a API não têm um resumo de linha filtrada ativado por padrão.

Importante: recomendamos usar ruído em vez de verificações de diferenças ao gerar seus relatórios. Quando você usa ruído, as linhas não são filtradas devido a verificações de diferenças, o que torna um resumo de linhas filtrado desnecessário. Para saber mais, consulte Injeção de ruído.

Importante: os requisitos de agregação ainda são usados nas colunas do resumo da linha filtrada. Se o resumo tiver menos de 50 usuários ou menos de 2 linhas, ele vai ser filtrado. No entanto, uma mensagem vai aparecer no resumo do status do job informando que houve uma filtração.

Exemplo

No exemplo a seguir, 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

Recomendamos usar o modo automático. Por padrão, o Ads Data Hub ativa e configura um resumo de linha filtrada para novas consultas criadas usando a interface. Quando você edita a consulta, o ADH ajusta a configuração com base nas colunas selecionadas.

• Para conferir as configurações configuradas automaticamente ao visualizar um relatório, acesse Propriedades > Resumo da linha filtrada. A configuração é exclusiva para leitura.
• Para desativar o modo automático, clique no botão Automático para a posição desativada. A configuração atual é mantida, e o modo automático é desativado. É necessário salvar a consulta para manter a alteração.
• Para ativar o modo automático, clique no botão Automático para ativar a posição. É necessário salvar a consulta para manter a alteração.
• Para alternar o modo automático com a API, use generateFilteredRowSummaryAutomatically.

Modo manual

Recomendamos usar o modo automático. Para adicionar manualmente um resumo de linha filtrada a uma consulta salva ou após desativar o modo automático:

1. Identifique a coluna que você quer agregar.
2. Clique em Adicionar regra em Propriedades > Resumo da linha filtrada no lado direito do editor de consultas.
3. Insira o nome da coluna que você quer agregar no campo Nome da coluna.
4. Selecione Soma no menu suspenso Tipo. Se a soma estiver abaixo dos limites de agregação, o resumo da linha filtrada será descartado.
5. Opcional: adicione mais regras, como você fez nas etapas anteriores.
6. Opcional: adicione um identificador para o resumo da linha filtrada usando uma constante. A constante precisa ser um tipo de dados válido para a coluna escolhida.
   1. Insira o nome da coluna no campo **Nome da coluna.
   2. Selecione Constante no menu suspenso Tipo.
   3. Insira um identificador para a linha no campo Especificar constante.
7. Para remover uma regra, clique em Excluir.
8. Para remover todas as regras, clique em Remover tudo.

Modo manual com várias tabelas

Recomendamos usar o modo automático. Se você estiver exportando várias tabelas usando a sintaxe in-sql apresentada em Como exportar várias tabelas, adicione um resumo de linha filtrado 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 de linha filtrado 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.