Guia de integração do Apple App Clips

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.

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

• Integração do SDK no App Clip
• Configurar a atribuição de instalação de aplicativo de clipe para aplicativo completo
• [Opcional] Configurar eventos in-app, se você ainda não tiver eventos in-app sendo medidos para seu aplicativo completo ou quiser usar eventos in-app diferentes para o App Clip.

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.

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.

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.