iOS Consent SDK 使用教程

iOS Consent SDK 使用教程

ios-consent-sdkConfigurable consent SDK for iOS项目地址:https://gitcode.com/gh_mirrors/io/ios-consent-sdk

项目介绍

iOS Consent SDK 是一个可配置的同意管理SDK，旨在帮助iOS应用程序开发者轻松管理用户同意政策。该SDK允许开发者自定义同意类型，并在应用程序中集成同意管理功能，以便用户可以查看和修改他们的同意设置。

项目快速启动

安装

使用 Swift Package Manager

在 Xcode 项目中，选择 File -> Swift Packages -> Add Package Dependency，然后输入仓库地址：

https://github.com/smartlook/ios-consent-sdk.git

使用 Cocoapods

在 Podfile 中添加以下内容：

pod 'SmartlookConsentSDK'

然后运行 pod install。

集成

在应用程序的 AppDelegate 中，调用 SmartlookConsentSDK.check() 方法：

import SmartlookConsentSDK

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    SmartlookConsentSDK.check { (consents) in
        // 处理同意结果
    }
    return true
}

应用案例和最佳实践

自定义同意类型

假设你需要添加一个新的同意类型 "marketing"，你可以按照以下步骤进行：

1. 在本地化文件中添加新的键值对：

"smartlook-consent-sdk-marketing-consent" = "My marketing consent";
"smartlook-consent-sdk-marketing-consent-url" = "https://www.my-company.com/consent-policy-details?lang=de"; // 可选

2. 在代码中配置新的同意类型：

let consentsSettings = ConsentsSettings(
    required: [.privacy, .analytics, .custom("marketing")],
    defaultValues: [.privacy: .provided, .analytics: .provided, .custom("marketing"): .notProvided]
)

SmartlookConsentSDK.check(with: consentsSettings) { (consents) in
    // 处理同意结果
}

在 iOS 设置中集成同意管理

为了在 iOS 设置应用中集成同意管理，你需要手动添加系统设置面板。具体步骤可以参考苹果开发者文档。

典型生态项目

iOS Consent SDK 可以与其他数据收集和分析工具集成，例如 Smartlook 分析工具。通过集成这些工具，开发者可以更好地理解用户行为，并根据用户同意政策进行数据收集和分析。

import SmartlookAnalytics

SmartlookConsentSDK.check { (consents) in
    if consents[.privacy] == .provided && consents[.analytics] == .provided {
        Smartlook.start()
    }
}

通过以上步骤，你可以快速集成 iOS Consent SDK，并根据需要进行自定义配置，以满足你的应用程序需求。

ios-consent-sdkConfigurable consent SDK for iOS项目地址:https://gitcode.com/gh_mirrors/io/ios-consent-sdk