响应式搜索广告记录 - 批量

为搜索网络中可在批量文件中下载和上传的文本广告定义响应式搜索广告格式。

注意

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

响应式搜索广告允许您在单个广告中设置 3-15 个唯一广告标题 (“标题”) 和 2-4 个广告说明。 从那里,必应将为每个给定查询和相应的搜索用户选择最相关的标题和说明组合。 通过允许必应 AI 为每个查询选择最相关的标题和说明,我们可确保在正确的时间跨所有可能的意向信号为每个潜在客户提供正确的消息。

向用户显示的响应式广告与扩展文本广告相同,即通过扩展文本广告) 最多显示 3 个标题 (标题部分,通过扩展文本广告) 显示 2 个描述 (文本部分。 但是,根据屏幕大小,你的广告可能会在没有第三个标题或第二个说明的情况下显示。

创建响应式搜索广告时, “说明 ”和 “标题 ”列表将存储为可由帐户中的任何响应式搜索广告共享的文本资产。 例如,如果“无缝集成”是一个文本资产,你将看到它在同一 Microsoft Advertising 帐户中链接到“无缝集成”的所有广告中具有相同的资产标识符。 上传文本资产后,结果文件将包括资产标识符,例如 ""id:""123,无论资产是新资产还是已存在于帐户的资产库中。

注意

响应式搜索广告只能在 广告组类型 设置为“SearchStandard”的搜索市场活动中创建。 如果 “广告组类型 ”设置为“SearchDynamic”,则广告组不支持响应式搜索广告。

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

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

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Description,Path 1,Path 2,Domain,Headline
Format Version,,,,,,,,,6.0,,,,,,,,,,,,
Responsive Search Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,False,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,,{_promoCode}=PROMO1; {_season}=summer,"[{""text"":""Find New Customers & Increase Sales!"",""pinnedField"":""Description1""},{""text"":""Start Advertising on Contoso Today.""}]",seattle,shoe sale,,"[{""text"":""Contoso"",""pinnedField"":""Headline1""},{""text"":""Quick & Easy Setup""},{""text"":""Seamless Integration""}]"

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkResponsiveSearchAd
var bulkResponsiveSearchAd = new BulkResponsiveSearchAd
{
    // '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 
    // ResponsiveSearchAd object of the Campaign Management service.
    ResponsiveSearchAd = new ResponsiveSearchAd
    {
        // 'Description' column header in the Bulk file
        Descriptions = new AssetLink[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Find New Customers & Increase Sales!"
                },
                PinnedField = "Description1"
            },
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Start Advertising on Contoso Today."
                },
            },
        },
        // '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
        Headlines = new AssetLink[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Contoso"
                },
                PinnedField = "Headline1"
            },
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Quick & Easy Setup"
                },
            },
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Seamless Integration"
                },
            },
        },
        // 'Id' column header in the Bulk file
        Id = responsiveSearchAdIdKey,
        // 'Path 1' column header in the Bulk file
        Path1 = "seattle",
        // 'Path 2' column header in the Bulk file
        Path2 = "shoe sale",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // '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(bulkResponsiveSearchAd);

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

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

对于 响应式搜索广告 记录, 批量文件架构中提供了以下属性字段。

广告组

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

添加: 只读和必需
更新: 只读和必需
删除: 只读和必需

注意

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

Campaign

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

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

客户端 ID

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

添加:
更新:
删除: 只读

自定义参数

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

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

  • 将每个自定义参数对的格式设置为 Key=Value,例如 {_promoCode}=PROMO1。

  • Microsoft Advertising 将接受你包含的前 8 个自定义参数键和值对,如果包含 8 个以上的自定义参数,将返回错误。 每个键值对由分号和空格 (“分隔;“) ,例如 {_promoCode}=PROMO1;{_season}=summer。

  • 键不能包含分号。 如果 Value 包含分号,则必须将其转义为“\;”。 此外,如果 Value 包含反斜杠,则还必须将其转义为“\”。

  • 键不能超过 16 个 UTF-8 字节,值不能超过 250 UTF-8 个字节。 密钥是必需的,值是可选的。 键的最大大小不包括大括号和下划线,即“{”、“_”和“}”。

    注意

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

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

说明

必应可用于优化广告布局的说明列表。

为了在所有广告格式中最大化展示,广告中可能不会始终显示说明。

除非将其中一个描述固定到特定位置,否则必应将使用用户搜索查询的最佳标题和说明动态优化广告布局。

从数据模型的角度来看,说明存储为文本资产。 同一资产可由多个广告使用。 例如,如果“无缝集成”是文本资产,它将在同一 Microsoft Advertising 帐户中的所有广告中具有相同的资产标识符。

