Data Locker—para parceiros

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.

6133DataLockerForPartners.png

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:

  • AWS
  • GCS

Sobre opções de armazenamento

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
  • CSV
  • PARQUET
Atualização de dados

A atualização depende do tipo de relatório:

  • Por hora: dados gerados continuamente
  • Por dia: alguns relatórios são preparados diariamente e ficam prontos no dia seguinte

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. 

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.

DLFolderOVerview.png

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

DLHourly.png

  • A pasta de nível superior no bucket depende do provedor do armazenamento.
  • A pasta data-locker-hourly contém os tópicos do relatório. 

 Exemplos de estrutura de pastas com base no proprietário do bucket e no provedor de nuvem:

  • Seu repositório AWS: <af-datalocker-your bucket prefix>/<generated-home-folder><subscription-id>
  • Seu repositório GCS: <your bucket name>/<generated-home-folder>/<subscription-id>
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:

  • Existem 24 pastas h enumeradas de 0 a 23. Por exemplo, h=0, h=1 e assim por diante. 
  • Além disso, a pasta "late" contém eventos do dia anterior que chegaram depois da meia-noite (em outras palavras, eventos que chegam entre 00:00 - 02:00 UTC do dia seguinte). Por exemplo, se um usuário instalar um aplicativo na segunda-feira às 08:00 e o evento chegar na terça-feira às 01:00, o evento será registrado na pasta "late" de segunda-feira. 
  • Os dados que chegam depois das 02:00 UTC são gravados na pasta da data e hora reais de chegada. 
  • Você deve usar os dados na pasta "late". Eles não estão contidos em nenhuma outra pasta. 
  • _temporary folder: em alguns casos, geramos uma pasta temporária dentro de uma pasta h. Desconsidere pastas e subpastas temporárias. Exemplo: /t=impressions/dt=2021-04-11/h=18/_temporary.
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

UnifiedByApp.png

  • No processo de carregamento dos dados, certifique-se do seguinte:
    • Você começa a consumir dados somente após o sinalizador _SUCCESS ser configurado.
    • Você carrega todos os arquivos com uma extensão .gz
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. 

  • Não leia dados em uma pasta antes de verificar se o sinalizador _SUCCESS existe.

  • O sinalizador _SUCCESS é definido mesmo nos casos em que não há nenhum dado gravado na pasta, ou seja, em que a pasta fica vazia.

Compactar

Os arquivos são compactados usando o GZ. Depois de descompactar:

  • Os arquivos não têm extensão.
  • Cada arquivo tem uma linha de cabeçalho contendo os nomes da coluna (campo). 
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: 

  • Fuso-horário: dados de data e hora ficam em UTC.
  • Moeda: o campo event_revenue_usd fica em USD.

Valores com vírgulas: essas vírgulas estão contidas entre aspas duplas `"`, por exemplo, `"iPhone6,1"`.

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. 

  • Não leia dados em uma pasta antes de verificar se o sinalizador _SUCCESS existe.

  • O sinalizador _SUCCESS é definido mesmo nos casos em que não há dados para gravar em uma determinada pasta e a pasta está vazia. 

  • Atenção! Na opção segregação por aplicativo, o sinalizador é definido na pasta h e não nas pastas individuais do aplicativo. Consulte as figuras na seção anterior. 
Tipos de arquivo
  • Os arquivos de parte são compactados usando o GZ.
  • Depois de descompactar, os arquivos de dados estarão no formato Parquet ou CSV de acordo com suas configurações.
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: 

  • A estrutura de colunas dos relatórios de jornada do usuário é idêntica. Isso significa que você pode ter procedimentos de carregamento de dados semelhantes para diferentes tipos de relatório. Você seleciona os campos contidos nos relatórios.  O significado do campo é detalhado no dicionário de dados brutos.
  • Os relatórios que têm uma indicação de FF na seção de disponibilidade do relatório não aderem à estrutura de coluna comum. 
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: 

  • Fuso-horário: dados de data e hora estão em UTC.
  • Moeda: o campo event_revenue_usd está em USD.

Valores com vírgulas: essas vírgulas estão contidas entre aspas duplas `"`, por exemplo, `"iPhone6,1"`.

Os arquivos de dados dependem do tipo de segregação

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
  • GCS: sem restrição
  • AWS: definido por você. Deve ter o prefixo af-datalocker-.

Exemplo: af-datalocker-nome-do-seu-bucke

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. 

  • AWS: a AppsFlyer requer permissão GetObject, ListBucket, DeleteObject, PutObject para o bucket. O bucket deve ser dedicado ao uso da AppsFlyer. Não o use para outros fins.
  • GCS

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:

  • Seu bucket AWS.
  • Seu bucket GCS.

AppsFlyerAdmin_us-en.png Para configurar o Data Locker:

  1. Faça login no dashboard da AppsFlyer.
  2. Selecione um aplicativo.
  3. Vá para Integração > Data Locker. 
  4. Escolha o método de integração. Siga um dos procedimentos abaixo:
    • Selecione Seu bucket AWS.
      1. Insira o nome do seu AWS bucket. Não insira o prefixo af-datalocker-
      2. Clique em Testar.
      3. 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.
  5. Selecione o formato do arquivo:
    • [Padrão] Parquet.
    • CSV.
  6. Clique em Aplicar.
  7. Selecione um ou mais tipos de relatório.
  8. Clique em Aplicar
  9. Clique em Salvar configuração.

Informações adicionais

Características e Limitações

Características
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. 

Solução de problemas

Este artigo foi útil?