图像广告扩展记录 - 批量

项目
11/13/2024

定义可在批量文件中下载和上传的图像广告扩展。

可以将图像广告扩展插件与帐户或帐户中的市场活动及广告组相关联。每个帐户最多可以有 250,000 个市场活动图像扩展关联，以及多达 250,000 个广告组图像扩展关联。 (帐户、市场活动或广告组) 的每个实体最多可与 25 个图像广告扩展相关联。使用帐户图像广告扩展、广告组图像广告扩展和市场活动图像广告扩展记录来管理图像广告扩展插件关联。

通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 ImageAdExtensions 的 DownloadEntity 值，可以下载帐户中的所有 Image Ad 扩展记录。此外，下载请求必须包括 EntityData 范围。有关批量服务的更多详细信息（包括最佳做法），请参阅批量下载和上传。

以下批量 CSV 示例会将新的图像广告扩展添加到帐户的共享库。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Alternative Text,Media Ids,Final Url Suffix
Format Version,,,,,,,,,,,6.0,,,,,
Image Ad Extension,Active,-14,0,,,ClientIdGoesHere,,,,,,,FALSE,ImageAdExtension Alternative Text,ImageMediaIdHere,

如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkImageAdExtension 对象，而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkImageAdExtension
var bulkImageAdExtension = new BulkImageAdExtension
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // ImageAdExtension object of the Campaign Management service.
    ImageAdExtension = new ImageAdExtension
    {
        // 'Alternative Text' column header in the Bulk file
        AlternativeText = "ImageAdExtension Alternative Text",
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Id' column header in the Bulk file
        Id = imageAdExtensionIdKey,
        // 'Media Ids' column header in the Bulk file
        ImageMediaIds = new long[] { ImageMediaIdHere },
        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkImageAdExtension);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

对于 图像广告扩展记录 ，批量文件架构中提供了以下属性字段。

广告计划
可选文字
客户端 ID
自定义参数
目标 URL
显示文本
编辑位置
编辑原因代码
编辑状态
编辑术语
"结束日期"
最终 URL
最终 URL 后缀
Id
Images
布局
媒体 ID
移动最终 URL
修改时间
父 ID
发布者国家/地区
"开始日期"
状态
跟踪模板
使用搜索器时区
版本

广告计划

希望广告扩展插件随广告一起显示的日期和时间范围列表。每天和时间范围包括计划的星期几、开始/结束小时和开始/结束分钟。每天和时间范围都用左括号和右括号括起来，并用分号 (;) 分隔符分隔其他日期和时间范围。在每天和时间范围内，格式为 Day[StartHour：StartMinue-EndHour：EndMinute]。

StartHour 的可能值范围为 00 到 23，其中 00 相当于 12：00AM，12 等于中午 12：00。

EndHour 的可能值范围为 00 到 24，其中 00 相当于凌晨 12：00,12 等于中午 12：00。

StartMinute 和 EndMinute 的可能值范围为 00 到 60。

以下示例演示工作日从上午 9：00 到晚上 9：00 的日期和时间范围： (Monday[09：00-21：00]) ; (Tuesday[09：00-21：00]) ; (星期三[09：00-21：00]) ; (星期四[09：00-21：00]) ; (星期五[09：00-21：00])

添加： 选。如果未设置此字段，广告扩展插件将有资格在日历开始和结束日期期间随时进行计划。
更新： 选。无法更新单个日期和时间范围。可以通过发送应替换上一组的新集来有效地更新日期和时间范围。 “广告计划”、“结束日期 ”、“开始日期”和“使用搜索器时区”字段相互依赖，并一起更新。如果在更新期间将所有这些字段留空，则不会更新这些字段。如果包含其中任何字段的值，则会删除或替换所有这些字段的先前值。若要删除以前的所有计划设置，请将其中每个字段设置为 delete_value。
删除： 只读

可选文字

可用性的图像媒体的替代说明。如果无法显示图像，则改用备用文本。

此字段的最大长度为 90 个字符。

