数据和关键词传递

分群定向

AppLovin MAX SDK 12.6.0 版本能在保护隐私的同时定向瀑布流和 Direct Sold campaign。此版本中引入的 API 使用通用键-值数字配对方法。

您来决定每个键和值的含义。

例如，您可以针对用户感兴趣的类型创建分群，并使用键值 849 代表这些分群。

类型值可能包括“恐怖”、“惊悚”和“爱情”。这些可以分别用 1、2 和 3 来表示。

定义上述键和值后，则可以使用下面的代码将一位用户添加到恐怖和浪漫类型分群中：

Objective-C
Swift

ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: «SDK-key» builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
  builder.mediationProvider = ALMediationProviderMAX;
  builder.segmentCollection = [MASegmentCollection segmentCollectionWithBuilderBlock:^(MASegmentCollectionBuilder *builder) {
    [builder addSegment: [[MASegment alloc] initWithKey: @(849) values: @[@(1), @(3)]]];
  }];
}];
⋮
[sdk initializeWithConfiguration: initConfig completionHandler:^(ALSdkConfiguration *sdkConfig) { …

let initConfig = ALSdkInitializationConfiguration(sdkKey: "«SDK-key»") { builder in
  builder.mediationProvider = ALMediationProviderMAX
  builder.segmentCollection = MASegmentCollection { segmentCollectionBuilder in
    segmentCollectionBuilder.add(MASegment(key: 849, values: [1, 3]))
  }
}
⋮
sdk.initialize(with:initConfig) { sdkConfig in …

内容 URL 传递

AppLovin 建议您在发送广告请求时传递应用内容 URL，方便买方进行上下文分析或审查。某些 DSP 买家可能需要此信息。您可以在竞价请求中发送该 URL。

下面的代码片段展示了在发送广告请求时如何传递应用内容 URL：

Objective-C
Swift

横幅广告

self.bannerAd = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»"];
[self.bannerAd setExtraParameterForKey: @"content_url" value: @"«value»"];

插屏广告

self.interstitialAd = [[MAInterstitialAd alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»"];
[self.interstitialAd setExtraParameterForKey: @"content_url" value: @"«value»"];

MREC广告

self.mrecAd = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»" adFormat: MAAdFormat.mrec ];
[self.mrecAd setExtraParameterForKey: @"content_url" value: @"«value»"];

原生广告

self.nativeAdLoader = [[MANativeAdLoader alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»"];
[self.nativeAdLoader setExtraParameterForKey: @"content_url" value: @"«value»"];

激励广告

self.rewardedAd = [MARewardedAd sharedWithAdUnitIdentifier: @"«ad-unit-ID»"];
[self.rewardedAd setExtraParameterForKey: @"content_url" value: @"«value»"];

横幅广告

let bannerAd = MAAdView(adUnitIdentifier: "«ad-unit-ID»")
bannerAd.setExtraParameterForKey("content_url", value: "«value»")

插屏广告

let interstitialAd = MAInterstitialAd(adUnitIdentifier: "«ad-unit-ID»")
interstitialAd.setExtraParameterForKey("content_url", value: "«value»")

MREC广告

let mrecAd = MAAdView(adUnitIdentifier: "«ad-unit-ID»", adFormat: MAAdFormat.mrec)
mrecAd.setExtraParameterForKey("content_url", value: "«value»")

原生广告

let nativeAdLoader = MANativeAdLoader(adUnitIdentifier: "«ad-unit-ID»")
nativeAdLoader.setExtraParameterForKey("content_url", value: "«value»")

激励广告

let rewardedAd = MARewardedAd.shared(withAdUnitIdentifier: "«ad-unit-ID»")
rewardedAd.setExtraParameterForKey("content_url", value: "«value»")

统一标识符

您可以在竞价流中传递 UID2 token。买方使用这些 token 定向应用广告位并对广告位进行准确竞价。您负责生成 token 并将其发送至 AppLovin。以下代码示例展示了传递 token 的方法：

Objective-C
Swift

ALSdkSettings *settings = [ALSdk shared].settings;
[settings setExtraParameterForKey: @"uid2_token" value: @"«value»"];

let settings = ALSdk.shared()?.settings
settings?.setExtraParameterForKey("uid2_token", value: "«value»")

针对 Google Ad Manager Direct Sold 的自定义定向

您可以将自定义定向值传递至 Google Ad Manager 的 Direct Sold 请求。

要将自定义定向值传递至 Google Ad Manager，请将本地额外参数 custom_targeting 的值 (一个或多个) 设置为您的定向值 (一个或多个)，如下所示：

Objective-C
Swift

使用以下对象来声明您的自定义定向值：

NSDictionary<NSString *, NSString *> customTargetingValues = @{@"«custom-targeting-key»" : @"«custom-targeting-value»"};

横幅广告

self.bannerAd = [[MAAdView alloc] initWithAdUnitIdentifier: @"«your-ad-unit-ID»"];
[self.bannerAd setLocalExtraParameterForKey: @"custom_targeting" value: customTargetingValues];

插屏广告

self.interstitialAd = [[MAInterstitialAd alloc] initWithAdUnitIdentifier: @"«your-ad-unit-ID»"];
[self.interstitialAd setLocalExtraParameterForKey: @"custom_targeting" value: customTargetingValues];

MREC广告

self.mrecAd = [[MAAdView alloc] initWithAdUnitIdentifier: @"«your-ad-unit-ID»" adFormat: MAAdFormat.mrec];
[self.mrecAd setLocalExtraParameterForKey: @"custom_targeting" value: customTargetingValues];

激励广告

self.rewardedAd = [MARewardedAd sharedWithAdUnitIdentifier: @"«your-ad-unit-ID»"];
[self.rewardedAd setLocalExtraParameterForKey: @"custom_targeting" value: customTargetingValues];

使用以下对象来声明您的自定义定向值：

let customTargetingValues: [String: String] = ["«custom-targeting-key»": "«custom-targeting-value»"]

横幅广告

let bannerAd = MAAdView(adUnitIdentifier: "«your-ad-unit-ID»")
bannerAd.setLocalExtraParameterForKey("custom_targeting", value: customTargetingValues)

插屏广告

let interstitialAd = MAInterstitialAd(adUnitIdentifier: "«your-ad-unit-ID»")
interstitialAd.setLocalExtraParameterForKey("custom_targeting", value: customTargetingValues)

MREC广告

let mrecAd = MAAdView(adUnitIdentifier: "«your-ad-unit-ID»", adFormat: MAAdFormat.mrec)
mrecAd.setLocalExtraParameterForKey("custom_targeting", value: customTargetingValues)

激励广告

let rewardedAd = MARewardedAd.shared(withAdUnitIdentifier: "«your-ad-unit-ID»")
rewardedAd.setLocalExtraParameterForKey("custom_targeting", value: customTargetingValues)

条款 | 隐私 | EULA | DMCA | Cookie 设置