高级设置

广告位

您可以为每个广告单元设置广告位名称 (例如 "Rewarded VideoLevels"、"INTER_levelEnd" 或 "RewardedVideoCoinStore")。 这可以帮助您汇总不同广告位类别的统计数据。 下面的片段展示了如何为不同的广告格式设置广告位名称。

横幅 / MREC

对于横幅和 MREC,您必须在加载横幅或 MREC 之前设置广告位名称。

adView.placement = @"«placement»";
[adView loadAd];

插屏

[interstitialAd showAdForPlacement: @"«placement»"];

激励广告

[rewardedAd showAdForPlacement: @"«placement»"];

原生广告

nativeAdLoader.placement = @"«placement»";

原生广告 (Ad Placer)

MAAdPlacerSettings *settings = [MAAdPlacerSettings settingsWithAdUnitIdentifier: @"«ad-unit-ID»"];
settings.placement = @"«placement»";

静音

您可以在启动应用时将某些聚合 SDK 平台的音频设为静音。 通过 AppLovin SDK 支持此功能的平台如下:

  • AppLovin
  • Bigo (仅限原生广告)
  • DT Exchange
  • Google Ad Manager
  • Google 竞价和 Google AdMob
  • LINE
  • Mintegral

对于其他平台,请咨询平台客户团队,了解此功能是否可用以及如何访问。

下面的代码片段展示了如何在支持静音的平台中设置静音:

ALSdk *sdk = [ALSdk shared];
sdk.settings.muted = YES; // to mute
sdk.settings.muted = NO;  // to unmute

在加载广告之前设置静音状态。 有些平台 (如 Google 竞价和 Google AdMob) 会基于广告加载前的静音状态返回静音或未静音的视频。

注意:静音广告可能会导致广告收入下降。

启用详细日志

启用详细日志的方法有两种:

编程方式

您可以在 SDK 设置对象中,将标记 isVerboseLoggingEnabled 设置为 YES,以启用详细日志。

[ALSdk shared].settings.verboseLoggingEnabled = YES;

Info.plist

您还可以在应用的 Info.plist 中,将 AppLovinVerboseLoggingOn 设置为 YES,以启用详细日志。

Key: Information Property List. Type: Dictionary. Value: (1 item). Key: AppLovinVerboseLoggingOn. Type: Boolean. Value: YES.

验证

要验证是否已成功启用详细日志,请查看 AppLovin SDK 日志初始化部分中是否有 Verbose Logging On: true 行。

AppLovin SDK
Version: 12.4.2
⋮
Verbose Logging On: true
⋮

AppLovin SDK 的日志标签为 “/AppLovinSdk: [AppLovinSdk]”。

Creative ID 和平台名称

您可以调取各个聚合平台已展示广告的 Creative ID 和平台名称。 请参阅 Creative Debugger 文档 了解更多信息。

DSP 名称

您可以使用如下代码,调取 AppLovin Exchange 投放的 MAX 广告的 DSP 名称:

- (void)didLoadAd:(MAAd *)ad
{
  NSLog(@"AppLovin Exchange DSP name: %@", ad.DSPName);
}

展示层级 User Revenue API

您可以在客户端获取展示层级的用户收入数据。 您可以使用这些数据来对比不同的渠道和推广活动。 您也可以通过使用 MAX User Revenue API 来获取这些数据。 希望获取此数据的 MMP 应参阅 MMP 展示层级 User Revenue API 页面。

您可以针对所有受支持的平台与 Adjust 等移动监测合作伙伴分享展示层级广告收入数据。

您可以在所有广告生命周期回调中检索收入金额。 以下示例展示了如何在 “ad revenue paid” 回调中执行此操作:

- (void)didPayRevenueForAd:(MAAd *)ad
{
  double revenue = ad.revenue; // In USD

  // Miscellaneous data
  NSString *countryCode = [ALSdk shared].configuration.countryCode; // "US" for the United States, etc - Note: Do not confuse this with currency code which is "USD"
  NSString *networkName = ad.networkName; // Display name of the network that showed the ad
  NSString *adUnitId = ad.adUnitIdentifier; // The MAX Ad Unit ID
  MAAdFormat *adFormat = ad.format; // The ad format of the ad (e.g. BANNER, MREC, INTERSTITIAL, REWARDED)
  NSString *placement = ad.placement; // The placement this ad's postbacks are tied to
  NSString *networkPlacement = ad.networkPlacement; // The placement ID from the network that showed the ad
}

如果 ad.revenue-1,则表示出现错误。

您还可以获取收入值的精确度评估,如下例所示:

NSString *revenuePrecision = ad.revenuePrecision;

该精确度采用下列值之一:

"publisher_defined"
收入金额为开发者指定的价格
"exact"
收入金额为实时竞价的结果
"estimated"
收入金额基于 Auto-CPM 或 FB 竞价估算
"undefined"
未定义收入金额,也没有足够的数据来估算
""
收入和精确度无效 (例如在测试模式下)