添加： 必填
更新： 选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

客户端 ID

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

添加： 选
更新： 选
删除： 只读

自定义参数

用于 URL 跟踪的键和值参数的自定义集合。

在批量文件中，自定义参数列表的格式如下所示。

将每个自定义参数对的格式设置为 Key=Value，例如 {_promoCode}=PROMO1。
Microsoft Advertising 将接受你包括的前 3 个自定义参数键和值对，并且将忽略任何其他自定义参数。对于自定义参数限制增加阶段 3 试点 (GetCustomerPilotFeatures 返回 635) 的客户，Microsoft Advertising 将接受你包含的前 8 个自定义参数键和值对，如果包含的自定义参数超过 8 个，将返回错误。
每个键值对由分号和空格 (“分隔;“) ，例如 {_promoCode}=PROMO1;{_season}=summer。
键不能包含分号。如果 Value 包含分号，则必须将其转义为“\;”。此外，如果 Value 包含反斜杠，则还必须将其转义为“\”。
键不能超过 16 个 UTF-8 字节，值不能超过 200 UTF-8 字节。对于自定义参数限制增加阶段 3 试点的客户 (GetCustomerPilotFeatures 返回 635) ，值限制增加到 250 UTF-8 字节。密钥是必需的，值是可选的。键的最大大小不包括大括号和下划线，即“{”、“_”和“}”。

注意

使用批量服务时，必须使用周围的大括号和前导下划线设置密钥的格式，例如，如果密钥是 promoCode，则必须将其格式设置为 {_promoCode}。使用市场活动管理服务时，不能指定周围的大括号和下划线。

添加： 选
更新： 选。如果未为更新设置任何值，则不会更改此设置。若要删除所有自定义参数，请将此字段设置为 delete_value。 delete_value关键字 (keyword) 删除以前的设置。若要删除自定义参数的子集，请指定要保留的自定义参数，并省略任何不想保留的参数。新的自定义参数集将替换以前的任何自定义参数集。
删除： 只读

目标 URL

当用户单击图像时要访问的网页的 URL。

URL 可以包含动态文本字符串，例如 {关键字 (keyword) }。有关详细信息，请参阅我可以使用哪些跟踪或 URL 参数？。

URL 最多可以包含 1,024 个字符。如果 URL 未指定协议，则当用户单击广告时，系统会使用 HTTP 协议。如果在添加广告时 URL 指定了 HTTP 协议，则服务将删除 http:// 协议字符串， (HTTP 协议字符串不计入 1,024 个字符限制) ;但是，该服务不会从 URL 中删除 HTTPS 协议字符串 (https：//) 。

注意

如果未为图像广告扩展指定 URL，则使用广告的 URL。

添加： 选。 注意： 多图像广告扩展需要此字段。 更新： 选。如果未为更新设置任何值，则不会更改此设置。 注意： 多图像广告扩展需要此字段。
删除： 只读

显示文本

图像扩展的显示文本。

此字段的最大长度为 35 个字符。

添加： 必填
更新： 必填。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

编辑位置

编辑评审失败的广告扩展插件的组件或属性。

添加： 只读
更新： 只读
删除： 只读

编辑原因代码

标识失败原因的代码。有关可能的原因代码列表，请参阅编辑原因代码。

添加： 只读
更新： 只读
删除： 只读

编辑状态

广告扩展的编辑状态。

下表介绍了可能的值。

值	说明
活动	广告扩展已通过编辑评审。
ActiveLimited	广告扩展在一个或多个市场通过了编辑评审，广告扩展的一个或多个元素正在另一个市场进行编辑评审。例如，广告扩展已通过加拿大的编辑评审，仍在美国中等待评审。
反对	广告扩展未通过编辑评审。
非活动	广告扩展的一个或多个元素正在接受编辑评审。

添加： 只读
更新： 只读
删除： 只读

编辑术语

编辑评审失败的术语。

如果术语组合导致失败，或者失败基于策略冲突，则不会设置此字段。

添加： 只读
更新： 只读
删除： 只读

