Creación de enlaces cortos de referencia

Genere enlaces cortos de referencia que se puedan compartir y que habiliten la atribución de usuario a usuario y rastreen las instalaciones de aplicaciones desde referencias orgánicas.

Descripción general

Qué son los enlaces cortos de referencia

Los enlaces cortos transforman los Singular Links largos y llenos de parámetros en URL compactas y seguras, convenientes para compartir a través de SMS, redes sociales o invitaciones dentro de la aplicación.

Cree enlaces cortos de forma dinámica para que los usuarios puedan compartirlos con amigos para invitarlos a descargar y usar su aplicación. Cada enlace corto rastrea al usuario referente, lo que le permite medir el crecimiento viral y atribuir nuevas instalaciones a defensores específicos.

Requisitos de implementación

Componentes requeridos

Reúna estos elementos antes de crear un enlace corto de referencia:

• Singular Link: Un enlace de seguimiento base que dirige a los usuarios a la descarga de su aplicación. Consulte Singular Links FAQ para obtener instrucciones de configuración
• Parámetros dinámicos: Parámetros personalizados opcionales para agregar contexto al enlace. Vea las opciones disponibles en Tracking Link Parameters
• Información del referente: Nombre e ID del usuario que comparte el enlace para habilitar la atribución de las nuevas instalaciones al referente

Método del SDK

createReferrerShortLink

Genere un enlace corto de referencia con parámetros personalizados y handlers de callback para estados de éxito y error.

Firma del método:

+ (void)createReferrerShortLink:(NSString *)baseLink
                   referrerName:(NSString *)referrerName
                     referrerId:(NSString *)referrerId
              passthroughParams:(NSDictionary *)passthroughParams
              completionHandler:(void(^)(NSString *, NSError *))completionHandler;

Parámetros:

• baseLink: La URL del enlace de seguimiento original de Singular
• referrerName: Nombre visible del usuario referente
• referrerId: Identificador único del usuario referente
• passthroughParams: NSDictionary que contiene parámetros dinámicos adicionales (opcional)
• completionHandler: Bloque de callback con la cadena del enlace corto y los parámetros de error

Ejemplo de uso

Cree un enlace corto con parámetros personalizados e implemente la lógica de compartir en el handler de finalización.

// Define your Singular tracking link as the base link
let referrerBaseLink = "https://yourdomain.sng.link/Csfge/aknl?_dl=myscheme%3A%2F%2Fmydeeplink/referrer&_smtype=3"

// Get referrer information from user input
let referrerID = referrerIDField.text ?? "unknown_user"
let referrerName = referrerNameField.text ?? "Anonymous"

// Add custom passthrough parameters
let passthroughParams: [String: Any] = [
    "channel": "sms",
    "campaign_id": "summer_promo_2025",
    "referral_type": "friend_invite"
]

// Generate the short referrer link
Singular.createReferrerShortLink(
    referrerBaseLink,
    referrerName: referrerName,
    referrerId: referrerID,
    passthroughParams: passthroughParams
) { shortLink, error in

    if let error = error {
        // Handle error - retry or show user feedback
        print("Error creating short link: \(error.localizedDescription)")

        // Show error message to user
        let alert = UIAlertController(
            title: "Error",
            message: "Failed to create share link. Please try again.",
            preferredStyle: .alert
        )
        alert.addAction(UIAlertAction(title: "OK", style: .default))
        self.present(alert, animated: true)
        return
    }

    if let shortLink = shortLink, !shortLink.isEmpty {
        // Share the short link via iOS Activity Controller
        let shareText = "Join me on this awesome app! \(shortLink)"
        let activityVC = UIActivityViewController(
            activityItems: [shareText],
            applicationActivities: nil
        )

        // For iPad: set popover presentation controller
        if let popover = activityVC.popoverPresentationController {
            popover.sourceView = self.view
            popover.sourceRect = CGRect(x: self.view.bounds.midX,
                                       y: self.view.bounds.midY,
                                       width: 0,
                                       height: 0)
            popover.permittedArrowDirections = []
        }

        self.present(activityVC, animated: true)
    }
}

// Define your Singular tracking link as the base link
NSString *referrerBaseLink = @"https://yourdomain.sng.link/Csfge/aknl?_dl=myscheme%3A%2F%2Fmydeeplink/referrer&_smtype=3";

