Criação de links de referência curtos

Gere links de referência curtos e compartilháveis que permitem a atribuição de usuário a usuário e rastreiam instalações de aplicativos a partir de referências orgânicas.

Visão geral

O que são links curtos de referência

Os links curtos transformam os Singular Links longos e cheios de parâmetros em URLs compactos e seguros, convenientes para partilhar por SMS, redes sociais ou convites na aplicação.

Crie links curtos de forma dinâmica para que os utilizadores possam partilhá-los com amigos e convidá-los a descarregar e utilizar a sua aplicação. Cada link curto rastreia o utilizador que o referiu, permitindo-lhe medir o crescimento viral e atribuir novas instalações a defensores específicos.

Requisitos de implementação

Componentes necessários

Reúna estes elementos antes de criar um link curto de referência:

• Link único: Um link de rastreamento básico que direciona os usuários para o download do seu aplicativo. Consulte as Perguntas frequentes sobre links singularespara obter instruções de configuração
• Parâmetros dinâmicos: Parâmetros personalizados opcionais para adicionar contexto ao link. Veja as opções disponíveis em Parâmetros do link de rastreamento
• Informações do referenciador: Nome e ID do utilizador que partilha o link para permitir a atribuição de novas instalações ao referenciador

Método SDK

createReferrerShortLink

Gera um link de referência curto com parâmetros personalizados e manipuladores de retorno de chamada para estados de sucesso e erro.

Assinatura do método:

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

Parâmetros:

• baseLink: O URL original do link de rastreamento Singular
• referrerName: Nome de exibição do usuário de referência
• referrerId: Identificador único para o utilizador de referência
• parâmetros: JSONObject que contém parâmetros dinâmicos adicionais (opcional)
• handler: Interface de retorno de chamada com os métodos onSuccesse onError

Exemplo de utilização

Crie uma ligação curta com parâmetros personalizados e implemente a lógica de partilha no callback de sucesso.

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();
        }
    }
);

Melhores práticas de implementação

Tratamento de erros

Implemente um tratamento de erros robusto na chamada de retorno onError para gerenciar falhas de rede, parâmetros inválidos ou problemas de servidor.

• Lógica de repetição: Implementar backoff exponencial para erros de rede transitórios
• Feedback do utilizador: Exibir mensagens de erro claras quando a criação de links falhar
• Opção de retorno: Fornecer métodos de partilha alternativos (por exemplo, partilhar a Ligação Singular completa se a criação de uma ligação curta falhar)
• Validação: Verificar os parâmetros antes de chamar createReferrerShortLink para detetar problemas antecipadamente

Controlo e análise

Aproveite as informações do referenciador para criar loops virais e medir o crescimento orgânico.

Expiração do link

Planeie o ciclo de vida do link de 30 dias na sua estratégia de partilha.

Casos de uso comuns

Programas de indicação no aplicativo

Permita que os utilizadores convidem amigos diretamente da sua aplicação com links de referência personalizados.

• Sistema de recompensa: Acompanhe as referências e recompense os utilizadores por inscrições bem sucedidas de amigos
• Partilha social: Integração com a Folha de Partilha do Android para SMS, WhatsApp, e-mail e redes sociais
• Convites pessoais: Inclua o nome do referenciador na mensagem partilhada para personalização

Conteúdo gerado pelo utilizador

Crie links partilháveis quando os utilizadores geram conteúdos que querem partilhar com outros.

• Atribuição de conteúdo: Acompanhe qual conteúdo gera mais instalações de aplicativos
• Reconhecimento do criador: Atribua novos utilizadores a criadores de conteúdos para gamificação
• Marcação de campanhas: Adicionar parâmetros dinâmicos com base no tipo ou categoria de conteúdo

Convites para eventos

Gerar links exclusivos para convites de eventos que monitorizam os participantes que trazem novos utilizadores.

• Contexto do evento: Incluir ID e detalhes do evento nos parâmetros do link
• Acompanhamento de participantes: Medir a propagação viral de evento para evento
• Efeitos de rede: Identificar eventos com as taxas de conversão mais elevadas