End Date

格式化为 MM/DD/YYYY 的广告扩展计划结束日期字符串。

结束日期是包含的。例如，如果将此字段设置为 2020 年 12 月 31 日，广告扩展将在 2020 年 12 月 31 日晚上 11：59 停止显示。

添加： 选。如果未指定结束日期，除非暂停关联的市场活动、广告组或广告，否则广告扩展将继续交付。
更新： 选。只要开始日期为 null 或出现在新的结束日期之前，就可以缩短或延长结束日期。如果将此字段设置为 delete_value 字符串，则实际上删除了结束日期。 “广告计划”、“结束日期 ”、“开始日期”和“使用搜索器时区”字段相互依赖，并一起更新。如果在更新期间将所有这些字段留空，则不会更新这些字段。如果包含其中任何字段的值，则会删除或替换所有这些字段的先前值。若要删除以前的所有计划设置，请将其中每个字段设置为 delete_value。
删除： 只读

最终 URL

登陆页 URL。

以下验证规则适用于最终 URL 和最终移动 URL。

URL 的长度限制为 2,048 个字符。 HTTP 或 HTTPS 协议字符串计入 2,048 个字符限制。
最多可为最终 URL 和移动最终 URL 指定 10 个列表项;但是，每个列表中的第一项仅用于传递。该服务最多允许 10 个列表项，以便实现潜在的向前兼容性。
每个 URL 由分号和空格 (“分隔;“) 。
仅允许使用“{”和“}”来描述标记，例如 {lpurl}。
最终 URL 必须是格式正确的 URL，以 http:// 或 https:// 开头。
如果指定移动最终 URL，还必须指定最终 URL。

添加： 选
更新： 选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

最终 URL 后缀

最终 URL 后缀可以包括跟踪参数，这些参数将追加到登陆页 URL 的末尾。建议将登陆页面所需的跟踪参数放在最终 URL 后缀中，以便始终将客户发送到登陆页面。有关更多详细信息和验证规则，请参阅技术指南中的最终 URL 后缀。

注意

此功能仅适用于最终 URL 后缀阶段 3 试点 (GetCustomerPilotFeatures 返回 636) 的客户。如果你不在试点中，则将忽略此属性，并且不会返回任何错误。

添加： 选
更新： 选。如果未为更新设置任何值，则不会更改此设置。如果将此字段设置为 delete_value 字符串，则会删除以前的设置。
删除： 只读

Id

广告扩展的系统生成的标识符。

添加： 选。必须将此字段留空，或指定负标识符。然后，可以在相关记录类型的 Id 字段中引用为广告扩展设置的负标识符，例如广告组图像广告扩展和市场活动图像广告扩展。如果要在同一批量文件中添加新广告扩展和新的依赖记录，则建议这样做。有关详细信息，请参阅批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需

图像

具有不同大小和纵横比的图像资产，因此它们可以在各种发布者和位置之间灵活显示。

只需提供横向图像资产，即此字段必须包含一个子类型设置为 LandscapeImageMedia 的图像资产。 LandscapeImageMedia 的建议尺寸为 1200 宽 x 628 高。（可选）可以包括其他资产链接，即每个受支持的子类型的一个图像资产。对于未显式设置的任何图像资产子类型，Microsoft Advertising 将通过裁剪 LandscapeImageMedia 自动创建图像资产链接。

图像资产在批量文件中以 JSON 字符串的形式表示。以下示例 JSON 中包含七个图像，并且只有 LandscapeImageMedia subType 未裁剪。是id资产的属性，而 cropHeight、、cropWidthcropX、 cropY和 subType 是资产链接的属性，即资产与广告之间的关系。有关详细信息，请参阅下面的 cropHeight、 cropWidth、 cropX、 cropY、 id 和 subType 。

