Perguntas frequentes sobre aplicativos (configuração de aplicativos)

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

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 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.

O que devo fazer se estiver comercializando uma propriedade da Web/página de destino, não um aplicativo para dispositivos móveis?

Se você estiver comercializando um site, loja online, página de destino etc., ainda precisará adicioná-lo na página Apps (Aplicativos):

  1. Na página Apps (Aplicativos), clique em Add New App (Adicionar novo aplicativo).
  2. Para a plataforma, selecione "web."
  3. Insira o URL da página ou o domínio principal do site.

image2.gif

O básico

O que é a página App Configuration (Configuração do aplicativo)?

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.

Por que o nome do aplicativo é importante?

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.

O que é um site de aplicativo e como ele é diferente de um aplicativo?

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:

image1.png

O que é um URL de loja?

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 que é um identificador de pacote?

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.

O que são aplicativos de teste e aplicativos ao vivo?

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).

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

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.

O que o botão Refresh Apps (Atualizar aplicativos) faz?

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

Como os aplicativos são adicionados à lista?

Novos aplicativos são adicionados à lista de duas maneiras:

  1. 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.
  2. Manualmente: Ao clicar em Add New App (Adicionar novo aplicativo) ou Add Site (Adicionar site) e inserir os detalhes do aplicativo.
Como posso adicionar um aplicativo à lista manualmente?

Para adicionar um aplicativo manualmente:

  1. Na plataforma Singular, vá para Settings > Apps Configurations (Configurações > Configuração de aplicativos).
  2. Clique em Add New App (Adicionar novo aplicativo).

    new_app.gif

  3. 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.

    Screen_Shot_2021-07-12_at_15.29.53.png

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

    Screen_Shot_2021-07-12_at_15.04.49.png

  5. 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.

      Screen_Shot_2021-07-12_at_15.22.07.png

    • 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.

      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 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.

      Screen_Shot_2021-07-12_at_15.20.43.png

  6. Clique em Save (Salvar).
  7. 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.

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 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.

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

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:

  1. 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).
  2. Selecione a plataforma apropriada.
  3. 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.

    Screen_Shot_2021-07-12_at_15.22.40.png

  4. 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.

    Screen_Shot_2021-07-12_at_15.20.43.png

Adicionei um aplicativo antes de ele estar disponível na loja de aplicativos - como faço para atualizá-lo depois que ele estiver disponível?

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.

Como faço para mover um aplicativo de teste para live ou vice-versa?

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.

move_to_test.gif

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.

Quais configurações preciso definir para o aplicativo antes de poder executar campanhas com a 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
O que são URLs de destino e como configurá-las?

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:

  1. Selecione o aplicativo e, em seguida, selecione o site do aplicativo que você deseja configurar.
  2. Clique no sinal + ao lado das URLs de destino e digite seu novo URL de destino.
  3. Clique em Save (Salvar).
Como configuro o rastreamento de desinstalação?

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.

O que é a "janela de inatividade"?

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.

O que são chaves de mapeamento?

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.

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

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.

mapping_key1.png

Quando é necessário usar chaves de mapeamento?

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.

Como adiciono uma chave de mapeamento?

Para adicionar uma chave de mapeamento:

  1. Na página Apps Configuration, encontre o aplicativo que tem campanhas não mapeadas.
  2. Abra o site do aplicativo apropriado para editá-lo.
  3. Insira uma string no campo Mapping Key (Chave de mapeamento).
  4. 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.

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

  1. Edite o site do aplicativo na Singular e adicione uma chave de mapeamento, por exemplo, "TB111".
  2. 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.

Como devo escolher a string da chave 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 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.