Visão geral: o Data Locker para parceiros (ad networks e agências) fornece dados de aplicativos para o armazenamento do parceiro em AWS, GCS, BigQuery ou Snowflake.
Data Locker para parceiros
O Data Locker para parceiros envia dados de aplicativos para o armazenamento em cloud. Os anunciantes definem permissões que fazem com que a AppsFlyer possa compartilhar dados selecionados com um determinado parceiro.
Recursos do Data Locker
| Recurso | Descrição |
|---|---|
| Opções de armazenamento (nuvem) |
Armazenamento (bucket) de sua propriedade em:
|
| Suporte para vários aplicativos |
Compatível com dados de aplicativos que são integrados com você. O anunciante deve permitir que você acesse cada relatório para que você obtenha os dados. |
| Opções de formato de dados |
|
| Atualização de dados |
A atualização depende do tipo de relatório:
|
Relatórios disponíveis para parceiros
Os relatórios disponíveis e as permissões necessárias para obter os relatórios são diferentes para cada tipo de parceiro. No entanto, o mecanismo do Data Locker, as opções de armazenamento e as configurações necessárias são as mesmas, independentemente do tipo de parceiro. Consulte os artigos por tipo de parceiro abaixo:
Arquitetura de armazenamento de dados
Visão geral
Os dados são registrados na opção de armazenamento selecionada por você. Você pode alternar de uma opção para outra a qualquer momento. A mudança ocorre em poucas horas.
Os dados no armazenamento em bucket na nuvem são organizados em uma estrutura de pastas hierárquica, de acordo com o tipo de relatório, data e hora. A figura a seguir contém um exemplo dessa estrutura:
Os dados de um determinado relatório estão contidos nas pastas de hora (h) associadas a esse relatório.
- O número de pastas de hora varia se o relatório é transmitido por hora ou por dia.
- Os dados são fornecidos em arquivos compactados Snappy ou GZIP, ou arquivos não compactados, com formato Parquet ou CSV.
- Os arquivos de dados consistem em colunas (campos).
- A estrutura da coluna é definida por tipo de relatório.
Estrutura de pastas
| Pasta | Descrição |
|---|---|
| data-locker-hourly |
Exemplos de estrutura de pastas com base no proprietário do bucket e no provedor de nuvem:
|
| t (tópico) | O tipo de relatório está relacionado ao assunto do relatório. |
| dt (data) |
Essa é a data dos dados relacionados. Na maioria dos casos, isso significa a data em que o evento ocorreu. |
| h (hora) |
As pastas h estão relacionadas ao horário em que a AppsFlyer recebeu os dados. Por exemplo, eventos de instalação recebidos entre 14:00-15:00 UTC são transmitidos para o arquivo h=14. Atenção! Há um atraso de cerca de 6 horas entre o momento em que os dados chegam à AppsFlyer até o momento em que a pasta h é transmitida para o Data Locker. Por exemplo, a pasta h=14 é transmitida seis horas depois, às 23:00 UTC. Características da pasta:
|
| Dados unificados |
Os dados de todos os aplicativos são fornecidos em arquivos de dados unificados. Ao carregar os dados, use o campo app_id no nível da linha para distinguir entre aplicativos. Exemplo de arquivos de dados estão na pasta h=2
|
| Sinalização de conclusão |
O último sinalizador de arquivo (conclusão) é definido quando todos os dados de uma determinada pasta h tiverem sido gravados.
|
| Compactar |
Os arquivos são compactados usando o GZ. Depois de descompactar:
|
| Sequência de coluna |
A sequência de campos nos relatórios é sempre a mesma. Novos campos são adicionados à direita dos campos existentes. As definições de coluna (campo) são definidas por relatório. Verifique o artigo do relatório relevante para a descrição. |
| Considerações sobre o preenchimento de campos |
Campos em branco ou vazios: alguns campos são preenchidos com nulo ou estão vazios. Isso significa que, no contexto de um certo relatório, não há dados a reportar. Em geral, nulo significa que esse campo não é preenchido no contexto de um determinado relatório e tipo de aplicativo. "Em branco" significa que o campo é relevante em seu contexto, mas nenhum dado foi encontrado para preenchê-lo. Fuso horário e moeda: As configurações de fuso horário e moeda específicas do aplicativo não afetam os dados gravados no Data Locker. Tais como:
Valores com vírgulas: essas vírgulas estão contidas entre aspas duplas `"`, por exemplo, |
Arquivos de dados
Os arquivos de dados dependem do tipo de segregação.
| Conteúdo | Detalhes | |
|---|---|---|
| Sinalização de conclusão |
O último sinalizador de arquivo (conclusão) é definido quando todos os dados de uma determinada pasta h tiverem sido gravados.
|
|
| Tipos de arquivo |
|
|
| Sequência de colunas (arquivos CSV) |
No caso de arquivos CSV, a sequência de campos nos relatórios é sempre a mesma. Quando adicionamos novos campos, eles são adicionados à direita dos campos existentes. Sobre isso:
|
|
| Considerações sobre o preenchimento de campos |
Campos em branco ou vazios: alguns campos são preenchidos com nulo ou estão vazios. Isso significa que, no contexto de um certo relatório, não há dados a reportar. Em geral, nulo significa que esse campo não é preenchido no contexto de um determinado relatório e tipo de aplicativo. "" em branco significa que o campo é relevante em seu contexto, mas nenhum dado foi encontrado para preenchê-lo. No caso da fonte de mídia restrita, o conteúdo dos campos restritos é definido como nulo. No geral, considere nulo e em branco como a mesma coisa. Não há dados disponíveis. Fuso horário e moeda As configurações de fuso horário e moeda específicas do aplicativo não afetam os dados gravados no Data Locker. O seguinte se aplica:
Valores com vírgulas: essas vírgulas estão contidas entre aspas duplas `"`, por exemplo, |
|
Opções de armazenamento
- Os dados são gravados em um proprietário de armazenamento de sua escolha da seguinte forma: AWS, GCS, BigQuery e Snowflake.
- Você pode alterar a seleção de armazenamento a qualquer momento.
- Se você alterar o armazenamento, acontecerá o seguinte:
- Começamos a registrar no armazenamento recém-selecionado dentro de uma hora.
- Continuamos registrando no armazenamento existente durante um período de transição de 7 dias. O tempo de expiração do período de transição é exibido na interface do usuário. Use o período de transição para atualizar seus processos de carregamento de dados.
- Alterar buckets: se você alterar o armazenamento, os dados serão enviados para ambos por um período de transição de 7 dias, permitindo que você alinhe o processo de consumo de dados.
| Armazenamento de propriedade do anunciante (GCS, AWS, BigQuery, Snowflake) | |
|---|---|
| Nome do repositório |
Exemplo: |
| Proprietário do armazenamento | Parceiro |
| Plataforma de armazenamento | AWS, GCS, BigQuery, Snowflake |
| Credenciais para acessar dados por você | Não conhecido pela AppsFlyer. Use credenciais fornecidas pelo provedor de armazenamento. |
| Retenção de dados | Controlado por você |
| Segurança |
Você controla o armazenamento.
|
Aviso aos agentes de segurança
Considere:
- O repositório ou destino é para o uso exclusivo da AppsFlyer. Não deve haver outra entidade gravando no bucket.
- Você pode excluir dados no bucket 25 horas após gravarmos os dados.
- Os dados que gravamos no destino são uma cópia dos dados que já estão em nossos servidores. Os dados continuam em nossos servidores de acordo com nossa política de retenção.
- Por motivos técnicos, às vezes precisamos excluir e reescrever os dados. Por isso, exigimos a possibilidade de exclusão e uma lista de permissões. Nem a lista nem a exclusão são um risco de segurança para você. No caso da lista, somos a única entidade que está escrevendo para o bucket. No caso de exclusão, podemos gerar os dados novamente.
Princípios de conexões múltiplas (mais de um destino)
No Data Locker você pode enviar alguns ou todos os seus dados para mais de um destino (definido nas configurações de conexão). Por exemplo, você pode enviar dados do App A para a AWS, e dados do App B para GCS.
Cada conexão consiste de um conjunto completo de configurações do Data Locker, incluindo um destino. As configurações de conexão são independentes umas das outras.
Ao administrar suas conexões:
- Nas configurações do Data Locker, as conexões são mostradas em abas. Cada conexão tem sua própria aba de configurações a partir da qual você pode gerenciá-la. A aba padrão é "Data Locker".
- Para criar uma nova conexão:
- Clique em Adicionar conexão.
- Forneça um nome para a conexão e escolha o tipo de armazenamento.
- Clique em Salvar.
Feito isso, a conexão é exibida ao lado da aba padrão "Data Locker". O ícone de cada aba representa o tipo de armazenamento.
- Para ver os detalhes da conexão, duplicar uma conexão, ou excluir uma conexão, clique em ⋮ (opções).
Procedimentos
Configure o Data Locker
Faça esse procedimento para configurar o Data Locker. As mudanças nas configurações entram em vigor dentro de 3 horas.
Pré-requisito:
Complete um ou mais dos seguintes procedimentos de armazenamento:
Para configurar o Data Locker:
- Faça login no dashboard da AppsFlyer.
- Os parceiros de marketing devem clicar aqui, pular a etapa 3 e continuar com a etapa 4.
- Vá para Integração > Data Locker.
- Siga as etapas 3 a 16 das instruções de configuração do Data Locker.
Informações adicionais
Características e Limitações
| Característica | Observações |
|---|---|
| Fuso horário específico do aplicativo | Não aplicável |
| Moeda específica do aplicativo | Não suportado |
| Limitações de tamanho | Não aplicável |
| Atualização de dados | Os dados são atualizados de acordo com a atualização específica dos dados do relatório, detalhada neste artigo. |
| Dados históricos |
Não suportado |
| Acesso de membro da equipe | Os membros da equipe não podem configurar o Data Locker. |