Implementação de ligações diretas

Documento

Guia de integração do SDK do Unreal Engine

Guia para Desenvolvedores Registro de alterações
Pré-requisitos
Compatibilidade Unreal Engine 4.23+
Guias de integração
  1. Integração básica
  2. Acompanhamento de eventos e receita
  3. Implementação de links profundos
  4. Adicionando suporte a SKAdNetwork
  5. Opções avançadas

Introdução

Deep links são links que levam a um conteúdo específico dentro de um aplicativo. Quando um utilizador clica numa ligação profunda num dispositivo que tem a aplicação instalada, a aplicação abre-se 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 como:

  1. Acessar o link de rastreamento que levou seu aplicativo a ser aberto,
  2. Ler o destino do link direto e
  3. Mostrar o conteúdo apropriado.

Observações:

  • Este artigo pressupõe que sua organização está usando Singular Links - a nova tecnologia de link de rastreamento da Singular, lançada em 2019. Os clientes mais antigos do Singular podem estar usando os links de rastreamento mais antigos do Singular (links herdados). Para dar suporte a links diretos com links herdados, consulte Manipulação de links diretos com links herdados.
  • Os destinos de deep link para seu aplicativo precisam ser configurados na página Aplicativos no Singular (consulte Configurando 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 habilitar o deep linking.


Manipulação de links diretos

O SDK do Singular 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 para 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:


  // Add to the include section of your app

  #include "SingularLinkParams.h"
  #include "SingularDelegates.h"
  
  // Add this method to your class

  void YourClass::SingularLinksResolved(const FSingularLinkParams& linkParams) { 
const FString deeplink = linkParams.SingularLinksParams["deeplink"];
  const FString passthrough = linkParams.SingularLinksParams["passthrough"];
  const bool isDeferred = linkParams.SingularLinksParams["isDeferred"];
  }
  
  ...
  // Call this code before calling initialize

  USingularDelegates* singularDelegates =
  CreateDefaultSubobject<USingularDelegates>(TEXT("SingularLinksHandler"));
  singularDelegates->OnSingularLinksResolved.AddDynamic(this, &YourClass::SingularLinksResolved);
  ...
  

Detalhes do método SingularLinksResolved
Descrição Método de retorno para links singulares. Lê os detalhes do link de rastreamento e processa-os.
Assinatura
public void OnSingularLinksResolved(const FSingularLinkParams& linkParams)

Nota: 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.