Data Clean Room — Criação de relatórios de eventos in-app

1. Vá para a aba Relatórios do DCR.
2. Clique no botão + Novo relatório.
3. Selecione Eventos in-app como o tipo de dados de origem e clique em Avançar no canto inferior direito da tela.
4. Insira um nome para o relatório
   • Pode ser qualquer nome que ajude você a identificar o relatório na plataforma DCR.
   • Importante! Certifique-se de que o nome do relatório é diferente de todos os outros relatórios em sua conta ou você não poderá salvá-lo.
   • Requisitos do nome do relatório:
     • Duração: 2-80 caracteres.
     • Caracteres válidos:
       • letras (A-Z, a-z)
       • números (0-9), não pode ser o primeiro caractere de um nome
       • um hífen (-), não pode ser o primeiro caractere de um nome
     • Caracteres inválidos:
       • espaços
       • todos os outros símbolos ou caracteres especiais

Especifique os dados de origem a serem usados para o relatório:

Fontes de eventos in-app

• Aplicativos Selecione um ou mais dos aplicativos em sua conta da AppsFlyer.
• Período de tempo: Selecione o número de dias de dados históricos que você deseja que o DCR pesquise eventos in-app (de 1 a 30 dias).
• Eventos: Selecione um ou mais eventos no aplicativo para incluir no relatório.
  • Os eventos disponíveis incluem todos os eventos in-app dos aplicativos selecionados que foram configurados para reportar dados à AppsFlyer por meio do SDK ou da API server-to-server (S2S).
• Tipos de fonte: Selecione um ou mais tipos de dados de eventos in-app:

  Instalações	Eventos in-app relacionados às atribuições de instalação Uma instalação é registrada quando um usuário faz o download, instala e inicializa um aplicativo móvel.
  Reengajamentos	Eventos in-app relacionados a reengajamentos Um reengajamento é registrado quando um usuário inativo de um aplicativo específico engaja com com uma campanha de retargeting para o aplicativo e, posteriormente, a lança.
  Reatribuições	Eventos in-app relacionados a reatribuições Uma reatribuição é registrada quando um ex-usuário de um aplicativo específico (que o desinstalou) engaja com uma campanha de retargeting para o aplicativo e, posteriormente, o reinstala.

Fontes de dados

1. [Opcional] Adicione outras fontes para usar no relatório. Ao escolher entre mais fontes, observe a diferença significativa entre os relatórios que usam e que não usam fontes personalizadas.
   • Um relatório que não usa fontes personalizadas extrai parâmetros e valores específicos do evento dos dados brutos dos eventos in-app.
   • Um relatório que usa fontes personalizadas extrai parâmetros e valores de eventos específicos dos dados brutos do evento no aplicativo e, em seguida, combina esses dados com dados de nível de usuário de suas fontes personalizadas (como dados de seus sistemas de BI ou CRM).
2. Conclua as próximas etapas com base no fato de seu relatório usar ou não fontes personalizadas:
   • Se seu relatório não usar fontes personalizadas, vá para Selecionar dimensões e continue com as etapas em todas as guias restantes.
   • Se seu relatório usar fontes personalizadas, continue com as etapas na aba Unir fontes (imediatamente a seguir) e em todas as abas restantes.

Para combinar os dados entre as fontes, cada uma das fontes personalizadas usadas no relatório deve incluir um identificador mapeado para um identificador de chave nos dados do evento in-app.

• Os relatórios de eventos in-app incluem todos os eventos selecionados que correspondem ao identificador da chave durante o período selecionado.

O que é um identificador de chave?

Você pode mapear para qualquer um desses identificadores de dados de eventos no aplicativo como identificadores-chave:

• ID da AppsFlyer (af_id): Identificador de aplicativo exclusivo gerado pela AppsFlyer na instalação.-
  • O ID aparece em todos os eventos registrados pela AppsFlyer.
  • Um novo ID da AppsFlyer é gerado se um aplicativo for excluído e depois reinstalado.
