AppMetrica Push SDK 允许您向应用用户发送定向推送通知。这些通知被称为推送活动。您可以使用推送活动来吸引您的听众并帮助降低流失率。
- 转到 文件 > 添加包依赖。
- 将 AppMetrica Push SDK 的 GitHub 链接放入其中: https://github.com/appmetrica/push-sdk-ios.
- 在 添加到目标 中,选择不想要的模块为 None。
- 将 SDK 添加到项目依赖项
dependencies: [
.package(url: "https://github.com/appmetrica/push-sdk-ios", from: "2.0.0")
],
- 列出目标依赖项中的模块
.target(
name: "YourTargetName",
dependencies: [
.product(name: "AppMetricaPush", package: "push-sdk-ios"),
// Optionally include 'AppMetricaPushLazy' for lazy push feature
]
)
- 如果您还没有设置 CocoaPods,请在项目目录中运行
pod init
。 - 在您的 Podfile 中,添加 AppMetrica Push 依赖项
target 'YourAppName' do
# For all analytics features, add this umbrella module:
pod 'AppMetricaPush', '~> 2.0.0'
# Optionally add Lazy Push pod
pod 'AppMetricaPushLazy', '~> 2.0.0'
end
- 使用
pod install
安装依赖项。 - 使用
.xcworkspace
文件在 Xcode 中打开您的项目。
AppMetricaPush
: 必需的,用于基本 SDK 使用。AppMetricaPushLazy
: 启用延迟推送支持
以下是向项目中添加 AppMetrica Push SDK 的方法(适用于 SwiftUI 和 UIKit)
-
将 AppMetrica 添加到项目中
-
import AppMetricaPush
. -
通过在
application(_:didFinishLaunchingWithOptions:)
中设置UNUserNotificationCenter.current().delegate = AppMetricaPush.userNotificationCenterDelegate
来配置 AppMetricaPush。 -
在
application(_:didRegisterForRemoteNotificationsWithDeviceToken:)
中注册设备令牌 -
调用
UIApplication.registerForRemoteNotifications()
。请见 文档 以启用可见的通知。 -
(可选)如果您也使用
UISceneDelegate
,请在scene(_:willConnectTo:options:)
中添加AppMetricaPush.handleSceneWillConnectToSession(with:)
将以下内容放入您的 AppDelegate.swift
import UIKit
import UserNotifications
import AppMetrica
import AppMetricaPush
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
if let configuration = AppMetricaConfiguration(apiKey: "Your_API_Key") {
AppMetrica.activate(with: configuration)
}
UNUserNotificationCenter.current().delegate = AppMetricaPush.userNotificationCenterDelegate
return true
}
func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
AppMetricaPush.setDeviceToken(deviceToken)
}
}
如果您使用场景,请将以下内容放入您的 SceneDelegate.swift
import UIKit
import AppMetricaPush
class SceneDelegate: UIResponder, UIWindowSceneDelegate {
func scene(_ scene: UIScene, willConnectTo
session: UISceneSession, options
connectionOptions: UIScene.ConnectionOptions) {
AppMetricaPush.handleSceneWillConnectToSession(with: connectionOptions)
}
}
对于将 AppMetrica Push SDK 集成到 SwiftUI 应用程序,您可以使用 AppDelegate 适配器来处理与推送通知相关的生命周期事件。创建一个新的 AppDelegate.swift,并根据 UIKit 方法进行设置
然后在您的 App
结构中
@main
struct YourAppNameApp: App {
// Use the `@UIApplicationDelegateAdaptor` property wrapper to work with AppDelegate and set up AppMetrica Push SDK
@UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
var body: some Scene {
WindowGroup {
ContentView()
}
}
}
您可以在我们的 完整文档 中找到详细的集成细节和安装、配置、测试等说明。
AppMetrica Push SDK 在 MIT 许可证下发布。许可证协议可在 LICENSE 中找到。