How can we help?

Guia de integração do Apple App Clips

  • Atualizado

Visão geral: Os App Clips permitem que os usuários com iOS 14 ou posterior acessem e experimentem rapidamente seu aplicativo. A AppsFlyer habilita a atribuição de App Clips e redireciona os usuários que não podem usar App Clips (por exemplo, usuários do Android) conforme necessário.

app_clip_flow_3.png

Integração do App Clip

  • Os App Clips fornecem aos usuários do iOS 14 acesso rápido e conveniente a uma experiência de aplicativo, sem a necessidade de baixar o aplicativo completo.
  • Os App Clips são instalados e iniciados a partir de uma invocação (por exemplo, um código QR ou uma tag NFC). Observação: Banners e links do Safari Smart App no Mensagens não são compatíveis. 
  • O SDK da AppsFlyer é necessário para a atribuição de cliques, instalações, eventos in-app e instalações completas do App Clip.
  • Independentemente do SDK, o OneLink redireciona os usuários conforme necessário:
    • Usuários sem o aplicativo instalado:
      • Com o iOS 14 ou posterior são enviados para o App Clip.
      • Com iOS 13 ou anterior, ou Android, são redirecionados com base em suas configurações no OneLink (para a loja de aplicativos, etc).
    • Os usuários com o aplicativo instalado são enviados para o aplicativo com base na configuração do Universal Link ou do App Link no OneLink.

Considerações

  • Os App Clips podem ter até 10 MB de tamanho. O SDK da AppsFlyer tem ~1,5 MB. 
  • Não há identificadores de publicidade disponíveis.
  • Os App Clips são excluídos pelo sistema operacional automaticamente após um período de inatividade de 30 dias.

 Exemplo

Marcos é o profissional de marketing de uma rede de cafeterias. Ele pede para o seu desenvolvedor iOS criar um App Clip que permite que os clientes evitem a fila e façam pedidos em segundos. Eles simplesmente se identificam usando Login da Apple, pedem o café e pagam usando o Apple Pay. O desenvolvedor adiciona o SDK da AppsFlyer e garante que ele funcione no aplicativo e no app clip.

Mark cria um OneLink e publica o código QR na cafeteria, junto com o slogan "Evite a fila!". 

Os clientes escaneam o código QR e:

  • Se eles tiverem um dispositivo com iOS 14 ou posterior, o App Clip será abertocom a unidade correta da cafeteria e um cupom de desconto preenchido.
  • Se eles já tiverem o aplicativo completo instalado, o aplicativo será aberto na página de pedidos de café.
  • Se eles não tiverem o aplicativo e tiverem um dispositivo com iOS 13 ou anterior, ou Android, a página da loja de aplicativos do aplicativo de cafeteria será aberta.

Marcos usa o painel e os relatórios da AppsFlyer para ver quantos cliques e instalações o App Clip recebe - e quantos usuários continuam baixando o aplicativo completo.

Métricas e relatórios

Os dados analíticos e brutos dos App Clips estão disponíveis na plataforma com base na atividade do usuário descrita na tabela a seguir.

Ação do usuário Evento AppsFlyer Painel de visão geral e ferramentas analíticas Dados brutos
Invocação (exemplo: código QR) Nenhum evento Nenhum evento Nenhum evento
Clicks App Card e App Clip são abertos

Clique e instalação atribuídos à fonte de invocação

  • Cliques
  • Instalações
app_type=app_clip
Usa o App Clip
  • [Opcional] O desenvolvedor envia evento in-app
  • Após a primeira inicialização do App Clip, as inicializações seguintes são contadas como sessões.
  • Evento in-app
  • Sessão
Baixar e iniciar o aplicativo completo Evento in-app Nome do evento no aplicativo= af_app_clip_to_full_app
Uso contínuo do aplicativo completo [Opcional] O desenvolvedor envia evento in-app Evento in-app

Painel de coorte

Visualize o desempenho do App Clip no Painel de coorte, onde você pode: 

  • Ver quanto tempo leva para os usuários irem do App Clip para a instalação completa do aplicativo.
  • Usar a métrica de conversão in-app para comparar o desempenho de diferentes campanhas de invocação.

Implementação do App Clip

O procedimento a seguir detalha o que você e o desenvolvedor do iOS precisam fazer para desenvolver e integrar App Clips.

Escopo do trabalho

Quem está envolvido

  • Anunciante: 
    • Configura Apple App Clips em templates do OneLink.
    • Coloca os links do OneLink no portal Apple App Store Connect.
    • Visualiza métricas no painel e nos relatórios da AppsFlyer.
  • Desenvolvedor iOS:
    • Cria o App Clip
    • Integra o SDK da AppsFlyer no App Clip.

Pré-requisitos

  • Uma conta da AppsFlyer com pelo menos um aplicativo.
  • Um template do OneLink com Links Universais e um link do OneLink configurado para direcionar todos os usuários do aplicativo.
    Recomendação: O template e a invocação de link que você usa para o App Clip enviam todos os usuários sem o aplicativo completo para o App Clip. Portanto, considere ter um template separado e um link personalizado para casos em que você deseja enviar esses usuários para a App Store, em vez do App Clip. 

Desenvolver App Clip

Para obter instruções completas sobre como os desenvolvedores criam um App Clip para seu aplicativo, consulte o Guia do App Clip para desenvolvedores da Apple.

