Pollfish iOS Max Mediation Adapter

适用于想要在与其他奖励广告同一瀑布中加入和展示 Pollfish 奖励调查的 iOS 应用程序的 Max 适配器。

注意：有关如何集成的详细分步指南，请参阅此处。

步骤 1：将Pollfish Max适配器添加到您的项目中

下载以下框架

• Pollfish SDK
• AppLovin SDK
• PollfishMaxAdapter

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

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

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

• AdSupport.framework
• CoreTelephony.framework
• SystemConfiguration.framework
• WebKit.framework（自 Pollfish v4.4.0 以来添加）

或者

通过 CocoaPods 获取 Pollfish Max 适配器

添加包含 PollfishMaxAdapterPod 引用的 Podfile

pod 'PollfishMaxAdapter'

您可以在 CocoaPods 此处找到最新版本的 PollfishMaxAdapter。

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

步骤 2：请求奖励广告

导入 AppLovinSDK

Swift

import AppLovinSDK

Objective C

#import <AppLovinSDK/AppLovinSDK.h>

在应用程序代理的 application:applicationDidFinishLaunching: 方法中初始化 SDK。

Swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        
    ALSdk.shared()!.mediationProvider = "max"
    
    ALSdk.shared()!.initializeSdk(completionHandler: nil)
    
    return true
}

Objective C

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    [ALSdk shared].mediationProvider = @"max";
    
    [[ALSdk shared] initializeSdkWithCompletionHandler:^(ALSdkConfiguration *configuration) {}];
}

实现 MARewardedAdDelegate，以便当您的广告准备好以及其他广告相关事件发生时能够得到通知。

从 AppLovin 请求一个奖励广告，通过调用您创建的 MARewardedAd 对象实例中的 load。默认情况下，Pollfish Max 适配器将使用在 AppLovin 仪表板上提供配置。如果没有提供任何配置或您想覆盖这些参数的任何一项，请参阅第 3 步。

Swift

class ViewController: UIViewController, MARewardedAdDelegate {

    var rewardedAd: MARewardedAd!

    ...

    func createRewardedAd() {
        rewardedAd = MARewardedAd.shared(withAdUnitIdentifier: "AD_UNIT_ID")
        rewardedAd.delegate = self
        rewardedAd.load()
    }

    func didLoad(_ ad: MAAd) {}

    func didDisplay(_ ad: MAAd) {}

    func didHide(_ ad: MAAd) {}

    func didClick(_ ad: MAAd) {}

    func didFailToLoadAd(forAdUnitIdentifier adUnitIdentifier: String, withError error: MAError) {}

    func didFail(toDisplay ad: MAAd, withError error: MAError) {}

    func didStartRewardedVideo(for ad: MAAd) {}

    func didCompleteRewardedVideo(for ad: MAAd) {}

    func didRewardUser(for ad: MAAd, with reward: MAReward) {}

}

Objective C

@interface ViewController()<MARewardedAdDelegate>
@property (nonatomic, strong) MARewardedAd *rewardedAd;
@end

@implementation ViewController

...

- (void)createRewardedAd
{
    self.rewardedAd = [MARewardedAd sharedWithAdUnitIdentifier: @"YOUR_AD_UNIT_ID"];
    self.rewardedAd.delegate = self;
    [self.rewardedAd loadAd];
}

#pragma mark - MAAdDelegate Protocol

- (void)didLoadAd:(MAAd *)ad {}

- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error {}

- (void)didDisplayAd:(MAAd *)ad {}

- (void)didClickAd:(MAAd *)ad {}

- (void)didHideAd:(MAAd *)ad {}

- (void)didFailToDisplayAd:(MAAd *)ad withError:(MAError *)error {}

#pragma mark - MARewardedAdDelegate Protocol

- (void)didStartRewardedVideoForAd:(MAAd *)ad {}

- (void)didCompleteRewardedVideoForAd:(MAAd *)ad {}

- (void)didRewardUserForAd:(MAAd *)ad withReward:(MAReward *)reward {}

@end

当奖励广告准备好时，通过调用 rewardedAd.show() 展示广告。为了确保一切正常，您可以结合使用展示和检查您即将展示的广告是否实际上已准备好。

Swift

if rewardedAd.isReady {
    rewardedAd.show()
}

Objective C

if ( [self.rewardedAd isReady] )
{
    [self.rewardedAd showAd];
}

步骤 3：在您的奖励广告单元中使用和控制 Pollfish Max 适配器（可选）

Pollfish Max 适配器提供了不同的选项，您可以使用这些选项来控制 Pollfish SDK 的行为。如果应用此配置，则将覆盖在 AppLovin 仪表板上所做的任何配置。

3.1 api_key

在您在Pollfish仪表板（https://www.pollfish.com/publisher/）上登录并创建应用程序后，由Pollfish提供的Pollfish API密钥。如果您已在AppLovin的UI上指定了Pollfish API密钥，此参数将覆盖在Web UI上定义的密钥。

3.2 request_uuid

设置一个唯一ID来识别用户，并在调查完成后通过s2s回调传递。

为了注册此类回调，您可以在Pollfish开发者仪表板上设置您的服务器URL。在每次调查完成后，您将收到一个包含传递的request_uuid参数的回调到您的服务器。

如果您想了解更多关于Pollfish s2s回调的信息，可以在此处阅读文档（https://www.pollfish.com/docs/s2s）

3.3 release_mode

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

• 开发者模式用于向开发者显示Pollfish调查将通过应用程序如何展示（在开发测试期间很有用）。
• 发布模式是用于任何应用商店上发布的应用的模式（开始接收付费调查）。

Pollfish Max Adapter默认以发布模式运行Pollfish SDK。如果您想使用测试调查进行测试，应将发布模式设置为false。

3.4 user_id

用于识别用户的可选ID

设置userId将覆盖默认行为，并使用它而不是广告ID来识别用户

您可以将系统上识别的用户ID传递给Pollfish。Pollfish将使用此ID来在会话中识别用户，而不是使用广告ID/idfa，如商店建议。您有责任确保提供此ID并获取用户所需的相应同意。Pollfish不对使用此ID的行为承担责任。对于您的用户请求重置/删除此ID和/或创建的资料，您应承担全部责任。

以下您可以看到Pollfish Max Adapter的所有可用配置选项。

rewardedAd = MARewardedAd.shared(withAdUnitIdentifier: "AD_UNIT_ID")
rewardedAd.setLocalExtraParameterForKey("api_key", value: "YOUR_API_KEY")
rewardedAd.setLocalExtraParameterForKey("request_uuid", value: "REQUEST_UUID")
rewardedAd.setLocalExtraParameterForKey("release_mode", value: true)
rewardedAd.setLocalExtraParameterForKey("user_id", value: "USER_ID")

步骤4：发布

如果前几步一切都正常工作，您应将Pollfish切换到发布模式并发布您的应用程序。

注意：您的应用程序上线后，请通过Pollfish仪表板中的应用设置区域请求验证您的帐户。

注意：有一个显示所必需的单独人口统计问题的选项（为了Pollfish在没有实际调查的情况下也能针对用户进行调查）。这些调查不会为发布商带来任何收入（但它们可以提高填写率），因此如果您不想在水下沙堆中显示此类调查，应访问您的应用设置区域并禁用该选项。