响应式广告记录 - 批量

项目
11/13/2024

定义可在批量文件中下载和上传的响应式广告。

响应式广告会自动调整以适应受众广告格式的大小和形状。这些广告最适合用于信息性文本，而不是行动号召。

注意

此功能目前在美国、加拿大、英国和澳大利亚可用。如果你在美国、加拿大、英国或澳大利亚做广告，并且想要选择加入受众广告，请联系支持人员。

注意

同一广告组中允许重复的响应式广告。

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

如果提供了有效的父 ID 值，下面的批量 CSV 示例将添加新的响应式广告。

Type,Status,Id,Parent Id,Campaign,Ad Group,Sync Time,Client Id,Modified Time,Tracking Template,Final Url Suffix,Custom Parameter,Final Url,Mobile Final Url,Text,Business Name,Device Preference,Ad Format Preference,Name,Call To Action,Headline,Long Headline,Images
Format Version,,,,,,,,,,,,,,,,,,6.0,,,,
Responsive Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,Contoso,,,,,Short Headline Here,Long Headline Here,"[{""id"":1234567890000,""subType"":""LandscapeImageMedia""}]"

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkResponsiveAd
var bulkResponsiveAd = new BulkResponsiveAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ResponsiveAd object of the Campaign Management service.
    ResponsiveAd = new ResponsiveAd
    {
        // 'Call To Action' column header in the Bulk file
        CallToAction = CallToAction.AddToCart,
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/womenshoesale"
        },
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/womenshoesale"
        },
        // 'Headline' column header in the Bulk file
        Headline = "Short Headline Here",
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Images' column header in the Bulk file
        Images = new[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new ImageAsset
                {
                    CropHeight = null,
                    CropWidth = null,
                    CropX = null,
                    CropY = null,
                    Id = landscapeImageMediaId,
                    SubType = "LandscapeImageMedia"
                },
            },
        },
        // 'Long Headline' column header in the Bulk file
        LongHeadlineString = "Long Headline Here",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
};

uploadEntities.Add(bulkResponsiveAd);

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 后缀
Id
Images
印象跟踪 URL
横向图像媒体 ID
横向徽标媒体 ID
长标题
长标题
长标题字符串
移动最终 URL
修改时间
父 ID
发布者国家/地区
状态
方形图像媒体 ID
方形徽标媒体 ID
Text
跟踪模板

广告组

包含广告的广告组的名称。

加：只读和必需
更新： 只读和必需
删除： 只读和必需

注意

若要添加、更新和删除，必须指定 “父 ID ”或 “广告组” 字段。

企业名称

企业名称。

根据受众广告的放置情况，你的企业名称可能会显示在广告中。

字符串的长度限制为 25 个字符。

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

行动号召

客户立即点击广告的简短而有力的理由。

下面是可用于搜索多媒体广告的操作调用：

行动号召
立即行动
立即申请
立即下注
立即出价
预订汽车
预订酒店
立即预订
立即生成
立即购买
立即聊天
比较
联系我们
经销商
方向
捐
下载
立即发送电子邮件
立即注册
立即文件
查找作业
查找应用商店
免费游戏
免费报价
免费试用版
获取优惠券
获取交易
获取演示
立即获取
获取产品/服务
获取报价
转到演示
现在加入
了解详情
立即收听
登录
立即订购
玩游戏
立即播放
发布作业
注册
立即续订
租一辆车
立即租用
重新安排
储备
立即保存
计划
查看演示
查看菜单
查看模型
查看产品/服务
查看产品/服务
查看促销
立即销售
立即购买
Showtimes
登录
注册
立即开始
Subscribe
体验版
立即试用
查看汽车
查看演示
查看计划
访问商店
立即投票
Watch
查看更多
立即观看

加：不适用于受众广告。
更新： 只读
删除： 只读

行动号召兰高格

将用于提供行动号召的语言。

无论市场活动的语言设置如何，行动号召都将始终以此语言提供。

下面是可用于搜索多媒体广告的操作号召语言：

行动号召
Language.阿尔巴尼亚语
Language.Arabic
Language.波斯尼亚语
Language.保加利亚语
Language.Croatian
Language.Czech
Language.丹麦语
Language.Dutch
Language.English
Language.爱沙尼亚语
Language.芬兰语
Language.French
Language.German
Language.Greek
Language.希伯来语
Language.匈牙利语
Language.冰岛语
Language.Italian
Language.Japanese
Language.拉脱维亚语
Language.立陶宛语
Language.马其顿语
Language.Maltese
Language.挪威语
Language.Polish
Language.葡萄牙语
Language.罗马尼亚语
Language.Russian
Language.塞尔维亚语
Language.斯洛伐克语
Language.斯洛文尼亚语
Language.Spanish
Language.Swedish
Language.TraditionalChinese
Language.Turkish

加：不适用于受众广告;多媒体广告是必需的。
更新： 自选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

Campaign

包含广告组和广告的市场活动的名称。

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

客户端 ID

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

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

自定义参数

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

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

将每个自定义参数对的格式设置为 Key=Value，例如 {_promoCode}=PROMO1。
Microsoft广告将接受包含的前 8 个自定义参数键和值对，如果包含超过 8 个自定义参数，则会返回错误。每个键值对由分号和空格 (“分隔;“) ，例如 {_promoCode}=PROMO1;{_season}=summer。
键不能包含分号。如果 Value 包含分号，则必须将其转义为“\;”。此外，如果 Value 包含反斜杠，则还必须将其转义为“\”。
键不能超过 16 个 UTF-8 字节，值不能超过 250 UTF-8 个字节。密钥是必需的，值是可选的。键的最大大小不包括大括号和下划线，即“{”、“_”和“}”。

注意

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

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

说明

根据受众广告的位置，此文本将显示在广告的长标题或短标题下方或旁边。

与标题相比，在广告文本中可以处理更多的字符空间。因此，一旦图像和标题引起了潜在客户的关注，广告文本需要说服他们点击它。是什么让你的产品或服务与众不同？

文本必须至少包含一个单词。

说明的上限为 5。字符串的长度限制为 90 个字符。标题的数据格式包含在以下示例 JSON 中。

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

加：受众广告和多媒体广告是必需的。不适用于视频广告。 更新： 自选。如果未为更新设置任何值，则不会更改此设置。 删除： 只读

编辑上诉状态

确定是否可以对编辑评审发现的问题提出上诉。

下表介绍了可能的值。

值	说明
上诉	编辑问题很有吸引力。
AppealPending	编辑问题可上诉，已提出上诉。
NotAppealable	编辑问题没有吸引力。

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

编辑位置

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

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

编辑原因代码

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

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

编辑状态

广告的编辑状态。

下表介绍了可能的值。

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

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

编辑术语

编辑评审失败的术语。

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

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

最终 URL

登陆页 URL。

URL 的域部分与路径 1 和路径 2 字符串组合不能超过 67 个字符。

以下验证规则适用于最终 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 的末尾。建议将登陆页面所需的跟踪参数放在最终 URL 后缀中，以便始终将客户发送到登陆页面。有关更多详细信息和验证规则，请参阅技术指南中的最终 URL 后缀。

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

标题

这是视频广告中可能出现的两个可能头条新闻之一。

由于视频广告具有响应性，因此我们需要多个头条新闻，以便它们可以灵活地跨各种发布者和位置提供服务。

字符串的长度限制为 30 个字符。

加：对于视频广告是必需的。不适用于多媒体广告和受众广告。 更新： 自选。已弃用多媒体和受众广告。请改用标题。
删除： 只读

标题

由于受众广告具有响应性，因此我们需要多个头条新闻，以便它们可以在各种发布者和位置上灵活投放。

头条新闻的上限是 15。每个标题的长度限制为 30 个字符。标题的数据格式包含在以下示例 JSON 中。

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

加：多媒体广告和受众广告是必需的。不适用于视频广告。 更新： 自选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

Id

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

加：自选。必须将此字段留空，或指定负标识符。然后，可以在相关记录类型的 父 ID 字段中引用为广告设置的负标识符，例如响应式广告标签。如果要在同一批量文件中添加新广告和新的从属记录，则建议这样做。有关详细信息，请参阅批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需

图像

由于受众广告具有响应性，因此可以创建具有不同大小和纵横比的多个图像资产，以便它们可以在各种发布者和位置上灵活显示。

注意

到目前为止，SubType OriginalImage 取代了 LandscapeImageMedia 的角色，作为 Audience Campaign 的 ResponsiveAd 的默认图像。

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

注意

如果将此字段设置为 (不为空) ，则横向图像媒体 ID 和方形图像媒体 ID 都将被忽略。

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

[{
	"id": 1234567890000,
	"subType": "OriginalImage"
},
{
	"id": 1234567890000,
	"subType": "LandscapeLogoMedia",
	"cropX": 0,
	"cropY": 0,
	"cropWidth": 512,
	"cropHeight": 128
},
{
	"id": 1234567890000,
	"subType": "SquareLogoMedia",
	"cropX": 0,
	"cropY": 0,
	"cropWidth": 128,
	"cropHeight": 128
},
{
	"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“”：“”OriginalImage“”}，{“”id“”：1234567890000，“”subType“”：“”LandscapeLogoMedia “”，“”cropX“”：0，“”cropY“”：0，“cropWidth”“：512，”cropHeight“”：128}，{“”id“”：1234567890000，“”subType“”：“”SquareLogoMedia“”，“”cropX“：0，”“cropY”“：0，”cropWidth“”：128，“cropHeight”：128}，{“”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，”裁剪Y“”：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 示例，请注意以下事项：

相同的图像资产标识符 (例如，1234567890000) 用于所有自动生成的图像资产子类型。无论你是否让Microsoft广告自动生成裁剪的图像， ID 在链接到同一广告的图像资产中不需要是唯一的。
由于此示例中的广告是在没有为 OriginalImage 图像资产子类型裁剪设置的情况下创建的，因此除 OriginalImage 关联的图像之外，所有图像资产都会被裁剪。
无论 OriginalImage 是否具有自己的裁剪设置，Microsoft广告对所有默认裁剪设置使用 OriginalImage 关联图像的真实高度。在此示例中，所有系统生成图像资源的裁剪高度为 628，我们可以推断出具有 1.91：1 纵横比的 OriginalImage (OriginalImage 子类型) 宽度和高度为 1200x628。即使使用裁剪设置（例如 703x368）创建了 OriginalImage 资产链接，自动生成的图像资产的裁剪设置也会基于 OriginalImage (的完整尺寸（在本示例中为 1200x628）) 。
尽管在必应广告 API 版本 12 中可以使用横向图像媒体 ID 和方形图像媒体 ID，但这些字段已弃用，并将在未来版本中删除。通过“ 图像 ”字段可以更灵活地控制裁剪的图像。

cropHeight

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

cropWidth

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

cropX

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

cropY

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

id

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

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

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

亚

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

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

如果图像与广告关联为“LandscapeLogoMedia”或“SquareLogoMedia”，则必须将子类型设置为“徽标”。

可能的子类型值包括 OriginalImage、LandscapeLogoMedia、SquareLogoMedia、LandscapeImageMedia、SquareImageMedia、ImageMedia4x1、ImageMedia1x2、ImageMedia169X100、ImageMedia201X100、ImageMedia120X100、ImageMedia200X100、ImageMedia124X100 和 ImageMedia153X100。将来可能会添加新的子类型，因此不应依赖于一组固定值。

子类型	纵横比	最小尺寸（以像素为单位）
OriginalImage	不适用	703 宽 x 368 高
LandscapeLogoMedia	4:1	512 宽 x 128 高
SquareLogoMedia	1:1	128 宽 x 128 高
LandscapeImageMedia	1.91:1	300 宽 x 157 高
SquareImageMedia	1:1	114 宽 x 114 高
ImageMedia4x1	4:1	608 宽 x 152 高
ImageMedia1x2	1:2	470 宽 x 940 高
ImageMedia201X100	2.01:1	612 宽 x 304 高
ImageMedia120X100	1.2:1	300 宽 x 250 高
ImageMedia200X100	2:1	200 宽 x 100 高度
ImageMedia169X100	1.69:1	628 宽 x 372 高
ImageMedia124X100	1.24:1	104 宽 x 84 高
ImageMedia153X100	1.53:1	306 宽 x 200 高

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

印象跟踪 URL

1x1 展示跟踪像素的 URL。每个像素将向第三方广告报告工具Microsoft受众网络印象。

每个响应式广告最多可以包含 2 个展示跟踪 URL。每个 URL 由分号和空格 (“分隔;“) 。

每个 URL 都必须可访问。 URL 的长度限制为 2,048 个字符。 HTTP 或 HTTPS 协议字符串计入 2,048 个字符限制。

对于每个Microsoft受众网络印象，Microsoft将对 URL 执行 ping 操作，以便在第三方广告报告工具中启用印象跟踪。不支持高级用户跟踪，例如转换跟踪或基于 Cookie 或 IP 地址的跟踪。

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

横向图像媒体 ID

用于横向图像的图像资产的标识符，其纵横比为 1.91：1，可显示在受众广告中。

存储的图像媒体的纵横比可能会有所不同，只要图像资产裁剪设置导致此字段支持的纵横比。若要使用裁剪设置确认有效纵横比，请使用 “图像” 字段。

注意

尽管在必应广告 API 版本 12 中可以使用横向图像媒体 ID 和 SquareImageMediaId，但这些字段已弃用，并将在未来版本中删除。通过“ 图像 ”字段可以更灵活地控制裁剪的图像。

加：如果未设置图像，则为必需。如果设置了 “图像” ，则忽略此字段。
更新： 自选。如果设置了 “图像” ，则忽略此字段。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

横向徽标媒体 ID

此字段保留供内部使用，将从未来版本的必应广告 API 中删除。

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

长标题

这是可能出现在受众广告中的两个可能头条新闻之一。

由于受众广告具有响应性，因此我们需要多个头条新闻，以便它们可以在各种发布者和位置上灵活投放。

字符串的长度限制为 90 个字符。

加：必填
更新： 荒废的。请改用长标题。
删除： 只读

长标题

由于受众广告具有响应性，因此我们需要多个头条新闻，以便它们可以在各种发布者和位置上灵活投放。

长标题的上限为 5。每个标题的长度限制为 90 个字符。长标题的数据格式包含在下面的示例 JSON 中。

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

加：多媒体广告和受众广告是必需的。不适用于视频广告。 更新： 自选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

长标题字符串

标题是广告中显示的最醒目的文本，因此应充分利用可用字符。由于受众广告具有响应性，因此我们需要多个头条新闻，以便它们可以在各种发布者和位置上灵活投放。

每个标题的长度限制为 90 个字符。长标题的数据格式包含在下面的示例 JSON 中。

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

加：受众广告和视频广告是必需的。不适用于多媒体广告。 更新： 自选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

移动最终 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。

修改时间

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

注意

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

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

父 ID

包含广告的广告组的系统生成的标识符。

此批量字段映射到广告组记录的 Id 字段。

加：只读和必需。必须指定现有广告组标识符，或指定等于父广告组记录的 Id 字段的负标识符。如果要将新广告添加到同一批量文件中的新广告组，则建议这样做。有关详细信息，请参阅批量文件架构引用密钥。
更新： 只读
删除： 只读

注意

若要添加、更新和删除，必须指定 “父 ID ”或 “广告组” 字段。

发布者国家/地区

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

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

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

状态

广告的状态。

可能的值为 Active、 Paused 或 Deleted。

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

方形图像媒体 ID

用于 1：1 纵横比的方形图像的图像资产的标识符，该图像可能显示在受众广告中。

注意

加：自选。如果设置了 “图像” ，则忽略此字段，Microsoft广告将通过裁剪 LandscapeImageMedia 图像资产自动创建新的方形图像资产。如果未设置图像，并且未设置此字段，Microsoft广告将通过裁剪横向图像媒体 ID 自动创建新的方形图像资产。
更新： 自选。如果设置了 “图像” ，则忽略此字段，Microsoft广告将通过裁剪 LandscapeImageMedia 图像资产自动创建新的方形图像资产。如果未设置图像，并且未设置此字段，Microsoft广告将通过裁剪横向图像媒体 ID 自动创建新的方形图像资产。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

方形徽标媒体 ID

此字段保留供内部使用，将从未来版本的必应广告 API 中删除。

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

Text

根据视频广告的位置，此文本将显示在广告的长标题或短标题下方或旁边。

文本必须至少包含一个单词。

字符串的长度限制为 90 个字符。

文本不能包含换行符 (\n) 。

加：对于视频广告是必需的。不适用于受众广告或多媒体广告。 更新： 视频广告可选。请改为对已弃用) (受众广告或多媒体广告使用说明。
删除： 只读

跟踪模板

要用作 FinalUrls 指定 URL 的默认跟踪模板。

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

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

通过

响应式广告记录 - 批量

广告组

企业名称

行动号召

行动号召兰高格

Campaign

客户端 ID

自定义参数

说明

编辑上诉状态

编辑位置

编辑原因代码

编辑状态

编辑术语

最终 URL

最终 URL 后缀

标题

标题

Id

图像

cropHeight

cropWidth

cropX

cropY

id

亚

印象跟踪 URL

横向图像媒体 ID

横向徽标媒体 ID

长标题

长标题

长标题字符串

移动最终 URL

修改时间

父 ID

发布者国家/地区

状态

方形图像媒体 ID

方形徽标媒体 ID

Text

跟踪模板

反馈

其他资源