A página App Configuration (Configuração do aplicativo) (Settings > Apps (Configurações > Aplicativos)) é onde você mantém uma lista atualizada de todos os aplicativos que está comercializando. A Singular precisa dessa lista para fornecer relatórios analíticos precisos divididos por aplicativo.
Perguntas frequentes
Solução de problemas
Se você usar o mesmo site de aplicativo para várias plataformas de um aplicativo, o nome do aplicativo será o mesmo nos relatórios e terá as mesmas configurações. É altamente recomendável usar uma ID de pacote diferente para cada site de aplicativo.
No entanto, se você tiver o mesmo site de aplicativo para várias plataformas, poderá distingui-los nos relatórios usando o URL da campanha se usar links de rastreamento diferentes para cada plataforma. Nos dados no nível do usuário, você pode distinguir entre seus aplicativos com o valor app_version.
Se você estiver comercializando um site, loja online, página de destino etc., ainda precisará adicioná-lo na página Apps (Aplicativos):
- Na página Apps (Aplicativos), clique em Add New App (Adicionar novo aplicativo).
- Para a plataforma, selecione "web."
- Insira o URL da página ou o domínio principal do site.
O básico
A página App Configuration (Configuração do aplicativo) é onde você mantém uma lista atualizada de todos os aplicativos que está comercializando. A Singular precisa dessa lista para fornecer relatórios analíticos precisos divididos por aplicativo.
A Singular usa o nome do aplicativo para mapear as estatísticas da sua rede de anúncios para o aplicativo certo para que possamos fornecer suas estatísticas detalhadas por aplicativo.
Se o nome do aplicativo na Singular não corresponder ao nome do aplicativo conforme aparece nos dados da rede de anúncios, a Singular tem outras maneiras de tentar mapear os dados para o aplicativo certo, mas é melhor evitar o problema.
Para obter mais informações, consulte Perguntas frequentes sobre dados não mapeados.
Na terminologia Singular, um aplicativo é um título de aplicativo como os usuários finais o conhecem, como "Google" ou "Instagram".
Um site de aplicativo é uma versão do aplicativo específica para uma plataforma, como iOS ou Android. É chamado de site de aplicativos porque (quando é lançado) tem um URL na loja de aplicativos da plataforma.
Um aplicativo geralmente inclui vários sites de aplicativos - um para cada plataforma em que o aplicativo está disponível. Por exemplo, aqui está um aplicativo definido com dois sites de aplicativos:
A URL da loja é onde os usuários vão para baixar o aplicativo em uma loja de aplicativos específica, como a Apple App Store ou o Google Play. Por exemplo:
https://itunes.apple.com/il/app/exampleapp/idXXXXXXXX
O identificador do pacote é um identificador interno usado pelos desenvolvedores do aplicativo, por exemplo, "com.myapp". Se o aplicativo ainda não estiver ativo na loja de aplicativos de uma plataforma específica, você ainda poderá adicionar um site de aplicativo para ele e defini-lo por enquanto pelo identificador de pacote interno do aplicativo.
Observação: Esse recurso premium está disponível apenas para clientes Enterprise.
Para clientes Enterprise, a página Apps é dividida em duas guias - Live Apps e Test Apps. Ao adicionar um aplicativo ou site de aplicativo, você pode primeiro escolher a guia na qual deseja adicioná-lo.
Use as guias para acompanhar quais aplicativos estão ativos e sendo comercializados e quais ainda não estão ativos.
Os aplicativos de teste não serão incluídos em listas suspensas ou filtros em qualquer lugar da plataforma Singular. Além disso, as definições de configuração do parceiro para esses aplicativos não serão editáveis e serão exibidas na página de Partner Configuration (Configuração do parceiro) como “Unavailable” (Indisponível).
Verde os sites de aplicativos estão ativos na loja de aplicativos da plataforma.
Vermelho os sites de aplicativos ainda não estão ativos.
Observação: Esta seção se aplica apenas aos clientes do serviço de atribuição da Singular.
Clique neste botão para que a Singular verifique os eventos recentes do SDK para novos aplicativos e adicione-os à lista na página Apps (Aplicativos).
Dica: Se você é cliente do serviço de atribuição da Singular, a Singular atualiza sua lista de aplicativos a cada 2 horas verificando seus eventos do SDK para novos aplicativos. Portanto, sempre que você abre a página Apps, a lista de aplicativos que você vê está praticamente atualizada. Mas se você quiser ter certeza de que a lista inclui aplicativos que foram ativados nas últimas 2 horas, clique em Refresh Apps para forçar uma verificação extra agora.
Adicionando aplicativos
Novos aplicativos são adicionados à lista de duas maneiras:
- Automaticamente: Quando seu rastreador (o rastreador Singular ou um MMP de terceiros) tiver dados sobre este aplicativo, incluindo pelo menos uma instalação ou evento. A Singular verifica se o aplicativo está ativo na loja de aplicativos e, em caso afirmativo, é adicionado à página.
- Manualmente: Ao clicar em Add New App (Adicionar novo aplicativo) ou Add Site (Adicionar site) e inserir os detalhes do aplicativo.
Para adicionar um aplicativo manualmente:
- Na plataforma Singular, vá para Settings > Apps Configurations (Configurações > Configuração de aplicativos).
-
Clique em Add New App (Adicionar novo aplicativo).
-
No formulário que aparece, você tem espaço para inserir um nome de aplicativo e, em seguida, inserir os detalhes de um site de aplicativo específico.
Primeiro, digite o nome do aplicativo. Certifique-se de inserir o nome exatamente como aparece nos relatórios de rede. Preste atenção a letras maiúsculas e minúsculas, espaços, palavras completas x acrônimos etc. Se a Singular não conseguir reconhecer o nome do aplicativo nos relatórios de rede porque é um pouco diferente, você poderá obter "dados não mapeados" em seus relatórios de análise.
-
Agora insira os detalhes do primeiro site do aplicativo. Para sistema operacional, selecione uma das opções.
-
Identifique o site do aplicativo por URL da loja x ID do pacote (Bundle ID):
-
Se o aplicativo estiver ativo na loja de aplicativos, selecione URL da loja e cole a URL do aplicativo na loja de aplicativos.
-
Se o aplicativo ainda não estiver ativo, selecione ID do pacote (Bundle ID) e insira o identificador de pacote interno do aplicativo, por exemplo, com.appname.
Dica: Se você enviou o aplicativo para revisão na Apple App Store, você já tem um URL da loja, mesmo que ainda não esteja ativo. Recomendamos adicionar a URL da loja na caixa de entrada Site Public ID (ID pública do site). Dessa forma, a Singular poderá usá-lo assim que o aplicativo for lançado.
-
- Clique em Save (Salvar).
-
Se o aplicativo aparecer em várias plataformas e lojas de aplicativos, selecione Add Site (Adicionar site). Adicione outro site de aplicativos para cada loja.
Ao manter todas as versões do mesmo aplicativo para diferentes plataformas juntas, você ajuda a Singular a entender os dados da rede de anúncios e fornecer relatórios que podem ser divididos por aplicativo, plataforma ou aplicativo e plataforma.
Além disso, a página Aplicativos não permite adicionar dois aplicativos separados com o mesmo nome. Portanto, se você tentar adicionar cada versão como um aplicativo separado, terá que dar um nome diferente, o que pode causar dados ausentes e outros problemas em seus relatórios (porque a Singular pode não conseguir mapear os dados do aplicativo para o aplicativo correto ). Para obter mais informações, consulte Perguntas frequentes sobre dados não mapeados.
Você pode fazer isso identificando o aplicativo por uma "ID de Pacote" (Bundle ID).
Para adicionar um aplicativo antes que ele seja publicado na loja de aplicativos:
- Na página Apps, clique em Add New App e digite o nome do aplicativo (observação: se você já criou outra versão do aplicativo na página Apps, adicionar o novo como um novo site de aplicativo em vez de um aplicativo totalmente novo).
- Selecione a plataforma apropriada.
-
Em Add an app using (Adicionar um aplicativo usando), selecione Bundle ID e digite a ID do pacote do aplicativo. Este é o identificador interno usado pelos desenvolvedores do aplicativo.
-
Para aplicativos iOS: Se você já enviou o aplicativo para a App Store, você teria recebido o URL da loja do aplicativo (mesmo que o aplicativo ainda não esteja ativo nesse URL). Insira-o em Site Public ID (ID pública do site). Isso ajudará a Singular a começar a mapear os dados para seu aplicativo corretamente.
Você não precisa - A Singular atualiza o status do aplicativo automaticamente para você (para aplicativos iOS e Android). Analisamos seus aplicativos duas vezes por dia e verificamos (usando o ID do pacote - Bundle ID) se algum aplicativo foi lançado na Apple App Store ou no Google Play.
Se um site de aplicativo foi criado em Live Apps automaticamente, mas você não deseja vê-lo nas listas suspensas e filtros de relatório na Singular, você pode movê-lo para Test Apps.
Se você configurou um site de aplicativo em Test Apps, poderá movê-lo para Live quando estiver pronto.
Para mover um site de aplicativo entre as guias, clique no ícone de menu no canto superior direito e clique em Move to Test ou Move to Live.
Configurando seu aplicativo para rastreamento de atribuição com a Singular
Observação: Esta seção se aplica apenas aos clientes do serviço de atribuição da Singular.
Depois de integrar o SDK Singular em seu aplicativo (de acordo com as instruções em Como começar com a atribuição Singular), várias novas configurações ficam disponíveis para o aplicativo na página App Configuration.
Para ver as novas configurações, verifique se o SDK está enviando eventos para a Singular e, em seguida, acesse o aplicativo e clique no botão Advanced Settings (Configurações avançadas).
As configurações são:
- URLs de destino
- Desinstalar rastreamento
- URLs de links diretos (Deep Link)
- Links de aplicativos universais para iOS
Você pode configurar um ou mais destinos alternativos para rastrear links além do URL da loja do aplicativo. Dessa forma, ao criar links de rastreamento para o aplicativo, você poderá selecionar esses destinos como destinos.
Isso é útil, por exemplo, quando você tem páginas de destino personalizadas ou usa uma solução de teste A/B da loja de aplicativos.
Para criar um novo URL de destino:
- Selecione o aplicativo e, em seguida, selecione o site do aplicativo que você deseja configurar.
- Clique no sinal + ao lado das URLs de destino e digite seu novo URL de destino.
- Clique em Save (Salvar).
Se você configurou o SDK Singular para rastrear desinstalações, adquiriu credenciais especiais que precisa inserir na página Apps em Unistall Tracking.
Essas credenciais permitem que a Singular rastreie desinstalações de aplicativos para você.
Para obter mais informações, consulte Introdução ao rastreamento de desinstalação do iOS e Introdução ao rastreamento de desinstalação do Android.
Se você configurou o SDK Singular para lidar com URLs de links diretos (conforme explicado em Como começar com a atribuição Singular), insira os URLs na página Apps da seguinte maneira:
- Clique no aplicativo e, em seguida, no site do aplicativo que você deseja configurar.
- Clique no sinal + ao lado dos URLs de link padrão e digite seu novo URL de link direto.
- Clique em Save (Salvar).
Para obter mais informações, consulte nossas Perguntas frequentes sobre links diretos e Perguntas frequentes sobre links da Singular.
Universal Links é uma tecnologia de links diretos da Apple introduzida e disponível apenas para dispositivos no iOS 9 e superior. É uma tecnologia destinada a substituir os links diretos tradicionais do esquema de URL e atender à necessidade de oferecer a melhor experiência do usuário aos usuários de aplicativos iOS, independentemente de o aplicativo estar presente no dispositivo.
Para obter mais informações sobre links universais e como habilitá-los para seus aplicativos na Singular, consulte as Perguntas frequentes sobre iOS Universal Links.
A janela de inatividade é uma configuração que determina por quanto tempo um usuário deve ficar inativo antes de ser inelegível para atribuição de retomada. Para obter mais informações, consulte O que é retomada? e Quanto tempo um usuário precisa ficar inativo antes que uma nova sessão conte como uma retomada?
Usando chaves de mapeamento
Observação: Esse recurso beta ainda não está disponível para todos os clientes. Se você estiver interessado em experimentá-lo, entre em contato com seu gerente de sucesso do cliente.
Uma chave de mapeamento é um código exclusivo, geralmente mais curto e mais simples que o nome do aplicativo, que você pode definir para um site de aplicativo na página Apps Configuration e também inseri-lo em nomes de campanha em sua rede de anunciantes. Dessa forma, quando a Singular lê os dados de uma campanha do relatório da rede de anunciantes, a Singular pode associar a campanha ao aplicativo correto e garantir que os dados de sua campanha sejam processados e incluídos em seus relatórios.
Ao extrair dados de redes de anúncios, a Singular precisa associar cada campanha publicitária ao aplicativo ao qual pertence e à plataforma do aplicativo (Android, iOS etc.) para fornecer métricas de marketing precisas para cada um de seus aplicativos.
Sem conhecer o aplicativo e a plataforma, a Singular não pode processar os dados da campanha e a campanha não aparecerá em seus relatórios.
Em alguns casos, a rede fornece a ID pública do site do aplicativo ou o nome do aplicativo + plataforma como campos nos relatórios da rede, o que resolve o problema.
Em muitos outros casos, a Singular pode derivar o aplicativo e a plataforma do nome da campanha, analisando a lista de aplicativos em sua conta e tentando encontrar um nome de aplicativo e uma plataforma dentro do nome da campanha. É por isso que é importante que o nome do aplicativo na Singular corresponda ao nome do aplicativo conforme aparece nos nomes das campanhas nos relatórios da rede de anúncios.
Como regra, recomendamos verificar se o nome do seu aplicativo na Singular corresponde ao nome do aplicativo definido em sua rede de anúncios e exibido nos nomes de suas campanhas. Essa é a maneira mais fácil de garantir que suas campanhas sejam mapeadas corretamente para seu aplicativo na Singular. Se os nomes não corresponderem, normalmente você deve editar o nome do aplicativo na Singular ou trabalhar com sua rede de anúncios para alterar o nome da campanha no lado da rede.
No entanto, existem alguns casos em que é difícil fazer com que os nomes correspondam em todas as plataformas. Por exemplo:
- O nome da campanha está em inglês, enquanto o aplicativo em Singular está em outro alfabeto, como chinês ou coreano.
- Um aplicativo tem nomes ligeiramente diferentes na Apple App Store e na Google Play Store, e os nomes das campanhas diferem de acordo.
Nesses casos, você pode usar chaves de mapeamento para garantir que suas campanhas sejam mapeadas.
Para adicionar uma chave de mapeamento:
- Na página Apps Configuration, encontre o aplicativo que tem campanhas não mapeadas.
- Abra o site do aplicativo apropriado para editá-lo.
- Insira uma string no campo Mapping Key (Chave de mapeamento).
- Trabalhando com sua rede de anunciantes, adicione a mesma string ao nome da campanha não mapeada. Certifique-se de separar a chave de mapeamento do restante do nome da campanha com um separador padrão, como um espaço, um sublinhado ou um sinal de pontuação.
Por exemplo, digamos que você tenha um aplicativo chamado “장난감 곰” e um nome de campanha para ele chamado “Teddy Bear iOS FR DE SP”. Para permitir que a Singular mapeie a campanha para o aplicativo:
- Edite o site do aplicativo na Singular e adicione uma chave de mapeamento, por exemplo, "TB111".
- Trabalhando com sua rede de anunciantes, altere o nome da campanha para “Teddy Bear iOS FR DE SP TB111”.
A Singular agora reconhecerá a campanha como associada ao site do aplicativo.
Limitações:
- A chave deve conter pelo menos 4 caracteres.
- A chave deve ser exclusiva do site do aplicativo (não dê a mesma chave a outro site do aplicativo).
- No nome da campanha, separe a chave do restante do nome usando um separador padrão, como um espaço, um sublinhado ou um sinal de pontuação.
- As palavras-chave não podem conter delimitadores em potencial ou não serão identificadas, por exemplo, _, ?, !, %, &, $, |, /, +, -, [, ], (, ) bem como "*", "_", ".", e ",". Por exemplo, uma palavra-chave chamada "MT_Android" não identificará uma campanha chamada "MT_Android_1".
Recomendações adicionais:
- Para evitar erros mais tarde, não use uma chave que corresponda ao nome de outro aplicativo. Por exemplo, se você tiver os aplicativos “Jewel Rush” e “Jewel Rush 2”, não use a tecla “jewelrush”.
- Recomendamos usar apenas letras e números em inglês.