通过

酒店组记录 - 批量

  • 项目

定义可在批量文件中上传的酒店组记录。

注意

此页面引用了未弃用但已替换的酒店广告版本。 建议使用 AdGroupHotelListingGroup 执行批量操作。

以下批量 CSV 示例将更新酒店集团出价和平板电脑出价乘数。

Type,Name,Id,Parent Id,Client Id,Modified Time,Bid,Bid Type,Device Tablet
Format Version,6,,,,,,,
Hotel Group,,HotelGroupIdGoesHere,SubAccountIdGoesHere,MyHotelGroupClientId,,13.2,Fixed,1.06

对于 酒店组 记录，可通过 批量上传获取以下属性字段。

重要

酒店可以从其父酒店组继承 Bid ，同时指定自己的出价乘数，反之亦然。 出价乘数包括 提前预订窗口乘数 1-10、 签入星期一 - 星期日、 国家/地区 AA-ZZ、 DateType Default、 DateType Selected、 Device Desktop、 Device Mobile、 Device Tablet、 Stay of Stay 1-14、 Site LocalUniversal、 Site MapResults 和 Site PropertyPromotionAd。

如果为酒店组设置了任何出价乘数，则酒店组不会从其父子帐户继承任何出价乘数。 如果只想更新出价，请确保将所有出价乘数留空。 如果酒店组已具有出价乘数，并且你想要开始继承父子帐户的出价乘数，则可以将 出价乘数源 设置为“InheritFromParent”或删除每个酒店组出价乘数。

另外，若要删除酒店组的出价并继承子帐户出价，只需将 “出价 ”字段设置为“delete_value”。

提前预订窗口最小天数 1-10

根据提前进行预留的天数调整出价，也称为高级预订窗口 (ABW) 。

批量文件最多包含 10 个 ABW 最小天数列，即 提前预订时段最小天数 1、 提前预订窗口最小天数 2、 提前预订时段最小天数 3、 提前预订时段最少天数 4、 提前预订时段最小天数 5、 提前预订时段最小天数 6、 提前预订时段最小天数 7、 提前预订时段最小天数 8、 提前预订时段最小天数 9， 提前预订窗口最小天数 10。

最小天数列指定 ABW 范围中 1 - 90 之间的最小天数，以应用乘数。 相应的 提前预订窗口乘数 1-10 列定义乘数因子。

更新： 选。 若要删除现有的 ABW 最小日数和乘数，请将此最小出价字段设置为要删除的最小日期，并将相应的 提前预订窗口乘数 1-10 字段设置为“delete_value”。

提前预订窗口乘数 1-10

用于调整相应 提前预订时段最小天数 1-10 的基本出价的百分比乘数 (ABW) 。

批量文件最多包含 10 个 ABW 乘数列，即 提前预订窗口乘数 1、 提前预订窗口乘数 2、 提前预订窗口乘数 3、 提前预订窗口乘数 4、 提前预订窗口乘数 5、 提前预订窗口乘数 6、 提前预订窗口乘数 7、 提前预订窗口乘数 8、 提前预订窗口乘数 9、 和 预预订窗口乘数 10。

此字段的有效范围为 0.00 到 11.00。 小于 1.00 的值会将基本出价降低高达 100%， (0.00) 。 大于 1.00 的值会将基本出价提高到 1,000%， (11.00) 。 如果不想调整基本出价，请将此字段设置为 1.00。

例如，如果固定出价为 $5，乘数为 1.05，则最终出价为 $5.25。 使用相同的乘数，如果百分比出价为 5%，总房价为 100 美元，则最终出价为 5.25 美元。

更新： 选。 若要删除现有的 ABW 最小天数和乘数，请将相应的 提前预订时段最小天数 1-10 字段设置为要删除的最小天数，并将此乘数字段设置为“delete_value”。

竞价

组中的酒店继承的基本出价（如果它们未指定出价）。

有效范围为 0.00 到 1000.00。

如果 “出价类型 ”为“固定”，则此 “出价 ”字段是固定的每晚出价金额。 例如，如果出价为 3.50，行程为 3 晚住宿，则最终出价为 10.50。 有关帐户货币的有效出价范围的详细信息，请参阅货币主题中的出价和预算货币部分。

如果 “出价类型 ”为“百分比”，则此 “出价 ”字段基于每晚总房价的百分比，包括税费和其他费用。 例如，若要出价会议室总费率的 3%，请将此字段设置为 3.0。 实际上，如果总房价为 99 美元，行程为 3 晚住宿，则最终出价为 8.91 美元。

更新： 选。 若要删除酒店组的出价并继承子帐户出价，请将此字段设置为“delete_value”。

出价乘数源

确定是否继承子帐户出价乘数。

如果将此字段设置为“InheritFromParent”，则将忽略酒店组出价乘数字段，并且酒店组将从其父子帐户继承出价乘数。

