Resumo: Configure as conexões da DCP para integrar suas fontes de dados, enriquecer seus dados e exportar audiências para armazenamento na nuvem e parceiros de mídia.
Sobre as conexões da DCP
As conexões determinam como a DCP ingere seus dados e exporta suas audiências. Depois de configurar seus serviços na nuvem, conecte-os à DCP usando o modal Gerenciar conexões. Estes são os tipos de conexão disponíveis:
- Conexões de fontes: para integrar seus dados first-party à DCP a partir do armazenamento na nuvem ou de um data warehouse.
- Conexões de armazenamento na nuvem: para exportar suas audiências para seus buckets do Amazon S3 ou do Google Cloud Storage (GCS).
- Conexões com parceiros de mídia: para enviar suas audiências às plataformas de anúncios para ativação.
- Conexões de dados e identidade: para unificar dados de usuário fragmentados, melhorar as taxas de correspondência e expandir audiências do parceiro.
A DCP é compatível com diferentes serviços na nuvem de acordo com o tipo de conexão. Consulte a tabela abaixo para ver quais serviços você pode usar para cada tipo de conexão:
| Serviços na nuvem | Fonte (entrada) | Exportação do armazenamento na nuvem (saída) |
|---|---|---|
| Amazon S3 | ✓ | ✓ |
| Google Cloud Storage (GCS) | ✓ | ✓ |
| BigQuery | ✓ | - |
| Snowflake | ✓ | - |
| Salesforce Cloud/CRM | ✓ | - |
No Amazon S3 e no Google Cloud Storage, uma única conexão funciona como fonte (entrada) e destino de exportação do armazenamento na nuvem (saída). Ao criar uma conexão de origem para o S3 ou o GCS, você também cria automaticamente uma conexão correspondente de armazenamento na nuvem (exportação), e vice-versa.
Criar conexões de origem
Crie conexões de origem para integrar dados first-party à DCP.
Para criar uma conexão de origem:
- Na AppsFlyer, vá para Colaborar > Data Clean Room.
- Clique em Gerenciar conexões no canto superior à direita.
- Acesse a aba Fonte e clique em + Nova conexão.
- Continue com as instruções sobre as conexões de serviços na nuvem para dados de origem abaixo.
Você também pode criar uma conexão de origem ao configurar uma fonte. Veja como criar e gerenciar fontes para obter mais instruções.
Atenção
Ao criar uma conexão de origem de entrada para o S3 ou o GCS, você também cria automaticamente uma conexão de saída correspondente de armazenamento na nuvem (e vice-versa). Ao excluir uma conexão do Amazon S3 ou do GCS, você também exclui automaticamente a outra. Como se trata de uma conexão subjacente, ao removê-la de qualquer uma das abas, você também a remove de todos os locais onde é usada.
Conexões dos serviços na nuvem para dados de origem
As conexões de origem servem para conectar seus dados de origem à DCP com segurança. Na caixa de diálogo Nova conexão, selecione seu serviço na nuvem e preencha os detalhes do seu provedor:
BigQuery: Na caixa de diálogo Nova conexão, insira o ID do projeto do BigQuery para o projeto que contém seus dados de origem. Você pode encontrá-lo na página do BigQuery do seu Google Cloud Console.
Snowflake: Na caixa de diálogo Nova conexão, insira o ID da conta do Snowflake e a região da conta que contém seus dados de origem. Para encontrá-los, clique no nome da conta na parte inferior à esquerda do seu console do Snowflake:
ACCOUNTADMIN > Conta > passe o mouse sobre a conta correspondente > Copiar identificador da conta. Consulte a documentação do Snowflake para obter mais detalhes.
Importante!
Busque o ID com a etiqueta Locator. Não é o mesmo ID usado para criar conexões de saída do Snowflake.
Amazon S3 e GCS: Na caixa de diálogo Nova conexão, insira o nome do bucket que você criou para uso exclusivo do Data Clean Room (DCR) da AppsFlyer.
Salesforce Cloud/CRM: Veja como configurar uma conexão com o Salesforce.
Conexão de arquivo local
As conexões de arquivos locais permitem que você carregue arquivos de dados do seu computador para a DCP. Essa opção costuma ser usada apenas para testes e não é recomendada para uma ingestão de dados contínua ou em grande escala.
Configurar uma conexão de arquivo local
Uma conexão de arquivo local é usada para testar a plataforma com um arquivo de exemplo. Ela permite que você se familiarize com os recursos da DCP antes de começar a compartilhar dados. Lembre-se: ela não é recomendada para o compartilhamento de dados, tem um período de retenção de dados limitado a 14 dias e não aceita processos de automação.
Uma conexão de arquivo local pode ser configurada durante a criação da fonte.
Criar conexões de armazenamento na nuvem
As conexões de armazenamento na nuvem permitem que você exporte automaticamente suas audiências da DCP para seu bucket do Amazon S3 ou do Google Cloud Storage (GCS) após cada atualização de audiência.
Para criar uma conexão de armazenamento na nuvem:
- Na AppsFlyer, vá para Colaborar > Data Clean Room.
- Clique em Gerenciar conexões no canto superior à direita.
- Acesse a aba Armazenamento na nuvem e clique em + Nova conexão.
- Você verá o modal Nova conexão de armazenamento na nuvem.
- No modal Nova conexão de armazenamento na nuvem, selecione seu provedor de nuvem: Google Cloud Storage ou Amazon Simple Storage.
- Insira o nome do seu bucket:
-
GCS: Insira o nome do bucket do GCS no formato
gs://my-bucket. -
S3: Insira o nome do bucket do S3.
-
GCS: Insira o nome do bucket do GCS no formato
-
Clique em Testar conexão para verificar se a DCP consegue se conectar ao seu bucket.
- Clique em Salvar. A nova conexão aparece em Suas conexões de armazenamento na nuvem na aba Armazenamento na nuvem.
Você também pode criar uma conexão de armazenamento na nuvem a partir do criador de audiências. Veja como criar e ativar audiências para obter as instruções.
Conhecer o caminho de exportação
Cada vez que uma audiência é exportada, a DCP grava essa audiência no seu bucket usando um caminho fixo e previsível:
<bucket>/dcp-output/audiences/<collaboration-id>/t=<audience_name>_<id>/dt=<YYYY-MM-DD>/v=<version>/<file>.csvExemplo de conteúdo da pasta para uma entrega:
s3://af-dcr-example-bucket/dcp-output/audiences/8f3a1c02-44b1-4e9a-9c7d-2b6e1a0f5d3e/t=example_audience_6148a3/dt=2026-07-18/v=1/
├── part-00000-a1b2c3d4-e5f6-47a8-9b0c-1d2e3f4a5b6c-c000.csv
├── part-00001-a1b2c3d4-e5f6-47a8-9b0c-1d2e3f4a5b6c-c000.csv
└── _SUCCESS| Segmento do caminho | O que significa |
|---|---|
| <bucket> | Seu bucket conectado do S3 ou do GCS. |
| dcp-output/audiences/ | Pasta fixa que a DCP cria automaticamente para todas as exportações de audiência. |
| <collaboration-id> | O ID exclusivo da colaboração a que pertence essa audiência. Você pode encontrá-lo no URL de colaboração na DCP. |
| t=<audience_name>_<id> | O nome da audiência (espaços e caracteres especiais substituídos por sublinhados) + um ID exclusivo. Isso garante que uma audiência excluída e recriada com o mesmo nome nunca substitua nem gere conflitos com os arquivos mais antigos. |
| dt=<YYYY-MM-DD> | A data de entrega. |
| v=<version> | Um número de versão para as exportações dessa audiência. Ele aumenta a cada nova entrega. |
| part-NNNNN-<job-id>-c000.csv | Um dos arquivos de saída para a entrega; consulte “Formato do arquivo e divisão” mais abaixo. |
| _SUCCESS | Um arquivo marcador vazio criado quando a exportação termina de gravar todos os arquivos parciais. |
Atenção
Esta estrutura de pastas é criada e gerenciada automaticamente. Não mude o nome nem a estrutura manualmente. Qualquer processo automatizado que leia estes arquivos deve seguir este padrão de caminho e esperar que _SUCCESS apareça antes de processar os arquivos parciais, evitando a leitura de uma entrega incompleta.
Formato de arquivo e divisão
- As audiências são sempre exportadas como arquivos CSV, não compactados, com duas colunas:
value(o identificador) etaxonomy(o tipo de identificador). - Audiências maiores podem ser entregues como vários arquivos em vez de apenas um, numerados como
part-00000,part-00001, etc. Por padrão, cada arquivo contém até aproximadamente 500.000 linhas. - Um único arquivo pode conter uma combinação de tipos de identificador nas mesmas linhas. Filtre usando a coluna
taxonomypara os identificadores necessários. Os valores comuns de taxonomia incluemcustomer_id,mobile_ad_id,hashed_emailehashed_phone_number_without_plus_sha256.
Exemplo:
value,taxonomy
6f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c,customer_id
1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d,mobile_ad_id
b7e2c9a1f4d6e8b0a2c4d6e8f0a1b3c5d7e9f1a3b5c7d9e0f2a4b6c8d0e2f4a6,hashed_email
c1d3e5f7a9b1c3d5e7f9a1b3c5d7e9f1a3b5c7d9e1f3a5b7c9d1e3f5a7b9c1d3,hashed_phone_number_without_plus_sha256Criar conexões com parceiros de mídia
As conexões de saída com parceiros de mídia permitem que você integre suas audiências da DCP a parceiros de mídia compatíveis de maneira segura, ativando campanhas personalizadas nas plataformas deles. Os parceiros de mídia são o principal destino para a ativação de audiências. Saiba como configurar conexões específicas com parceiros de mídia.
Para criar uma conexão com parceiros de mídia:
- Na AppsFlyer, vá para Colaborar > Data Clean Room.
- Clique em Gerenciar conexões no canto superior à direita.
- Acesse a aba Parceiros de mídia e clique em + Nova conexão. Se você já tiver conexões existentes, verá que elas estão listadas em Parceiros de mídia.
- Na caixa de diálogo Nova conexão com parceiros de mídia, selecione o parceiro de mídia correspondente.
- Insira um nome para a conexão.
- Faça login na conta do parceiro de mídia com suas credenciais e siga as instruções para conceder acesso à AppsFlyer.
- Clique em Selecionar ID da conta e selecione a conta correspondente para a conexão.
- Clique em Salvar. A nova conexão é adicionada à lista de parceiros.
Você também pode criar uma conexão com parceiros de mídia a partir do criador de audiências. Veja como criar e ativar audiências para obter as instruções.
Criar conexões de dados e identidade
As conexões de dados e identidade unificam os dados fragmentados dos usuários para melhorar as taxas de correspondência com os parceiros de ativação. Isso permite maximizar as audiências do parceiro e aumentar o impacto das suas campanhas.
ID5
Enriqueça seus dados first-party com identificadores ID5 para unificar os dados fragmentados dos usuários, melhorar as taxas de correspondência com os parceiros de ativação e aumentar o tamanho das audiências do parceiro.