建立广告请求回调

要监听广告请求的发出,请设置一个 MAAdRequestDelegate,实现它的 [didStartAdRequestForAdUnitIdentifier:] 方法,然后将委托设置为 requestDelegate。 以下示例展示了如何实现此类 "ad request started" 回调:

- (void)didStartAdRequestForAdUnitIdentifier:(NSString *)adUnitIdentifier
{
  // Ad request started here
}

选择性初始化

您可以在 ALSdkInitializationConfiguration 中指定特定的广告单元来初始化 SDK。 如果这样做,SDK 将仅初始化您为指定的广告单元配置的那些网络。 (如果您不指定任何广告单元,SDK 将假定当前会话需要您的所有广告单元。 如果是这样,它将初始化您为它们配置的所有网络。) 以下示例展示了如何实现此功能:

ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey:«your-SDK-key»
  builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
    builder.mediationProvider = ALMediationProviderMAX;
    builder.adUnitIdentifiers = @[@"«ad-unit-ID-1»", @"«ad-unit-ID-2»"];
  }];

[[ALSdk shared] initializeWithConfiguration: initConfig completionHandler:^(ALSdkConfiguration *sdkConfig) {
 ⋮
}];

您可以在 AppLovin 控制面板的 Account > General > Keys 部分找到 SDK key。

当您使用选择性初始化时,MAX 会在当前会话中排除任何您未明确指定的广告单元来投放广告。

当您启用 测试模式 时,选择性初始化将不起作用。

Waterfall Information API

Waterfall Information API 可向您展示广告的当前瀑布流 (已加载或加载失败的广告)。 API 会返回瀑布流中每则广告的广告加载状态、延迟、配置信息和聚合平台信息。 如果瀑布流中的广告加载失败,API 会提供错误信息。

AdLoadState 值

解释
0未尝试加载广告
1广告已加载
2广告加载失败

示例

- (void)didLoadAd:(MAAd *)ad
{
  NSLog(@"Waterfall Name: %@ and Test Name: %@", ad.waterfall.name, ad.waterfall.testName);
  NSLog(@"Waterfall latency was: %f seconds", ad.waterfall.latency);

  for (MANetworkResponseInfo *networkResponse in ad.waterfall.networkResponses)
  {
    NSLog(@"Network -> %@", networkResponse.mediatedNetwork);
    NSLog(@"...adLoadState: %ld", (long) networkResponse.adLoadState);
    NSLog(@"...latency: %f seconds", networkResponse.latency);
    NSLog(@"...credentials: %@", networkResponse.credentials);
    if (networkResponse.error) {
      NSLog(@"...error: %@", networkResponse.error);
    }
  }
}

- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error
{
  if (!error.waterfall) {
    return;
  }

  MAAdWaterfallInfo *waterfall = error.waterfall;
  NSLog(@"Waterfall Name: %@ and Test Name: %@", waterfall.name, waterfall.testName);
  NSLog(@"Waterfall latency was: %f seconds", waterfall.latency);

  for (MANetworkResponseInfo *networkResponse in waterfall.networkResponses)
  {
    NSLog(@"Network -> %@", networkResponse.mediatedNetwork);
    NSLog(@"...latency: %f seconds", networkResponse.latency);
    NSLog(@"...credentials: %@", networkResponse.credentials);
    if (networkResponse.error) {
      NSLog(@"...error: %@", networkResponse.error);
    }
  }
}

请注意,如果瀑布流为空,MAError.waterfall 将返回 nil,因此您无法查询瀑布流属性。 但是,您可以通过 requestLatency 获取空瀑布流的广告加载延迟:

- (void)didLoadAd:(MAAd *)ad
{
  NSLog(@"Succesful ad load latency: %f seconds", ad.requestLatency);
}

- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error
{
  NSLog("Failed ad load latency: %f seconds", error.requestLatency);
}

自定义横幅 / MREC 广告刷新

您可以在集成中直接自定义横幅和 MREC 广告的刷新间隔,就像在广告单元 UI 中配置它们一样。 最小刷新间隔为 10 秒。 最大刷新间隔为 120 秒。 MAX 会忽略这些限制之外的值。 以下代码示例展示了如何自定义这些刷新间隔:

// Where adView is an instance of MAAdView
[adView setExtraParameterForKey: @"ad_refresh_seconds" value: «ad-refresh-rate»];

音频设置

为避免插屏广告和激励广告音频干扰应用的背景音频,AppLovin 建议您在显示广告前暂停应用的背景音频。 您可以在隐藏广告后恢复应用的背景音频。

- (void)didDisplayAd:(MAAd *)ad
{
  // Pause your app's background audio
}

- (void)didHideAd:(MAAd *)ad
{
  // Resume your app's background audio
}

search