Aplicativos (configuração de aplicativos) Perguntas frequentes

A página Configuração de aplicações(Definições > Aplicações) é o local onde mantém uma lista actualizada de todas as aplicações que está a comercializar. A Singular precisa desta lista para lhe fornecer relatórios analíticosprecisos, discriminados por aplicação.

PERGUNTAS FREQUENTES

Resolução de problemas

O que acontece se eu usar o mesmo site de aplicativo para várias plataformas?

Se você usar o mesmo site de aplicativo para várias plataformas para um aplicativo, o nome do aplicativo será o mesmo nos relatórios e terá as mesmas configurações. Recomendamos fortemente o uso de um ID de pacote diferente para cada site de aplicativo.

No entanto, se você tiver o mesmo site de aplicativo para várias plataformas, poderá distinguir entre eles nos relatórios usando o URL da campanha se usar links de rastreamento diferentes para cada plataforma. Nos dados ao nível do utilizador, pode distinguir entre as suas aplicações com o valor app_version.

O que devo fazer se estiver a comercializar uma propriedade web/página de destino e não uma aplicação móvel?

Se estiver a comercializar um Web site, uma loja online, uma página de destino, etc., continua a ter de a adicionar na página Aplicações:

  1. Na página Aplicações, clique em Adicionar nova aplicação.
  2. Para a plataforma, seleccione "web".
  3. Introduza o URL da página ou o domínio principal do Web site.

image2.gif

Noções básicas

O que é a página Configuração de aplicativos?

A página Configuração da aplicação é onde mantém uma lista actualizada de todas as aplicações que está a comercializar. O Singular precisa desta lista para lhe fornecer relatórios analíticosprecisos, discriminados por aplicação.

Porque é que o nome da aplicação é importante?

A Singular utiliza o nome da aplicação para mapear as estatísticas da sua rede de publicidade para a aplicação correcta, de modo a podermos fornecer-lhe as suas estatísticas discriminadas por aplicação.

Se o nome da aplicação no Singular não corresponder ao nome da aplicação tal como aparece nos dados da rede de publicidade, o Singular tem outras formas de tentar mapear os dados para a aplicação correcta - mas é melhor evitar o problema.

Para obter mais informações, consulte as Perguntas frequentes sobre dados não mapeados.

O que é um site de aplicativo e qual a diferença entre ele e um aplicativo?

Na terminologia da 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 que é específica para uma plataforma, como iOS ou Android. É chamado de site de aplicativo porque (quando vai ao ar) tem um URL na loja de aplicativos da plataforma.

Uma aplicação inclui frequentemente vários sítios de aplicações - um para cada plataforma em que a aplicação está disponível. Por exemplo, aqui está uma aplicação definida com dois sítios de aplicações:

image1.png

O que é um URL da loja?

O URL da loja é onde os utilizadores vão para descarregar a aplicação numa loja de aplicações específica, como a Apple App Store ou o Google Play. Por exemplo:

https://itunes.apple.com/il/app/exampleapp/idXXXXXXXX
O que é um identificador de pacote?

O identificador de pacote é um identificador interno utilizado pelos programadores de aplicações, por exemplo, "com.myapp". Se a aplicação ainda não estiver ativa na loja de aplicações de uma plataforma específica, pode adicionar um site de aplicações para a mesma e defini-lo, por enquanto, pelo identificador de pacote interno da aplicação.

O que são aplicações de teste e aplicações activas?

Nota: Esta funcionalidade premium só está disponível para clientes Enterprise.

Para os clientes Enterprise, a página Apps está dividida em dois separadores - Live Apps e Test Apps. Quando adiciona uma aplicação ou um site de aplicações, pode escolher primeiro o separador em que pretende adicioná-lo.

Utilize os separadores para saber quais as aplicações que estão activas e a ser comercializadas e quais as que ainda não estão activas.

As aplicações de teste não serão incluídas em listas pendentes ou filtros em qualquer parte da plataforma Singular.Além disso, as definições de configuração de parceiros para estas aplicações não serão editáveis e aparecerão na página Configuração de parceiroscomo "Indisponível".

O que significa o ponto vermelho/verde ao lado do site do aplicativo?

Os sites de aplicações verdesestão activos na loja de aplicações da plataforma.

Os sites de aplicativos vermelhos ainda não estão ativos.

O que o botão Atualizar aplicativos faz?

Nota: Esta secção aplica-se apenas aos clientes do serviço de atribuição da Singular.

Clique nesse botão para que a Singular verifique os eventos recentes do SDK em busca de novos aplicativos e adicione-os à lista na página Aplicativos.

