针对卖方的 Ad Exchange 数据传输指南

无法在新帐号中启用 Ad Exchange 数据传输。

数据传输功能可提供与客户的 Ad Exchange 交易有关的事件级报表。数据传输报表中的信息未进行无效活动过滤。

Google Cloud Storage

Google Cloud Storage 每天（按太平洋时间）都会发送一次数据传输报表。您无需注册 Google Cloud Storage 帐号，只需选择一个或多个将查看报表的 Ad Exchange 用户即可。
用户可以在已验证了身份的浏览器会话 (sandbox.google.com/storage) 中下载报表，也可以使用下列工具之一下载报表：

• GSUtil/Boto (Python)
• Jets3t (Java) | 查看代码示例

详细了解 Google Cloud Storage 身份验证。

不要使用 Google Storage Manager 获取 Ad Exchange 数据传输报表，因为此工具只会显示您拥有的存储分区。

通知

每当 Google 云端存储发送新的数据传输文件时，可以访问 Google 云端存储的用户都会收到一封通知电子邮件。此类电子邮件提供以下信息：

• 已发送报表文件的名称
• 包含文件的 Google 云端存储分区
• 用于在浏览器中登录并下载报表的链接

了解数据传输报表

所有数据传输报表均采用 CSV 文件格式。数据传输报表分为两种：

• 展示次数和点击次数
  提供以下信息：媒体资源投放的展示次数，以及是否记录了点击次数。此类报表包含多个文件，每个文件对应于 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	用数字表示的供应商类型（以“+”号分隔）。该字段不适用于屏蔽类保护措施会被覆盖的交易。 供应商代码 Google 展示广告网络供应商代码 有关详情，请参阅实时出价协议。	字符串	否
allowed_video_formats	视频文件格式（以“+”号分隔）。有关详情，请参阅实时出价协议。	字符串	否
blocked_urls	已屏蔽的网址（以“+”号分隔）。	字符串	否