出价乘数包括 提前预订窗口乘数 1-10、 签入星期一 - 星期日、 国家/地区 AA-ZZ、 DateType Default、 DateType Selected、 Device Desktop、 Device Mobile、 Device Tablet、 Stay of Stay 1-14、 Site LocalUniversal、 Site MapResults 和 Site PropertyPromotionAd。

如果此字段为空，并且为酒店组设置了任何出价乘数，则酒店组将不再从其父子帐户继承任何出价乘数。

酒店组可以从其父子帐户继承 Bid ，同时指定自己的出价乘数，反之亦然。 若要删除酒店组的出价并继承子帐户出价，只需将 “出价 ”字段设置为“delete_value”。

更新： 选。 若要删除酒店组的出价乘数并继承子帐户出价乘数，请将此字段设置为“InheritFromParent”。

出价类型

确定 出价 是固定金额还是百分比。

可以将此字段设置为“固定”或“百分比”。

若要暂停组中的所有酒店，请指定一个百分比出价，并将其出价金额设置为零 (0) 。

更新： 选。 如果 Bid 设置为“delete_value”，则忽略此字段。

星期一至星期日签到

如果用户在指定的工作日之一签入，请调整出价。

批量文件最多包含 7 个签到列，即 签到星期一、签 到星期二、 签到星期三、 签到星期四、 签到星期五、 签到星期六和 签到星期天。

此字段的有效范围为 0.00 到 11.00。 小于 1.00 的值会将基本出价降低高达 100%， (0.00) 。 大于 1.00 的值会将基本出价提高到 1,000%， (11.00) 。 如果不想调整基本出价，请将此字段设置为 1.00。

例如，如果固定出价为 $5，乘数为 1.05，则最终出价为 $5.25。 使用相同的乘数，如果百分比出价为 5%，总房价为 100 美元，则最终出价为 5.25 美元。

更新： 选。 若要删除现有的签中出价乘数，请将相应的字段设置为“delete_value”。 例如，如果不想再修改星期三的基本出价，请将 “签到星期三 ”字段设置为“delete_value”。

客户端 ID

用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。

更新： 选

国家/地区 AA-ZZ

如果用户访问了必应域之一，则按 调整基本出价。

如果用户使用相应的国家/地区代码访问必应域，则应用乘数。 例如，如果在 “美国国家/地区 ”和 “国家/地区 DE ”字段中设置了出价乘数，则如果用户将 Bing.com 与 us 或 de country 代码 (（例如 bing.com？cc=de) ）使用乘数。

批量文件包括每个国家/地区代码的列，例如 ，国家/地区 AD、 国家/地区 AE、 国家/地区 AF、 国家 AG、 国家/地区 AI、 国家/地区 AL、 国家/地区 AM、 国家/地区 AN、 国家 AO、 国家 AQ、 国家/地区 AR、 国家/地区 AS、 国家/地区 AT、 国家/地区 AU、 国家/地区 AW、 国家/地区 AZ、 国家/地区 BA、 国家/地区 BB、 国家 BD、 国家/地区 BE、 Country BF、 Country BG、 Country BH、 Country BI、 Country BJ、 Country BM、 Country BN、 Country BO、 Country BR、 Country BS、 Country BT、 Country BW、 Country BY、 Country BZ、 Country CA、 Country CC、 Country CD、 Country CF、 Country CG、 Country CH、 Country CI、 Country CK、 Country CL、 Country CM、 Country CN、 Country CO、 Country CR、 Country CV、 Country CX、 Country CY、 Country CZ、 Country DE、 Country DJ、 Country DK、 Country DM、 Country DO、 Country DZ、 Country EC、 Country EE、 Country EG、 Country ER、 Country ES、 Country ET、 国家 FI、 Country FJ、 Country FK、 Country FM、 Country FO、 Country FR、 Country GA、 Country GB、 Country GD、 Country GE、 Country GF、 Country GH、 Country GI、 Country GL、 Country GM、 Country GN、 Country GP、 Country GQ、 Country GR、 Country GT、 Country GU、 Country GW、 Country GY、 Country HK、 Country HN、 Country HR、 Country HT、 Country HU、 Country ID、 Country IE、 Country IL、 Country IN、 Country IQ、 Country IS、 Country IT、 Country JM、 Country JO、 Country JP、 Country KE、 Country KG、 Country KH、 Country KI、 Country KM、 Country KN、 Country KR、 Country KW、 Country KY、 Country KZ、 Country LA、 Country LB、 Country LC、 Country LI、 Country LK、 Country LR、 Country LS、 Country LT、 Country LU、 Country LV、 Country LY、 Country MA、 Country MC、 Country MD、 Country ME、 Country MG、 Country MH、 Country MK、 Country ML、 Country MM、 Country MN、 Country MO、 Country MP、 Country MQ、 Country MR、 Country MS、 Country MT、 Country MU、 Country MV、 Country MW、 Country MX、 Country MY、 Country MZ、 Country NA、 Country NC、 Country NE、 Country NF、 Country NG、 Country NI、 Country NL、 Country NO、 Country NP、 Country NR、 Country NU、 Country NZ、 Country OM、 Country PA、 Country PE、 Country PF、 Country PG、 Country PH、 Country PK、 CountryPL、 Country PM、 Country PN、 Country PR、 Country PS、 Country PT、 Country PW、 Country PY、 Country QA、 Country RE、 Country RO、 Country RS、 Country RU、 Country RW、 Country SA、 Country SB、 Country SC、 Country SE、 Country SG、 Country SH、 Country SI、 Country SK、 Country SL、 Country SM、 Country SN、 Country SO、 Country SR、 Country ST、 Country SV、 Country SZ、 Country TC、 Country TD、 Country TG、 Country TH、 Country TJ、 Country TK、 Country TL、 Country TM、 Country TN、 Country TO、 Country TR、 Country TT、 Country TV、 Country TW、 Country TZ、 Country UA、 Country UG、 Country US、 Country UY、 Country UZ、 Country VA、 Country VC、 Country VE、 Country VG、 Country VI、 Country VN、 Country VU、 Country WF、 Country WS、 Country YE、 Country YT、 Country ZA、 Country ZM 和 Country ZW。