• customer_user_id (CUID) Um identificador de usuário exclusivo geralmente gerado e definido pelo proprietário do aplicativo no momento do registro do usuário.
  • O uso do CUID para mapear dados exige que seu aplicativo esteja configurado para enviar o CUID à AppsFlyer por meio do SDK ou da API de servidor para servidor (S2S).

Esquemas de mapeamento (direto/indireto)

Se o relatório incluir mais de uma fonte personalizada, somente uma delas precisará ser mapeada diretamente para um identificador de chave de evento no aplicativo. Outras fontes personalizadas podem ser mapeadas direta ou indiretamente, conforme ilustrado no exemplo a seguir:

Lembre-se de que os dados no nível de usuário não podem ser reportados pelo DCR. Em vez disso, ele fornece os insights de que você precisa para tomar decisões agregando (ou agrupando) os dados pelas dimensões que você escolher.

Uma dimensão geralmente é um atributo pelo qual você categoriza os usuários do aplicativo (por exemplo, localização geográfica, data de instalação, campanha etc.)

Extraindo dimensões de event_value

Quando eventos in-app são reportados à AppsFlyer por meio do SDK ou da API S2S, muitos dos dados brutos estão contidos em um único campo chamado event_value. Esse campo de dados estruturados inclui todos os parâmetros específicos de eventos in-app que foram configurados para os eventos que seus aplicativos enviam à AppsFlyer.

Uma das principais vantagens dos relatórios de eventos in-app é que eles permitem que você extraia parâmetros específicos e seus valores do campo event_value para os eventos que você escolher.

Para extrair dimensões do campo event_value para uso em relatórios DCR:

1. Na lista Dimensões das fontes, clique no botão .

   A janela Extrair campo do event_value é aberta.

2. Na caixa Campo Relatório, insira o nome da dimensão extraída conforme você deseja que ela apareça em seu relatório.
3. Na lista de parâmetros Event_value selecione o parâmetro de evento in-app que deve ser mapeado por padrão para o campo do relatório (dimensão) que você definiu na etapa 2.
   • Os parâmetros disponíveis incluem aqueles que foram configurados nos eventos in-app selecionados nos aplicativos selecionados.
4. Pode ser que o mapeamento padrão seja diferente por aplicativo e/ou evento. Se for esse o caso:
   1. Clique no botão Adicionar exceção
   2. Selecione o aplicativo e o evento para os quais o campo do relatório deve ser mapeado de forma diferente.
   3. Selecione o parâmetro de evento in-app que deve ser mapeado no campo do relatório para essa combinação de aplicativo/evento.
   4. Siga estas etapas para quantas exceções você quiser configurar.
5. Quando terminar de configurar o mapeamento para a dimensão extraída, clique em Salvar e adicionar outra para extrair outra dimensão do campo event_value ou em Salvar para retornar à tela principal.

Para editar as dimensões extraídas:

1. Na lista Dimensões das fontes ou na lista de dimensões do relatório, passe o mouse sobre o nome da dimensão que você deseja editar.
2. Clique no botão que é exibido à direita da dimensão.
3. Selecione Editar campo extraído.
4. Faça alterações no nome do Campo Relatório e/ou no mapeamento de parâmetros conforme necessário.
5. Clique em Salvar para salvar suas alterações.

Para excluir as dimensões extraídas:

1. Na lista Dimensões das fontes ou na lista de dimensões do relatório, passe o mouse sobre o nome da dimensão que você deseja excluir.
2. Clique no botão que é exibido à direita da dimensão.
3. Selecione Excluir campo.
   • Atenção! Se você excluir um campo extraído da lista Dimensões do relatório, ele excluirá a definição do campo extraído. Se você quiser remover o campo do relatório enquanto preserva sua definição, selecione o campo e, em vez disso, use o botão Remover.

Selecionando dimensões do relatório

As dimensões do relatório de eventos in-app podem incluir:

• Dimensões que você extraiu do event_value
• Dimensões padrão de eventos in-app
• Qualquer campo nas fontes personalizadas do relatório que tenha sido categorizado como uma dimensão (se aplicável)

Para selecionar as dimensões a serem incluídas em seu relatório:

1. Selecione uma ou mais dimensões na lista Dimensões das fontes à esquerda e use o botão Adicionar no meio da tela para adicioná-las à lista Dimensões do relatório.
   • Você pode usar a barra de pesquisa para pesquisar dimensões nas listas.
2. Para remover uma dimensão, selecione-a na lista Dimensões do relatório e use o botão Remover para retorná-la à lista Dimensões das fontes.
3. Repita este processo até que você tenha adicionado cada dimensão que deseja incluir nos relatórios do DCR.

Observação: Por padrão, todos os relatórios são agrupados pela dimensão de evento in-app media_source. Se você não quiser usar essa dimensão em seu relatório, você pode removê-la da lista Dimensões do relatório.

[Opcional] Personalizando nomes de exibição de dimensões

Por padrão, os nomes das dimensões são exibidos em seu relatório exatamente como são nomeados nos dados de eventos in-app ou em suas fontes personalizadas. Se desejar, você pode personalizar os nomes das dimensões do seu relatório.

Para personalizar os nomes de exibição da dimensão:

1. Na lista Dimensões do relatório, passe o mouse sobre o nome da dimensão que você deseja editar.
2. Clique no botão de edição que é exibido à direita da dimensão.
3. Altere o nome para o nome de exibição da dimensão a ser usado em seu relatório (até 50 caracteres).
4. Clique em OK para salvar o nome de exibição ou em X para cancelá-lo.

Observação: Se você quiser alterar o nome de uma dimensão extraída, use as etapas para editar as dimensões extraídas (acima).

Preservando a privacidade ao agrupar por dimensão (reagrupamento)

Dependendo do tamanho do seu conjunto de dados, do número de dimensões que você escolher e de outros fatores, é possível que um relatório inclua um ou mais grupos contendo poucos usuários para permitir a geração de relatórios. Se os dados fossem relatados dessa forma, isso violaria as restrições ao fornecimento de dados em nível de usuário.

No entanto, em vez de remover ou ocultar completamente os dados do relatório, o DCR usa um mecanismo de reagrupamento para fornecer o máximo de detalhes possível, mantendo a privacidade do usuário.

[Opcional] Gerenciando a prioridade da dimensão

Por padrão, as dimensões de eventos in-app são eliminadas na ordem inversa da ordem em que aparecem na lista Dimensões do relatório. No entanto, você pode modificar a sequência padrão e/ou aplicar o reagrupamento às dimensões de origem personalizadas selecionadas (se aplicável) para preservar as dimensões mais importantes para você.

Para alterar a ordem na qual as dimensões são eliminadas:

1. Clique no botão Gerenciar prioridade da dimensão.
2. Selecione uma dimensão e arraste-a até a posição desejada na lista (ou use os botões de seta à direita para movê-la).
   • A dimensão rotulada como Prioridade mais alta (no topo da lista) significa que ela é a última a ser eliminada se o reagrupamento for necessário.
3. [Opcional] Para aplicar o reagrupamento às dimensões de origem personalizadas (para relatórios usando fontes personalizadas):
   1. Clique em Usar opções avançadas para refinar o reagrupamento
   2. Selecione dimensões de origem personalizadas às quais você gostaria de aplicar o reagrupamento.
   3. As dimensões selecionadas são adicionadas à lista Gerenciar prioridades de dimensões.
      • Por padrão, essas dimensões são adicionadas ao final da lista, como Menor prioridade para reagrupamento. No entanto, você pode reordená-las da mesma forma que as dimensões de eventos in-app, conforme descrito acima.
