Deep Linking

Visão geral

Deep linking permite que você abra uma página específica dentro do seu aplicativo a partir de uma fonte externa, como um site, email ou SMS. Se o aplicativo não estiver instalado, os usuários são redirecionados para a loja de aplicativos apropriada. Se estiverem em uma plataforma não suportada, os usuários são redirecionados para um site de fallback. Este guia cobre a configuração e uso de deep linking em:

Android (App Links)
iOS (Universal Links e URL Schemes)
Notificações push
Emails
Mensagens in-app

Para funcionar corretamente, deep links devem:

Ser hospedados via HTTPS
Incluir os arquivos de verificação necessários:
- Apple App Site Association
- Asset Link

Android setup
iOS setup

Configuração Android

Use o App Links Assistant do Android Studio para simplificar a configuração.

Etapas:

Abra o Android Studio → Tools → App Links Assistant
Siga as etapas para configurar links para seu site
O Android Studio gera automaticamente o código necessário e o arquivo assetlinks.json

Exemplo de Manifest:

<activity android:name=".SecondActivity" android:exported="true">
  <intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="https" />
    <data android:host="yoursite.com" />
  </intent-filter>
</activity>

Exemplo de manipulador de Activity:

Intent appLinkIntent = getIntent();
String appLinkAction = appLinkIntent.getAction();
Uri appLinkData = appLinkIntent.getData();

O arquivo assetlinks.json gerado deve ser hospedado em:

https://yoursite.com/.well-known/assetlinks.json

A Apple suporta Universal Links e URL Schemes.

Quando usar:

Universal Links: Para email, SMS e fontes externas
URL Schemes: Para links push ou in-app quando o aplicativo está aberto

Configurar Universal Links:

No Xcode → selecione o target → Signing & Capabilities → adicione Associated Domains
Adicione o domínio como applinks:yourdomain.com

O SDK iOS do OneSignal usa openURL para Launch URL. Isso redireciona primeiro para o navegador, depois de volta para o aplicativo.Para suprimir isso:

Use data em vez de url na API
Ou adicione OneSignal_suppress_launch_urls ao Info.plist como um Boolean com valor YES Mais informações

Lógica do AppDelegate:

func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
  if userActivity.activityType == NSUserActivityTypeBrowsingWeb,
     let webpageURL = userActivity.webpageURL {
    print("Received Universal Link: \(webpageURL)")
  }
  return true
}

Hospede o JSON `apple-app-site-association` em:

https://your_url/.well-known/apple-app-site-association

Exemplo de arquivo:

{
  "apps": [],
  "details": [
    {
      "appID": "TEAMID.com.example.deeplink",
      "paths": ["*"]
    }
  ]
}

Hospedar os arquivos de verificação

// Exemplo de servidor Node
const http = require('http');
const url = require('url');

http.createServer((req, res) => {
  const path = url.parse(req.url).pathname;
  if (path === '/.well-known/assetlinks.json') {
    res.writeHead(200, {'Content-Type': 'application/json'});
    res.end(JSON.stringify([{
      relation: ["delegate_permission/common.handle_all_urls"],
      target: {
        namespace: "android_app",
        package_name: "com.example.deeplink",
        sha256_cert_fingerprints: ["8A:4C:3D:..."]
      }
    }]));
  } else if (path === '/.well-known/apple-app-site-association') {
    res.writeHead(200, {'Content-Type': 'application/json'});
    res.end(JSON.stringify({
      applinks: {
        apps: [],
        details: [{ appID: "TEAMID.com.example.deeplink", paths: ["*"] }]
      }
    }));
  } else {
    res.writeHead(404);
    res.end('Not Found');
  }
}).listen(3000);

Enviar com deeplinks

Send push notification with deeplinks
Send email with deep links
Send in-app messages with deep links

Inclua o deep link como:

Propriedade url (Launch URL)
Ou propriedade data (recomendado para iOS para suprimir redirecionamento do navegador)

Comportamento:

Android: Abre diretamente para a activity vinculada
iOS: Abre o navegador, depois o aplicativo (a menos que seja suprimido com flag plist)

Enviar email com deep links

Por padrão, links de email usam o rastreamento do OneSignal, que altera a URL e quebra o deep linking.

Para suportar deep linking:

Desabilite o rastreamento de links no dashboard (Track link clicks)
Ou defina disable_email_click_tracking: true na API

Track link clicks está desabilitado.

Tradeoff:

Você perde métricas de cliques em Relatórios de Email

Matriz de comportamento:

Cenário	Resultado
iOS + Safari + Universal Link + Tracking Habilitado	Abre Safari, pergunta para abrir app
iOS + Safari + Universal Link + Tracking Desabilitado	Abre app diretamente
iOS + Não-Safari + Universal Link	Abre App Store
Android + Universal Link ou App Link	Pode abrir App Store se não instalado
Android + App Link + Tracking Desabilitado	Abre app diretamente
Android + App Link + Tracking Habilitado	Abre navegador primeiro, depois app

Editor drag-and-drop:

Use Custom Action ID
Defina o URI do deep link como Action Name

Editor HTML:

Use Click Name

Use event listener:

OneSignal.getInAppMessages().addClickListener(event -> {
  if ("https://your_url_here".equals(event.getResult().getActionId())) {
    // Redirecionar usuário
  }
});

Primeiros passos & configurações

Canais de mensagem

Jornadas

Público & eventos personalizados

Análises & Integrações

Privacidade & Segurança

Visão geral

Configuração Android

Etapas:

Exemplo de Manifest:

Exemplo de manipulador de Activity:

Quando usar:

Configurar Universal Links:

Lógica do AppDelegate:

Hospede o JSON `apple-app-site-association` em:

Hospedar os arquivos de verificação

Enviar com deeplinks

Enviar email com deep links

Para suportar deep linking:

Matriz de comportamento:

Editor drag-and-drop:

Editor HTML:

Use event listener:

Primeiros passos & configurações

Canais de mensagem

Jornadas

Público & eventos personalizados

Análises & Integrações

Privacidade & Segurança

​Visão geral

​Configuração Android

​Etapas:

​Exemplo de Manifest:

​Exemplo de manipulador de Activity:

​Quando usar:

​Configurar Universal Links:

​Lógica do AppDelegate:

​Hospede o JSON apple-app-site-association em:

​Hospedar os arquivos de verificação

​Enviar com deeplinks

​Enviar email com deep links

​Para suportar deep linking:

​Matriz de comportamento:

​Editor drag-and-drop:

​Editor HTML:

​Use event listener:

Visão geral

Configuração Android

Etapas:

Exemplo de Manifest:

Exemplo de manipulador de Activity:

Quando usar:

Configurar Universal Links:

Lógica do AppDelegate:

Hospede o JSON `apple-app-site-association` em:

Hospedar os arquivos de verificação

Enviar com deeplinks

Enviar email com deep links

Para suportar deep linking:

Matriz de comportamento:

Editor drag-and-drop:

Editor HTML:

Use event listener: