Pollfish iOS MoPub Mediation Adapter

适用于希望在与其他奖励广告相同的瀑布流中加载和显示 Pollfish 奖励调查的 iOS 应用程序的 MoPub 中介适配器。

注意：有关如何集成，可在此处找到详细步骤指南 这里

第一步：将 Pollfish MoPub 适配器添加到您的项目中

手动导入 PollfishMoPubAdapter

下载以下框架

• Pollfish SDK
• MoPub SDK
• PollfishMoPubAdapter

并将它们添加到您的应用程序的目标依赖项中

1. 导航到您的项目
2. 选择您的应用程序目标，并转到“通用”标签部分的框架、库和嵌入式内容
3. 通过按下+按钮逐个添加三个依赖框架 -> 添加其他 -> 选择适当的框架。

在您的项目中添加以下框架（如果您还没有的话）

• AdSupport.framework
• CoreTelephony.framework
• SystemConfiguration.framework
• WebKit.framework（自 Pollfish v4.4.0 版本添加）

或

通过 CocoaPods 获取 Pollfish MoPub Adapter

添加包含 PollfishMoPubAdapter pod 引用的 Podfile

pod 'PollfishMoPubAdapter'

您可以在 CocoaPods 上找到最新的 Pollfish iOS SDK 版本，此处。

在命令行中运行 pod install 以安装 Pollfish Cocoapod。

重要步骤：Objective-C 项目

对于基于 Objective-C 的项目，您需要创建一个空白的 Swift 文件和一个名为 YourProjectName-Bridging-Header.h 的桥接头文件。跳过此步骤会导致编译失败。

步骤 2：请求 RewardedAd

导入 PollfishMoPubAdapter 和 MoPubSDK

Swift

import PollfishMoPubAdapter
import MoPubSDK

Objective-C

@import PollfishMoPubAdapter;
#import <MoPubSDK/MoPub.h>

在初始化配置中初始化 MoPub SDK 并传递 PollfishAdapterConfiguration。

Swift

let config = MPMoPubConfiguration(adUnitIdForAppInitialization: "AD_UNIT_ID")

config.additionalNetworks = [PollfishAdapterConfiguration.self]

MoPub.sharedInstance().initializeSdk(with: config) {
    // Load Ad
}

Objective-C

MPMoPubConfiguration *config = [[MPMoPubConfiguration alloc] 
    initWithAdUnitIdForAppInitialization:@"AD_UNIT_ID"];
[config setAdditionalNetworks:@[PollfishAdapterConfiguration.class]];

[[MoPub sharedInstance] initializeSdkWithConfiguration: config 
                        completion:^(void) {
    // Load Ad
}];

使用在 MoPub Web UI 上提供的 Pollfish 配置参数从 MoPub 请求 RewardedAd。如果没有提供配置或要覆盖 Web UI 中提供的任何参数，请参阅步骤 3。

Swift

MPRewardedAds.setDelegate(self, forAdUnitId: "AD_UNIT_ID")
        
MPRewardedAds.loadRewardedAd(withAdUnitID: "AD_UNIT_ID", 
                             withMediationSettings: nil)

Objective-C

[MPRewardedAds setDelegate:self forAdUnitId:@"AD_UNIT_ID"];
    
[MPRewardedAds loadRewardedAdWithAdUnitID:@"AD_UNIT_ID" withMediationSettings:@[]];

实现 MPRewardedAdsDelegate 以在奖励广告准备好显示时得到通知。

Swift

extension ViewController: MPRewardedAdsDelegate {
    
    func rewardedAdDidLoad(forAdUnitID adUnitID: String!) {}
    
    func rewardedAdDidFailToLoad(forAdUnitID adUnitID: String!, error: Error!) {}
    
}

Objective-C

// ViewController.h

@interface ViewController : UIViewController<MPRewardedAdsDelegate>

...

@end

// ViewController.m
@implementation ViewController

...

- (void) rewardedAdDidLoadForAdUnitID:(NSString *)adUnitID {}

- (void) rewardedAdDidFailToLoadForAdUnitID:(NSString *)adUnitID error:(NSError *)error {}

@end

当 Rewarded Ad 准备好后，通过调用 presentRewardedAd 来显示广告。

Swift

MPRewardedAds.presentRewardedAd(forAdUnitID: unitId,
                                from: self,
                                with: nil)

Objective-C

[MPRewardedAds presentRewardedAdForAdUnitID:@"AD_UNIT_ID" 
               fromViewController:self 
               withReward:NULL];

步骤 3：在 Rewarded Ad 单元中使用和控制 Pollfish MoPub Adapter

Pollfish MoPub Adapter 提供了不同的选项，可用于控制 Pollfish SDK 的行为。

以下列出了所有可用的键值选项，这些选项用于配置 Pollfish SDK 的行为。

3.1 api_key

根据在Pollfish仪表板（在Pollfish 发布者仪表板完成平台注册后由Pollfish提供的）提供的Pollfish API Key设置。如果已经在MoPub的Web UI上指定了Pollfish API Key，则此参数将被忽略。

3.2 request_uuid

设置一个唯一的ID来识别用户并在调查完成后通过服务器到服务器的回调传递。

为了注册此类回调，您可以在Pollfish开发者仪表板上的应用页面设置您的服务器URL，然后在初始化期间通过ParamsBuilder对象传递requestUUID。在每次调查完成后，您将收到一个包含传递的requestUUID参数的回调。

如果您想了解更多关于Pollfish s2s回调的信息，您可以在此处查阅文档（链接）

3.3 release_mode

将Pollfish SDK设置为开发者或发布模式。

• 开发者模式用于向开发者展示应用中如何显示Pollfish调查（在开发和测试期间非常有用）。
• 发布模式是用于在任何应用商店发布的应用的模式（开始接收付费调查）。

Pollfish MoPub适配器默认以发布模式运行Pollfish SDK。如果您想要测试测试调查，应将发布模式设置为false。

3.4 offerwall_mode

启用offerwall模式。如未设置，每次只显示一个调查。

以下是一个示例，说明如何将信息传递给Pollfish MoPub适配器配置。

let localExtras: [AnyHashable: Any] = [
    "api_key": "API_KEY",
    "release_mode": true,
    "offerwall_mode": true,
    "request_uuid": "USER_ID"]

MPRewardedAds.loadRewardedAd(
    withAdUnitID: "UNIT_ID",
    keywords: nil,
    userDataKeywords: nil,
    customerId: nil,
    mediationSettings: nil,
    localExtras: localExtras)

NSDictionary *localExtras = @{
    @"api_key": @"API_KEY",
    @"offerwall_mode": @true,
    @"release_mode": @true,
    @"request_uuid": @"USER_ID"};

[MPRewardedAds loadRewardedAdWithAdUnitID:adUnitid 
               keywords:NULL 
               userDataKeywords:NULL 
               customerId:NULL 
               mediationSettings:NULL 
               localExtras:localExtras];

步骤 4：在商店发布您的应用

如果在之前的步骤中一切顺利，您应该将 Pollfish 切换到发布模式并发布您的应用。

注意：在您的应用上线后，您应该在应用设置的“Pollfish 桌面”区域请求您的账户进行验证。

注意：有一个选项来展示独立的人口统计问题，即使没有实际的调查可用，Pollfish 也可以使用这些问题来定位用户。这些调查不会为出版商带来任何收入（但它们可以提高填充率），因此，如果您不想在倒排顺序中显示此类调查，请访问您的应用设置并禁用该选项。