Você está aqui:
Usar links universais do iOS no Email Studio
O recurso de link universal do iOS configura se os links em suas mensagens do Email Studio são abertos em um aplicativo iOS instalado anteriormente ou em um navegador.
Neste tópico:
- Implementar links universais do iOS
- Testar links universais do iOS
- Forçar links do iOS para abrir em um navegador
Implementar links universais do iOS
Para usar links universais, você precisa do Pacote de autenticação do remetente (SAP) e de um certificado SSL para o domínio de clique. Cada par de domínios AppID e click que você usa deve ser exclusivo em todos os aplicativos ativos em suas unidades de negócios. Os links universais funcionam apenas com conexões HTTPS.
-
Modifique seu aplicativo para iOS para aceitar solicitações de link universal.
-
Adicione uma entrada referente ao link de domínio de cliques com marca ao direito com.apple.developer.associated-domains. A entrada deve incluir o prefixo applinks.
Por exemplo, uma entrada para click.example.com tem a seguinte aparência:
"applinks:click.example.com". -
Use a propriedade webpageURL no objeto NSUserActivity fornecido pelo iOS para determinar se o clique se origina do domínio de clique que o Marketing Cloud Engagement usa.
A propriedade aparece como este URL quebrado:
https://click.example.com/?qs=hxdwbvpwueDMUFuWaNEhguEVdMLWCPTsutky0fd - Verifique se o URL recebido é do engajamento realizando uma chamada GET para desempacotar o primeiro URL.
-
Se seus emails estiverem usando a Seleção de conteúdo do Einstein, adicione outra chamada GET para desempacotar o URL de seleção de conteúdo do Einstein intermediário.
Exemplo de URL intermediário de seleção de conteúdo do Einstein:
https://ecs.us.sfmc-einstein.com/einstein/api/block/44644947... - Depois que o URL for totalmente desempacotado, recupere o destino do URL.
- Para analisar a lógica do URL desencapsulado e navegar para a visualização correta no aplicativo, chame um método.
Esse pseudocódigo ilustra as etapas para aceitar uma solicitação de link universal. Esse método acomoda URLs agrupados do Marketing Cloud Engagement que podem usar o aplicativo Einstein Content Selection. Ele adiciona um redirecionamento antes de alcançar o URL original. O pseudocódigo refere-se a uma função chamadaNetworking.getUnwrapped(), que recupera o URL final emitindo uma solicitação GET para o URL e recuperando o valor de seu cabeçalho delocation.-
public func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([Any]?) -> Void) -> Bool { // Example: Double wrapped url if let url = userActivity.webpageURL { if url.absoluteString.contains("sfmc-einstein") { Networking.getUnwrapped(url) { result in switch result { case .success(let singleUnwrappedURL): // first unwrapped link; will need to be unwrapped again Networking.getUnwrapped(singleUnwrappedURL) { result in switch result { case .success(let doubleUnwrappedURL): // Final unwrapped link to be parsed by app parseAndRedirect(with: doubleUnwrappedURL) case .failure: print("Failed to get 2nd unwrapped link") } } case .failure: print("Failed to get 1st unwrapped link") } } } } return true }
-
Adicione uma entrada referente ao link de domínio de cliques com marca ao direito com.apple.developer.associated-domains. A entrada deve incluir o prefixo applinks.
-
Configure o link universal para iOS para o Email Studio. Essas configurações são usadas para implantar o arquivo apple-app-site-association (AASA) a um domínio de clique.
- Na seção Administrador do Email Studio, em Vinculação profunda, insira seu AppID. O AppID é o teamID alfanumérico do seu aplicativo seguido pelo bundleID.
- Para forçar uma experiência móvel da Web para centros de perfil e assinatura, selecione Excluir perfil e Unsub Center.
- Salve a entrada.
-
A ordem das entradas afeta a ordem das entradas no arquivo AASA. Para alterar a ordem, exclua as entradas e insira-as na ordem correta.
Sua primeira entrada deve ser um aplicativo de teste ou preparação.
- Depois de configurado, seu domínio de clique apresenta um arquivo AASA. O AASA é https://click.{your-sap-domain}/.well-known/apple-app-site-association.
-
{ "applinks": { "apps": [], "details": [ { "appID": "ABC123EFG.com.staging.app", "paths": [ "NOT /subscription_center.aspx*", "NOT /profile_center.aspx*", "NOT /unsub_center.aspx*", "NOT /u/*", "/*" ] }, { "appID": "HJK456LMN.com.production.app", "paths": [ "NOT /subscription_center.aspx*", "NOT /profile_center.aspx*", "NOT /unsub_center.aspx*", "NOT /u/*", "/*" ] } ] } }
Testar links universais do iOS
Antes de testar links com seu próprio aplicativo móvel, adicione o domínio ao direito do aplicativo iOS. Usar o mesmo domínio de clique para versões de desenvolvimento e produção não permite a diferenciação entre dados de teste e dados de produção.
- Para testar links, envie mensagens de email para versões de desenvolvimento do seu aplicativo.
- Para todas as versões do aplicativo usarem o recurso, inclua todos os valores AppID aplicáveis em seu arquivo de associação. Se você usar apenas um valor AppID, inclua esse valor somente em versões locais do aplicativo para fins de teste.
- Use certificados SSL para todas as contas de sandbox ou de teste para o Marketing Cloud Engagement.
Forçar links do iOS para abrir em um navegador
Crie uma marca que impeça que links universais do iOS abram o link em seu aplicativo móvel. Em vez disso, essa marca exclui o link universal e força seu dispositivo móvel a abrir o link em uma janela do navegador.
- Abra a versão HTML da mensagem de email que contém o link.
-
Adicione
mc-deep-link="false"à marca<a>do link, como neste exemplo:<a href="https://www.example.com" mc-deep-link="false">Your Link</a> - Salve a mensagem de email.