Para obter um aplicativo de exemplo simplificado que demonstra o uso de App Clips e sua integração com um aplicativo completo, consulte o Guia do App Clip da AppsFlyer.

Integrar SDK

  • O SDK é necessário para a atribuição da AppsFlyer de cliques, instalações, eventos no aplicativo e instalações completas do aplicativo App Clip.
  • O OneLink redireciona os usuários independentemente da integração do SDK.

Para instalar o SDK e configurar o SDK completo do aplicativo

Envie os seguintes links para o seu desenvolvedor iOS e diga a ele para seguir as instruções para:

Configurar OneLink

Pré-requisitos:

  • Template do OneLink para seu aplicativo completo com links universais do iOS configurados.
  • Link do OneLink.
  • Recomendação: O template e a invocação de link que você usa para o App Clip enviam todos os usuários sem o aplicativo completo para o App Clip. Portanto, considere ter um template separado e um link personalizado para casos em que você deseja enviar esses usuários para a App Store, em vez do App Clip.

Para configurar o template do OneLink para seu App Clip:

  1. No painel da AppsFlyer, acesse Engajar > Gerenciamento OneLink.
  2. Selecione o íconeTemplate do OneLinkque você usa para direcionar os usuários para seu aplicativo completo. 
  3. Verifique se o template do OneLink tem Links Universais configurados. (Veja Instruções para adicionar links universais.)
  4. Clique em Salvar.
    O arquivo AASA é atualizado para dar suporte ao App Clip.
  5. No painel da AppsFlyer, acesse Engajar > Gerenciamento OneLink.
  6. Selecione o íconeLink personalizado do OneLink com base no template configurado nas etapas 1 a 4 que você usa para direcionar os usuários para o App Clip.
  7. Verifique se você tem um canal de mídia (pid) especificada.
    O canal de mídia precisa ser especificada no URL (por exemplo: pid=chartboost_int) ou contidos no link.

Para verificar se o App Clips está ativado no AppsFlyer OneLink:

  1. Crie um URL para obter seu arquivo de associação. O URL é criado pegando o domínio do seu template OneLink e adicionando /.well-known/apple-app-site-association
    Por exemplo: coffee.onelink.me/.well-known/apple-app-site-association.
  2. Vá para o URL do seu arquivo de associação.
    O arquivo apple-app-site-association é baixado automaticamente.
  3. Abra o arquivo apple-app-site-association com um editor de texto (por exemplo, Notepad).
  4. Certifique-se de que o arquivo contenha a palavra "appclips". e que o ID do pacote termine com ". Clip". Por exemplo:
    "appclips": {
        "apps": [
          "ABCD1234.id.your.app. Clip",
          ...
        ]
    ...
    }
    Em caso afirmativo, você configurou com êxito os App Clips no lado da AppsFlyer e o App Clip é implementado em qualquer template do OneLink com o mesmo subdomínio.

Configurar o App Store Connect

Pré-requisitos: Conclusão de Configuração do template do OneLink para App Clips

Para configurar seu App Clip para funcionar com o OneLink

  1. Na página do seu aplicativo no App Store Connect, vá para Construir > Status do domínio.
  2. Verifique se o domínio do OneLink é exibido em Criar domínios e que Status do cache e Status de depuração são ambos "validados".
  3. No painel da AppsFlyer, acesse Engajar > Gerenciamento OneLink.
  4. Passe o mouse sobre o ícone Ações do link que deseja testar e clique em Obter URL
  5. Registre o URL curto (ou o prefixo do URL longo). 
  6. Na página do seu aplicativo no App Store Connect, vá para Clipe de aplicativo > Editar experiências avançadas > +Adicionar > Próximo.
  7. Em URL da experiência do App Clip, cole o URL personalizado do OneLink que você registrou na etapa 5.
    Observação: Você pode anexar parâmetros de consulta após o URL personalizado principal, mas não pode alterar o caminho.
  8. Clique em Próximo.
    Seu App Clip agora está configurado para funcionar com o OneLink. Mais instruções sobre as configurações do App Store Connect estão disponíveis no Guia do desenvolvedor da Apple.

Testes

Pré-requisitos: Um Dispositivo de teste registrado com iOS 14 sem seu aplicativo completo instalado.

Para testar sua integração OneLink/App Clip:

  1. No painel da AppsFlyer, acesseContratar > Gerenciamento OneLink.
  2. Passe o mouse sobre o ícone Ações do link que deseja testar e clique em Obter URL
  3. Escaneie o código QR com seu dispositivo.
    O App Clip Card é exibido no seu dispositivo, indicando que a integração do OneLink/App Clip está configurada corretamente.

Características e limitações

Características e limitações

Característica/limitação Descrição
Métodos de invocação
  • Códigos QR e tags NFC são compatíveis.
  • Banners e links do Safari Smart App no Mensagens não são compatíveis. 
Proteção contra fraudes

A funcionalidade SKAdNetwork não está disponível. Portanto, as instalações do App Clip são exibidas no painel da SKAdNetwork como orgânicas.

Os links diretos universais do OneLink

Apenas uma experiência avançada do App Clip é permitida por link personalizado do OneLink. Isso significa que você não pode adicionar caminhos adicionais ao OneLink no App Store Connect.

Os alertas do Protect360 são atualizados no horário UTC diário.

O Protect360 não é compatível com App Clips.

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: