AccountProperty 数据对象 - 市场活动管理

项目
11/14/2024

将帐户级别属性名称映射到字符串值。

语法

XML
JSON

<xs:complexType name="AccountProperty" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Name" type="tns:AccountPropertyName" />
    <xs:element minOccurs="0" name="Value" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

{
  "Name": "ValueHere",
  "Value": "ValueHere"
}

元素

AccountProperty 对象具有以下元素：Name、Value。

元素	说明	数据类型
名称	帐户属性的名称。	AccountPropertyName
值	命名帐户属性的值。该值因帐户属性名称而异。有关详细信息，请参阅以下部分中的帐户属性值。	string

备注

帐户属性值

AdClickParallelTracking

确定是否启用并行跟踪。

如果使用 URL 跟踪，当客户点击你的广告时，他们通常需要经过一些重定向才能访问你的页面。这称为顺序跟踪。

通过并行跟踪，当客户单击你的广告时，他们会立即看到你的登陆页面。同时，Microsoft广告在后台运行跟踪 URL。因此，客户的用户体验得到了改进，你仍然可以获得相同的出色度量跟踪。

你需要在 URL 的跟踪模板中具有 {lpurl} 或其变体之一，以便并行跟踪正常工作。有关详细信息，请参阅并行跟踪将客户更快地到达登陆页面和我可以使用哪些跟踪或 URL 参数？。

如果 Name 元素设置为 AdClickParallelTracking，则返回的值可以是 true 或 false。如果值为 true，则启用并行跟踪。

重要

2020 年 5 月 31 日之后创建的所有帐户都需要并行跟踪。在 2021 年 1 月之前，你可以为 2020 年 6 月 1 日之前创建的帐户启用和禁用该功能，即将属性设置为 true 或 false。到 2021 年 1 月中旬，所有帐户都将启用并行跟踪，并且该值只能设置为 true。

AllowImageAutoRetrieve

确定是否允许Microsoft广告使用域中的图像来增强Microsoft受众网络上的广告。

重要

选择加入即表示你同意，从广告客户登陆页面检索到的任何图像或创意内容都是广告商根据广告协议 (第 2 节) 的内容使用许可“由” 广告商“提供的内容，并且广告客户同意Microsoft可以使用该内容为其自动创建广告和扩展。

注意

还不是每个人都有此功能。如果你没有，别担心，它即将推出！

如果 Name 元素设置为 AllowImageAutoRetrieve，则可以将 Value 设置为 true 或 false。如果值为 true，则启用图像自动检索功能。

AutoApplyRecommendations

确定是否允许Microsoft广告自动应用广告建议，以帮助提高广告性能。

警告

从 2022 年 11 月 30 日开始，市场活动管理 API 中的 AutoApplyRecommendations 已弃用。强烈建议你在 Ad Insight API 中使用新的自动应用管理界面。

注意

还不是每个人都有此功能。如果你没有，别担心，它即将推出！

当建议的广告可供你查看时，我们会告知你。可以在“建议”页面上找到广告建议。如果你不采取措施，我们将在评审期后自动应用它们：

多媒体广告：7 天
所有其他：14 天

可以随时更改自动应用选项。如果不选择自动应用广告建议，仍可手动应用建议。

如果 Name 元素设置为 AutoApplyRecommendations，则 Value 可以包含建议类型的列表。

在 Value 元素中，键和值对的列表用分号 (;) 分隔。在此示例中，为多媒体广告启用自动应用广告建议，但对响应式搜索广告或扩展文本广告则不支持。

<SetAccountPropertiesRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
  <AccountProperties xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AccountProperty>
      <Name>AutoApplyRecommendations</Name>
      <Value>MultimediaAdsAutoApply=true;ResponsiveSearchAdsAutoApply=false;ExpandedTextAdsAutoApply=false</Value>
    </AccountProperty>
  </AccountProperties>
</SetAccountPropertiesRequest>

默认键和值对为：

MultimediaAdsAutoApply=true;
ResponsiveSearchAdsAutoApply=false;
ExpandedTextAdsAutoApply=false;

如果键的值设置为 true，则为建议类型启用自动应用功能。

可以选择仅设置要更新的键和值对。如果未为更新设置任何值，则不会更改此设置。

BusinessAttributes

允许突出显示旨在帮助提高广告性能的关键业务价值。

业务属性是可选的，可以选择一个或多个适用于业务的属性。

如果 Name 元素设置为 BusinessAttributes，则 Value 可以包含属性类型的列表。

在 Value 元素中，业务属性列表用分号 (;) 分隔。可能的值包括：AlcoholFree、AllergyFriendly、AsianOwned、BlackOwned、CarbonNegative、CarbonNeutral、CrueltyFree、糖尿病朋友、EcoFriendly、 FamilyFriendly、FamilyOwned、麸质Free、清真、HearingAssistance、Kosher、LatinOwned、LocalBusiness、LGBTQIFriendly、LGBTQIOwned、MinorityOwned、MobilityAssistance、NoContactDelivery、非营利组织、PetFriendly、SmallBusiness、SupportACure、SupportDiseaseResearch、Sustainable、素食、VisualAssistance、TouchlessPickup、Unisex、WebAccessibility、WheelchairAccessible 和 WomenOwned。

在此示例中，无酒精、家庭拥有和素食是所选的业务属性。

<SetAccountPropertiesRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
  <AccountProperties xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AccountProperty>
      <Name>BusinessAttributes</Name>
      <Value>AlcoholFree;FamilyOwned;Vegan</Value>
    </AccountProperty>
  </AccountProperties>
</SetAccountPropertiesRequest>

如果属性出现在 value 属性中，则将其选中;如果属性未出现在 value 属性中，则表示未选择该属性。

若要删除帐户的业务属性，请将 “名称” 设置为 BusinessAttributes ，将 “值 ”设置为“” (空字符串) 。

可以选择仅设置要更新的业务属性。如果未为更新设置任何值，则不会更改此设置。

FinalUrlSuffix

如果 Name 元素设置为 FinalUrlSuffix，则 Value 表示帐户的最终 URL 后缀。

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

若要删除帐户的最终 URL 后缀，请将 Name 设置为 FinalUrlSuffix ，将值设置为 “” (空字符串) 。

IncludeViewThroughConversions

确定是否要为帐户中的市场活动包括查看转换。

浏览转换是用户在看到你的广告后进行转换，即使他们没有点击广告。

如果 Name 元素设置为 IncludeViewThroughConversions，则可以将 Value 设置为 true 或 false。如果值为 true，则将包括查看转换。默认情况下，如果处于功能试点 (GetCustomerPilotFeatures 返回 616) 此属性设置为 true，这意味着性能报告的“所有”转换列中的值将包括查看转换。如果不想包括视图转换，可以选择禁用它。

注意

查看转换需要 UETTag，因此此属性不适用于 AppInstallGoal、 InStoreTransactionGoal 和 OfflineConversionGoal。

MSCLKIDAutoTaggingEnabled

确定是否启用 MSCLKID 查询字符串参数的自动标记。 MSCLKID 是一个 32 个字符的 GUID，对于每次广告点击都是唯一的。

如果 Name 元素设置为 MSCLKIDAutoTaggingEnabled，则可以将 Value 设置为 true 或 false。如果值为 true，则启用 MSCLKID 自动标记功能。你可能希望启用 MSCLKID 的自动标记，以便通过脱机转换目标跟踪潜在顾客。如果启用了 MSCLKID 的自动标记，则当客户单击你的广告时，MSCLKID 会自动追加到登陆页 URL。例如， www.contoso.com/?msclkid={msclkid}。每次点击广告的点击 ID 都是唯一的，同一用户多次点击同一广告将导致多个点击 ID。

重要

创建新帐户时，MSCLKIDAutoTaggingEnabled 值默认设置为 true 。如果处于关闭状态，可以手动关闭。每次通过 Microsoft Advertising Web 应用程序或市场活动管理 API 添加或更新新的 DurationGoal、EventGoal、OfflineConversionGoal、PagesViewedPerVisitGoal 或 UrlGoal 时，相应 AccountProperty 的 MSCLKIDAutoTaggingEnabled 值会自动设置为 true。如果目标的范围设置为 “客户 级别”，则将设置“客户”下所有现有帐户的 AccountProperty 。

ProfileExpansionEnabled

确定是否在帐户中扩展LinkedIn配置文件目标，以覆盖与当前目标客户类似的其他客户。

启用个人资料定位扩展允许Microsoft广告向其他客户展示你的广告，就像你当前定位的客户一样。例如，如果你面向特定的LinkedIn受众细分，我们还将定位没有已确认LinkedIn帐户但与该细分中LinkedIn用户具有相同特征的必应用户。

如果 Name 元素设置为 ProfileExpansionEnabled，则可以将 Value 设置为 true 或 false。如果值为 true，则启用LinkedIn配置文件目标扩展功能。

TrackingUrlTemplate

如果 Name 元素设置为 TrackingUrlTemplate，则 Value 表示帐户的跟踪模板，用作帐户中所有 URL 的默认模板。 TrackingUrlTemplate 键的值可以设置为任何有效的字符串，如下所述。

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

若要删除帐户的跟踪模板，请将 Name 设置为 TrackingUrlTemplate ，将 “值 ”设置为 “” (空字符串) 。

要求

服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13

使用者

GetAccountProperties
SetAccountProperties

通过