[{
	"id": 1234567890000,
	"subType": "LandscapeImageMedia"
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia169X100",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 1061,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia93X100",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 584,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia155X100",
	"cropX": 114,
	"cropY": 0,
	"cropWidth": 973,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia133X100",
	"cropX": 183,
	"cropY": 0,
	"cropWidth": 835,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia178X100",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 1118,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia172X100",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1080,
	"cropHeight": 628
}]

注意

在逗号分隔的大容量文件中，需要用一组额外的双引号将资产链接、每个属性键和每个属性字符串值括起来，上述 JSON 字符串将写为“[{”id“”：1234567890000，“”subType“”：“”LandscapeImageMedia“”“}，{”“id”：1234567890000，“”subType“”：“”SquareImageMedia “”，“”cropX“”：286，“cropY”：0，“”cropWidth“”：628，“cropHeight”：628}，{“id”“：1234567890000，“”subType“”：“”ImageMedia169X100“”，“”cropX“”：70，“cropY”“：0，”cropWidth“：1061，”cropHeight“：628}，{”id“”：1234567890000 “subType”“：”“ImageMedia93X100”“，”“cropX”：308，“cropY”“：0，”cropWidth“：584，”cropHeight“：628}，{”“ id”“”：1234567890000，“”subType“”：“”ImageMedia15X10“”，“”cropX“”：129，“cropY”“：0，”cropWidth“：942，”cropHeight“：628}， {”“id”：1234567890000，“”subType“”：“”ImageMedia155X100“”，“”cropX“”：114，“cropY”“：0，”cropWidth“：973，”cropHeight“”：628}，{“id”“：1234567890000，”subType“”：“”ImageMedia133X100“”，“”cropX“”：183，“裁剪Y”“：0，”“cropWi ”：835，“cropHeight”“：628}，{”“id”“：1234567890000，”subType“”：“”ImageMedia178X100“”，“”cropX“”：1 41，“”cropY“”：0，“cropWidth”：1118，“cropHeight”“：628}，{”“id”“：1234567890000，”“subType”“：”“”ImageMedia172X100“”，“”cropX“”：60，“cropY”“：0，”cropWidth“”：1080，“cropHeight”“：628}]”。

鉴于上述上传响应 JSON 示例，请注意以下事项：

相同的图像资产标识符 (例如，1234567890000) 用于所有自动生成的图像资产子类型。无论你是否让 Microsoft Advertising 自动生成裁剪的图像， ID 都不需要在链接到同一广告的图像资产中唯一。
由于此示例中的广告是在不使用 LandscapeImageMedia 图像资产子类型的裁剪设置的情况下创建的，因此将裁剪除原始横向图像之外的所有图像资产。
无论横向图像是否具有自己的裁剪设置，Microsoft Advertising 对所有默认裁剪设置使用横向图像的真实高度。在此示例中，所有系统生成图像资产的裁剪高度为 628，我们可以推断横向图像 (LandscapeImageMedia 子类型) 具有 1.91：1 纵横比的宽度和高度为 1200x628。即使已使用裁剪设置（例如 703x368）创建了横向图像资产链接，自动生成的图像资产的裁剪设置也会基于横向图像的完整尺寸 (，在本示例中为 1200x628) 。

cropHeight

要从图像资产源使用的像素数，从裁剪位置开始向上移动。

cropWidth

要从图像资产源使用的像素数，从裁剪X 位置开始，向右移动。

cropX

从图像资产源的左下角开始，这是应用 cropWidth 之前要跳到 x 轴右侧的像素数。

cropY

从图像资产源的左下角开始，这是应用 cropHeight 之前在 y 轴上向上跳过的像素数。

id

属性 id 是 Microsoft Advertising 帐户中资产的唯一 Microsoft Advertising 标识符。

同一图像资产标识符可以在同一广告中多次用于不同的纵横比，也可以由同一 Microsoft Advertising 帐户中的多个广告使用。将 SubType 设置为 LandscapeImageMedia 的图像资产标识符用于同一广告中的所有自动生成的图像资产子类型。无论你是否让 Microsoft Advertising 自动生成裁剪的图像， ID 都不需要在链接到同一广告的图像资产中唯一。

