Planeje a integração do SDK

Antes de começar a integrar o SDK da Singular, a equipe de marketing/negócios deve responder às seguintes perguntas. Isso permite que a equipe de desenvolvimento saiba quais recursos e funcionalidades do SDK devem ser ativados.

Esse aplicativo é direcionado explicitamente para crianças?

Os aplicativos para crianças devem estar em conformidade com as políticas da Play Store e da App Store para proteger a privacidade das crianças. Recomendamos o uso dos SDKs de aplicativos para crianças da Singular, que o ajudam a cumprir essas políticas ao não capturar identificadores de dispositivos.

O aplicativo lidará com deep links?

Siga as instruções em Pré-requisitos do Singular Linkse, em seguida, implemente um manipulador de links profundos em seu código, conforme explicado no guia do SDK relevante.

O aplicativo rastreará os eventos do usuário?

O Singular pode coletar dados sobre eventos in-app para ajudar a analisar o desempenho de suas campanhas e medir KPIs. Por exemplo, sua organização pode querer coletar dados sobre logins de usuários, registros, conclusões de tutoriais ou aumento de nível em um aplicativo de jogos.

Eventos padrão

A Singular oferece suporte a uma variedade de eventos padrão, que são comumente usados pelas redes de anúncios para geração de relatórios e otimização. Outra vantagem é que, quando você usa nomes de eventos padrão, o Singular os reconhece automaticamente e os adiciona à lista de eventos sem que você precise defini-los manualmente. Recomendamos o uso de eventos padrão sempre que possível.

Para cada evento padrão, você deve passar os atributos padrão recomendados. Por exemplo, para um evento sng_content_view(o cliente visualiza um produto), você deve passar os atributos sng_attr_content_type, sng_attr_content_id e sng_attr_content.

A lista de eventos enviados à Singular (com os respectivos atributos) deve ser compilada pela equipe de UA/marketing/negócioscom base nos seus KPIs de marketing. Os guias a seguir são úteis na criação de uma estratégia de eventos:

• Como rastrear eventos no aplicativo
• Eventos padrão singulares: Lista completa e eventos recomendados por vertical

Eventos personalizados

Se quiser medir eventos que não correspondam a nenhum dos eventos padrão da Singular, você pode definir seus próprios eventos personalizados com nomes personalizados.

A equipe de desenvolvimento pode usar qualquer nome personalizado (máximo de 32 caracteres). Recomendamos o uso de nomes em inglês para compatibilidade com quaisquer parceiros de rede de anúncios que possam receber o evento da Singular para fins de otimização.

(iOS) O aplicativo implementará SKAdNetwork?

Você pode usar os métodos do SDK para ativar o SKAN no modo gerenciado (em que o valor da conversão é atualizado pela Singular) ou no modo manual (em que você mesmo atualiza o valor da conversão).

(iOS) O aplicativo solicitará ao usuário permissão para compartilhar informações de rastreamento (ATT)?

Recomendamos a exibição do prompt ATT porque, se o usuário optar por compartilhar a ID do dispositivo, isso ajudará a atribuir a instalação corretamente.

Se você exibir o prompt ATT, deverá configurar o SDK para atrasar a inicialização do Singular em seu aplicativo até que o usuário responda.

Registrar um aplicativo de desenvolvimento/teste

Identificador do pacote de aplicativos

A mesma chave SDK e a mesma chave secreta são usadas para aplicativos de produção e de teste. Uma vez que os dados de teste/produção tenham sido salvos no Singular, eles não poderão ser excluídos.

Com isso em mente, recomendamos o uso de um identificador de pacote diferente para seu aplicativo de teste para manter os dados separados do eventual aplicativo de produção.

Por exemplo, se o seu aplicativo de produção usar o identificador de pacote com.myapp, você poderá usar com.myapp.dev para o estágio de desenvolvimento. Em seguida, você pode alterar o ID do pacote de volta para a versão de produção antes de lançar seu aplicativo nas lojas de aplicativos.

Etapas para registrar um aplicativo

1. Na plataforma Singular, vá para Configurações > Aplicativose clique em Adicionar novo aplicativo.
2. Digite um nome de aplicativo para o aplicativo de desenvolvimento. Recomendamos usar a ID do pacote.
3. Selecione o sistema operacional correspondente à plataforma do aplicativo.
4. Identifique o aplicativo usando a opção Bundle ID e insira a versão de desenvolvimento de seu Bundle Identifier. Salve o aplicativo.
5. Para aplicativos iOS: depois de salvar o aplicativo, clique na seta ao lado do nome do aplicativo para exibir os detalhes do aplicativo e alterne a opção Mostrar configurações avançadas. Adicione seu TeamID e seu esquema. Isso é necessário para links universais e links diretos.
   

Depois de concluir o desenvolvimento e o teste do aplicativo, atualize o ID do pacote para a versão de produção e permita que a equipe de marketing adicione o aplicativo de produçãocom base nas instruções das Perguntas frequentes sobre configuração de aplicativos.

Crie um domínio de link (se você ainda não tiver um)

Os links singulares (links de rastreamento singulares) têm a seguinte estrutura, em que [SUBDOMAIN] é escolhido por você:

https://[SUBDOMAIN].sng.link/[PARAMETERS]

Por exemplo, para uma campanha que comercializa um aplicativo chamado Jewel Rush, você pode criar o domínio "jewelrush.sng.link". Em seguida, você pode usá-lo para criar links de rastreamento com a seguinte estrutura:

https://jewelrush.sng.link/[PARAMETERS]

Você pode usar um único domínio para todos os seus links ou pode criar vários para usar com finalidades diferentes. De qualquer forma, é necessário pelo menos um domínio para que você possa usar o Singular Tracking Links.

A equipe de marketing da organização deve estar envolvida na decisão sobre um domínio de link, pois ele será exposto em campanhas de marketing.

Ao integrar o Singular SDK em aplicativos iOS, você deve adicionar o domínio do link nas Configurações de Domínio Associado do Xcode na forma de:

applinks:[DOMAIN].sng.link

Consulte também: Singular Links Pré-requisitos.

Saiba como testar sua integração

Ao integrar o SDK/S2S da Singular em seu aplicativo, é importante garantir que ele funcione corretamente antes de lançar a nova versão do aplicativo.

A Singular oferece uma seleção de ferramentas para testar sua integração:

Teste durante a implementação:

• Use o Console de teste, que permite testar manualmente os diferentes recursos que você implementa, à medida que os implementa em tempo real.
• Ou use uma ferramenta de terceiros, como o Charles Proxy, com o proxy SSL ativado para verificar se os dados da Singular são acionados no momento correto com os pontos de dados corretos.

Testes após a implementação:

• Execute umrelatórioSDKauditpara identificar automaticamente quaisquer problemas em sua integração e recomendar soluções testadas e comprovadas.
• Faça o download dos dados no nível do usuário usando a página Export Logs.O arquivo CSV mostra todos os dados enviados do seu aplicativo com sucesso para a Singular. Observe que leva aproximadamente 30 minutos para que os dados estejam disponíveis nessa ferramenta.
• Teste seus deep linksseguindo as instruções em Como testar sua integração com o SDK da Singular.
• Use a API Attribution Details para consultar os detalhes do dispositivo após o teste. Leva aproximadamente de 4 a 6 minutos para que os dados de atribuição estejam disponíveis. Saiba mais.

Para obter mais dicas de teste, consulte Como testar sua integração do SDK da Singular.