集成适用于 iOS 的 Vungle SDK

John Mai

2024年09月17日 17:35

该文档将介绍如何集成Liftoff的iOS monetizon SDK。当完成改文档集成工作，请继续查看并集成 ad formats相关文档。

要求

Xcode v.13.0 或更高版本
兼容 iOS v.10.0 和更高版本的设备
CocoaPods v.1.10.0 或更高版本
推荐文档： Create a Liftoff account and register an app

Step 1. 添加SDK

您可以手动下载Vungle SDK 或者通过CocoaPods (推荐) 加成.

Option 1. CocoaPods (推荐)

Vungle SDK 可通过 Cocoapods 获得。将以下内容添加到项目的 podfile 中： (当您的工程中不包含Podfile时，请运行pod init 命令来添加Podfile到您的工程中):

pod "VungleAds", "7.0.0"

之后，运行 pod install --repo-update命令将使用我们最新版本的 iOS SDK 更新您的项目。

此时，您可以跳过手动集成部分，然后从“Add SKAdNetwork IDs to Info.plist部分继续。

Option 2. 手动集成

下载 Vungle SDK for iOS 并将 VungleAdsSDK.xcframework 添加到您的工程中。对于Swift工程，这步是必须的。
对于 Objective-C 工程，请先创建bridging header在您的工程中。创建bridging header，请创建一个新的Swift文件在您的工程中，当有提示是，创建bridging header，并将以下代码添加到文件中：
```
import <VungleAdsSDK/VungleAdsSDK.h>
```

添加SKAdNetwork IDs 到 Info.plist

配置您的应用程序以通过 iOS 14+ 上的 SKAdNetwork 框架参与广告变现。为此，请将我们批准的合作伙伴 ID 列表添加到您的Info.plist文件中以进行广告归因。添加 Vungle SKAdnetwork ID 和您要向其销售的所有 DSP 的 ID 表明您的应用希望与 Vungle 合作并接受这些买家的出价。

请参阅Apple文档来配置 Info.plist。详情请查看文档 Xcode documentation 以便了解更多来修改该文件。如果您不了解App Tracking Transparency (ATT)，我们还推荐查看文档 Apple’s documentation on ATT。

请依照以下步骤配置SKAdNetworkIDs :

在 Xcode Project navigator，打开Info.plist 文件。
单击Info.plist文件内属性列表中的键旁边的添加按钮 ( + ) 以创建新的属性键。
输入SKAdNetworkItems并在类型列中选择Array 。
添加一个字典项，然后在字典中添加一个字符串项。
对于每个字符串项，添加SKAdNetworkIdentifier作为键，广告网络标识符作为值。

Vungle 在我们的网站上以 JSON 和 XML 格式托管 Vungle SKAdNetwork ID 和我们买家的 SKAdNetwork ID 列表。请注意，我们的列表会定期更新：

Step 2. 初始化SDK

当您将SDK添加到您的工程后，请第一时间在代码中初始化它。

用Xcode打开您的工程
在您的App Delegate文件或App文件（SwiftUI）中添加如下代码：
SwiftObjective-C
```
import VungleAdsSDK
```
```
#import <VungleAdsSDK/VungleAdsSDK.h>
```

在您的App Delegate文件或App文件（SwiftUI）中添加如下代码：

VungleAds.initWithAppId("<YOUR_APP_ID>") { error in
    if let error = error {
        print("Error initializing SDK")
    } else {
        print("Init is complete")
    }
}

if (VungleAds.isInitialized()) {
    print("SDK is initialized")
} else {
    print("SDK is NOT initialized")
}

[VungleAds initWithAppId:@"" completion:^(NSError * _Nullable error) {
    if (error) {
        NSLog(@"Error initializing SDK");
    } else {
        NSLog(@"Init is complete");
    }
}];

if ([VungleAds isInitialized]) {
    NSLog(@"SDK is initialized");
} else {
    NSLog(@"SDK is NOT initialized");
}

Step 3. 集成广告格式

完成各种广告类型的集成，您才能顺利的将广告展示在您的应用中。详情请查看以下文档：

Step 4. 进一步定制您的广告

按照我们的高级设置文章中的说明，微调您的应用与其他配置选项的集成，例如 GDPR、CCPA 实施和许多其他设置。

要求