// Get referrer information from user input
NSString *referrerID = self.referrerIDField.text ?: @"unknown_user";
NSString *referrerName = self.referrerNameField.text ?: @"Anonymous";

// Add custom passthrough parameters
NSDictionary *passthroughParams = @{
    @"channel": @"sms",
    @"campaign_id": @"summer_promo_2025",
    @"referral_type": @"friend_invite"
};

// Generate the short referrer link
[Singular createReferrerShortLink:referrerBaseLink
                     referrerName:referrerName
                       referrerId:referrerID
                passthroughParams:passthroughParams
                completionHandler:^(NSString *shortLink, NSError *error) {

    if (error) {
        // Handle error - retry or show user feedback
        NSLog(@"Error creating short link: %@", error.localizedDescription);

        // Show error message to user
        UIAlertController *alert = [UIAlertController
            alertControllerWithTitle:@"Error"
            message:@"Failed to create share link. Please try again."
            preferredStyle:UIAlertControllerStyleAlert];
        [alert addAction:[UIAlertAction actionWithTitle:@"OK"
            style:UIAlertActionStyleDefault
            handler:nil]];
        [self presentViewController:alert animated:YES completion:nil];
        return;
    }

    if (shortLink && ![shortLink isEqualToString:@""]) {
        // Share the short link via iOS Activity Controller
        NSString *shareText = [NSString stringWithFormat:@"Join me on this awesome app! %@", shortLink];
        UIActivityViewController *activityVC = [[UIActivityViewController alloc]
            initWithActivityItems:@[shareText]
            applicationActivities:nil];

        // For iPad: set popover presentation controller
        if (activityVC.popoverPresentationController) {
            activityVC.popoverPresentationController.sourceView = self.view;
            activityVC.popoverPresentationController.sourceRect = CGRectMake(
                CGRectGetMidX(self.view.bounds),
                CGRectGetMidY(self.view.bounds),
                0, 0
            );
            activityVC.popoverPresentationController.permittedArrowDirections = 0;
        }

        [self presentViewController:activityVC animated:YES completion:nil];
    }
}];

Mejores prácticas de implementación

Manejo de errores

Implemente un manejo robusto de errores en el handler de finalización para gestionar fallas de red, parámetros no válidos o problemas del servidor.

• Lógica de reintento: Implemente retroceso exponencial para errores de red transitorios
• Comentarios del usuario: Muestre mensajes de error claros cuando falle la creación del enlace
• Opción de respaldo: Proporcione métodos alternativos de compartir (por ejemplo, compartir el Singular Link completo si falla la creación del enlace corto)
• Validación: Verifique los parámetros antes de llamar createReferrerShortLink para detectar problemas con anticipación

Seguimiento y análisis

Aproveche la información del referente para construir bucles virales y medir el crecimiento orgánico.

Expiración del enlace

Planifique el ciclo de vida del enlace de 30 días en su estrategia de compartir.

Casos de uso comunes

Programas de referencias dentro de la aplicación

Permita que los usuarios inviten a sus amigos directamente desde su aplicación con enlaces de referencia personalizados.

• Sistema de recompensas: Rastree las referencias y recompense a los usuarios por los registros exitosos de amigos
• Compartir en redes sociales: Intégrese con iOS Activity Controller para Messages, Mail y redes sociales
• Invitaciones personales: Incluya el nombre del referente en el mensaje compartido para personalización

Contenido generado por el usuario

Cree enlaces que se puedan compartir cuando los usuarios generen contenido que deseen compartir con otros.

• Atribución de contenido: Rastree qué contenido genera la mayor cantidad de instalaciones de aplicaciones
• Reconocimiento del creador: Atribuya nuevos usuarios a los creadores de contenido para gamificación
• Etiquetado de campañas: Agregue parámetros dinámicos según el tipo o categoría de contenido

Invitaciones a eventos

Genere enlaces únicos para invitaciones a eventos que rastreen qué asistentes traen nuevos usuarios.

• Contexto del evento: Incluya el ID del evento y los detalles en los parámetros del enlace
• Seguimiento de asistentes: Mida la propagación viral de evento a evento
• Efectos de red: Identifique los eventos con las tasas de conversión más altas