A seguir estão as etapas preliminares necessárias para qualquer integração do Singular SDK.
Saiba como planear a sua integração SDK, registar uma aplicação para desenvolvimento, criar um domínio para links de rastreio e planear como testar a sua integração durante e após o desenvolvimento.
| Guia para | Equipas de negócios/marketing |
| 1 |
Planeje sua integração de SDKAntes de começar a integrar o Singular SDK, a equipa de marketing/negócios deve responder às seguintes perguntas. Isto permite à equipa de desenvolvimento saber quais as caraterísticas e funcionalidades do SDK a ativar. Esta aplicação é dirigida explicitamente a crianças?As aplicações para crianças devem estar em conformidade com as políticas da Play Store e da App Store para salvaguardar a privacidade das crianças. Recomendamos a utilização dos SDKs de aplicações para crianças da Singular, que o ajudam a cumprir estas políticas ao não capturar identificadores de dispositivos. O aplicativo lidará com links diretos?Siga as instruções em Pré-requisitos do Singular Links e, em seguida, implemente um manipulador de links profundos em seu código, conforme explicado no guia do SDK relevante. O aplicativo acompanhará 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, a sua organização pode querer recolher dados sobre logins de utilizadores, registos, conclusões de tutoriais ou subida de nível numa aplicação de jogos. Eventos padrão O Singular suporta uma variedade de eventos padrão. Esses eventos comumente usados são frequentemente suportados por redes de anúncios para 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ê tenha que 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 para a Singular (com os atributos que os acompanham) deve ser compilada pela equipa de UA/marketing/negócio com base nos seus KPIs de marketing. Os guias a seguir são úteis na criação de uma estratégia de eventos:
Importante: Ao integrar um SDK Singular na sua aplicação, a sua equipa de programadores poderá ter de utilizar uma versão ligeiramente diferente dos nomes de eventos/atributos (tudo em maiúsculas, sem sublinhados, etc.) com base na plataforma de desenvolvimento. Consulte as listas de nomes de eventos e atributos para iOS, Android, Unity, React e Flutter. Eventos personalizados Se você deseja medir eventos que não correspondem a nenhum dos eventos padrão do Singular, é possível definir seus próprios eventos personalizados com nomes personalizados. A equipa de desenvolvimento pode utilizar 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. Dica: Envie eventos para a Singular apenas se precisar que eles sejam rastreados para fins de marketing. Se um evento não for significativo como um KPI para o desempenho da campanha ou para o valor do utilizador, esse evento não deve ser rastreado pela Singular. (iOS) A aplicação vai 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) A aplicação pedirá ao utilizador permissão para partilhar informações de seguimento (ATT)?Recomendamos a apresentação do pedido ATT porque, se o utilizador optar por partilhar a sua ID de dispositivo, isso ajuda 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. |
| 2 |
Registrar um aplicativo de desenvolvimento/testeIdentificador do pacote de aplicativosA mesma chave SDK e a mesma chave secreta são usadas para aplicativos de produção e teste. Uma vez que os dados de teste/produção tenham sido salvos no Singular, eles não podem 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 usa o identificador de pacote com.myapp, você pode usar com.myapp.dev para o estágio de desenvolvimento. Em seguida, pode alterar a ID do pacote de volta para a versão de produção antes de lançar a sua aplicação nas lojas de aplicações. Etapas para registrar um aplicativo
Depois de concluir o desenvolvimento e o teste do aplicativo, atualize a ID do pacote para a versão de produção e permita que a equipe de marketing adicione o aplicativo de produção com base nas instruções nas Perguntas frequentes sobre configuração de aplicativos. |
| 3 |
Criar 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 si: Por exemplo, para uma campanha que comercializa uma aplicação chamada Jewel Rush, pode criar o domínio "jewelrush.sng.link". Depois, pode utilizá-lo para criar tracking links com a seguinte estrutura: Pode utilizar um único domínio para todas as suas hiperligações ou pode criar vários para utilizar para diferentes fins. Em qualquer caso, é necessário pelo menos um domínio antes de poder utilizar as ligações de seguimento singulares. A equipa de marketing da organização deve estar envolvida na decisão sobre um domínio de ligação, uma vez que este será exposto em campanhas de marketing. Ao integrar o SDK Singular em aplicativos iOS, é necessário adicionar o domínio do link nas Configurações de domínio associado do Xcode na forma de: Veja também: Links Singulares Pré-requisitos. |
| 4 |
Saiba como testar sua integraçãoAo integrar o Singular SDK/S2S em seu aplicativo, é importante certificar-se de que ele funciona corretamente antes de lançar a nova versão do aplicativo. O Singular oferece uma seleção de ferramentas para testar sua integração: Teste durante a implementação:
Testes após a implementação:
Para obter mais dicas de teste, consulte Como testar sua integração do SDK Singular. |