Como configurar a mensuração para jogos da Steam
Este guia orienta você no processo de configuração de um aplicativo de gaming da Steam, 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. Seus usuários podem baixar seus jogos usando a loja da Steam ou sua loja personalizada no Windows e Mac.
Aqui está o que você deve fazer para configurar a mensuração em jogos da Steam:
- 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 Steam
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 do Google aqui.
Selecione Adicionar app.
Selecione Adicionar plataforma para conectar uma plataforma ao seu jogo.
- Selecione PC > Steam. Disponível para as lojas da Steam 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 Steam. É o que recomendamos caso o seu app não tenha um ID.
- Selecione Salvar.
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 app:
|
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 |
Você pode passar o steam_id do usuário para a Adjust usando o parâmetro external_device_id.
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.