关于项目
Piano Analytics Apple SDK 允许您为 Piano Analytics 解决方案收集受众测量数据。它可以与 iOS、watchOS、tvOS 和 iOS 扩展应用程序一起使用。
此 SDK 使实现 Piano Analytics 变得尽可能简单,同时保留解决方案的所有灵活性。通过在您的应用程序中使用此小型库,并使用 专用且已记录的方法,您将能够发送强大的事件。
它还包括 隐私标签方法,允许您根据您参考的法规进行完美的标签管理。
入门
- 将我们的库安装到您的项目中(见下文),您有一些选择
- 使用 NPM
- 使用我们的 CDN(仅限浏览器)
- 克隆 GitHub 项目以构建一个您将托管的自定义文件(仅限浏览器)
- 如果您想要在不添加额外标签的情况下配置您的库(例如,在构建文件中已配置您的站点和收集域名),请使用此方法。但是,如果您使用 Build Tools(webpack 等),我们建议您使用 NPM 方法。
- 查看 文档 以了解功能概述和代码示例
使用 Cocoapods
如果您是 Cocoapods 新手,请参阅 CocoaPods 文档
-
使用以下行更新您的 Podfile
# iOS Application pod "PianoAnalytics/iOS", ">=3.0" # tvOS Application pod "PianoAnalytics/tvOS", ">=3.0" # watchOS Application pod "PianoAnalytics/watchOS", ">=3.0" # iOS Application pod "PianoAnalytics/appExtension", ">=3.0"
为了避免由 CocoaPods 引起的冲突,您可以使用独立的 pod
target 'MyProject' do pod "PianoAnalytics-AppExtension", ">=3.0" use_frameworks! end
如果您没有任何其他 pod,则您的 Podfile 应该看起来像这样
target 'MyProject' do pod "PianoAnalytics/iOS", ">=3.0" use_frameworks! end
-
保存您的 Podfile
-
运行
pod install
(返回顶部)
使用 Swift Package Manager
-
在您的应用程序中,点击文件 > 添加包...
-
在右上角的搜索框中粘贴公共存储库的 URL,
https://github.com/at-internet/piano-analytics-apple
-
选择 piano-analytics-apple 包
-
点击添加包
(返回顶部)
使用 Carthage
-
更新 Cartfile,包括以下行
github "at-internet/piano-analytics-apple" ~> 3.0
-
保存您的 Cartfile
-
使用相应的平台运行
carthage update --platform iOS
(如果您失败,您可能需要使用--use-xcframeworks
选项) -
从 Build/PianoAnalytics.xcframework 添加依赖项到“框架、库和嵌入式内容”
(返回顶部)
使用
-
在您的应用程序初始化中配置您的站点和收集域名
import PianoAnalytics ... pa.setConfiguration(ConfigurationBuilder() .withCollectDomain("log.xiti.com") .withSite(123456789) .build() )
-
发送事件
pa.sendEvent(Event("page.display", data: [ "page": "page name", // Event properties "page_chapter1": "chapter 1", "page_chapter2": "chapter 2", "page_chapter3": "chapter 3" ]))
有关更多示例,请参阅 文档
(返回顶部)
贡献
请毫不犹豫地使用此GitHub项目进行贡献,我们会审核任何合并请求或问题。请注意,在接纳或拒绝合并请求时,我们总是将其关闭,因为任何修改都必须由我们独家完成(所以如果我们认为有用,我们将实现您的合并请求)。此外,GitHub上的问题和请求可能需要更长的时间来处理,因为我们有专为客户设置的支持工具。因此,我们建议您仅使用GitHub工具进行技术目的:)
许可证
在MIT许可证下分发。
(返回顶部)
联系
AtInternet钢琴公司 - [email protected]
(返回顶部)