Visão geral: Data Locker para parceiros (ad networks e agências) fornece dados do aplicativo para o armazenamento do parceiro no AWS ou GCS.
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:
- Ad Networks
- Agências
- [Em breve] Parceiros de marketing
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.
No armazenamento, os dados são organizados em uma estrutura hierárquica de pastas, ilustrada na figura abaixo, de acordo com o tipo de relatório, data e hora.
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 arquivos de dados consistem em arquivos compactados GZ contendo arquivos 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
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 registrados em um proprietário de armazenamento de sua escolha: AWS ou GCS
- 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 (AWS) | |
---|---|
Nome do repositório |
Exemplo: |
Proprietário do armazenamento | Parceiro |
Plataforma de armazenamento | AWS ou GCS |
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 bucket é 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 bucket 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.
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 dos seguintes procedimentos de armazenamento:
Para configurar o Data Locker:
- Faça login no dashboard da AppsFlyer.
- Selecione um aplicativo.
- Vá para Integração > Data Locker.
- Escolha o método de integração. Siga um dos procedimentos abaixo:
- Selecione Seu bucket AWS.
- Insira o nome do seu AWS bucket. Não insira o prefixo af-datalocker-
- Clique em Testar.
- Verifique se nenhuma mensagem de erro é exibida indicando que o caminho do bucket é inválido.
- Selecione Seu bucket GCS, insira o nome do seu bucket GCS e, finalmente, clique em testar.
- Selecione Seu bucket AWS.
- Selecione o formato do arquivo:
- [Padrão] Parquet.
- CSV.
- Clique em Aplicar.
- Selecione um ou mais tipos de relatório.
- Clique em Aplicar.
- Clique em Salvar configuração.
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. |