如何通过DV360 API获取曝光、点击等绩效指标？Python实现咨询

你用的SDF（结构化数据文件）API本来就是用来获取资源配置信息（比如广告系列设置、广告素材详情）的，绩效类指标确实不在SDF的返回范围内。要拿曝光、点击、收入这类数据，得用DV360的Reporting API（即Report Service），这是专门针对投放绩效数据设计的接口。

核心步骤 #

• 构建包含目标维度（如日期、广告系列）和指标（曝光、点击、收入）的报告请求
• 提交报告生成任务，等待任务完成
• 下载生成的报告文件（支持CSV、JSON等格式）

Python代码示例 #

使用Google官方的google-api-python-client库实现：

from googleapiclient.discovery import build
from google.oauth2 import service_account
import requests
import time

# 加载服务账号密钥文件
credentials = service_account.Credentials.from_service_account_file(
    'your-service-account-key.json',
    scopes=['https://www.googleapis.com/auth/display-video']
)

# 初始化DV360 Reporting API客户端
dv360_client = build('displayvideo', 'v3', credentials=credentials)

# 定义报告参数
report_spec = {
    "displayName": "Campaign Performance Report",
    "dateRange": {
        "startDate": {"year": 2024, "month": 5, "day": 1},
        "endDate": {"year": 2024, "month": 5, "day": 31}
    },
    # 指定需要的绩效指标
    "metrics": ["METRIC_IMPRESSIONS", "METRIC_CLICKS", "METRIC_REVENUE_ADVERTISER"],
    # 指定分组维度
    "dimensions": ["DIMENSION_DATE", "DIMENSION_CAMPAIGN_NAME", "DIMENSION_ADVERTISER_NAME"],
    "format": "FORMAT_CSV"
}

# 创建报告任务
report_response = dv360_client.reports().create(body=report_spec).execute()
report_id = report_response["reportId"]

# 轮询等待报告生成完成
while True:
    report_status = dv360_client.reports().get(reportId=report_id).execute()
    if report_status["status"] == "REPORT_STATUS_DONE":
        # 下载报告文件
        download_link = report_status["downloadUrl"]
        csv_data = requests.get(
            download_link,
            headers={"Authorization": f"Bearer {credentials.token}"}
        )
        with open("dv360_performance_report.csv", "wb") as f:
            f.write(csv_data.content)
        print("报告下载完成")
        break
    time.sleep(15)  # 每15秒检查一次状态

注意事项 #

• 指标名称必须严格匹配API定义的枚举值，比如收入可选择METRIC_REVENUE_ADVERTISER（广告主侧收入）或METRIC_REVENUE_PUBLISHER（发布商侧收入）
• 维度与指标的组合需符合API规则，部分维度和指标无法搭配使用，可参考官方文档的维度指标映射表
• 服务账号需拥有DV360的报告查看权限，否则会返回权限错误

内容的提问来源于stack exchange，提问作者Pkr