Mage 1.1.1

Mage 1.1.1

×

由Patrick Blaesing维护。

Mage 1.1.1

Mage iOS SDK

全球产品分销不应是一劳永逸的策略。从使用Mage开始，将您的产品扩展到全球！

Version License Platform

在实施SDK之前，请先在我们的网站上阅读并完成 集成指南。

示例

要运行示例项目，请克隆仓库，然后从Example目录首先运行 pod install

要求

请注意，我们的SDK目前仅支持iOS 11及以上版本。

安装

Mage可以通过CocoaPods获得。要安装它，只需将以下行添加到您的Podfile

pod 'Mage'

如何在您的iOS项目中使用Mage

1) 在AppDelegate.m中设置API密钥

#import <Mage/Mage.h>
// ...
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{
  // ...
  [[Mage sharedInstance] setOptions:@{
    // Set your API key
    @"apiKey": @"YOUR_API_KEY",
    // Indicate if your app is running on a consumer device.
    // Please not that production should not be set to true if your app runs on real testing devices!
    // Default: false
    @"production": @(TRUE),
    // Optional: strict mode. The SDK will crash when errors occur.
    // This way you can test if you set up the SDK correctly!
    // Default: false
    @"strict": @(FALSE)
  }];
  // ...
}

2) 获取您的内购ID

在显示内购的地方，调用getIdFromProductName以获取正确的内购ID。例如，在您的商店视图/弹出视图中。

// Get the correct in app purchase id to show to the user
// In some cases (no internet connection) the method won't return anything so defining a fallback is not a bad idea!
NSString *myInAppPurchaseID = [[Mage sharedInstance] getIdFromProductName:@"MyProduct" withFallback:@"com.myapp.fallbackID"]

3) 了解您售出了什么

在某些情况下，您可能想了解用户购买了什么，以便将其发送到CRM、您的后端或您应用中的一些自定义逻辑。使用getProductNameFromId将有助于您实现这一目标！

// Get the correct in app purchase id to show to the user
[[Mage sharedInstance] getProductNameFromId:@"com.myapp.someIapID" completionHandler:^(NSError * _Nonnull err, NSString * _Nonnull productName) {
  if(!err){
    NSLog(@"User bought: %@", productName);
  }
}];

4) 为我们的订阅生命周期价值跟踪识别用户（可选）

订阅状态跟踪通常在您的后端或某些第三方服务中完成。Apple或Google发送实时订阅状态更新，您对其进行解释并采取措施。这就是我们为什么提供了一个简单的Web API来为Mage启用订阅生命周期价值跟踪的原因。Apple或Google联系您的后端，您的后端联系Mage。

这样，我们就可以充分跟踪您订阅的持续时间，并识别免费试用和 introductory 价格优惠的转换率。为了使该功能工作，您需要实现setUserIdentifier方法，这样我们就可以识别来自您的后端的调用。有关我们的订阅生命周期价值跟踪功能，请参考更多信息。

[[Mage sharedInstance] setUserIdentifier:@"myUserIdentifier"];

许可证

Mage 在 MIT 许可证下可用。有关更多信息，请参阅 LICENSE 文件。