从 AdX Seller REST API 迁移

Google Ad Manager 提供了一个用于报告和操纵广告投放管理实体(如 LineItems)的 SOAP API。 客户端库提供多种语言版本。与 AdX Seller API 一样,Ad Manager API 也使用 OAuth2 进行身份验证

若要开始发出您的第一个 API 请求,请参阅使用入门

Ad Manager API 中的报表

Ad Manager API ReportService提供了两种生成和下载报表的方法:

  1. 在界面中创建查询并根据其 ID 运行查询。
  2. 构建临时的 ReportQuery

无论采用哪种方法,API 工作流程都包括四个步骤:

  1. 调用 runReportJob
  2. 使用 getReportJobStatus 轮询报告状态。
  3. 使用 getReportDownloadUrlWithOptions 获取指向已完成报表的网址。
  4. 通过返回的网址下载报告。

如需了解详情,请参阅报告指南

报告时区

与 Ad Exchange Seller REST API 不同,在 Ad Manager API 中,报表默认采用您广告资源网的时区。如需更改此设置,请设置 TimeZoneType 字段。

AdX 与 Ad Manager 之间的指标和维度对应关系

Ad Manager Reporting API 中现在包含所有受支持的 Ad Exchange Seller REST API 指标和维度。我们更改了部分名称,还有一些名称已弃用。如需了解详情,请参阅下表。

指标 / 列

下表列出了 AdX 指标与 Ad Manager 列的对应关系。

AdX 指标Ad Manager 列Ad Manager 查询工具名称
ACTIVE_VIEW_ELIGIBLE_COUNT AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS 启用了 Active View 的展示次数
ACTIVE_VIEW_MEASURABLE_COUNT AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS Active View 衡量的展示次数
ACTIVE_VIEW_MEASURABLE_RATIO (已弃用) (已弃用)
ACTIVE_VIEW_VIEWABLE_COUNT AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS Active View 可见的展示次数
ACTIVE_VIEW_VIEWABLE_RATIO (已弃用) (已弃用)
ACTIVE_VIEW_VIEWABLE_TIME AD_EXCHANGE_AVERAGE_VIEWABLE_TIME 平均可见时间(秒)
AD_IMPRESSIONS AD_EXCHANGE_IMPRESSIONS 广告展示次数
AD_IMPRESSIONS_RPM AD_EXCHANGE_AD_ECPM 广告 eCPM
AD_REQUESTS AD_EXCHANGE_AD_REQUESTS 广告请求数
AD_REQUESTS_COVERAGE AD_EXCHANGE_COVERAGE 覆盖率
AD_REQUESTS_CTR AD_EXCHANGE_AD_REQUEST_CTR 广告请求点击率
AD_REQUESTS_RPM AD_EXCHANGE_AD_REQUEST_ECPM 广告请求 eCPM
点击次数 AD_EXCHANGE_CLICKS Clicks
COST_PER_CLICK AD_EXCHANGE_CPC CPC
DEALS_AD_REQUESTS AD_EXCHANGE_DEALS_AD_REQUESTS 交易广告请求数
DEALS_BID_RESPONSES AD_EXCHANGE_DEALS_BID_RESPONSES 交易出价响应数
DEALS_MATCH_RATE AD_EXCHANGE_DEALS_MATCH_RATE 交易匹配率
DEALS_MATCHED_REQUESTS AD_EXCHANGE_DEALS_MATCHED_REQUESTS 交易匹配请求数
收入 AD_EXCHANGE_ESTIMATED_REVENUE 估算收入
INDIVIDUAL_AD_IMPRESSIONS (已弃用) (已弃用)
INDIVIDUAL_AD_IMPRESSIONS_CTR AD_EXCHANGE_AD_CTR 广告点击率
INDIVIDUAL_AD_IMPRESSIONS_RPM (新推荐)AD_EXCHANGE_AD_ECPM (新推荐)广告 eCPM
LIFT_RATE AD_EXCHANGE_LIFT 上升
MATCHED_AD_REQUESTS AD_EXCHANGE_MATCHED_REQUESTS 匹配的请求数
MATCHED_AD_REQUESTS_CTR AD_EXCHANGE_CTR CTR
MATCHED_AD_REQUESTS_RPM AD_EXCHANGE_MATCHED_ECPM 匹配 eCPM
VIDEO_AD_ABANDONMENT_RATIO AD_EXCHANGE_VIDEO_ABANDONMENT_RATE 视频广告放弃率
VIDEO_AD_DROPOFF_RATIO AD_EXCHANGE_VIDEO_DROPOFF_RATE 视频广告流失率
VIDEO_AD_QUARTILE_ONE AD_EXCHANGE_VIDEO_QUARTILE_1 视频四分之一处
VIDEO_AD_QUARTILE_THREE AD_EXCHANGE_VIDEO_QUARTILE_3 视频四分之三
VIDEO_AD_SKIPPABLE_SKIP_RATIO AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE TrueView 跳过率
VIDEO_AD_SKIPPABLE_VIEWS AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS TrueView 观看次数
VIDEO_AD_SKIPPABLE_VTR AD_EXCHANGE_VIDEO_TRUEVIEW_VTR TrueView 完整观看率

维度

下表列出了 AdX 维度与 Ad Manager 维度的对应关系。

