广告组动态搜索广告目标记录 - 批量

项目
11/13/2024

定义可在批量文件中上传和下载的广告组动态搜索广告目标。

只能在具有有效动态搜索广告设置的搜索市场活动中创建广告组动态搜索广告目标记录，这些设置 (包括“域语言 ”、“已启用动态说明”、“页面源 ID”、“源”和“网站”字段) 。必须设置市场活动的试验 ID ，并且广告组类型必须设置为“SearchDynamic”。

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

如果提供了有效的父 ID 值，下面的批量 CSV 示例将添加新的广告组动态搜索广告目标。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Tracking Template,Custom Parameter,Dynamic Ad Target Condition 1,Dynamic Ad Target Condition 2,Dynamic Ad Target Condition 3,Dynamic Ad Target Value 1,Dynamic Ad Target Value 2,Dynamic Ad Target Value 3
Format Version,,,,,,,,,6.0,,,,,,,,
Ad Group Dynamic Search Ad Target,Paused,,-1113,,,ClientIdGoesHere,,0.5,Bulk Ad Group Dynamic Search Ad Target,,{_promoCode}=PROMO1; {_season}=summer,Url,Category,PageContent,contoso.com,US/CA/SFO,flowers

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupDynamicSearchAdTarget
var bulkAdGroupDynamicSearchAdTarget = new BulkAdGroupDynamicSearchAdTarget
{
    // Map properties in the Bulk file to the 
    // BiddableAdGroupCriterion object of the Campaign Management service.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new Webpage
        {
            Parameter = new WebpageParameter
            {
                // Set Conditions null if you want to target all webpages
                Conditions = new []
                {
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 1' column header in the Bulk file
                        Argument = "contoso.com",
                        // 'Dynamic Ad Target Condition 1' column header in the Bulk file
                        Operand = WebpageConditionOperand.Url
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 2' column header in the Bulk file
                        Argument = "US/CA/SFO",
                        // 'Dynamic Ad Target Condition 2' column header in the Bulk file
                        Operand = WebpageConditionOperand.Category
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 3' column header in the Bulk file
                        Argument = "flowers",
                        // 'Dynamic Ad Target Condition 3' column header in the Bulk file
                        Operand = WebpageConditionOperand.PageContent
                    },
                },
                // 'Name' column header in the Bulk file
                CriterionName = "Bulk Ad Group Dynamic Search Ad Target"
            }
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file
            Amount = 0.50
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // '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"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupDynamicSearchAdTarget);

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

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

对于 广告组动态搜索广告目标 记录，批量文件架构中提供了以下属性字段。

广告组
出价
市场活动
客户端 ID
自定义参数
动态广告目标条件 1
动态广告目标条件 2
动态广告目标条件 3
动态广告目标运算符 1
动态广告目标运算符 2
动态广告目标运算符 3
动态广告目标值 1
动态广告目标值 2
动态广告目标值 3
最终 URL 后缀
Id
修改时间
名称
父 ID
状态
跟踪模板

广告组

包含动态广告目标 (网页条件) 的广告组的名称。

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

注意

若要添加、更新和删除，必须指定 “父 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_value。 delete_value关键字 (keyword) 删除以前的设置。若要删除自定义参数的子集，请指定要保留的自定义参数，并省略任何不想保留的参数。新的自定义参数集将替换以前的任何自定义参数集。
删除： 只读

注意

如果未设置任何动态广告目标条件、运算符或值字段，则实际上是针对所有网页。

动态广告目标条件 1

最多 3 个网页条件操作数中的第一个。如果此字段引用的网页属性包含或等于 动态广告目标值 1 值 ，则满足条件。

可能的值包括 Category、 CustomLabel、 PageContent、 PageTitle 和 Url。

添加： 选。如果未设置任何动态广告目标条件或值字段，则实际上是针对所有网页。对于所有网页，每个广告组只能有一个动态广告目标。
更新： 不允许。不能更新动态广告目标条件或值字段。若要更新网页条件，必须删除动态广告目标并添加新目标。
删除： 只读

动态广告目标条件 2

最多 3 个网页条件操作数中的第二个。如果此字段引用的网页属性包含或等于 动态广告目标值 2 值 ，则满足条件。

可能的值包括 Category、 CustomLabel、 PageContent、 PageTitle 和 Url。

动态广告目标条件 3

最多 3 个网页条件操作数中的第三个。如果此字段引用的网页属性包含或等于 动态广告目标值 1 值 ，则满足条件。

可能的值包括 Category、 CustomLabel、 PageContent、 PageTitle 和 Url。

动态广告目标运算符 1

最多 3 个网页条件运算符中的第一个。如果此字段引用的网页属性包含或等于 动态广告目标值 1 值 ，则满足条件。

可能的值包括 Contains 和 Equals。

添加： 选。如果未设置任何动态广告目标条件、运算符或值字段，则实际上是针对所有网页。如果设置了动态广告目标条件 1，但未设置动态广告目标操作员 1，我们将对所选操作数使用默认运算符。如果要创建 URL Equals，则必须传递运算符。 更新： 不允许。无法更新动态广告目标运算符或值字段。若要更新网页条件，必须删除动态广告目标并添加新目标。
删除： 只读

动态广告目标运算符 2

最多 3 个网页条件运算符中的第二个。如果此字段引用的网页属性包含或等于 动态广告目标值 2 值 ，则满足条件。

可能的值包括 Contains 和 Equals。

添加： 选。如果未设置任何动态广告目标条件、运算符或值字段，则实际上是针对所有网页。如果设置了动态广告目标条件 21 且未设置动态广告目标运算符 2，我们将对所选的操作数使用默认运算符。如果要创建 URL Equals，则必须传递运算符。 更新： 不允许。无法更新动态广告目标运算符或值字段。若要更新网页条件，必须删除动态广告目标并添加新目标。
删除： 只读

动态广告目标运算符 3

最多 3 个网页条件运算符中的第三个。如果此字段引用的网页属性包含或等于 动态广告目标值 3 值，则满足条件。

可能的值包括 Contains 和 Equals。

添加： 选。如果未设置任何动态广告目标条件、运算符或值字段，则实际上是针对所有网页。如果设置了动态广告目标条件 3，但未设置动态广告目标运算符 3，我们将对所选的操作数使用默认运算符。如果要创建 URL Equals，则必须传递运算符。 更新： 不允许。无法更新动态广告目标运算符或值字段。若要更新网页条件，必须删除动态广告目标并添加新目标。
删除： 只读

动态广告目标值 1

最多 3 个网页条件或条件参数中的第一个。

可以将此字符串设置为网站的 URL、类别、页面标题或页面内容。例如，如果 “动态广告目标条件 1 ”字段设置为 “Url”，则可以将此字段设置为 contoso.com/flowers。

动态广告目标值 2

最多 3 个网页条件或条件参数中的第二个。

可以将此字符串设置为网站的 URL、类别、页面标题或页面内容。例如，如果 “动态广告目标条件 2 ”字段设置为 “Url”，则可以将此字段设置为 “contoso.com/flowers”。

动态广告目标值 3

最多 3 个网页条件或条件参数中的第三个。

可以将此字符串设置为网站的 URL、类别、页面标题或页面内容。例如，如果 “动态广告目标条件 3 ”字段设置为 “Url”，则可以将此字段设置为 “contoso.com/flowers”。

Id

系统生成的动态广告目标标识符 (网页条件) 。

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

最终 URL 后缀

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

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

修改时间

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

注意

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

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

名称

可用于标识条件的条件名称，例如，可以按字母顺序进行筛选或排序。

条件名称长度必须介于 1 到 2048 之间（含 1 到 2048）。

添加： 选。如果未指定任何名称，则默认情况下，该名称将设置为串联的条件列表。每个条件将由和关键字 (keyword) 分隔。例如，如果条件为) Url 包含花 ，b) Url 包含书籍 ，而 c) PageContent 包含 seattle，则默认条件名称将为 Url 包含花，Url 包含书籍，PageContent 包含 seattle。如果所有条件和值字段都为空，则有效定位所有网页，并且名称将设置为 “所有网页”。
更新： 选。如果未为更新设置任何值，则不会更改此设置。如果指定delete_value关键字 (keyword) ，则条件名称将更新为默认值，即所有网页或串联的条件列表。
删除： 只读

父 ID

系统生成的广告组标识符，其中包含动态广告目标 (网页条件) 。

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

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

注意

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

状态

动态广告目标 (网页条件的状态) 。

可能的值为 Active、 Paused 或 Deleted。

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

跟踪模板

跟踪模板可与从为动态搜索广告市场指定的域动态生成的登陆页面 URL 结合使用。通过将域与跟踪模板组合在一起，登陆页 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 将相同。

通过

广告组动态搜索广告目标记录 - 批量

广告组

出价

Campaign

客户端 ID

自定义参数

动态广告目标条件 1

动态广告目标条件 2

动态广告目标条件 3

动态广告目标运算符 1

动态广告目标运算符 2

动态广告目标运算符 3

动态广告目标值 1

动态广告目标值 2

动态广告目标值 3

Id

最终 URL 后缀

修改时间

名称

父 ID

状态

跟踪模板

反馈

其他资源