Como configurar a mensuração para jogos da Microsoft Store e nativos de PC
Com a solução de mensuração em PC e Console da Adjust, você pode obter insights de atribuição importantes de jogos para Windows e Mac. Uma vez configurada, a Adjust pode gerar relatórios sobre o desempenho de seus anúncios na geração de instalações, sessões e eventos in-app personalizados de jogos para Windows e Mac. Você também pode usar coortes para analisar dados específicos de atribuição, por exemplo, como os usuários progridem em diferentes níveis durante um período definido.
Este guia orienta você no processo de configuração de um novo aplicativo de gaming, no estabelecimento de uma conexão segura de API de servidor a servidor (S2S) e no gerenciamento eficaz de links para uma mensuração de atribuição bem-sucedida.
Aqui está o que você deve fazer para configurar a mensuração em jogos de PC nativos:
- Configure um novo app no AppView.
- Configure a API S2S para começar a registrar as sessões.
- Configure links no Campaign Lab.
Configure seu app de PC
Para começar a adicionar e configurar seu aplicativo de PC, siga esses passos:
Em AppView , selecione Todos os apps .
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:
Selecione Adicionar app.
Selecione Adicionar plataforma para conectar uma plataforma ao seu jogo.
Selecione PC > Windows.
Conecte-se a plataforma usando uma das duas opções:
- Se o seu jogo está na Microsoft Store, selecione Microsoft Store e insira seu ID do app ou selecione Não tenho um ID do app ainda para inseri-lo depois.
- Se o seu jogo está em uma loja personalizada, seja para Windows ou Mac, selecione Nativo de PC, habilite a opção Redirecionar todos os cliques a uma URL personalizada e insira a URL.
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 de Eventos , adicione um nome de evento in-app para mensurar as atividades do usuário 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 para o 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 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 de servidor para servidor: 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 codificado |
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.