Como monitorar novos criativos de anúncios do Google ao longo do tempo

1. Configure seu primeiro instantâneo de linha de base

Defina exatamente quais anunciantes conferidos e quais valores de filtro você monitora. Salve um pequeno lote de referência com o momento da coleta, o limite de resultados, o resultado da execução e qualquer nota de escopo. Salve as linhas de criativos sem sobrescrevê-las.

A tarefa pública Google Ads Advertiser Monitor | Creative Snapshots é uma predefinição de entrada salva para o ator. A entrada predefinida dela é `{"targets": ["apple.com", "samsung.com"], "region": "US", "platform": "ALL", "adFormat": "ALL", "includeDeliveryDetails": false, "maxItems": 10}`. Substitua targets por IDs ou URLs exatos de anunciantes conferidos, pois uma busca por domínio pode retornar várias contas de anunciante. `maxItems` é um teto compartilhado entre targets. Registre os seus filtros reais, inclusive a política de datas.

Uma linha significa um anunciante e um criativo observados. A identidade exata usa `advertiserId` mais `creativeId`. Os campos obrigatórios incluem `creativeUrl`, `observedAt`, `requestedRegion`, `requestedPlatform`, `requestedFormat`, `status` e `statusReason`. `firstShownAt` e `lastShownAt` são datas públicas da fonte, não o momento da sua primeira observação. `variations` e `variationCount` são detalhes de recursos filhos, não IDs de criativos novos.

Mantenha o ID do lote de coleta e o status da execução em um manifesto pertencente ao leitor. A linha não tem o campo `runId`. Não invente um total da fonte nem alegue completude a partir de uma execução bem-sucedida limitada por teto. Revise a saída e o teto real ou o status de parada dela. Se a cobertura não puder ser estabelecida, rotule o instantâneo como limitado. A aceitação atual de metadados de duas linhas não é um teste de monitoramento em dois momentos.

2. Agende e valide execuções posteriores

Defina um tempo de repetição manual razoável para a sua necessidade. A tarefa não tem alerta recorrente integrado. Mantenha a mesma conta alvo, região, formato, plataforma e política de janela de datas. Se uma janela móvel for necessária, registre as duas janelas reais e não trate as exclusões delas como remoções.

Valide cada execução posterior antes de compará-la. Verifique se há coleta bem-sucedida, as contas esperadas, o mesmo escopo pretendido, nenhuma falha não tratada e um estado honesto de teto ou de cobertura. Uma amostra parcial bem-sucedida continua sendo uma amostra. Mantenha falhas e coletas vazias distintas de um zero explícito da fonte.

3. Compare conjuntos de identidades entre lotes

Deduplique as linhas dentro de um lote por `advertiserId` e `creativeId`. Entre os lotes, mantenha o seu histórico de observação, mas compare o conjunto de identidades de cada lote.

Rotule os itens atuais menos os itens anteriores como recém-observados nesta comparação. Rotule os itens anteriores menos os itens atuais como não observados agora. Nunca chame estes últimos de excluídos ou inativos somente pela ausência. Compare somente chaves não em branco de `advertiserId` mais `creativeId`. Uma identidade ausente permanece sem resolução fora dos conjuntos.

Interseção significa identidades nos dois conjuntos. União significa todas as identidades distintas nos dois conjuntos.

4. Revise criativos recém-observados

Abra a fonte de cada criativo recém-observado e revise a identidade, as datas da fonte e se você já processou aquela chave exata de conta e de criativo. Mantenha um estado não revisado quando a pré-visualização não estiver disponível. Uma descoberta tardia pode mostrar uma data antiga de primeira veiculação. Informe isso em vez de anunciar um lançamento novo.

Mantenha uma tabela de chaves processadas para os alertas. Cada chave precisa de uma data em que foi vista pela primeira vez, um status de revisão, o momento da última observação e um estado de alerta. Tente novamente um alerta com falha separadamente de recoletar os dados. Uma pré-visualização alterada sob a mesma chave de criativo pode ser uma revisão de alteração, mas não é um alerta de criativo novo. Mantenha essas decisões explícitas.

Salve a sua fila de revisão e o desfecho dela após cada comparação aceita. Não avance a linha de base confiável após uma execução com falha. Uma execução limitada pode produzir novos candidatos observados, mas as identidades ausentes dela devem permanecer desconhecidas.

Exemplo prático fictício

Todas as identidades, datas, contagens e eventos neste exemplo são inventados.

Imagine que você confere o anunciante A com o mesmo conjunto de filtros:

• O Lote 1 foi coletado em 1º de outubro de 2026, às 12:00:00 UTC. Ele tem as chaves de criativo A/C1, A/C2 e A/C3. Você anota que ele é uma amostra limitada. Os seus alertas processados já contêm C1, C2 e C3.
• O Lote 2 foi coletado em 8 de outubro de 2026, às 12:00:00 UTC. Ele tem A/C2, A/C3, A/C4 e A/C5. Também é uma amostra limitada.
• Atual menos anterior é igual a `{C4, C5}` com contagem 2.
• Anterior menos atual é igual a `{C1}` com contagem 1.
• A interseção é igual a `{C2, C3}` com contagem 2.
• A união é igual a `{C1, C2, C3, C4, C5}` com contagem 5.
• Não transforme 2 itens novos e 4 itens retornados em uma taxa de crescimento, porque as amostras têm teto.

Em seguida, você inspeciona os itens no Lote 2:

• O criativo C4 tem o `firstShownAt` da fonte em 2 de setembro de 2026. Ele é recém-observado, mas claramente não foi veiculado pela primeira vez nesta semana.
• O criativo C5 tem uma data de `firstShownAt` desconhecida, então o momento do lançamento dele é desconhecido.
• Estado da fila de revisão:
• A/C4 é recém-observado, a fonte foi conferida, tem uma data antiga da fonte, e um alerta é emitido sobre ele porque é novo para a biblioteca.
• A/C5 é recém-observado, a pré-visualização não está disponível, a data é desconhecida e a revisão está pendente.
• C1 não é observado agora, a comparação é limitada, a disponibilidade é desconhecida e nenhum alerta de remoção é enviado.

Próximas etapas na linha do tempo fictícia:

• O Lote 3 em 9 de outubro falha e não retorna linhas aceitas. Você mantém o Lote 2 como a sua última linha de base confiável. Você não move a linha de base após o Lote 3 com falha e não produz alertas de remoção para C2 até C5.
• O Lote 4 em 15 de outubro retorna C3, C4, C5 e C6 com o mesmo escopo. Você compara o Lote 4 aceito com o Lote 2.
• Recém-observado é igual a `{C6}`.
• Não observado é igual a `{C2}`.
• Os itens em comum são iguais a `{C3, C4, C5}`.

• O criativo C4 processado evita alerta repetido. O criativo C5 não está revisado. O criativo C6 é uma revisão nova. A ausência de C1 ou C2 é desconhecida. As linhas completas do livro-razão incluem C4 alertado, C5 pendente, C6 revisão nova e ausência de C1 ou C2 desconhecida. Esta é uma verificação fictícia de regra, não uma prova da disponibilidade completa atual da fonte.