此字段的有效范围为 0.00 到 11.00。 小于 1.00 的值会将基本出价降低高达 100%， (0.00) 。 大于 1.00 的值会将基本出价提高到 1,000%， (11.00) 。 如果不想调整基本出价，请将此字段设置为 1.00。

例如，如果固定出价为 $5，乘数为 1.05，则最终出价为 $5.25。 使用相同的乘数，如果百分比出价为 5%，总房价为 100 美元，则最终出价为 5.25 美元。

更新： 选。 若要删除现有的国家/地区出价乘数，请将相应的字段设置为“delete_value”。 例如，如果不再需要修改 US 和 DE 的基本出价，请将“ 美国国家/地区 ”和“ 国家/地区 DE ”字段都设置为“delete_value”。

DateType 默认值

如果用户未使用特定日期搜索酒店，请调整基本出价。

此字段的有效范围为 0.00 到 11.00。 小于 1.00 的值会将基本出价降低高达 100%， (0.00) 。 大于 1.00 的值会将基本出价提高到 1,000%， (11.00) 。 如果不想调整基本出价，请将此字段设置为 1.00。

例如，如果固定出价为 $5，乘数为 1.05，则最终出价为 $5.25。 使用相同的乘数，如果百分比出价为 5%，总房价为 100 美元，则最终出价为 5.25 美元。

更新： 选。 若要删除现有的默认日期出价乘数，请将此字段设置为“delete_value”。

已选择 DateType

如果用户使用特定日期搜索酒店，请调整基本出价。

此字段的有效范围为 0.00 到 11.00。 小于 1.00 的值会将基本出价降低高达 100%， (0.00) 。 大于 1.00 的值会将基本出价提高到 1,000%， (11.00) 。 如果不想调整基本出价，请将此字段设置为 1.00。

例如，如果固定出价为 $5，乘数为 1.05，则最终出价为 $5.25。 使用相同的乘数，如果百分比出价为 5%，总房价为 100 美元，则最终出价为 5.25 美元。

更新： 选。 若要删除现有的所选日期出价乘数，请将此字段设置为“delete_value”。

设备桌面

如果用户使用桌面设备搜索酒店，请调整基本出价。

此字段的有效范围为 0.00 到 11.00。 小于 1.00 的值会将基本出价降低高达 100%， (0.00) 。 大于 1.00 的值会将基本出价提高到 1,000%， (11.00) 。 如果不想调整基本出价，请将此字段设置为 1.00。

例如，如果固定出价为 $5，乘数为 1.05，则最终出价为 $5.25。 使用相同的乘数，如果百分比出价为 5%，总房价为 100 美元，则最终出价为 5.25 美元。

更新： 选。 若要删除现有的桌面出价乘数，请将此字段设置为“delete_value”。

设备移动设备

如果用户使用智能手机设备搜索酒店，请调整基本出价。

此字段的有效范围为 0.00 到 11.00。 小于 1.00 的值会将基本出价降低高达 100%， (0.00) 。 大于 1.00 的值会将基本出价提高到 1,000%， (11.00) 。 如果不想调整基本出价，请将此字段设置为 1.00。

例如，如果固定出价为 $5，乘数为 1.05，则最终出价为 $5.25。 使用相同的乘数，如果百分比出价为 5%，总房价为 100 美元，则最终出价为 5.25 美元。

更新： 选。 若要删除现有的智能手机出价乘数，请将此字段设置为“delete_value”。

设备平板电脑

如果用户使用平板电脑设备搜索酒店，请调整基本出价。

此字段的有效范围为 0.00 到 11.00。 小于 1.00 的值会将基本出价降低高达 100%， (0.00) 。 大于 1.00 的值会将基本出价提高到 1,000%， (11.00) 。 如果不想调整基本出价，请将此字段设置为 1.00。

例如，如果固定出价为 $5，乘数为 1.05，则最终出价为 $5.25。 使用相同的乘数，如果百分比出价为 5%，总房价为 100 美元，则最终出价为 5.25 美元。

更新： 选。 若要删除现有的平板电脑出价乘数，请将此字段设置为“delete_value”。

Id

唯一标识酒店组的系统生成的 ID。

更新： 只读和必需

停留时间 1-14

如果用户停留指定的天数或更长时间，请调整出价。

批量文件包含最多 14 个长度的停留乘数列，即 ，留出 1、 停留 2、 停留 3、 停留时长 4、 停留时长 5、 停留时长 6、 停留时长 7、 停留时长 8、停留时长 9、 停留时长 10、 停留时长 11、 停留时长 12、 停留时长 13 和 停留时长 14。

列后缀表示应用乘数所需的最小晚数。 如果用户停留指定的天数或更长时间，则应用乘数，如果设置了下一个最长的停留乘数，则应用乘数。 例如，如果将 “停留时间 1” 设置为 1.10，将 “停留时间 1” 设置为 1.20，则 10% 乘数适用于 1-7 晚的停留时间，20% 乘数用于 8 晚或以上的停留时间。

此字段的有效范围为 0.00 到 11.00。 小于 1.00 的值会将基本出价降低高达 100%， (0.00) 。 大于 1.00 的值会将基本出价提高到 1,000%， (11.00) 。 如果不想调整基本出价，请将此字段设置为 1.00。

例如，如果固定出价为 $5，乘数为 1.05，则最终出价为 $5.25。 使用相同的乘数，如果百分比出价为 5%，总房价为 100 美元，则最终出价为 5.25 美元。

更新： 选。 若要删除现有停留出价乘数长度，请将相应的字段设置为“delete_value”。 例如，如果不想再修改 8 晚或以上住宿的基本出价，请将“ 停留 8”字段 设置为“delete_value”。

修改时间

上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。

注意

日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。

更新： 只读

父 ID

系统生成的 ID，用于唯一标识包含酒店组的子帐户。

子帐户定义顶级酒店价格广告分组。 你可以从逻辑上将此视为住宿运动。

更新： 只读和必需

Site LocalUniversal

如果用户在 Bing.com 搜索酒店，请调整基本出价。

此字段的有效范围为 0.00 到 11.00。 小于 1.00 的值会将基本出价降低高达 100%， (0.00) 。 大于 1.00 的值会将基本出价提高到 1,000%， (11.00) 。 如果不想调整基本出价，请将此字段设置为 1.00。

例如，如果固定出价为 $5，乘数为 1.05，则最终出价为 $5.25。 使用相同的乘数，如果百分比出价为 5%，总房价为 100 美元，则最终出价为 5.25 美元。

更新： 选。 若要删除现有的出价乘数，请将此字段设置为“delete_value”。

Site MapResults

如果用户在 Bing.com/maps 上搜索酒店，请调整基本出价。

此字段的有效范围为 0.00 到 11.00。 小于 1.00 的值会将基本出价降低高达 100%， (0.00) 。 大于 1.00 的值会将基本出价提高到 1,000%， (11.00) 。 如果不想调整基本出价，请将此字段设置为 1.00。

例如，如果固定出价为 $5，乘数为 1.05，则最终出价为 $5.25。 使用相同的乘数，如果百分比出价为 5%，总房价为 100 美元，则最终出价为 5.25 美元。

更新： 选。 若要删除现有的出价乘数，请将此字段设置为“delete_value”。

Site PropertyPromotionAd

如果酒店广告显示在地图搜索中显示的第一个结果页中，则调整基本出价。

注意

Site PropertyPromotionAd 仅适用于试点客户， (GetCustomerPilotFeatures 返回 764) 。

此字段的有效范围为 0.00 到 11.00。 小于 1.00 的值会将基本出价降低高达 100%， (0.00) 。 大于 1.00 的值会将基本出价提高到 1,000%， (11.00) 。 如果不想调整基本出价，请将此字段设置为 1.00。

例如，如果固定出价为 $5，乘数为 1.05，则最终出价为 $5.25。 使用相同的乘数，如果百分比出价为 5%，总房价为 100 美元，则最终出价为 5.25 美元。

更新： 选。 若要删除现有的出价乘数，请将此字段设置为“delete_value”。