Introdução

Em países com regulamentações de publicidade para serviços financeiros, a Meta pode exigir que os anunciantes verifiquem a própria identidade e licença financeira. Os reguladores fornecerão à Meta um conjunto de dados de licenças financeiras, que a Meta usa para validar as licenças enviadas pelos anunciantes. Este documento aborda como os reguladores compartilham dados de licença com a Meta de forma segura e as especificações técnicas para integração.

Visão geral

A integração funciona da seguinte forma:

1. A Meta fornece credenciais de SFTP – a Meta envia dados de login para o endereço de email confirmado do regulador.
2. O regulador carrega dois arquivos – um arquivo config.json (metadados) e um arquivo CSV (dados de licença) são carregados no servidor SFTP seguro da Meta. Instruções para carregar arquivos.
3. A Meta ingere os dados – os arquivos são processados periodicamente.
4. O regulador carrega regularmente – os reguladores são responsáveis por carregar rotineiramente arquivos atualizados semanalmente.

O que é config.json?

O arquivo config.json é um manifesto que contém metadados necessários para processamento. Deve ser incluído em cada carregamento.

Campos

Exemplo

{
  "version": "v1",
  "load_type": "full",
  "mode": "ingestion",
  "support_email_addresses": [
    "support@domain.com",
    "support2@domain.com"
  ]
}

Dados de licença (CSV)

Os dados de licença são fornecidos como um arquivo CSV. O arquivo pode ter qualquer nome. Há dois tipos de carregamento:

• Carga completa – contém o conjunto completo de todos os dados de licença.
• Carga incremental – contém apenas as alterações (deltas) desde o último carregamento.

Regras gerais

• Os cabeçalhos das colunas devem estar na primeira linha.
• Todos os cabeçalhos de coluna devem ser únicos.
• Todas as colunas obrigatórias devem estar presentes.
• Cada linha deve ter um Credential_Id único.
• Erros no nível da linha não bloqueiam o arquivo inteiro. Linhas válidas ainda são processadas. Por exemplo, se 50 de 100 mil linhas tiverem erros, as 99.950 linhas restantes serão processadas normalmente.

Esquema de carga total (V1)

Para evitar falsificação de identidade, fraude e abuso nas plataformas de publicidade da Meta, uma verificação de conexão é essencial. Os dados da licença financeira carregados devem fornecer pelo menos um dos seguintes itens para cada licença: números de telefone, endereços de email ou URLs de site para realizar essa verificação. Isso garante que o anunciante que está tentando anunciar está usando uma licença conectada à entidade na verificação.

Esquema incremental (V1)

O esquema incremental usa as mesmas colunas que o esquema de carregamento completo, além de uma coluna adicional obrigatória:

Regras de operação

• UPSERT – adiciona uma nova licença ou atualiza uma existente. Segue as mesmas regras de campos obrigatórios/opcionais que o esquema de carregamento completo.
• DELETE – remove uma licença. Apenas Credential_Id é obrigatório. Todos os outros campos são opcionais.

Exemplo de situação de carregamento incremental

Um conjunto de dados inicial contém três licenças: A, B, C.

As seguintes alterações ocorrerão depois:

• A licença B foi atualizada.
• A licença C foi excluída.
• A licença D foi adicionada.

O CSV incremental contém:

A licença A não foi incluída porque não sofreu alterações.

O registro de data e hora do seu último conjunto de dados ingerido está disponível na pasta ingestion_history/ do SFTP (veja abaixo).

Processo de carregamento e ingestão de SFTP

Como carregar

1. Entre no servidor SFTP usando as credenciais fornecidas pela Meta.
2. Carregue config.json e seu arquivo de dados CSV no seu diretório padrão.
3. Aguarde o processamento. Os arquivos podem ser validados várias vezes por dia usando o modo validation em config.json. No entanto, os dados só podem ser ingeridos uma vez por dia.

O que acontece após o carregamento

• Após o processamento, ambos os arquivos são movidos automaticamente para um diretório validation_history/ ou ingestion_history/ dependendo do modo definido em config.json. Se o arquivo CSV carregado contiver algum erro em nível de linha, como valores obrigatórios ausentes ou valores inválidos, será gerado um arquivo CSV separado detalhando esses erros. Antes de realizar uma ingestão, use o modo validation para confirmar que seus arquivos serão processados corretamente.
• Cada execução cria uma pasta com registro de data e hora (por exemplo, 2026-03-11T12-23-56Z/) contendo os arquivos exatos usados no diretório de histórico.
• Se os seus arquivos ainda estiverem no diretório padrão (não em ingestion_history/ ou validation_history/), isso significa que o processamento ainda não ocorreu.
• Retenção: o servidor SFTP retém os arquivos por apenas 30 dias.

Exemplo: antes e depois da ingestão

Abaixo, ilustra-se a estrutura do arquivo antes e depois de uma nova ingestão em 11/03/26 envolvendo data1.csv e config.json com o modo ingestion.

Antes da ingestão

config.json
data1.csv
ingestion_history/
  └── 2026-03-06T04-20-17Z/
       ├── config.json
       ├── license_data.csv
       ├── csv_errors.csv
validation_history/
  └── 2026-03-11T05-18-14Z/
       ├── config.json
       ├── data1.csv
       ├── csv_errors.csv
  └── 2026-03-06T01-15-24Z/
       ├── config.json
       ├── license_data.csv
       ├── csv_errors.csv

Após a ingestão

ingestion_history/
  └── 2026-03-11T12-23-56Z/
       ├── config.json
       ├── data1.csv
  └── 2026-03-06T04-20-17Z/
       ├── config.json
       ├── license_data.csv
       ├── csv_errors.csv
validation_history/
  └── 2026-03-11T05-18-14Z/
       ├── config.json
       ├── data1.csv
       ├── csv_errors.csv
  └── 2026-03-06T01-15-24Z/
       ├── config.json
       ├── license_data.csv
       ├── csv_errors.csv

Para acionar outra ingestão, carregue novos arquivos no seu diretório padrão novamente.

Observações importantes

• Tempo de processamento: os dados podem demorar até um dia para aparecer no sistema da Meta após a ingestão.