可以通过图像批量记录为图像广告扩展创建图像。然后，可以使用返回的媒体标识符作为图像资产 ID。图像资产子类型必须支持添加的图像的纵横比。

亚

属性 subType 表示此图像资产的纵横比。

存储在帐户级别媒体库中的图像的真实纵横比可能会有所不同，只要生成的维度导致每个子类型的预期纵横比。如果未指定裁剪设置，该服务将自动从图像中心裁剪到最大可能区域。例如，给定 1000x1000 像素的图像，对于 1.91：1 纵横比，自动裁剪设置将为 cropWidth=1000、 cropHeight=524、 cropX=0 和 cropY=238。

可能的子类型值包括 LandscapeImageMedia、SquareImageMedia、ImageMedia169X100、ImageMedia93X100、ImageMedia15X10、ImageMedia155X100、ImageMedia133X100、ImageMedia178X100 和 ImageMedia172X100。将来可能会添加新的子类型，因此不应依赖于一组固定值。

子类型	最小尺寸（以像素为单位）
LandscapeImageMedia	703 宽 x 368 高方面无线电 1.91：1
SquareImageMedia	300 宽度 x 300 高度方面无线电 1：1
ImageMedia169X100	622 宽 x 368 高方面无线电 1.69：1
ImageMedia93X100	311 宽 x 333 高方面无线电 0.93：1
ImageMedia15X10	300 宽度 x 200 高度方面无线电 1.5：1
ImageMedia155X100	300 宽 x 194 高方面无线电 1.55：1
ImageMedia133X100	100 宽 x 75 高方面无线电 1.33：1
ImageMedia178X100	624 宽 x 350 高方面无线电 1.78：1
ImageMedia172X100	300 宽 x 174 高方面无线电 1.72：1

添加： 必填。每个资产链接仅需要 ID 和 subType 。
更新： 选。若要保留所有现有资产链接，请将此字段设置为空或留空。如果设置此字段，将替换以前链接到此广告的任何图像。如果设置此字段，则每个资产链接只需要 ID 和 subType 。
删除： 只读

布局

符合条件的图像布局列表。

支持的值为 SearchSingle 和 SearchMultiple。将来可能会添加新布局，因此不应依赖于一组固定值。

在大容量文件中，布局字符串列表用分号 (;) 分隔。

添加： 选。如果未设置此字段，默认情况下将设置所有当前和将来支持的布局。
更新： 选。如果未为更新设置任何值，则不会更改此设置。如果将此字段设置为 delete_value 字符串，则会删除以前的设置。
删除： 只读

媒体 ID

要包含在广告中的图像的标识符。不能为同一纵横比的多个图像指定媒体标识符。换句话说，每个引用的图像必须具有不同的纵横比。

最多可以指定 4 个 (4 个) 图像标识符。虽然最低要求是一个图像媒体 ID，但为了符合所有广告放置条件，必须提供四个图像媒体标识符。

在大容量文件中，媒体标识符列表用分号 (;) 分隔。

添加： 必填
更新： 选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

移动最终 URL

移动设备的登陆页 URL。

以下验证规则适用于最终 URL 和最终移动 URL。

URL 的长度限制为 2,048 个字符。 HTTP 或 HTTPS 协议字符串计入 2,048 个字符限制。
最多可为最终 URL 和移动最终 URL 指定 10 个列表项;但是，每个列表中的第一项仅用于传递。该服务最多允许 10 个列表项，以便实现潜在的向前兼容性。
每个 URL 由分号和空格 (“分隔;“) 。
仅允许使用“{”和“}”来描述标记，例如 {lpurl}。
最终 URL 必须是格式正确的 URL，以 http:// 或 https:// 开头。
如果指定移动最终 URL，还必须指定最终 URL。

修改时间

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

注意

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

添加： 只读
更新： 只读
删除： 只读

父 ID

包含广告扩展的帐户的系统生成的标识符。

此批量字段映射到帐户记录的 ID 字段。

添加： 只读
更新： 只读
删除： 只读

