Unreal Engine SDK: Implementación de enlaces profundos

Introducción

Los enlaces profundos son enlaces que llevan a un contenido específico dentro de una aplicación. Cuando un usuario hace clic en un enlace profundo en un dispositivo que tiene instalada la aplicación, ésta se abre y muestra un producto o experiencia específicos.

Los enlaces de seguimiento singulares pueden incluir enlaces profundos, así como enlaces profundos diferidos(consulte nuestras Preguntas frecuentes sobre enlaces profundos y las Preguntas frecuentes sobre enlaces singulares para obtener más información).

Las siguientes instrucciones le mostrarán cómo:

  1. Acceder al enlace de seguimiento que condujo a la apertura de su aplicación,
  2. Leer el destino del enlace profundo, y
  3. Mostrar el contenido apropiado.

Notas:

  • Este artículo asume que su organización está utilizando Singular Links- la nueva tecnología de enlaces de seguimiento de Singular, lanzada en 2019. Los clientes más antiguos de Singular pueden estar utilizando los enlaces de seguimiento más antiguos de Singular (enlaces heredados). Para admitir enlaces profundos con enlaces heredados, consulte Manejo de enlaces profundos con enlaces heredados.
  • Los destinos de enlaces profundos para su aplicación deben configurarse en la página Apps en Singular (consulte Configuración de URL de enlaces profundos).

Requisitos previos para enlaces profundos

Configuración para iOS y Android

Siga las instrucciones de Singular Links Prerequisites para habilitar la vinculación profunda.

Manejo de enlaces profundos

Singular SDK proporciona un mecanismo de gestión para leer los detalles del enlace de seguimiento que ha llevado a la apertura de la aplicación.

Para utilizar este mecanismo

  1. Implemente la interfaz OnSingularLinkResolved.
  2. Regístrese en el delegado OnSingularLinkResolved antes de inicializar Singular SDK para registrar la clase como gestor de enlaces profundos.
  3. Al inicializar Singular SDK, éste obtiene el enlace de seguimiento y llama al método OnSingularLinkResolved, pasándole los detalles del enlace de seguimiento. Anule este método para leer los detalles del enlace y procesarlos.

El siguiente código de ejemplo muestra los tres pasos:


  // Agregar a la sección de inclusión de su aplicación
  #include "SingularLinkParams.h"
  #include "SingularDelegates.h"
  
  // Agrega este método a tu clase
  void YourClass::SingularLinksResolved(const FSingularLinkParams& linkParams) { 
const FString deeplink = linkParams.SingularLinksParams["deeplink"]; const FString passthrough = linkParams.SingularLinksParams["passthrough"]; const bool isDeferred = linkParams.SingularLinksParams["isDeferred"]; } ... // Llame a este código antes de llamar a inicializar USingularDelegates* singularDelegates = CreateDefaultSubobject<USingularDelegates>(TEXT("SingularLinksHandler")); singularDelegates->OnSingularLinksResolved.AddDynamic(this, &YourClass::SingularLinksResolved); ...
Detalles del método SingularLinksResolved
Descripción Método de devolución de llamada para Singular Links . Lee los detalles del enlace de seguimiento y los procesa.
Firma
public void OnSingularLinksResolved(const FSingularLinkParams& linkParams)

Nota: El objeto FSingularLinkParams contiene los siguientes valores:

  • Deeplink - El destino del enlace profundo, tal como se ha configurado en la página Gestionar enlaces de la plataforma Singular.
  • Passthrough - Parámetros passthrough añadidos al enlace, si los hay.
  • IsDeferred - Si el enlace está configurado como enlace profundo diferido.
Singular Unreal Engine SDK
Guías de integración
  1. Integración básica
  2. Seguimiento de eventos e ingresos
  3. Implementación de enlaces profundos
  4. Añadir soporte SKAdNetwork
  5. Opciones avanzadas