必须在 2-4 个说明之间设置。 说明在大容量文件中以 JSON 字符串的形式表示。 以下示例 JSON 中包含两个说明,第一个说明固定到特定位置。 idtext 是资产的属性,而 editorialStatuspinnedField 是资产链接的属性,即资产与广告之间的关系。 有关详细信息,请参阅 下面的编辑状态idpinnedField文本

[{
	"text": "Find New Customers & Increase Sales!",
	"pinnedField": "Description1"
},
{
	"text": "Start Advertising on Contoso Today."
}]

注意

在逗号分隔的批量文件中,需要将资产链接列表括起来, 每个属性键和每个具有额外双引号集的属性字符串值(例如,上面的 JSON 字符串将编写为“[{”“text”“:”“查找新客户 & 增加销售额!”“,”pinnedField“”“:”Description1“},{”text“”:“”开始在 Contoso Today 上发布广告“。”}”。

下面是批量下载示例,其中还将获取只读属性,例如 ideditorialStatus

[{
	"id": 1,
	"text": "Contoso",
	"pinnedField": "Description1",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

添加: 必填。 需要 2-4 个说明的列表。 仅 使用 pinnedField文本 。 即使帐户中已存在资产,如果包含 ID、assetPerformanceLabeleditorialStatus,也会忽略它们。
更新: 选。 若要保留所有现有资产链接,请将此字段设置为空或留空。 如果设置此字段,将替换以前链接到此广告的任何说明。 如果指定此字段,则需要包含 2-4 个说明的列表。 仅 使用 pinnedField文本 。 即使帐户中已存在资产,如果包含 ID、assetPerformanceLabeleditorialStatus,也会忽略它们。
删除: 只读

assetPerformanceLabel

这可让你了解资产的性能。

下载 assetPerformanceLabel 响应式搜索广告时,属性是只读的。 下表介绍了可能的值。

说明
此资产的性能较低,建议替换此资产以提高广告性能。
Good 此资产性能良好。 建议保留此资产并添加更多资产以提高广告性能。
最好 此资产的性能是最好的,建议添加更多类似的资产。
未分级 对此资产没有任何性能评级。 这可能是由于资产处于非活动状态,没有足够的信息来确定其性能,或者没有足够的类似资产与之进行比较。
学习 正在积极评估资产的性能。 评估完成后,资产评级将为“低”、“良好”、“最佳”或“未评级”。

editorialStatus

下载 editorialStatus 响应式搜索广告时,属性是只读的。 下表介绍了可能的值。

说明
活动 资产通过了编辑评审。
ActiveLimited 资产在一个或多个市场通过了编辑评审,资产的一个或多个元素正在另一个市场进行编辑评审。 例如,该资产通过了加拿大的编辑评审,仍在美国等待评审。
反对 资产编辑评审失败。
非活动 资产的一个或多个元素正在接受编辑评审。
未知 保留供以后使用。

id

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

同一资产可由多个广告使用。 例如,如果“无缝集成”是文本资产,它将在同一 Microsoft Advertising 帐户中的所有广告中具有相同的资产标识符。 上传文本资产后,结果文件将包括资产标识符,例如 ""id:""123,无论资产是新资产还是已存在于帐户的资产库中。

pinnedField

若要将资产固定到特定说明位置,请将 pinnedField 属性设置为“Description1”或“Description2”。 除非对文本资产有特定要求,否则不要固定它,让必应 AI 优化文本位置。

每个说明位置必须至少有一个符合条件的文本资产可用,因此不能将所有资产固定到同一位置。 例如,可以将 3 个文本资产固定到 Description1,前提是响应式搜索广告的 “说明 ”列表中至少有一个未固定或固定到 Description2 的文本资产。

下载未固定的资产时, pinnedField 不会返回 属性。

text

每个说明的属性 text 必须至少包含一个单词。 为了有效地使用资源,建议使用动态文本字符串(如 {keyword}),而不是为每个关键字创建新的广告副本。 有关详细信息,请参阅 Microsoft Advertising 帮助文章 使用动态文本参数自动自定义广告

每个说明 text 属性的最大输入长度为 1,000 个字符(包括动态文本字符串),在替换后允许的 1,000 个字符中不允许超过 90 个最终字符。 如果动态文本替换发生后长度超过 90 个字符,广告将无法显示,或者将使用 默认 文本。 对于具有双角字符的语言(例如繁体中文),最大输入长度为 500 个字符(包括动态文本字符串),在替换后允许的 500 个字符中不超过 45 个字符。 如果动态文本替换发生后长度超过 45 个字符,广告将无法显示,或使用 默认 文本。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。

特性 text 不能包含换行符 (\n) 。

Domain

将显示的 URL,而不是最终 URL。 最终 URL 仍将用于登陆页 URL。

保留给有限的试点使用,例如制药客户。

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

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

编辑上诉状态

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

下表介绍了可能的值。

说明
上诉 编辑问题很有吸引力。
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。

添加: 必填
更新:
删除: 只读

标题

必应可用于优化广告布局的广告标题列表。

除非将其中一个标题固定到特定位置,否则必应将使用用户搜索查询的最佳标题和说明动态优化广告布局。

从数据模型的角度来看,标题存储为文本资产。 同一资产可由多个广告使用。 例如,如果“无缝集成”是文本资产,它将在同一 Microsoft Advertising 帐户中的所有广告中具有相同的资产标识符。

必须设置 3-15 个标题。 标题在大容量文件中以 JSON 字符串的形式表示。 以下示例 JSON 中包含三个标题,只有第一个标题固定到特定位置。 idtext 是资产的属性,而 editorialStatuspinnedField 是资产链接的属性,即资产与广告之间的关系。 有关详细信息,请参阅 下面的编辑状态idpinnedField文本

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

注意

在逗号分隔的批量文件中,需要将资产链接列表括起来, 每个属性键和每个具有额外双引号集的属性字符串值,例如,上述 JSON 字符串将写为“[{”“text”“:”“Contoso”“,”“pinnedField”“:”“标题1”“},{”“text”:“快速 & Easy Setup”“},{”“text”:“无缝集成”“}]”。

下面是批量下载示例,其中还将获取只读属性,例如 ideditorialStatus

[{
	"id": 3,
	"text": "Contoso",
	"pinnedField": "Headline1",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 4,
	"text": "Quick & Easy Setup",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 5,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

添加: 必填。 需要 3-15 条标题的列表。 仅 使用 pinnedField文本 。 即使帐户中已存在资产,如果包含 ID、assetPerformanceLabeleditorialStatus,也会忽略它们。
更新: 选。 若要保留所有现有资产链接,请将此字段设置为空或留空。 如果设置此字段,将替换以前链接到此广告的所有标题。 如果指定此字段,则需要包含 3-15 个标题的列表。 仅 使用 pinnedField文本 。 即使帐户中已存在资产,如果包含 ID、assetPerformanceLabeleditorialStatus,也会忽略它们。
删除: 只读

assetPerformanceLabel

这可让你了解资产的性能。

下载 assetPerformanceLabel 响应式搜索广告时,属性是只读的。 下表介绍了可能的值。

说明
此资产的性能较低,建议替换此资产以提高广告性能。
Good 此资产性能良好。 建议保留此资产并添加更多资产以提高广告性能。
最好 此资产的性能是最好的,建议添加更多类似的资产。
未分级 对此资产没有任何性能评级。 这可能是由于资产处于非活动状态,没有足够的信息来确定其性能,或者没有足够的类似资产与之进行比较。
学习 正在积极评估资产的性能。 评估完成后,资产评级将为“低”、“良好”、“最佳”或“未评级”。

editorialStatus

下载响应式搜索广告时, editorialStatus 属性是只读字符串。 下表介绍了可能的值。

说明
活动 资产通过了编辑评审。
ActiveLimited 资产在一个或多个市场中通过了编辑评审,而资产的一个或多个元素正在另一个市场进行编辑评审。 例如,该资产已通过加拿大的编辑评审,仍在美国等待评审。
反对 资产编辑评审失败。
非活动 资产的一个或多个元素正在接受编辑评审。
未知 保留供以后使用。

id

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

同一资产可由多个广告使用。 例如,如果“无缝集成”是文本资产,它将在同一 Microsoft Advertising 帐户中的所有广告中具有相同的资产标识符。 上传文本资产后,结果文件将包括资产标识符,例如 ""id:""123,无论资产是新资产还是已存在于帐户的资产库中。

pinnedField

若要将资产固定到特定的标题位置,请将 pinnedField 字符串值设置为“Headline1”、“Headline2”或“Headline3”。 除非对文本资产有特定要求,否则不要固定它,让必应 AI 优化文本位置。

每个标题位置必须至少有一个符合条件的文本资产可用,因此不能将所有资产固定到同一位置。 例如,可以将 3 个文本资产固定到 标题 1 ,将 3 个文本资产固定到 标题 2,前提是响应式搜索广告的 标题 列表中至少有一个未固定或固定到 标题 3 的文本资产。

下载未固定的资产时, pinnedField 不会返回 属性。

text

每个标题的 text 属性必须至少包含一个单词。 为了有效地使用资源,建议使用动态文本字符串(如 {keyword}),而不是为每个关键字创建新的广告副本。 有关详细信息,请参阅 Microsoft Advertising 帮助文章 使用动态文本参数自动自定义广告

每个标题 text 属性的最大输入长度为 1,000 个字符(包括动态文本字符串),其中 1,000 个字符在替换后允许不超过 30 个最终字符。 如果动态文本替换发生后长度超过 30 个字符,广告将无法显示,或者将使用 默认 文本。 对于具有双宽度字符的语言(例如繁体中文),最大输入长度为 500 个字符(包括动态文本字符串),替换后允许的 500 个字符不超过 15 个。 如果动态文本替换发生后长度超过 15 个字符,广告将无法显示,或者将使用 默认 文本。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。

特性 text 不能包含换行符 (\n) 。

最终 URL 后缀

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

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

Id

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

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

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

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

修改时间

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

注意

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

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

父 ID

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

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

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

注意

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

路径 1

将追加到显示 URL 的域部分的可选路径的第一部分。 显示 URL 的域部分(例如 https://www.contoso.com )将从“最终 URL”的域 (“最终 URL” 字段) 生成。 如果为 路径 1 指定了值,则会将其追加到显示 URL。 如果还为 路径 2 指定了一个值,则该值也将追加到 路径 1 后的显示 URL。 例如,如果 最终 URL 包含 https://www.contoso.com则路径 1 设置为 subdirectory1将路径 2 设置为 subdirectory2,则显示的 URL 将为 https://www.contoso.com/subdirectory1/subdirectory2

路径可以包含动态参数,例如 {MatchType}。 有关支持的参数列表,请参阅 Microsoft Advertising 帮助文章 我可以使用哪些跟踪或 URL 参数?

如果包含动态文本字符串,则最大输入长度为 1,000 个字符。 不能输入超过 15 个最终 (不能输入) 字符的动态文本。 如果最终 URL 域的长度和路径组合超过 67 个字符,广告将无法显示,或者将使用 默认文本

对于具有双角字符的语言(例如繁体中文),如果包含动态文本字符串,则最大输入长度为 1,000 个字符。 不能输入超过 7 个最终 (不能输入) 字符的动态文本。 如果最终 URL 域和路径的总长度超过 33 个字符,广告将无法显示,或者将使用 默认文本 。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。

路径不能包含正斜杠 (/) 或换行 (\n) 字符。

如果路径包含空格,则会在显示广告时将其替换为下划线 (_) 。

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

路径 2

将追加到显示 URL 的域部分的可选路径的第二部分。 显示 URL 的域部分(例如 https://www.contoso.com )将从“最终 URL”的域 (“最终 URL” 字段) 生成。 如果为 路径 1 指定了值,则会将其追加到显示 URL。 如果还为 路径 2 指定了一个值,则该值也将追加到 路径 1 后的显示 URL。 例如,如果 最终 URL 包含 https://www.contoso.com则路径 1 设置为 subdirectory1将路径 2 设置为 subdirectory2,则显示的 URL 将为 https://www.contoso.com/subdirectory1/subdirectory2

如果还设置了 路径 1 ,则只能指定 路径 2。

路径可以包含动态参数,例如 {MatchType}。 有关支持的参数列表,请参阅 Microsoft Advertising 帮助文章 我可以使用哪些跟踪或 URL 参数?

如果包含动态文本字符串,则最大输入长度为 1,000 个字符。 不能输入超过 15 个最终 (不能输入) 字符的动态文本。 如果最终 URL 域的长度和路径组合超过 67 个字符,广告将无法显示,或者将使用 默认文本

对于具有双角字符的语言(例如繁体中文),如果包含动态文本字符串,则最大输入长度为 1,000 个字符。 不能输入超过 7 个最终 (不能输入) 字符的动态文本。 如果最终 URL 域和路径的总长度超过 33 个字符,广告将无法显示,或者将使用 默认文本 。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。

路径不能包含正斜杠 (/) 或换行 (\n) 字符。

如果路径包含空格,则会在显示广告时将其替换为下划线 (_) 。

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

发布者国家/地区

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

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

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

状态

广告的状态。

可能的值为 ActivePausedDeleted

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

跟踪模板

要用作 FinalUrls 指定 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},并且未在市场活动、广告组、条件、关键字或广告级别定义 {_season}{_promocode} ,则登陆页 URL 将相同。

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