Alau.me 2.1.2

Alau.me 2.1.2

×

测试已测试✗
Lang语言 Obj-CObjective C
许可证 商业
发布最后发布2014年12月

由 Christoph Zelazowski 维护。

Alau.me 2.1.2

  • 由
  • Lumen Spark

Alau.me SDK

Alau.me 是一款 iOS 应用推荐跟踪 API。它允许您在 App Store 中创建指向您应用的短推荐链接并跟踪由此产生的应用安装。

您可以为特定的广告活动创建短链接，或者为每个用户创建独特的链接并跟踪用户间的推荐。

Alau.me 可以跟踪打开链接的人数，以及有多少人继续下载并使用应用。它扩展到数百万用户，截至 2014 年 5 月，已有 300 多个应用在使用。

使用方法

  • 创建一个免费的 Alau.me 账户。

  • 设置推荐链接属性为您的应用 iTunes URL 或自定义落地页面。

  • 将 Alau.me.framework 添加到您的 XCode 项目中（请参阅下方的安装说明）。

  • 将 #import <Alaume/AMConnect.h> 语句添加到您的 AppDelegate.h 文件中。

  • 在您的应用委托的 application:didFinishLaunchingWithOptions: 方法中初始化 Alau.me。

    AMConnect *alaume = [AMConnect sharedInstance];

// For debugging purposes only
alaume.isLoggingEnabled = YES;

// Substitute with your own keys; the values below will result in error
[alaume initializeWithAppId:@"px" apiKey:@"8f609af737964c5490025c03462d7318"];

  • 在 活动 页面上创建一个测试推荐链接（点击“添加自定义推荐链接”）。

  • 使用自定义推荐链接跟踪下载，例如 http://alau.me/px5d34Sd。

注意：每个用户都会自动获得一个独特的推荐链接。您可以利用这些链接跟踪用户间的推荐。自定义推荐链接可以用于特定的广告活动或用于联盟跟踪。

如何测试

  • 将推荐链接复制到您的测试设备并打开它（您将被重定向到 App Store）

  • 安装并运行您的应用

假设您之前从未在测试设备上安装过您的应用，Total Referral Count 将增加 1（请参见 活动 页面）。如果您正在使用自定义推荐链接，您还将看到链接打开的次数以及相应的下载次数。

如果您之前已经在测试设备上运行过您的应用，Alau.me 不会将那次安装计为推荐。在这种情况下，您需要注销该测试设备，以便 Alau.me 将其视为新设备。以下是如何操作的：

  • 运行您的应用并打印出 [AMConnect sharedInstance].referralLink 属性的值

  • 使用该链接在第 活动 页面上将您的设备注册为测试设备

  • 每次您想在该设备上测试推荐时都点击注销按钮

故障排除：如果您看不到任何推荐，那么可能是您的 AMConnect 实例没有被正确地用正确的 App ID 和 API 密钥初始化，或者您的应用之前已经在您的测试设备上运行过。如果您有任何问题，请随时通过电子邮件联系我们：[email protected]。

要求

iOS 7.0 及以上版本。

安装

如果您不使用 CocoaPods，请执行以下操作

  • 下载 此存储库的 ZIP 文件

  • 将 Alau.me.framework 复制到您的项目中的一个文件夹中

  • 将 Alau.me.framework 从 Finder 拖动到 Xcode 项目的 Frameworks 组中

  • 将 Security.framework 添加到您的项目中

常见问题

它如何工作？

Alau.me 使用 IP 地址匹配来跟踪推荐。为了使推荐注册，推荐链接和刚安装的应用必须在同一 IP 地址上，相隔不超过一小时。当然，IP 地址并非独一无二。在 NAT 场景中，许多用户共享相同的公网可见地址。然而，随机用户在相同的 IP 地址背后打开推荐链接和下载对应应用的几率非常低，即使在每天有 50,000 多次下载的非常受欢迎的应用也是如此。因此，在实际操作中，Alau.me 非常准确。

如何识别应用？

当与 Alau.me 集成的应用程序首次运行时，Alau.me 创建一个 UUID 并将其存储在应用程序的密钥链中。该 UUID 用于将该应用程序的特定实例注册到 Alau.me 服务。如果您删除并重新安装应用程序，将使用相同的 UUID（因为当应用程序被删除时，密钥链中的数据会持续存在），因此该应用程序将被计为现有安装。

常见任务

获取用户特定的推荐链接

Alau.me 会为系统中的每台设备自动创建推荐链接。您可以通过调用 referralLink 属性来获取它，并让用户与朋友分享。如果设备尚未注册，此方法将返回 nil。您的设备在首次启动时会自动注册。如果由于任何原因（例如连接问题）失败，Alau.me 将在每次将应用程序带到前台时重试一次。

AMConnect *alaume = [AMConnect sharedInstance];
NSString *referralLink = alaume.referralLink;

确定被推荐用户数量

referralCount 属性返回由此用户的推荐链接推荐的用户数量。此属性可用于分析目的或奖励您的用户。例如，如果用户推荐了一定数量的人下载您的应用程序，您可以解锁高级功能。

AMConnect *alaume = [AMConnect sharedInstance];
int referralCount = alaume.referralCount;

确定用户是否被别人推荐

您可以使用 wasReferred 属性来确定某个设备上您的应用程序是否被推荐安装。如果设备尚未注册，此方法将返回 NO。使用 referredBy 方法来确定推荐用户的推荐 ID。

AMConnect *alaume = [AMConnect sharedInstance];
BOOL wasReferred = alaume.wasReferred;

确定设备是否在Alau.me上注册

如上所述，设备注册会在初始化AMConnect时自动发生。您可以通过isRegistered属性来验证您的设备是否已注册。

AMConnect *alaume = [AMConnect sharedInstance];
BOOL isRegistered = alaume.isRegistered;

刷新推荐属性

以下属性在本地缓存并从服务器自动刷新，每天最多刷新一次：referralCount（推荐数量）、rewardPoints（奖励积分）、pointsPerReferral（每推荐获得的点数）、cashPerReferral（每推荐获得的现金）、pointsRequiredToRedeem（兑换所需点数）和endDate（结束日期）。

您可以根据需要刷新这些属性，例如，每次显示您的推荐项目UI时，可以通过调用[AMConnect beginRewardStatusCheckWithDelegate:didFinishSelector:]方法。

- (void)refreshReferralProperties
{
    [[AMConnect sharedInstance] beginRewardStatusCheckWithDelegate:self 
        didFinishSelector:@selector(didFinishRewardStatusCheckWithError:)];
}

- (void)didFinishRewardStatusCheckWithError:(NSError*)error
{
    // Update the UI
}

作者

Lumen Spark LLC，华盛顿州西雅图，[email protected]

许可

Alau.me 在商业许可下可用。请参阅使用条款和价格。