注意:无法在新账号中启用 Ad Exchange 数据传输。
数据传输功能可提供与客户的 Ad Exchange 交易有关的事件级报表。数据传输报表中的信息未进行无效活动过滤。
Google Cloud Storage
Google Cloud Storage 每天(按太平洋时间)都会发送一次数据传输报表。您无需注册 Google Cloud Storage 账号,只需选择一个或多个将查看报表的 Ad Exchange 用户即可。用户可以在已验证了身份的浏览器会话 (sandbox.google.com/storage) 中下载报表,也可以使用下列工具之一下载报表:
详细了解 Google Cloud Storage 身份验证。
不要使用 Google Storage Manager 获取 Ad Exchange 数据传输报表,因为此工具只会显示您拥有的存储分区。
通知
有权访问 Google Cloud Storage 的用户都会在有新数据传输文件传送到 Google Cloud Storage 时收到一封通知电子邮件。此类电子邮件提供以下信息:
- 已发送报表文件的名称
- 包含文件的 Google Cloud Storage 存储桶
- 用于在浏览器中登录并下载报表的链接
了解数据传输报报告
所有数据传输报告均以 .CSV 和/或 Parquet 格式提供。数据传输报表分为两种:
- 展示次数和点击次数
提供以下信息:媒体资源投放的展示次数,以及是否记录了点击次数。此类报表包含多个文件,每个文件对应于 1 小时。 - 广告位属性
提供有关自定义广告位属性的信息。我们会提供媒体资源级设置以显示可沿用的属性,也会提供单个广告位的附加设置(若需获得特定广告位的有效属性列表,则可合并这些设置)。此类报表包含一个与日期对应的文件。
数据传输报表文件中的每一行代表一个 Ad Exchange 交易。要详细了解数据,请展开以下部分。
注意:标为“可选”的字段有时可能不存在,在这种情况下,其在报告中会显示为空白/空字段。布尔值显示为
展示次数和点击次数
true
或 false
。整数/浮点值采用十进制表示法。示例:
TOEw6QAElpQK2l8H8LRh9g,2016-05-17 05:08:57,false,Some Buyer Network, www.examplesite.com,,http://www.examplesite.com/examplepath?%2Cxxx&nodebug=1,false,true,true,,docvertical::258,Sports,4,123456789, 0.00140351999645645,0.649999,false,false,1,0,0,Some DSP,Some Advertiser
字段 | 说明 | 类型 | 是否必需? |
---|---|---|---|
query_id |
唯一广告请求标识符。 | 字符串 | 是 |
datetime |
收到广告请求的日期和时间(采用太平洋时间)。 | 字符串 | 是 |
is_anonymous |
已弃用 Ad Manager 中不再有“匿名展示”概念。 |
布尔值 | 否 |
buyer |
获胜买方的名称。对于视频广告连播,这是胜出买方(以“+”号分隔)列表。 | 字符串 | 否 |
DEPRECATED_sitename |
使用 referer_url 字段。 |
字符串 | 否 |
anonymous_id |
已弃用。 | 字符串 | 否 |
referer_url |
相应广告请求对应的网址。 | 字符串 | 否 |
allow_data_collection_for_interest_targeting |
是否允许针对相应展示收集用于兴趣定位的数据。 | 布尔值 | 否 |
allow_user_list_targeting |
相应展示是否允许进行用户列表定位。 | 布尔值 | 否 |
allow_user_interest_targeting |
相应展示是否允许进行用户兴趣定位。 | 布尔值 | 否 |
matched_geo_list |
使用 ISO 3166-1/ISO 3166-2 代码的地理位置信息(以“+”号分隔)列表。 | 字符串 | 否 |
matched_verticals_list |
用 docvertical::xxx 表示的发布商行业(以“+”号分隔,其中 xxx 是数字代码)。 |
字符串 | 否 |
channels |
跟踪渠道名称(以“+”号分隔)。 | 字符串 | 否 |
ad_type |
必须解读为位图。ad_type & 0x1 表示展示了文字广告。ad_type & 0x2 表示展示了静态或动态图片广告。ad_type & 0x4 表示展示了其他类型的广告。 |
int32 | 否 |
client_ip |
已弃用 接收此广告请求的 IP 地址。整个八位字节设为 0,以保护客户隐私。 |
字符串 | 否 |
adslot_code |
Ad Exchange 代码 ID。 | 字符串 | 否 |
seller_impression_revenue_usd |
相应展示给发布商带来的收入(以美元计)。 | 双精度 | 否 |
seller_reserve_price_usd |
应用的每千次展示费用预订价格(以美元计)。 | 双精度 | 否 |
was_userlist_targeted |
相应展示是否采用了用户列表定位。 | 布尔值 | 否 |
was_match_on_keyword |
相应展示是否有成功的关键字匹配。 | 布尔值 | 否 |
num_clicks |
是否记录了点击。以布尔值表示,为 0 或 1。 | int32 | 是 |
transaction_type |
交易类型(0 = 公开竞价,1 = 首选交易,2 = 私下竞价,3 = 有保证的程序化交易,4 = 优先认购)。 | int32 | 否 |
deal_ids |
胜出展示的交易 ID(以“+”号分隔)。 | 字符串 | 否 |
buyer_network_names |
DSP 的广告联盟名称(以“+”号分隔)。 | 字符串 | 否 |
advertiser |
赢得相应展示机会的广告客户名称(以“+”号分隔)。 | 字符串 | 否 |
示例:
ca-pub-123456789,property_wide,26+110+9+12+1+55+5+11+6+57+17+8+113+60+2+65+7+69+70+4+18+13+3+14+92+94+19+96,,firstblockedurl.com+secondblockedurl.com+thirdblockedurl.com
ca-pub-123456789,987654321,,10,
字段 | 说明 | 类型 | 是否必需? |
property_code |
Ad Exchange 媒体资源代码。 | 字符串 | 是 |
adslot_code |
Ad Exchange 代码 ID。 如果值是 site_wide ,则表明使用了 Ad Exchange 账号级或媒体资源级设置。 |
字符串 | 是 |
allowed_vendor_types |
用数字表示的供应商类型(以“+”号分隔)。该字段不适用于屏蔽类保护措施会被覆盖的交易。 有关详情,请参阅实时出价协议。 |
字符串 | 否 |
allowed_video_formats |
视频文件格式(以“+”号分隔)。有关详情,请参阅实时出价协议。 | 字符串 | 否 |
blocked_urls |
已屏蔽的网址(以“+”号分隔)。 | 字符串 | 否 |