4. Clique em OK para salvar suas alterações.
   • A lista Dimensões do relatório na tela principal permanece em sua ordem original, mas a ordem revisada foi salva. (Clique novamente no botão Gerenciar prioridade da dimensão se quiser revisar ou editar sua seleção.)

As métricas são os dados numéricos que você coletou com relação a um usuário do aplicativo (exemplos podem incluir receita, número de aberturas de aplicativos, LTV etc.) e podem ser qualquer campo de dados numéricos de suas fontes que você categorizou como métrica.

Extraindo métricas de event_value

Assim como você pode fazer com as dimensões do relatório, você pode extrair parâmetros de eventos no aplicativo do campo event_value para usar como métricas em seus relatórios.

Para extrair dimensões do campo event_value para uso em relatórios DCR:

1. Na lista Métricas de fontes, clique no botão .

   A janela Extrair campo do event_value é aberta.

2. Na caixa dCampo Relatório, insira o nome da métrica extraída conforme você gostaria que ela aparecesse em seu relatório.
3. Na lista de parâmetros Event_value selecione o parâmetro de evento in-app que deve ser mapeado por padrão para o campo do relatório (métrica) que você definiu na etapa 2.
   • Os parâmetros disponíveis incluem aqueles que foram configurados nos eventos in-app selecionados nos aplicativos selecionados.
4. Pode ser que o mapeamento padrão seja diferente por aplicativo e/ou evento. Se for esse o caso:
   1. Clique no botão Adicionar exceção
   2. Selecione o aplicativo e o evento para os quais o campo do relatório deve ser mapeado de forma diferente.
   3. Selecione o parâmetro de evento in-app que deve ser mapeado no campo do relatório para essa combinação de aplicativo/evento.
   4. Siga estas etapas para quantas exceções você quiser configurar.
5. Quando terminar de configurar o mapeamento para a métrica extraída, clique em Salvar e adicionar outra para extrair outra métrica do campo event_value ou em Salvar para retornar à tela principal.

Para editar as métricas extraídas:

1. Na lista Métricas das fontes ou na lista Métricas do relatório, passe o mouse sobre o nome da métrica que você deseja editar.
2. Clique no botão que é exibido à direita da métrica.
3. Selecione Editar campo extraído.
4. Faça alterações no nome do Campo Relatório e/ou no mapeamento de parâmetros conforme necessário.
5. Clique em Salvar para salvar suas alterações.

Para excluir métricas extraídas:

1. Na lista Métricas das fontes ou na lista Métricas do relatório, passe o mouse sobre o nome da métrica que você deseja excluir.
2. Clique no botão que é exibido à direita da métrica.
3. Selecione Excluir campo.
   • Atenção! Se você excluir um campo extraído da lista Métricas do relatório, ele excluirá a definição do campo extraído. Se você quiser remover o campo do relatório enquanto preserva sua definição, selecione o campo e, em vez disso, use o botão Remover.

Selecione as métricas do relatório

Para selecionar as métricas a serem incluídas em seu relatório:

1. Selecione uma ou mais métricas na lista Métricas das fontes à esquerda e use o botão Adicionar no meio da tela para adicioná-las à lista Métricas do relatório.
   • Você pode usar a barra de busca para pesquisar as métricas das listas.
2. Para cada métrica na lista de Métricas do relatório, selecione se você deseja que os dados sejam relatados da seguinte forma:
   • uma soma de valores numéricos; ou
   • uma contagem de valores distintos
3. Para remover uma métrica, selecione-a na lista Dimensões da métrica e use o botão Remover para retorná-la à lista Métricas das fontes.
4. Repita este processo até que você tenha adicionado cada métrica que deseja incluir no relatório.

[Opcional] Personalizando nomes de exibição de métricas

Por padrão, os nomes das métricas são exibidos em seu relatório exatamente como são nomeados nos dados de eventos in-app ou em suas fontes personalizadas. Se desejar, você pode personalizar os nomes das métricas para seu relatório.

Para personalizar nomes de exibição de métricas:

1. Na lista Dimensões da métrica, passe o mouse sobre o nome da métrica que você deseja editar.
2. Clique no botão de edição que é exibido à direita da métrica.
3. Altere o nome para o nome de exibição da métrica a ser usado em seu relatório (até 50 caracteres).
4. Clique em OK para salvar o nome de exibição ou em X para cancelá-lo.

Observação: Se você quiser alterar o nome de uma métrica extraída, use as etapas para editar as métricas extraídas (acima).

[Opcional] Selecione identificadores para contar

Por padrão, cada linha do relatório termina com uma coluna contendo uma contagem dos IDs distintos da AppsFlyer agrupados nos dados dessa linha.

Se você quiser adicionar colunas para as contagens distintas de outros identificadores de suas fontes, faça o seguinte:

1. Selecione um ou mais identificadores na lista Identificadores das fontes à esquerda e use o botão Adicionar no meio da tela para adicioná-las à lista Identificadores de contagem distinta.
   • Você pode usar a barra de busca para pesquisar os identificadores nas listas.
2. Para remover um identificador, selecione-o na lista Identificadores de contagem distinta e use o botão Remover para retorná-lo à lista Identificadores de fontes.
3. Repita este processo até que você tenha adicionado cada identificador que você quer que seja contado no relatório.

Cronograma (somente para relatórios sem fontes personalizadas)

Os relatórios sem fontes personalizadas são executados de acordo com o cronograma definido por você.

Para definir o cronograma do relatório:

1. Selecione se deseja executar o relatório diariamente ou em um ou mais dias por semana.
2. Selecione a hora em que o relatório será executado (o fuso horário é UTC).

Destino do relatório:

O DCR entrega relatórios para seus serviços de nuvem selecionados usando o Data Locker da AppsFlyer. Portanto, especificar o destino do relatório envolve selecionar ou criar uma conexão com o Data Locker.

• Observação: para receber relatórios do DCR não é necessário uma assinatura premium do Data Locker. Se você estiver interessado em receber outros relatórios da AppsFlyer por meio do Data Locker, entre em contato com seu CSM ou envie um e-mail para hello@appsflyer.com.

Para definir o destino do relatório e salvá-lo:

1. Selecione na lista de conexões do Data Locker disponíveis em sua conta da AppsFlyer.
   • Se não houver conexões definidas em sua conta:
     • Uma nova guia será aberta em seu navegador (mostrando a página do Data Locker da AppsFlyer)
     • Um diálogo de Nova conexão abrirá. Siga estas instruções para criar a conexão.
   • Se você tiver conexões existentes, mas quiser usar uma nova, clique no botão :
     • Uma nova aba será aberta em seu navegador (mostrando a página do Data Locker da AppsFlyer)
     • Um diálogo de Nova conexão abrirá. Siga estas instruções para criar a conexão.
   • Depois de criar a conexão, retorne à aba DCR em seu navegador e selecione a conexão recém-criada na lista de conexões do Data Locker.
2. Clique em Salvar para salvar o relatório.
3. O novo relatório agora é exibido na aba Relatórios da aba Data Clean Room.

Além das dimensões extraídas de event_value e das dimensões de suas fontes personalizadas (se aplicável), as seguintes dimensões de eventos in-app podem ser usadas para agrupar relatórios:

• media_source (incluído como uma dimensão de relatório por padrão)
• anúncio
• ad_id
• ad_type
• adset_id
• adset_name
• app_id
• app_version
• attributed_touch_type
• Marca
• campanha
• campaign_id
• channel
• cidade
• conversion_type
• country
• device_type
• dma
• engagement_type
• event_name
• event_revenue_currency
• geo_region
• is_attributed
• keywords
• match_type
• Modelo
• parceiro
• platform
• site_id

Além das métricas extraídas do event_value e das métricas de suas fontes personalizadas (se aplicável), as seguintes métricas de eventos in-app podem ser incluídas nos relatórios:

• event_revenue
• event_revenue_u_s_d