发布者国家/地区

编辑指南不允许指定术语的发布者国家或地区的列表。

在批量文件中，发布者国家或地区的列表用分号 (;) 分隔。

添加： 只读
更新： 只读
删除： 只读

开始日期

格式化为 MM/DD/YYYY 的广告扩展计划开始日期字符串。

开始日期是包含的。例如，如果将 StartDate 设置为 5/5/2020，广告扩展将在 2020 年 5 月 5 日凌晨 12：00 开始显示。

添加： 选。如果未指定开始日期，广告扩展将立即符合计划条件。
更新： 选。只要结束日期为 null 或发生在新的开始日期之后，就可以缩短或延长开始日期。如果将此字段设置为 delete_value 字符串，则实际上将删除开始日期，并且广告扩展将立即符合计划条件。 “广告计划”、“结束日期 ”、“开始日期”和“使用搜索器时区”字段相互依赖，并一起更新。如果在更新期间将所有这些字段留空，则不会更新这些字段。如果包含其中任何字段的值，则会删除或替换所有这些字段的先前值。若要删除以前的所有计划设置，请将其中每个字段设置为 delete_value。
删除： 只读

状态

广告扩展的状态。

可能的值为 Active 或 Deleted。

添加： 选。默认值为 Active。
更新： 选。如果未为更新设置任何值，则不会更改此设置。
删除： 必填。 “状态”必须设置为 “已删除”。

跟踪模板

用于促销 URL 的跟踪模板。

以下验证规则适用于跟踪模板。有关支持的模板和参数的更多详细信息，请参阅 Microsoft Advertising 帮助文章我可以使用哪些跟踪或 URL 参数？

为较低级别的实体（例如广告）定义的跟踪模板将覆盖为较高级别的实体（例如市场活动）设置的模板。有关详细信息，请参阅实体限制。
跟踪模板的长度限制为 2,048 个字符。 HTTP 或 HTTPS 协议字符串计入 2,048 个字符限制。
跟踪模板必须是格式正确的 URL，从以下项之一开始： http://、 https://、 {lpurl}或 {unescapedlpurl}。
Microsoft Advertising 不会验证自定义参数是否存在。如果在跟踪模板中使用自定义参数，并且这些参数不存在，则登陆页 URL 将包含自定义参数的键和值占位符，而不进行替换。例如，如果跟踪模板为 https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}，并且未在市场活动、广告组、条件、关键字 (keyword) 或广告级别定义 {_season} 或 {_promocode}，则登陆页 URL 将相同。

使用搜索器时区

确定是使用帐户时区还是搜索用户的时区（可在其中投放广告）。

如果希望广告扩展显示在搜索用户的时区中，则将此属性设置为 TRUE ，否则将其设置为 FALSE。

添加： 选。如果未指定此字段或将其留空，则将设置默认值 FALSE ，并使用帐户时区。
更新： 选。如果将此字段设置为 delete_value 字符串，则实际上将重置为默认值 FALSE。 “广告计划”、“结束日期 ”、“开始日期”和“使用搜索器时区”字段相互依赖，并一起更新。如果在更新期间将所有这些字段留空，则不会更新这些字段。如果包含其中任何字段的值，则会删除或替换所有这些字段的先前值。若要删除以前的所有计划设置，请将其中每个字段设置为 delete_value。
删除： 只读

版本

广告扩展内容已更新的次数。添加扩展时，版本设置为 1，每次修改时都会递增。

添加： 只读
更新： 只读
删除： 只读

通过

图像广告扩展记录 - 批量

广告计划

可选文字

客户端 ID

自定义参数

目标 URL

显示文本

编辑位置

编辑原因代码

编辑状态

编辑术语

End Date

最终 URL

最终 URL 后缀

Id

图像

cropHeight

cropWidth

cropX

cropY

id

亚

布局

媒体 ID

移动最终 URL

修改时间

父 ID

发布者国家/地区

开始日期

状态

跟踪模板

使用搜索器时区

版本

反馈

其他资源