# 具有 AdInfo 集成(iOS)的 LevelPlay 监听器

> 集成 LevelPlay 监听器并在 iOS app 中使用 AdInfo 数据。包括事件详细信息、代码示例和 AdInfo 字段。

LevelPlay AdInfo 表示成功加载的最后一个广告。加载失败回调中不包含此属性，因为没有可用的广告。

## 集成 AdInfo 数据##integrate-the-adinfo-data

实现 LevelPlay 监听器后，可以将数据用作 app 数据的一部分。

如果 LevelPlayAdInfo 数据不可用，adInfo 字字符串参数将返回空字字符串，而数字参数将返回 0 值。

1. **Objective-C**

   ```objective-c
   - (void)didLoadAdWithAdInfo:(LPMAdInfo *)adInfo { }
      NSString *auctionId = adInfo.auctionId;
      NSString *adFormat = adInfo.adFormat;
      NSString *adNetwork = adInfo.adNetwork;
      NSString *instanceName = adInfo.instanceName;
      NSString *instanceId = adInfo.instanceId;
      NSString *country = adInfo.country;
      NSNumber *revenue = adInfo.revenue;
      NSString *precision = adInfo.precision;
      NSString *ab = adInfo.ab;
      NSString *segmentName = adInfo.segmentName;
      NSString *encryptedCPM = adInfo.encryptedCPM;
      NSString *creativeId = adInfo.creativeId;
   }
   ```

2. **Swift**

   ```swift
   func didLoadAd（包含 adInfo：LPMAdInfo) {
       let auctionId = adInfo.auctionId
       let adFormat = adInfo.adFormat
       let adNetwork = adInfo.adNetwork
       let instanceName = adInfo.instanceName
       let instanceId = adInfo.instanceId
       let country = adInfo.country
       let revenue = adInfo.revenue
       let precision = adInfo.precision
       let ab = adInfo.ab
       let segmentName = adInfo.segmentName
       let encryptedCPM = adInfo.encryptedCPM
       let creativeId = adInfo.creativeId
   }
   ```

## AdInfo 字段##adinfo-fields

以下是相关数据字段的列表，包括作为新 AdInfo 对象的一部分返回的描述和类型：

| 参数名称         | 描述                                                                                                                         | 数据类型 |
| ------------ | -------------------------------------------------------------------------------------------------------------------------- | ---- |
| auctionId    | 拍卖的唯一标识符                                                                                                                   | 字符串  |
| adUnit       | 显示的广告单元（奖励视频/插页/横幅）                                                                                                        | 字符串  |
| adNetwork    | 投放广告的广告网络名称                                                                                                                | 字符串  |
| instanceName | 平台上定义的广告网络实例名称。对于竞价源，实例名称将为“Bidding”                                                                                       | 字符串  |
| instanceId   | 每个网络的标识符，包括广告网络的实例 ID/放置/位置/区域/等。                                                                                          | 字符串  |
| country      | 国家代码 [ISO 3166-1](https://www.iso.org/iso/country_names_and_code_elements) 格式                                              | 字符串  |
| 收入           | 广告展示产生的收入（美元）。收入值根据精度进行估算或精确估算（请参阅精度字段描述）                                                                                  | 双倍   |
| 精度           | Revenue 字段的音频源值：BID – 时间拍卖中提供的收入（Meta 和 Google 出价者不支持精确出价） 速率 – 发布者分配给 LevelPlay 平台中实例的手动价格 CPM – LevelPlay 平台根据历史实例性能进行计算 | 字符串  |
| ab           | 指示是否通过 LevelPlay 平台激活了 A/B 测试                                                                                              | 字符串  |
| segmentName  | 用户相关的细分段（根据细分方法定义）                                                                                                         | 字符串  |
| encryptedCPM | 仅与 Meta Audience Network 提供的广告服务相关，并将在封闭测试版内报告给 Meta Audience Network 批准的发布者                                               | 字符串  |
| creativeId   | 广告系列的创意 ID。默认为空字字符串。                                                                                                       | 字符串  |

## 注意##notes

* LevelPlay AdInfo 表示成功加载的最后一个广告。加载失败回调中不包含此属性，因为没有可用的广告。