
Um Actor é um programa de coleta hospedado. Um criativo é o texto, a imagem, o vídeo ou outra apresentação pública de um anúncio. Um conjunto de dados de criativos vazio informa que o programa não salvou nenhuma linha. Por si só, ele não informa o motivo.
A dúvida de quem avalia essas opções é direta: “Estou preenchendo os dados de entrada de forma errada?” Um chamado público de suporte descreve uma busca por domínio na Alemanha que não retornou linhas, embora o usuário visse anúncios. A entrada enviada usava `maxItems:1` e valores em branco para plataforma e formato. Esse relato mostra a necessidade de um método claro de análise. Ele não comprova a causa daquele resultado. Chamado público de suporte
A Chronometrica publica esta comparação e desenvolve o Actor recomendado. As evidências sobre os produtos foram coletadas em 20 de outubro de 2026. Nenhuma execução real testou os Actors ou o domínio relatado para este artigo.
Escolha o contrato de resultados de que seu trabalho precisa
A principal decisão é saber se o seu processo exige resultados declarados para cada alvo. Aqui, contrato de resultados significa o conjunto de informações documentadas que um programa fornece sobre o que ocorreu durante uma verificação.
A Chronometrica documenta `targetOutcomes` e diferencia `no_results` de uma fonte pública indisponível. Ela também documenta os criativos úteis salvos, os criativos duplicados ou inutilizáveis ignorados e os motivos finais de parada. Escolha essa opção quando esses registros forem necessários para analisar um resultado com 0 linhas. Esta recomendação se baseia no contrato documentado. Actor da Chronometrica
Continue com o Fortuitous Pirate quando sua entrada de consulta única e os controles `advertiserId` e `proxyConfiguration` atenderem ao seu fluxo de trabalho. O esquema verificado aceita a consulta histórica para a Alemanha e os valores em branco de plataforma e formato. Examine os logs e a saída de uma execução atual antes de decidir pela troca. O README curto não comprova a ausência de logs ou de resultados por alvo. Actor do Fortuitous Pirate
| Critério de decisão | Chronometrica | Fortuitous Pirate |
|---|---|---|
| Evidências necessárias para uma verificação sem resultados | Resultados e motivos de parada declarados por alvo | Examine as evidências reais de uma execução atual |
| Adequação da entrada nesta comparação | Alvo por domínio com Alemanha definida explicitamente e configurações para todas as plataformas e todos os formatos | O esquema verificado aceita a estrutura da entrada histórica |
| Motivo para escolher | Sua análise exige o contrato de resultados documentado | A consulta e os controles já atendem ao seu processo |
Essas são regras de seleção, não resultados de desempenho medidos. As evidências não comprovam vantagem em velocidade, preço, precisão, cobertura ou confiabilidade.
Separe a contagem de linhas salvas do estado da fonte
Um conjunto de dados vazio responde a uma pergunta específica: quantas linhas de criativos foram salvas? O estado da fonte responde a outra pergunta: o que o programa conseguiu acessar e usar?
Mantenha 3 explicações possíveis separadas durante a análise.
Primeiro, uma verificação pode acessar a fonte pública e não encontrar resultados úteis para o alvo e os filtros. O próximo passo é examinar a identidade do alvo e o escopo da busca. Uma divergência de domínio, anunciante, região ou data pode mudar o que você espera encontrar. Não escolha uma causa até que as evidências a sustentem.
Segundo, a fonte pública pode estar indisponível para a verificação. Nesse caso, um conjunto de dados com 0 linhas não descreve a atividade publicitária do anunciante. Analise o acesso à fonte antes de concluir algo sobre o escopo da busca.
Terceiro, a página de um criativo pode estar visível, mas seus arquivos públicos podem ser inutilizáveis para a coleta. A regra de resultados da Chronometrica pode ignorar um criativo sem mídia pública utilizável ou prévia. Por isso, uma página visível e uma linha de criativo salva não precisam ter uma correspondência de 1 para 1. Actor da Chronometrica
Essa distinção também muda a forma de relatar o resultado. Escreva “0 linhas úteis salvas com estas configurações” quando isso for o que você sabe. Não reduza a frase a “o anunciante não tem anúncios”. A frase mais curta omite os filtros, as condições da fonte e as limitações dos arquivos que dão sentido ao resultado.
O limite configurado é outro fato separado. Uma solicitação de no máximo 1 linha não promete 1 linha. Ela define um máximo. Se a verificação salvar 0 linhas, aumentar apenas o limite não explica o resultado anterior.
Prepare a entrada para a Alemanha antes de executar
Uma Task é uma configuração de entrada salva para um Actor. A Task de pesquisa regional no link tem Canada no título. Use-a como ponto de partida e examine a entrada que está salva nela. A página pública verificada estava disponível, mas essa consulta à página não confirmou os valores salvos nos campos. Task de pesquisa regional
Para o caso da Alemanha no chamado de suporte, use esta entrada:
{
"targets": [
"ritzenberger.de"
],
"region": "DE",
"platform": "ALL",
"adFormat": "ALL",
"includeDeliveryDetails": false,
"maxItems": 1
}Esta entrada passou por uma validação com base no JSON Schema público salvo. Um JSON Schema define os campos, tipos e valores de entrada permitidos. Todos os campos mostrados acima existem no esquema verificado. Isso confirma a estrutura da entrada. Não confirma o acesso à fonte em uma execução real nem promete um resultado. Entrada do Actor da Chronometrica
Siga estas etapas antes da verificação pequena:
- Preserve o domínio exatamente como foi relatado. Guarde nas notas da análise qualquer identidade do anunciante conhecida por outros meios.
- Abra a entrada da Task e substitua a região por `DE`. Não se baseie no título da Task nem presuma que a região salva já corresponde à desejada.
- Defina `platform` e `adFormat` como `ALL` para esta verificação.
- Examine todos os campos salvos. Elimine qualquer dúvida sobre os filtros antes de comparar a saída com o que aparece no navegador.
- Mantenha `maxItems` em `1` para a verificação inicial mostrada aqui.
Registre o intervalo de datas usado na comparação com a fonte pública. Se o Actor não mostrar esse intervalo nas evidências que você examinar, marque-o como desconhecido. Não adicione um campo de entrada que você não tenha validado com base no esquema.
O esquema verificado permite de 1 a 100 entradas em `targets` e um número inteiro de 1 a 5.000 em `maxItems`. Se o seu requisito original for uma única execução configurada para retornar mais de 5.000 resultados, este Actor não atende ao requisito. Uma verificação menor não atende a uma solicitação maior de todos os resultados. Entrada do Actor da Chronometrica
Analise o resultado da verificação junto com o conjunto de dados
Após executar a verificação pequena planejada, analise as linhas salvas junto com os registros dos resultados. Comece pelo alvo. Depois, examine os filtros, o estado da fonte, os criativos ignorados e o motivo da parada. A Chronometrica documenta essas informações no contexto do alvo e na contabilização dos resultados. Actor da Chronometrica
Use uma ficha de análise curta. Aqui, uma ficha é um registro escrito das evidências de 1 alvo.
- Alvo identificado: registre a identidade do anunciante que a verificação identificou. Se ela diferir do anunciante pretendido, deixe essa diferença explícita.
- Filtros solicitados: registre a região, a plataforma, o formato, o intervalo de datas quando conhecido e o limite solicitado.
- Estado da fonte: registre se o resultado sustenta a ausência de resultados úteis ou a indisponibilidade da fonte pública.
- Linhas úteis: registre a quantidade real salva. Use 0 apenas quando a saída informar ou comprovar 0.
- Criativos ignorados: registre as contagens de criativos duplicados e inutilizáveis conforme fornecidas. Preserve os valores desconhecidos ou ausentes.
- Motivo final da parada: registre por que a verificação terminou. Não deduza esse motivo apenas pelo tamanho do conjunto de dados.
- Causa não esclarecida: informe o que as evidências disponíveis ainda não conseguem explicar.
Mantenha a ficha vinculada a 1 alvo e a 1 conjunto de configurações. Caso contrário, uma mudança posterior nos filtros pode fazer um resultado anterior parecer incoerente, quando as 2 verificações responderam a perguntas diferentes.
Leia as contagens de itens ignorados com cuidado. Um item ignorado por duplicidade e um item ignorado por ter um arquivo inutilizável sustentam interpretações diferentes. A duplicidade se refere a material repetido. Um arquivo inutilizável se refere à possibilidade de um criativo gerar uma linha útil salva. Use apenas os detalhes que a saída realmente fornece. Não invente uma divisão por motivo quando ela apresentar uma contagem conjunta.
Se um valor estiver ausente, escreva “desconhecido”. A ausência de evidências sobre o estado da fonte não equivale a uma falha confirmada da fonte. A ausência de contagens de itens ignorados não confirma que 0 itens foram ignorados. Isso mantém o registro útil para uma análise posterior.
Um exemplo fictício: contagens iguais, próximos passos diferentes
O exemplo a seguir é fictício. Ele não é um teste de Actor, um conjunto de dados real ou um resultado de cliente.
Uma analista verifica 1 alvo 2 vezes. As 2 verificações salvam 0 linhas de criativos.
A verificação A acessa a fonte pública. Seu resultado informa que não há resultados úteis com os filtros declarados. O próximo passo da analista é comparar o anunciante identificado e os filtros com a visualização pública que gerou a expectativa de encontrar anúncios. A analista confere a região, a plataforma, o formato, as datas e o horário da consulta à fonte.
A verificação B não consegue usar a fonte pública. A analista examina primeiro o acesso à fonte. A verificação não sustenta uma conclusão sobre os anúncios do anunciante, pois não conseguiu usar a fonte.
A conta é simples: a verificação A salvou 0 linhas, e a verificação B salvou 0 linhas. As contagens de linhas são iguais. Os estados da fonte são diferentes, portanto os próximos passos também são diferentes.
As 2 verificações usaram um limite de 1 linha. Esse limite não exigia que nenhuma delas retornasse 1 linha. Ele restringia a quantidade máxima de resultados, mas não garantia um resultado.
Nenhum dos resultados comprova que o anunciante não tem anúncios. A verificação A continua limitada pelo alvo, pelos filtros e pela regra de resultados úteis. A verificação B continua limitada pelo acesso à fonte. O exemplo sustenta um método de análise, não uma estimativa de custo ou uma alegação de confiabilidade.
Use uma verificação pequena de aceitação para decidir
Uma verificação de aceitação é um teste pequeno com um critério de aprovação por escrito. Aqui, sua finalidade é decidir se a saída consegue responder à sua dúvida sobre o resultado vazio.
Defina o critério de aprovação antes da execução: “Para este alvo, consigo identificar o anunciante encontrado, os filtros solicitados, o estado da fonte, as linhas salvas, os criativos ignorados e o motivo final da parada.” Uma contagem positiva de linhas não é necessária para passar nesta verificação. Um resultado vazio explicado pode ser uma evidência útil.
Siga este método:
- Registre as evidências públicas esperadas. Anote o domínio ou anunciante, a região, a referência do criativo visível e quando você o observou. Preserve a entrada original sem alterações nas suas notas.
- Valide a estrutura da entrada. Confira os campos e valores permitidos no esquema atual do Actor. Diferencie um erro de esquema de uma busca válida que não produz linhas úteis.
- Execute a verificação pequena planejada. Use as configurações explícitas que você analisou. Não altere vários filtros apenas para obter uma contagem positiva.
- Preencha a ficha. Leia as evidências do resultado junto com o conjunto de dados. Marque como desconhecido todo valor não esclarecido.
- Escolha a próxima ação. Analise a identidade e os filtros quando não houver resultados úteis, o acesso à fonte quando ela estiver indisponível ou as limitações dos arquivos quando houver criativos inutilizáveis.
Se outra verificação for necessária, altere 1 configuração relevante e registre o motivo. Isso facilita a interpretação do novo resultado. Um conjunto de dados maior não é automaticamente uma explicação melhor.
Para casos não esclarecidos, prepare um relato para o suporte com a entrada sanitizada, as evidências públicas esperadas, o resultado observado e a dúvida restante. Sanitizada significa que os dados privados ou sensíveis foram removidos. Não inclua credenciais de proxy ou outros segredos.
Esse processo também oferece uma base justa para continuar com uma ferramenta existente. Avalie se as evidências reais dela atendem ao seu critério de aceitação. Um relato histórico de suporte, por si só, não pode responder a essa questão para uma execução atual.
Depois de esclarecer a dúvida sobre o resultado vazio, use o guia de comparação regional de criativos para comparar conjuntos de criativos salvos em diferentes regiões. Essa é uma análise separada. Determine o que a verificação sem resultados significa antes de usá-la como evidência de uma diferença regional.
Fontes e leituras adicionais
- Chronometrica Google Ads Transparency Scraper — resultados documentados, regras de resultados úteis, criativos ignorados e motivos de parada; verificado em 20 de outubro de 2026 com evidências em cache da build 0.2.7; apenas o contrato documentado, sem execução real
- Esquema de entrada do Chronometrica Google Ads Transparency Scraper — campos e limites de entrada verificados; verificado em 20 de outubro de 2026 com base no esquema público em cache da build 0.2.7; a entrada fornecida passou por uma validação de estrutura, não por uma verificação de acesso à fonte em execução real
- Fortuitous Pirate Google Ads Transparency Scraper — contrato de entrada e controles da alternativa; verificado em 20 de outubro de 2026 com evidências em cache da build 1.0.12; os valores de entrada aceitos não explicam o resultado histórico, e o registro de logs durante a execução não foi medido
- Chamado público de suporte do Fortuitous Pirate sobre resultado vazio — dúvida histórica de um comprador e entrada enviada; verificado em 20 de outubro de 2026; evidência da necessidade de quem compra, não uma prova da causa ou de uma falha atual de execução
- Task de pesquisa regional de criativos da Chronometrica — configuração inicial com Canada no título; verificada em 20 de outubro de 2026, com resposta HTTP 200 da página pública; a entrada salva não foi verificada, a Alemanha exige configurações explícitas com DE e nenhuma execução foi feita
Por Chronometrica · Atualizado
Voltar ao topo ↑