Configurando referências de usuários

Quando um usuário recomenda a um amigo que baixe e se cadastre no seu aplicativo, você pode enviar a ele uma recompensa in-app.

A configuração de referências de usuários consiste nas seguintes etapas:

1. Crie um link personalizado para o seu programa de referência. Esse link precisará ser colocado atrás do componente de convite em seu aplicativo.
2. Anexe um parâmetro label. Um parâmetro de label servirá para passar um ID de referência exclusivo. Você precisará instruir seu aplicativo a preencher o parâmetro de label com o ID da referência antes de enviar a URL do link ao usuário convidado.
3. Configure a passagem de IDs de referência para seus sistemas. Configure callbacks de atribuição ou de servidor para receber o ID de referência quando um novo usuário baixar e abrir o aplicativo por meio do link de referência. O sistema precisará aplicar a recompensa ao usuário com base no ID de referência recebido.

Antes de começar

Aqui está o que você precisa fazer antes de configurar referências de usuários:

• Se o seu aplicativo for direcionado ao iOS, certifique-se de que a modelagem probabilística esteja habilitada. Isso garante que as referências funcionem em um ambiente web mobile.
• Verifique se o seu sistema está configurado para enviar recompensas aos usuários por meio da geração e aplicação de códigos de referência. Certifique-se de verificar o seguinte:
  • Seu servidor pode gerar um ID de referência quando um usuário seleciona a opção de compartilhamento de convite.
  • Seu servidor pode preencher o placeholder label com o ID de referência.
  • Seu servidor pode processar o valor do placeholder label do callback da Adjust para aplicar uma recompensa à conta que fez a referência, à conta que recebeu a referência ou ambas.

1. Crie um link personalizado para seu programa de referência

1. Siga as instruções em nosso Guia de configuração de link personalizado.
2. Considere habilitar a modelagem probabilística nas configurações de atribuição, o que garantirá a precisão da atribuição em vários posicionamentos.

2. Anexe um parâmetro de rótulo ao link

A Adjust usa o parâmetro label para receber dados personalizados que não estão relacionados aos dados de atribuição. No caso de referências de usuários, você pode usá-lo para identificar os usuários do aplicativo com um ID exclusivo.

Certifique-se de anexar um parâmetro label ao seu link personalizado junto com seus outros parâmetros. Você pode usar um link com marca para melhorar a experiência do usuário.

https://example.go.link?adj_t=abc123&adj_label={user_id}

Se você usar callbacks de servidor para compartilhar seu ID de referência com a Adjust, poderá usar um parâmetro de callback dinâmico.

3. Configure a passagem de IDs de referência para seus sistemas

Quando o usuário convidado baixar e abrir o aplicativo, uma das seguintes situações ocorrerá:

• Callback de atribuição: o SDK da Adjust recebe um callback de atribuição com o parâmetro label preenchido com o ID de referência, que o aplicativo pode coletar.
• Callback de instalação: seu servidor recebe um callback de instalação da Adjust com o ID de referência usando o parâmetro label ou o parâmetro de callback dinâmico.

O sistema precisa aplicar a recompensa ao usuário com base no ID de referência recebido.

Callback de atribuição (recomendado)

Os callbacks de atribuição permitem que você receba um parâmetro label, que contém um ID de referência exclusivo no seu aplicativo, imediatamente após o usuário instalar o aplicativo por meio de um link de referência e ser atribuído ao link de referência personalizado. Siga o guia de callbacks de atribuição para fazer essa configuração no seu app:

• iOS
• Android
• Unity
• React Native
• Flutter

installl callback

Os callbacks de instalação do servidor permitem que você receba um callback com um código de referência para seu servidor de BI. Confira o guia Configuração de callbacks do servidor para mais informações.

Siga estas etapas para configurar callbacks de instalação:

1. Acesse as configurações de callback de servidor a partir do seu cartão do app ou na aba de Gerenciamento de dados nas configurações do seu app.

   • (apenas para permissões de Admin, Editor ou Editor personalizado) Para configurar um callback de servidor a partir do cartão do app, em AppView , selecione Todos os apps . Encontre seu app e selecione Callbacks de servidor .
   • Para configurar um callback de servidor a partir da aba Gerenciamento de dados da sua configuração de apps, em AppView , selecione Todos os aplicativos . Selecione seu app e, em seguida, selecione a aba Gerenciamento de dados .

2. Em Callbacks de servidor , selecione Adicionar callback > Configuração guiada .

3. Na lista Ativador de callback, selecione a atividade “install”.

4. No campo Endpoint do servidor , insira a URL do endpoint do servidor onde você quer receber os dados.

5. (Opcional) Selecione Adicionar uma condição para adicionar uma condição com placeholders e valores. O callback seria acionado apenas se a condição for atendida.

6. Selecione Adicionar um placeholder na seção Placeholders e escolha {install} na lista para incluir dinamicamente os dados do código de referência do usuário em seu callback. Você pode adicionar vários placeholders.

7. Selecione Criar URL de callback para gerar uma URL de callback codificada.

Aqui está um exemplo de URL de callback com parâmetro de label anexado e placeholders recomendados:

https://myendpoint.test/?label={label}&adid={adid}&tracker_name={tracker_name}&gps_adid={gps_adid}&idfa={idfa}&idfv={idfv}&app_name={app_name}&activity_kind={activity_kind}&created_at={created_at}

Relatórios

O Datascape da Adjust fornece relatórios agregados de seu link de referência. O valor do parâmetro label não aparece em nenhum lugar do Datascape e está disponível apenas por meio de callback de atribuição ou na exportação de dados brutos.

Guia de teste

Siga as próximas etapas para testar a configuração de referências de usuários:

1. Coloque o link personalizado gerado com o parâmetro label anexado atrás do componente de convite no seu aplicativo.
2. Selecione o componente de convite e copie o link. Certifique-se de que o parâmetro label esteja preenchido com um código de referência.
3. Cole o link em um mensageiro ou outro ambiente que seu usuário usará para compartilhar esse link.
4. Prepare um dispositivo de teste seguindo a seção Antes de começar no guia do Console de teste.
5. Selecione o link.
6. Verifique os dados do dispositivo no Console de teste seguindo estas instruções.
7. Verifique se você recebeu o parâmetro label nos callbacks de atribuição ou por meio do callback de servidor no seu sistema de BI.
8. Conceda a recompensa com base no código de referência recebido.