创建简短的推荐人链接

生成简短、可共享的推荐人链接，以实现用户到用户归因并跟踪来自有机推荐的应用程序安装。

概述

什么是推荐人短链接

短链接将冗长、充满参数的奇异链接转换为紧凑、安全的 URL，便于通过短信、社交媒体或应用程序内的邀请进行分享。

动态创建短链接，以便用户与朋友分享，邀请他们下载和使用您的应用程序。每个短链接都会跟踪推荐用户，使您能够衡量病毒式增长，并将新安装归功于特定的拥护者。

实施要求

所需组件

在创建推荐人短链接之前，请先收集这些元素：

• 单一链接：引导用户下载应用程序的基本跟踪链接。有关设置说明，请参阅奇异链接常见问题
• 动态参数：用于为链接添加上下文的可选自定义参数。查看跟踪链接参数中的可用选项
• 推荐人信息：分享链接的用户的姓名和 ID，以便将新安装归因于推荐人

SDK 方法

创建推荐人短链接

生成带有自定义参数和成功与错误状态回调处理程序的短链接。

方法签名：

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

参数：

• baseLink：原始奇异跟踪链接 URL
• referrerName：引用用户的显示名称：引用用户的显示名称
• referrerId：推荐用户的唯一标识符
• 参数：包含附加动态参数的 JSONObject（可选
• handler：带有onSuccess和onError 方法的回调接口

使用示例

创建一个带有自定义参数的短链接，并在成功回调中实现共享逻辑。

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

实施最佳实践

错误处理

在onError 回调中实施强大的错误处理，以管理网络故障、无效参数或服务器问题。

• 重试逻辑：针对瞬时网络错误实施指数回退
• 用户反馈：链接创建失败时显示清晰的错误信息
• 回退选项：提供其他共享方式（例如，如果短链接创建失败，则共享完整的奇异链接
• 验证：在调用createReferrerShortLink 之前验证参数，以便及早发现问题

跟踪和分析

利用推荐人信息建立病毒循环并衡量有机增长。

链接过期

在分享策略中规划 30 天的链接生命周期。

常用案例

应用内推荐计划

让用户可以通过个性化推荐链接直接从应用中邀请朋友。

• 奖励系统：跟踪推荐并奖励成功注册朋友的用户
• 社交分享：与用于短信、WhatsApp、电子邮件和社交媒体的 Android Share Sheet 集成
• 个人邀请：在共享信息中包含推荐人姓名，实现个性化

用户生成的内容

当用户生成想要与他人分享的内容时，创建可分享链接。

• 内容归因：跟踪哪些内容推动了最多的应用安装
• 创作者识别：将新用户归属于内容创作者，实现游戏化
• 活动标签：根据内容类型或类别添加动态参数

活动邀请

为活动邀请函生成唯一链接，跟踪哪些与会者带来了新用户。

• 活动背景：在链接参数中包含活动 ID 和详细信息
• 与会者跟踪：衡量活动之间的病毒传播
• 网络效应：识别转换率最高的活动