Como configurar a mensuração para jogos da Epic Games
Este guia orienta você no processo de configuração de um novo aplicativo da Epic Games, no estabelecimento de uma conexão segura de API de S2S e no gerenciamento eficaz de links para uma mensuração de atribuição bem-sucedida. Seus usuários podem baixar seus jogos usando a loja da Epic Games ou sua loja personalizada no Windows e no Mac.
Aqui está o que você deve fazer para configurar a mensuração em jogos da Epic Games:
- Configure um novo app no AppView.
- Configure a API de S2S da Adjust para começar a registrar as sessões.
- Configure links no Campaign Lab.
Configure seu app da Epic Games
Para começar a adicionar e configurar seu aplicativo de PC, siga estes passos:
Em AppView, selecione Todos os aplicativos.
Selecione Novo aplicativo.
Em Insira as informações do seu app, insira o nome do app, escolha a moeda de relatório e verifique se o seu jogo precisa estar em conformidade com:
- Conformidade com a COPPA. A conformidade com a COPPA aplica-se apenas às empresas nos EUA. Saiba mais sobre a conformidade com a COPPA aqui.
- Regulamento de Mercados Digitais (DMA) no Google. Aplica-se apenas aos aplicativos com uma base de usuários fora do Espaço Econômico Europeu. Saiba mais sobre o DMA no Google aqui.
Selecione Adicionar app.
Selecione Adicionar plataforma para conectar uma plataforma ao seu jogo.
- Selecione PC > Epic Games. Disponível para as lojas da Epic Games para Windows e Mac.
- Insira seu ID do app ou selecione Não tenho um ID do app ainda para inseri-lo depois.
- (Opcional) Ative a função Redirecionar todos os cliques a uma URL personalizada e insira uma URL personalizada se quiser conduzir seus usuários a um site personalizado em vez da loja de apps da Epic. É o que recomendamos se o seu app não tiver um ID.
- Selecione Salvar.
Em Informações do app, você pode personalizar como todos os links para o seu jogo aparecerão ao serem compartilhados em apps de redes sociais.
Na aba Eventos, adicione um nome de evento in-app para mensurar as atividades dos usuários em seu jogo.
Na aba Configurações de atribuição, defina as configurações de atribuição (para matching de dispositivos, modelagem probabilística e atribuição temporária) e de reatribuição.
- Verifique se a modelagem probabilística está habilitada tanto para cliques como para impressões. É altamente recomendável configurar a janela de atribuição da modelagem probabilística para 24 horas, mas você pode escolher configurá-la para até 90 dias. A janela de atribuição de 90 dias está disponível apenas para as plataformas de PC e console.
Na aba Gerenciamento de dados, configure os callbacks de servidor ou uploads no armazenamento em nuvem para receber dados brutos no nível de usuários ou use o Console de teste para ver os dados de dispositivos de teste.
Na aba de Proteção , configure a segurança S2S já que você precisará do token na configuração da API de S2S.
Configurar a API de S2S da Adjust
Use a API S2S da Adjust para conectar seu app à Adjust e começar a mensurar as sessões e eventos dos usuários sem mudar o código do seu app.
Continue com o processo de configuração usando o seguinte endpoint de sessão ou session.
Antes de começar
O servidor da Adjust impõe verificações rigorosas de consistência que impedem o abuso ou a sobrecarga do sistema. A atribuição S2S é uma integração exclusiva que não pode ser usada em conjunto com o SDK da Adjust.
- Certifique-se de ler nossa checklist de atribuição S2S para entender por completo as limitações de usar a configuração S2S em vez de uma integração de SDK.
- Você deve fazer suas solicitações a nossos servidores na mesma ordem sequencial em que ocorreram no dispositivo.
Autenticação
Configure a Segurança S2S para garantir a segurança das suas sessões S2S e se proteger contra requisições falsificadas. Para isso, todas as requisições recebidas precisam carregar um token de autenticação gerado no painel da Adjust. Os pedidos sem o token ou com um token incorreto são rejeitados pelo nosso servidor.
Endpoint
O endpoint session permite que você registre sessões quando os usuários iniciarem seu jogo. Uma sessão é acionada quando um usuário retoma o jogo do segundo plano ou o inicia, por exemplo, abrindo outro aplicativo enquanto mantém o jogo em execução ou iniciando-o após um fechamento anterior. O servidor da Adjust aceita novas sessões a cada 30 minutos para evitar o uso desnecessário de recursos.
https://s2s.adjust.com/sessionCabeçalho do POST
Autorização : ao chamar as APIs da Adjust, envie o valor do seu token de autenticação da Adjust com o tipo de autenticação definido como Bearer.
Exemplo: authentication_token Bearer.
Payload POST
Parâmetros marcados com ***** são obrigatórios.
| Parâmetro | Tipo de dados | Em | Descrição |
|---|---|---|---|
s2s* | String | Consulta | Parâmetro S2S: possibilita que os servidores da Adjust reconheçam a atividade do lado do servidor. Deve ser sempre enviado como 1. |
app_token* | String | Consulta | Token de autenticação único para seu app |
os_name* | String | Consulta | Use um dos parâmetros disponíveis de acordo com o sistema operacional do seu aplicativo:
|
ip_address* | String | Consulta | Endereço IP do dispositivo |
created_at* | Marca temporal | Consulta | Marca temporal do dispositivo local, criação do pacote incluindo o fuso horário. |
external_device_id* | String | Consulta | Exemplo de user_id único: account_id do usuário ou endereço de e-mail criptografado |
Exemplo de requisição
Se quiser aprender como registrar eventos usando a API de S2S, confira Eventos de servidor a servidor (S2S).
Configuração de links
Após ter configurado e testado a integração da API de S2S entre o servidor do seu app e a Adjust, você precisa conectar a Adjust à rede de anúncios que está usando para executar sua campanha.
Com o uso de links, você pode registrar a atribuição quando os usuários interagirem com seu anúncio em outros dispositivos, por exemplo, ao assistir a um anúncio no celular ou na CTV e, em seguida, instalar o jogo no PC. Aqui estão dois exemplos de redes para campanhas web:
No Campaign Lab, siga os passos abaixo.
Em Campaign Lab, selecione Parceiros.
Selecione Novo parceiro.
Na tela Seleção de parceiros, escolha a rede de anúncios que você deseja configurar.
Na tela Seleção de aplicativos, escolha o aplicativo para o qual você deseja criar o link.
(Opcional) Na tela Compartilhamento de dados, configure a integraçāo entre sua rede e a Adjust, depois escolha as opções de compartilhamento.
Na tela Estrutura do link, revise os parâmetros da estrutura padrão para os links oferecida pela rede e atualize os valores, se necessário.
(Opcional) Na tela Destinos do usuário, configure um deep link ou adicione um redirecionamento e fallback ao seu link.
- Se quiser redirecionar usuários a uma loja de jogos em particular, certifique-se de incluir a URL como parâmetro de redirecionamento adicional.
(Opcional) Na tela Configurações de atribuição, defina configurações de atribuição personalizadas para usuários novos e existentes. Essas configurações de atribuição estão disponíveis para cliques e impressões. Se você pular essa etapa, as configurações de atribuição escolhidas durante a configuração do aplicativo serão aplicadas.
- Verifique se a modelagem probabilística está habilitada tanto para cliques como para impressões. É altamente recomendável configurar a janela de atribuição da modelagem probabilística para 24 horas, mas você pode escolher configurá-la para até 90 dias. A janela de atribuição de 90 dias está disponível apenas para as plataformas de PC e console.
Na tela de Revisão da configuração, revise suas escolhas e faça alterações, se necessário.
Selecione Criar link para gerar a URL de clique, a URL de impressão, seu QR Code e seu token de link, bem como para habilitar o compartilhamento de dados, se isso estiver configurado.