Creación de enlaces de referencia cortos

Genere enlaces de referencia cortos y compartibles que permitan la atribución de usuario a usuario y el seguimiento de las instalaciones de aplicaciones a partir de referencias orgánicas.

Información general

¿Qué son los enlaces de referencia cortos?

Los enlaces cortos transforman los enlaces singulares largos y llenos de parámetros en URL compactas y seguras, cómodas 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 sus amigos e invitarles a descargar y utilizar su aplicación. Cada enlace corto realiza un seguimiento del usuario que lo ha recomendado, lo que le permite medir el crecimiento viral y atribuir nuevas instalaciones a promotores específicos.

Requisitos de implementación

Componentes necesarios

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

• Enlace singular: Un enlace de seguimiento base que dirige a los usuarios a la descarga de su aplicación. Consulte las preguntas frecuentes sobre enlaces singularespara obtener instrucciones de configuración
• Parámetros dinámicos: Parámetros personalizados opcionales para añadir contexto al enlace. Ver las opciones disponibles en Parámetros del enlace de seguimiento
• Información del remitente: Nombre e ID del usuario que comparte el enlace para permitir la atribución de nuevas instalaciones al remitente.

Método SDK

createReferrerShortLink

Genera un enlace de referencia corto con parámetros personalizados y controladores de devolución de llamada para los estados de éxito y error.

Firmadel método:

Singular.createReferrerShortLink(
    String baseLink,
    String referrerName,
    String referrerId,
    JSONObject parameters,
    ShortLinkHandler handler
)

Parámetros:

• baseLink: La URL original del enlace de seguimiento de Singular
• referrerName: Nombre para mostrar del usuario remitente
• referrerId: Identificador único del usuario remitente
• parameters: JSONObject que contiene parámetros dinámicos adicionales (opcional)
• manejador: Interfaz de devolución de llamada con los métodos onSuccessy onError

Ejemplo de uso

Cree un enlace corto con parámetros personalizados e implemente la lógica de compartición en la devolución de llamada de éxito.

import org.json.JSONObject
import org.json.JSONException

// Create custom parameters for the link
val params = JSONObject()
try {
    params.put("channel", "sms")
    params.put("campaign_id", "summer_promo_2025")
    params.put("referral_type", "friend_invite")
} catch (e: JSONException) {
    Log.e("ShortLink", "Error creating parameters: ${e.message}")
}

// Generate the short referrer link
Singular.createReferrerShortLink(
    "https://sample.sng.link/D52wc/cuvk?pcn=test",  // Base Singular Link
    "John Doe",                                      // Referrer name
    "user_12345",                                    // Referrer ID
    params,                                          // Custom parameters
    object : ShortLinkHandler {
        override fun onSuccess(shortLinkURL: String) {
            Log.d("ShortLink", "Generated: $shortLinkURL")
            
            // Share the short link via Android Share Sheet
            val shareIntent = Intent(Intent.ACTION_SEND).apply {
                type = "text/plain"
                putExtra(Intent.EXTRA_TEXT, 
                    "Join me on this awesome app! $shortLinkURL")
            }
            startActivity(Intent.createChooser(shareIntent, "Share via"))
        }

        override fun onError(error: String) {
            Log.e("ShortLink", "Error creating link: $error")
            
            // Handle error - retry or show user feedback
            Toast.makeText(
                applicationContext,
                "Failed to create share link. Please try again.",
                Toast.LENGTH_SHORT
            ).show()
        }
    }
)

import org.json.JSONObject;
import org.json.JSONException;

// Create custom parameters for the link
JSONObject params = new JSONObject();
try {
    params.put("channel", "sms");
    params.put("campaign_id", "summer_promo_2025");
    params.put("referral_type", "friend_invite");
} catch (JSONException e) {
    Log.e("ShortLink", "Error creating parameters: " + e.getMessage());
}

// Generate the short referrer link
Singular.createReferrerShortLink(
    "https://sample.sng.link/D52wc/cuvk?pcn=test",  // Base Singular Link
    "John Doe",                                      // Referrer name
    "user_12345",                                    // Referrer ID
    params,                                          // Custom parameters
    new ShortLinkHandler() {
        @Override
        public void onSuccess(final String shortLinkURL) {
            Log.d("ShortLink", "Generated: " + shortLinkURL);
            
            // Share the short link via Android Share Sheet
            Intent shareIntent = new Intent(Intent.ACTION_SEND);
            shareIntent.setType("text/plain");
            shareIntent.putExtra(Intent.EXTRA_TEXT, 
                "Join me on this awesome app! " + shortLinkURL);
            startActivity(Intent.createChooser(shareIntent, "Share via"));
        }

        @Override
        public void onError(final String error) {
            Log.e("ShortLink", "Error creating link: " + error);
            
            // Handle error - retry or show user feedback
            Toast.makeText(
                getApplicationContext(),
                "Failed to create share link. Please try again.",
                Toast.LENGTH_SHORT
            ).show();
        }
    }
);

Mejores prácticas de implementación

Gestión de errores

Implemente una sólida gestión de errores en la llamada de retorno onError para gestionar fallos de red, parámetros no válidos o problemas del servidor.

• Lógica de reintentos: Implemente un reintento exponencial para errores de red transitorios.
• Comentarios del usuario: Visualización de mensajes de error claros cuando falla la creación de enlaces
• Opción alternativa: Proporcionar métodos alternativos para compartir (por ejemplo, compartir el enlace singular completo si falla la creación del enlace corto).
• Validación: Verifique los parámetros antes de llamar a createReferrerShortLink para detectar problemas con antelación.

Seguimiento y análisis

Aproveche la información de los remitentes para crear bucles virales y medir el crecimiento orgánico.

Caducidad de enlaces

Planifique el ciclo de vida de los enlaces de 30 días en su estrategia de compartición.

Casos de uso comunes

Programas de recomendación dentro de la aplicación

Permite a los usuarios invitar a amigos directamente desde tu aplicación con enlaces de recomendación personalizados.

• Sistema de recompensas: Realice un seguimiento de las recomendaciones y recompense a los usuarios por las inscripciones exitosas de amigos.
• Compartir en redes sociales: Integración con Android Share Sheet para SMS, WhatsApp, correo electrónico y redes sociales.
• Invitaciones personales: incluye el nombre del recomendante en el mensaje compartido para personalizarlo.

Contenido generado por el usuario

Cree enlaces compartibles cuando los usuarios generen contenido que quieran compartir con otros.

• Atribución de contenidos: Rastrea qué contenido impulsa más instalaciones de aplicaciones
• Reconocimiento de creadores: Atribuya los nuevos usuarios a los creadores de contenidos para la gamificación.
• Etiquetado de campañas: Añada parámetros dinámicos basados en el tipo o la categoría del contenido

Invitaciones a eventos

Genere enlaces únicos para invitaciones a eventos que realicen un seguimiento de los asistentes que traen nuevos usuarios.

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