Dica: Se você for cliente do serviço de atribuição da Singular, a Singular atualiza sua lista de aplicativos a cada 2 horas, verificando se há novos aplicativos nos eventos do SDK. Portanto, sempre que você abre a página Aplicativos, a lista de aplicativos que você vê está quase sempre atualizada. Mas se você quiser ter certeza de que a lista inclui aplicativos que foram ativados nas últimas 2 horas, clique em Atualizar aplicativos para forçar uma verificação extra agora mesmo.

Adicionar aplicações

Como é que as aplicações são adicionadas à lista?

As novas aplicações são adicionadas à lista de duas formas:

  1. Automaticamente: Quando o seu rastreador(seja o rastreador Singular ou um MMP de terceiros) tem dados sobre este aplicativo, incluindo pelo menos uma instalação ou evento. O Singular verifica se o aplicativo está ativo na loja de aplicativos e, em caso afirmativo, ele é adicionado à página.
  2. Manualmente: Quando você clica em Adicionar novo aplicativoou Adicionar site e insere os detalhes do aplicativo.
Como posso adicionar um aplicativo à lista manualmente?

Para adicionar um aplicativo manualmente:

  1. Na plataforma Singular, vá para Configurações > Configuração de aplicativos.
  2. Clique em Adicionar nova aplicação.

    new_app.gif

  3. No formulário que aparece, tem espaço para introduzir um nome de aplicação e, em seguida, introduzir os detalhes de um site de aplicação específico.

    Primeiro, introduza o nome da aplicação. Certifique-se de que introduz o nome exatamente como aparece nos relatórios de rede. Preste atenção às letras maiúsculas e minúsculas, aos espaços, às palavras completas em vez de acrónimos, etc. Se o Singular não conseguir reconhecer o nome da aplicação nos relatórios de rede porque é um pouco diferente, poderá obter "dados não mapeados" nos seus relatórios de análise.

    Screen_Shot_2021-07-12_at_15.29.53.png

  4. Agora insira os detalhes do primeiro site de aplicativo.Para o sistema operacional, selecione uma das opções.

    Screen_Shot_2021-07-12_at_15.04.49.png

  5. Identifique o site de aplicativos pelo URL da lojaou pelo ID do pacote:

    • Se a aplicação estiver ativa na loja de aplicações, seleccione URL da loja e cole o URL da aplicação na loja de aplicações.

      Screen_Shot_2021-07-12_at_15.22.07.png

    • Se a aplicação ainda não estiver ativa, seleccione ID do pacote e introduza o identificador de pacote interno da aplicação, por exemplo, com.appname.

      Screen_Shot_2021-07-12_at_15.22.40.png

      Dica: Se você enviou o aplicativo para revisão na Apple App Store, você já tem um URL da loja, mesmo que ele ainda não esteja ativo. Recomendamos adicionar o URL da loja na caixa de entrada ID pública do site. Dessa forma, o Singular poderá usá-lo quando o aplicativo for lançado.

      Screen_Shot_2021-07-12_at_15.20.43.png

  6. Clique em Salvar.
  7. Se o aplicativo aparecer em várias plataformas e lojas de aplicativos, selecione Adicionar site. Adicione outro site de aplicativo para cada loja.

Por que devo adicionar meu aplicativo Android e meu aplicativo iOS como "sites de aplicativos" no mesmo aplicativo?

image1.png

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 fornece relatórios que podem ser divididos por aplicativo, plataforma ou aplicativo e plataforma.

Além disso, a página Aplicativos não permite que você adicione dois aplicativos separados com o mesmo nome. Assim, se tentar adicionar cada versão como uma aplicação separada, terá de lhe dar um nome diferente, o que pode causar dados em falta e outros problemas nos seus relatórios (porque o Singular pode não conseguir mapear os dados da aplicação para a aplicação correcta). Para obter mais informações, consulte as Perguntas frequentes sobre dados não mapeados.

Como posso adicionar um aplicativo que ainda não está disponível na loja de aplicativos?

Pode fazê-lo identificando a aplicação com um "Bundle ID".

Para adicionar uma aplicação antes de estar disponível na loja de aplicações:

  1. Na página Apps, clique em Adicionar nova aplicação e introduza o nome da aplicação (nota: se já tiver criado outra versão da aplicação na página Apps, adicione a nova versão como um novo site de aplicações em vez de uma aplicação totalmente nova).
  2. Seleccione a plataforma adequada.
  3. Em Adicionar um aplicativo usando, selecione ID do pacote e insira o ID do pacote do aplicativo, que é o identificador interno usado pelos desenvolvedores de aplicativos.

    Screen_Shot_2021-07-12_at_15.22.40.png

  4. Para aplicativos iOS: se você já tiver enviado o aplicativo para a App Store, terá recebido o URL da loja do aplicativo (mesmo que o aplicativo ainda não esteja ativo nesse URL). Insira-o em ID pública do site. Isso ajudará o Singular a começar a mapear os dados para seu aplicativo corretamente.

    Screen_Shot_2021-07-12_at_15.20.43.png