AdX 维度Ad Manager 维度Ad Manager 查询工具名称
AD_CLIENT_ID AD_EXCHANGE_WEB_PROPERTY_CODE 网络媒体资源
AD_LOCATION AD_EXCHANGE_AD_LOCATION 广告位置
AD_TAG_NAME AD_EXCHANGE_TAG_NAME 标签
AD_UNIT_SIZE_CODE AD_EXCHANGE_INVENTORY_SIZE_CODE (不可用)
AD_UNIT_SIZE_NAME AD_EXCHANGE_INVENTORY_SIZE 广告资源尺寸
ADVERTISER_DOMAIN AD_EXCHANGE_ADVERTISER_DOMAIN 广告客户域名
ADVERTISER_NAME AD_EXCHANGE_ADVERTISER_NAME 广告客户
ADVERTISER_VERTICAL AD_EXCHANGE_ADVERTISER_VERTICAL 广告客户所在行业
AGENCY_NAME AD_EXCHANGE_AGENCY 代理机构
BID_TYPE_CODE AD_EXCHANGE_BID_TYPE_CODE (不可用)
BRAND_NAME AD_EXCHANGE_BRAND_NAME 品牌
BRANDING_TYPE_CODE AD_EXCHANGE_BRANDING_TYPE_CODE (不可用)
BRANDING_TYPE_NAME AD_EXCHANGE_BRANDING_TYPE 品牌类型
BUYER_NETWORK_ID AD_EXCHANGE_BUYER_NETWORK_ID (不可用)
BUYER_NETWORK_NAME AD_EXCHANGE_BUYER_NETWORK_NAME 买方联盟
COUNTRY_CODE AD_EXCHANGE_COUNTRY_CODE (不可用)
COUNTRY_NAME AD_EXCHANGE_COUNTRY_NAME 国家/地区
CREATIVE_SIZE AD_EXCHANGE_CREATIVE_SIZES 广告素材尺寸
CUSTOM_CHANNEL_CODE AD_EXCHANGE_CUSTOM_CHANNEL_CODE (不可用)
CUSTOM_CHANNEL_ID AD_EXCHANGE_CUSTOM_CHANNEL_ID (不可用)
CUSTOM_CHANNEL_NAME AD_EXCHANGE_CHANNEL_NAME 频道
日期 AD_EXCHANGE_DATE 星期几
DEAL_ID AD_EXCHANGE_DEAL_ID 交易 ID
DEAL_NAME AD_EXCHANGE_DEAL_NAME 交易名称
DFP_AD_UNIT_ID AD_EXCHANGE_DFP_AD_UNIT_ID (不可用)
DFP_AD_UNITS AD_EXCHANGE_DFP_AD_UNIT DFP 广告单元
DFP_REQUEST_SOURCE AD_EXCHANGE_REQUEST_SOURCES 请求来源
DOMAIN_NAME AD_EXCHANGE_SITE_NAME 协作平台
DSP_NAME AD_EXCHANGE_DSP_BUYER_NETWORK_NAME DSP
EXPANSION_TYPE_NAME AD_EXCHANGE_EXPANSION_TYPE 展开式广告类型
INVENTORY_OWNERSHIP AD_EXCHANGE_INVENTORY_OWNERSHIP 广告资源所有权
INVENTORY_PARTNER_NAME AD_EXCHANGE_NETWORK_PARTNER_NAME 广告资源网合作伙伴名称
MOBILE_APP_NAME AD_EXCHANGE_MOBILE_APP_NAME 应用名称
MOBILE_CARRIER_NAME AD_EXCHANGE_MOBILE_CARRIER_NAME 运营商名称
MOBILE_DEVICE_NAME AD_EXCHANGE_MOBILE_DEVICE_NAME 设备
MOBILE_INVENTORY_TYPE AD_EXCHANGE_MOBILE_INVENTORY_TYPE 广告资源类型
MOBILE_OS_VERSION AD_EXCHANGE_OPERATING_SYSTEM 操作系统
MOBILE_USER_BANDWIDTH AD_EXCHANGE_USER_BANDWIDTH_NAME 带宽
AD_EXCHANGE_MONTH
PLATFORM_TYPE_NAME AD_EXCHANGE_DEVICE_CATEGORY 设备类别
PRODUCT_CODE AD_EXCHANGE_PRODUCT_CODE (不可用)
PRODUCT_NAME AD_EXCHANGE_PRODUCT_NAME 产品
TARGETING_TYPE_CODE AD_EXCHANGE_TARGETING_TYPE_CODE (不可用)
TARGETING_TYPE_NAME AD_EXCHANGE_TARGETING_TYPE 定位类型
TRANSACTION_TYPE_CODE AD_EXCHANGE_TRANSACTION_TYPE_CODE (不可用)
TRANSACTION_TYPE_NAME AD_EXCHANGE_TRANSACTION_TYPE 交易类型
URL_CHANNEL_ID AD_EXCHANGE_URL_ID (不可用)
URL_CHANNEL_NAME AD_EXCHANGE_URL 网址
VIDEO_AD_DURATION AD_EXCHANGE_VIDEO_AD_DURATION (不可用)
VIDEO_AD_DURATION_RAW AD_EXCHANGE_VIDEO_AD_DURATION_RAW 视频广告时长
VIDEO_AD_FORMAT AD_EXCHANGE_VIDEO_AD_TYPE 视频广告类型
AD_EXCHANGE_WEEK
WINNING_BID_RULE_ID AD_EXCHANGE_PRICING_RULE_ID (不可用)
WINNING_BID_RULE_NAME AD_EXCHANGE_PRICING_RULE_NAME 定价规则