Unreal Engine SDK: Implementação de Deep Linking

Introdução

Deep links são links que levam a um conteúdo específico dentro de um aplicativo. Quando um usuário clica em um link profundo em um dispositivo que tem o aplicativo instalado, o aplicativo é aberto e mostra um produto ou uma experiência específica.

Os links de rastreamento singulares podem incluir links diretos, bem como links diretos diferidos(consulte nossas Perguntas frequentes sobre links diretos e as Perguntas frequentes sobre links singulares para obter mais informações).

As instruções abaixo mostrarão a você como:

  1. Acessar o link de rastreamento que levou à abertura do seu aplicativo,
  2. Ler o destino do deep link e
  3. Mostrar o conteúdo apropriado.

Observações:

  • Este artigo pressupõe que sua organização esteja usando o Singular Links- a nova tecnologia de links de rastreamento da Singular, lançada em 2019. Os clientes mais antigos da Singular podem estar usando os links de rastreamento mais antigos da Singular (links herdados). Para oferecer suporte a deep linking com links herdados, consulte Manipulação de deep links com links herdados.
  • Os destinos de deep link para seu aplicativo precisam ser configurados na página Aplicativos na Singular (consulte Configuração de URLs de deep link).

Pré-requisitos do Deep Linking

Configuração de iOS e Android

Siga as instruções em Pré-requisitos do Singular Links para ativar o deep linking.

Manipulação de deep links

O Singular SDK fornece um mecanismo de manipulador para ler os detalhes do link de rastreamento que levou à abertura do aplicativo.

Para usar o manipulador:

  1. Implemente a interface OnSingularLinkResolved.
  2. Registre o delegado OnSingularLinkResolved antes de inicializar o Singular SDK para registrar a classe como o manipulador de deep links.
  3. Quando você inicializa o Singular SDK, ele obtém o link de rastreamento e chama o método OnSingularLinkResolved, passando os detalhes do link de rastreamento para ele. Substitua esse método para ler os detalhes do link e processá-los.

O código de exemplo a seguir mostra as três etapas:


  // Adicione à seção de inclusão do seu aplicativo
  #include "SingularLinkParams.h"
  #include "SingularDelegates.h"
  
  // Adicione este método à sua classe
  void YourClass::SingularLinksResolved(const FSingularLinkParams& linkParams) { 
const FString deeplink = linkParams.SingularLinksParams["deeplink"]; const FString passthrough = linkParams.SingularLinksParams["passthrough"]; const bool isDeferred = linkParams.SingularLinksParams["isDeferred"]; } ... // Chame este código antes de chamar inicializar USingularDelegates* singularDelegates = CreateDefaultSubobject<USingularDelegates>(TEXT("SingularLinksHandler")); singularDelegates->OnSingularLinksResolved.AddDynamic(this, &YourClass::SingularLinksResolved); ...
Detalhes do método SingularLinksResolved
Descrição Método de retorno de chamada para Singular Links. Lê os detalhes do link de rastreamento e os processa.
Assinatura
public void OnSingularLinksResolved(const FSingularLinkParams& linkParams)

Observação: O objeto FSingularLinkParams contém os seguintes valores:

  • Deeplink - O destino do deep link, conforme configurado na página Gerenciar links na plataforma Singular.
  • Passthrough - Parâmetros de passagem adicionados ao link, se houver.
  • IsDeferred - O link está configurado como um deep link diferido.