Como comparar criativos públicos de anúncios do Google entre regiões

Configuração e detalhes do build público

O build público 0.2.7 do Google Ads Transparency aceita targets que contêm nomes, domínios, IDs de anunciante ou URLs públicas de anunciante/criativo; region, platform, adFormat, dateFrom/dateTo opcionais, includeDeliveryDetails e maxItems. Uma predefinição de Task salva usa targets como `["nike.com", "adidas.com"]`, region `CA`, platform `ALL`, adFormat `ALL`, includeDeliveryDetails `false` e maxItems `10`. Substitua os targets de amostra por um ID de anunciante conferido pretendido para a sua primeira conferência: targets `[oneID]`, region `CA`, platform `ALL`, adFormat `ALL`, includeDeliveryDetails `false` e maxItems `2`. Use o adFormat nativo exato, não uma entrada inventada. As configurações opcionais dateFrom/dateTo devem coincidir entre as amostras comparadas; não invente paginação.

Os campos nativos obrigatórios incluem input, inputType, requestedRegion, requestedPlatform, requestedFormat, advertiserId, advertiserName, advertiserLegalName, advertiserDomain, advertiserCountryCode, advertiserVerified, creativeId, creativeUrl, observedAt, status e statusReason. payerName, servedRegions e servedPlatforms opcionais podem ser null. Mantenha requestedRegion separado de advertiserCountryCode e da geografia de veiculação opcional; não infira segmentação, nacionalidade do público ou desempenho privado.

OUTPUT representa a evidência da execução contendo targetsReceived, targetsResolved, targetOutcomes, duplicatesSkipped, unusableCreativesSkipped, creativesSaved, statusCounts e stopReason. A aceitação delimitada atual e real difere da ficção: um piloto do Canadá com ID exato retornou um criativo útil sob o teto 2, com requestedRegion ca, advertiserCountryCode SG, advertiserDomain null, servedRegions null e servedPlatforms null com os detalhes de veiculação desativados; null é indisponível, não ausência de veiculação. OUTPUT relatou um target recebido e resolvido, um criativo salvo, status ok e sources_finished. Um teto de 2 é um limite superior, não um número prometido, e sources_finished não certifica a cobertura completa do país. Somente o Canadá foi testado; uma comparação real com um segundo país exige uma segunda execução correspondente aceita antes de comparar. Não apresente a ficção dos EUA como aceitação do produto.

Etapas para a comparação regional de criativos

1. Confirme primeiro o ID exato do anunciante. Um nome de domínio pode corresponder a várias contas, então confira a inclusão da conta antes de começar.
2. Escolha dois países. Mantenha a plataforma, o formato do anúncio, as configurações de data e os tetos de itens idênticos nas duas execuções. Mantenha o país do anunciante separado da região de anúncio solicitada.
3. Execute primeiro um teste pequeno. Para o Canadá, use targets com o seu ID de anunciante conhecido, region CA, platform ALL, formato de anúncio ALL, includeDeliveryDetails false e maxItems 2. Um teto é um limite, não uma contagem prometida.
4. Salve cada linha nativa de criativo. Anote o ID do anunciante, o ID do criativo, a URL do criativo, a região e o status. Não adivinhe a segmentação de público nem o desempenho a partir dessas datas.
5. Confira cada execução de origem antes de comparar conjuntos. Uma consulta com falha ou um teto atingido é um limite da origem, não uma população vazia. Se as entradas, a identidade ou as datas de coleta diferirem de modo material, rotule as amostras como não pareadas e não atribua as diferenças ao filtro de região.
6. Monte os conjuntos usando a chave combinada de ID do anunciante e ID do criativo para cada amostra de região. Informe a interseção e cada conjunto exclusivo — as chaves observadas naquela amostra de região e ausentes na outra amostra — usando essa chave combinada exata. IDs desconhecidos permanecem não resolvidos. Várias variações em um criativo não são vários IDs de criativo.
7. Descreva os resultados com clareza. Use rótulos como observado em ambos, somente a região A, somente a região B ou não visto nesta amostra. Mantenha este último distinto de nunca veiculado. As diferenças de resultado podem refletir a seleção da origem, tetos, mudanças ao longo do tempo nos dados ou nas observações, ou detalhes ausentes, em vez de uma estratégia comprovada do anunciante.
8. Entregue a sua tabela de pertencimento e o seu recibo. Se uma consulta falhar ou uma divergência de anunciante permanecer, interrompa a comparação e conserve a sua evidência de uma única região. Não combine uma amostra de qualquer lugar com uma amostra de país.

Livro-razão e recibo de amostra regional em ficção original

O recibo de amostra e a tabela de pertencimento em ficção original a seguir ilustram um recibo feito pelo leitor, não campos nativos nem uma execução real do produto nos EUA. Suponha que o anunciante A tenha um recibo de entradas pareadas, coletado sob platform ALL, formato de anúncio ALL, teto 5, includeDeliveryDetails false, dateFrom explícito 2026-01-01 e dateTo 2026-03-31, todos idênticos, com marcas de tempo concretas de observação em 2026-02-15 para o Canadá e para os Estados Unidos. Configurações do anunciante ou fronteiras de coleta materialmente diferentes criam amostras não pareadas, não um efeito de região.

Abaixo está a tabela regional de pertencimento em ficção original, com cinco chaves compostas de advertiserId mais creativeId. Aqui, AC1, AC2, AC3, AC4 e AC5 representam chaves fictícias de criativo do anunciante A.

Neste conjunto de ficção original, o tamanho da amostra do Canadá é 3, o tamanho da amostra dos Estados Unidos é 4, o tamanho da interseção é 2 (AC2, AC3), o tamanho somente do Canadá é 1 (AC1), o tamanho somente dos Estados Unidos é 2 (AC4, AC5) e o tamanho da união é 5. "Não visto" significa ausente somente dentro daquela amostra salva conferida, não que nunca foi veiculado. Observações duplicadas do criativo C3 contribuem com somente uma chave conhecida, e chaves desconhecidas permanecem não resolvidas fora dos conjuntos confiáveis. Se, em vez disso, a execução dos Estados Unidos falhar, esse conjunto é desconhecido em vez de vazio, e a aritmética de pertencimento exclusivo não pode ser calculada a partir dele.