Adicionei uma aplicação antes de estar disponível na loja de aplicações - como é que a actualizo depois de estar disponível?

Você não precisa fazer isso - Singular atualiza o status do aplicativo automaticamente para você (para aplicativos iOS e Android). Analisamos as suas aplicações duas vezes por dia e verificamos (usando o ID do pacote) se alguma aplicação foi lançada na Apple App Store ou no Google Play.

Como é que mudo uma aplicação de teste para a versão de produção ou vice-versa?

Se um site de aplicativo foi criado automaticamente no Live Apps, mas você não quer vê-lo nas listas suspensas e nos filtros de relatório no Singular, você pode movê-lo para o Test Apps.

Se tiver configurado um site de aplicativos nos Aplicativos de teste, poderá movê-lo para o 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 Mover para teste ou Mover para ativo.

move_to_test.gif

Configurando seu aplicativo para rastreamento de atribuição com Singular

Observação: Esta seção se aplica apenas aos clientes do serviço de atribuição da Singular.

Quais configurações eu preciso definir para o aplicativo antes de poder executar campanhas com o Singular?

Depois de integrar o SDK da Singular em seu aplicativo (de acordo com as instruções em Como começar a usar o Singular Attribution), várias novas configurações ficam disponíveis para o aplicativo na página Configuração do aplicativo.

Para ver as novas configurações, certifique-se de que o SDK está enviando eventos para o Singular e, em seguida, vá para o aplicativo e clique no botão Configurações avançadas.

As configurações são:

  • URLs de destino
  • Desinstalar rastreamento
  • URLs de links profundos
  • Links de aplicativos universais do iOS
O que são URLs de destino e como configurá-los?

Pode configurar um ou mais destinos alternativos para links de rastreamento, para além do URL da loja da aplicação. Desta forma, quando criar links de rastreamento para a aplicação, poderá selecionar estes destinos como alvos.

Isto é útil, por exemplo, quando tem páginas de destino personalizadas ou utiliza uma solução de teste A/B da loja de aplicações.

Para criar um novo URL de destino:

  1. Seleccione a aplicação e, em seguida, seleccione o site da aplicação que pretende configurar.
  2. Clique no sinal + ao lado de URLs de destinoe digite seu novo URL de destino.
  3. Clique em Guardar.
Como configurar o rastreamento de desinstalação?

Se você configurou o SDK do Singular para rastrear desinstalações, adquiriu credenciais especiais que precisam ser inseridas na página Aplicativos em Rastreamento de desinstalação.

Essas credenciais permitem que o Singular rastreie desinstalações de aplicativos para você.

Para obter mais informações, consulte Introdução ao rastreamento de desinstalação do iOSe Introdução ao rastreamento de desinstalação do Android.

O que é a "janela de inatividade"?

A janela de inatividade é uma definição que determina quanto tempo um utilizador tem de estar inativo antes de não ser elegível para atribuição de reengajamento. Para mais informações, consulte O que é o reengajamento?e Quanto tempo tem um utilizador de estar inativo para que uma nova sessão conte como um reengajamento?

O que é o "intervalo mínimo de sessão"?

O intervalo mínimo de sessão é o tempo mínimo entre as sessões que o Singular processará as sessões recebidas por um aplicativo. Há suporte para valores de 5 minutos a 24 horas, e o valor padrão é 12 horas. Esse mecanismo limita o número de sessões repetidas que são processadas no Singular. Por exemplo, se um aplicativo tiver um "Intervalo mínimo de sessão" de 1 hora, o comportamento será o seguinte:

Além disso, as sessões que accionam a funcionalidade principal estão isentas desta funcionalidade, tais como:

  • Sessões de deep link, deferred deep link e resolução de short link
  • Sessões de instalação
  • Sessões que são elegíveis para reativação a partir da janela de inatividade configurada
  • Actualizações de ID de utilizador personalizado ou propriedades globais
  • Consola de testes SDK
  • Actualizações do modelo de conversão SKAdNetwork

O "Intervalo mínimo de sessão" não afeta o relatório de retenção Singular. A retenção Singular é calculada usando um período contínuo de 24 horas (consulte Perguntas frequentes sobre retenção), portanto a retenção de um usuário será registrada, desde que pelo menos uma sessão seja processada durante cada período de 24 horas.

A partir de 8 de maio de 2023:

  • Todas as aplicações integradas existentes não sofrem alterações no comportamento e têm um intervalo mínimo de sessão de 0 (desligado).
  • Todas as aplicações recém-adicionadas e integradas terão um intervalo mínimo de sessão predefinido de 12 horas. O valor do intervalo pode ser modificado para cada aplicação na sua página de definições das aplicações.

Utilizar as teclas de mapeamento

Nota: Esta funcionalidade beta ainda não está disponível para todos os clientes. Se estiver interessado em experimentá-la, contacte o seu Gestor de Sucesso do Cliente.

O que são chaves de mapeamento?

Uma chave de mapeamento é um código exclusivo, normalmente mais curto e mais simples do que o nome do aplicativo, que pode ser definido para um site de aplicativona página Configuração de aplicativos e também inserido em nomes de campanha em sua rede de anúncios. Dessa forma, quando o Singular lê os dados de uma campanha no relatório da rede de anúncios, o Singular pode associar a campanha ao aplicativo correto e garantir que os dados da campanha sejam processados e incluídos nos relatórios.

Por que é importante para o Singular mapear cada campanha para um aplicativo?

Ao extrair dados de redes de anúncios, o Singular precisa associar cada campanha publicitária ao aplicativo ao qual ela 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, o Singular não pode processar os dados da campanha, e a campanha não aparecerá nos 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, o Singular pode derivar o aplicativo e a plataforma do nome da campanha, examinando a lista de aplicativos em sua contae tentando encontrar um nome de aplicativo e uma plataforma dentro do nome da campanha. É por isso que é importante que o nome da aplicação no Singular corresponda ao nome da aplicação tal como aparece nos nomes das campanhas nos relatórios da rede de anúncios.

mapping_key1.png

Quando é que é necessário utilizar chaves de mapeamento?

Como regra geral, recomendamos que o nome do aplicativo no Singular corresponda ao nome do aplicativo definido na rede de anúncios e que aparece nos nomes das campanhas. Essa é a maneira mais fácil de garantir que suas campanhas sejam mapeadas corretamente para seu aplicativo no Singular. Se os nomes não corresponderem, normalmente você deve editar o nome do aplicativo no Singular ou trabalhar com sua rede de anúncios para alterar o nome da campanha no lado da rede.

No entanto, há 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 no Singular está em outro alfabeto, como chinês ou coreano.
  • Uma aplicação tem nomes ligeiramente diferentes na Apple App Store e na Google Play Store, e os nomes das campanhas diferem em conformidade.

Nesses casos, pode utilizar chaves de mapeamento para garantir que as suas campanhas são mapeadas.

Como é que adiciono uma chave de mapeamento?

Para adicionar uma chave de mapeamento:

  1. Na página Configuração de aplicativos, encontre o aplicativo que tem campanhas não mapeadas.
  2. Abra o site do aplicativo apropriado para editá-lo.
  3. Introduza uma cadeia de caracteres no campo Chave de mapeamento.
  4. Trabalhando com sua rede de anúncios, adicione a mesma cadeia de caracteres ao nome da campanha não mapeada. Certifique-se de que separa a chave de mapeamento do resto do nome da campanha com um separador padrão, como um espaço, um sublinhado ou um sinal de pontuação.

mapping_key2.png

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 o Singular mapeie a campanha para o aplicativo:

  1. Edite o site do aplicativo no Singular e adicione uma chave de mapeamento, por exemplo, "TB111".
  2. Trabalhando com sua rede de anúncios, altere o nome da campanha para "Teddy Bear iOS FR DE SP TB111".

A Singular reconhecerá agora a campanha como estando associada ao site da aplicação.

Como devo escolher a cadeia de chaves de mapeamento? Existem limitações no comprimento da chave?

Limitações:

  • A chave deve conter pelo menos 4 caracteres.
  • A chave deve ser exclusiva do sítio de aplicação (não dê a outro sítio de aplicação a mesma chave).
  • No nome da campanha, separe a chave do resto do nome utilizando um separador padrão, como um espaço, um sublinhado ou um sinal de pontuação.
  • As palavras-chave não podem conter potenciais delimitadores ou não serão identificadas, por exemplo, _, ?, !, %, &, $, |, /, +, -, [, ], (, ), bem como "*", "_", ". " e ",". Por exemplo, uma palavra-chave denominada "MT_Android" não identificará uma campanha denominada "MT_Android_1".

Recomendações adicionais:

  • Para evitar erros mais tarde, não utilize uma chave que corresponda ao nome de outra aplicação. Por exemplo, se tiver as aplicações "Jewel Rush" e "Jewel Rush 2", não utilize a chave "jewelrush".
  • Recomendamos que utilize apenas letras e números em inglês.