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

项目
11/13/2024

定义广告市场活动中的广告组。

注意

自 2024 年 7 月起，你无法再将要在其中显示广告的搜索网络设置为 SyndicatedSearchOnly。如果尝试将其设置为 SyndicatedSearchOnly，将返回 CampaignServiceInvalidNetwork 错误。

语法

XML
JSON

<xs:complexType name="AdGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdRotation" nillable="true" type="tns:AdRotation" />
    <xs:element minOccurs="0" name="AudienceAdsBidAdjustment" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="CommissionRate" nillable="true" type="tns:RateBid">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="CpcBid" nillable="true" type="tns:Bid" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q21="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q21:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="FrequencyCapSettings" nillable="true" type="tns:ArrayOfFrequencyCapSettings">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Language" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="MultimediaAdsBidAdjustment" nillable="true" type="xs:int">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Network" nillable="true" type="tns:Network" />
    <xs:element minOccurs="0" name="PercentCpcBid" nillable="true" type="tns:RateBid">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="PrivacyStatus" nillable="true" type="tns:AdGroupPrivacyStatus" />
    <xs:element minOccurs="0" name="Settings" nillable="true" type="tns:ArrayOfSetting" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdGroupStatus" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
    <xs:element minOccurs="0" name="UseOptimizedTargeting" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="UsePredictiveTargeting" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="AdScheduleUseSearcherTimeZone" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="AdGroupType" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="CpvBid" nillable="true" type="tns:Bid">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="CpmBid" nillable="true" type="tns:Bid">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="McpaBid" nillable="true" type="tns:Bid">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

{
  "AdGroupType": "ValueHere",
  "AdRotation": {
    "EndDate": "ValueHere",
    "StartDate": "ValueHere",
    "Type": "ValueHere"
  },
  "AdScheduleUseSearcherTimeZone": "ValueHere",
  "AudienceAdsBidAdjustment": IntValueHere,
  "BiddingScheme": {
    "Type": "CommissionBiddingScheme",
    "CommissionRate": DoubleValueHere
  },
  "CommissionRate": {
    "RateAmount": {
      "Amount": DoubleValueHere
    }
  },
  "CpcBid": {
    "Amount": DoubleValueHere
  },
  "CpmBid": {
    "Amount": DoubleValueHere
  },
  "CpvBid": {
    "Amount": DoubleValueHere
  },
  "EndDate": {
    "Day": IntValueHere,
    "Month": IntValueHere,
    "Year": IntValueHere
  },
  "FinalUrlSuffix": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "FrequencyCapSettings": [
    {
      "CapValue": IntValueHere,
      "TimeGranularity": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Language": "ValueHere",
  "McpaBid": {
    "Amount": DoubleValueHere
  },
  "MultimediaAdsBidAdjustment": IntValueHere,
  "Name": "ValueHere",
  "Network": "ValueHere",
  "PercentCpcBid": {
    "RateAmount": {
      "Amount": DoubleValueHere
    }
  },
  "PrivacyStatus": "ValueHere",
  "Settings": [
    {
      "Type": "AppSetting",
      "AppId": "ValueHere",
      "AppStore": "ValueHere"
    }
  ],
  "StartDate": {
    "Day": IntValueHere,
    "Month": IntValueHere,
    "Year": IntValueHere
  },
  "Status": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  },
  "UseOptimizedTargeting": "ValueHere",
  "UsePredictiveTargeting": "ValueHere"
}

元素

AdGroup 对象具有以下元素：AdGroupType、AdRotation、AdScheduleUseSearcherTimeZone、AudienceAdsBidAdjustment、BiddingScheme、CommissionRate、CpcBid、CpmBid、CpvBid、EndDate、FinalUrlSuffix、ForwardCompatibilityMap、FrequencyCapSettings、Id、Language、McpaBid、 MultimediaAdsBidAdjustment、Name、Network、PercentCpcBid、PrivacyStatus、Settings、StartDate、Status、TrackingUrlTemplate、UrlCustomParameters、UseOptimizedTargeting、UsePredictiveTargeting。

元素	说明	数据类型
AdGroupType	广告组类型。在 CampaignType 为“Search”的混合市场活动中，未设置 ExperimentId，并且“设置”已具有有效的 DynamicSearchAdsSetting，可能的值为“SearchDynamic”和“SearchStandard”。否则，“搜索”市场活动中的广告组类型只能设置为“SearchStandard”。如果广告组类型为“SearchDynamic”，则只能在此广告组中添加动态搜索广告。如果广告组类型为“SearchStandard”，则可以在此广告组中添加展开的文本广告或响应式搜索广告。 “DynamicSearchAds”市场活动中的广告组类型只能设置为“SearchDynamic”。无需为“DynamicSearchAds”市场活动设置广告组类型，但请注意，检索广告组时，此元素将设置为“SearchDynamic”。对于“酒店”或“搜索”市场活动类型，此字段可以设置为“ HotelAds ”。无法为“受众”或“购物”市场活动类型设置此元素。检索不受支持的市场活动中的广告组时，不会设置此元素。加：自选。 “搜索”市场活动的默认值为“SearchStandard”。 “DynamicSearchAds”市场活动的默认值为“SearchDynamic”。更新：只读。无法更新广告组类型。	string
AdRotation	如果一个广告组中有多个广告，广告轮换设置Microsoft广告选择投放哪些广告的频率。由于一次只能显示帐户中的一个广告，因此广告轮换将优先考虑在统计上显示更可能表现更好的广告。注意：广告轮换不适用于产品广告。广告轮换类型的可能值为 OptimizeForClicks 和 RotateAdsEvenly。如果设置为 OptimizeForClicks，Microsoft广告会根据拍卖特征或因素（如关键字 (keyword) 、搜索词、设备或位置）确定广告组中表现最好的广告的优先级。效果更好的广告将更频繁地显示，而其他广告的投放频率会降低（如果的话）。如果设置为 RotateAdsEvenly，Microsoft广告在广告之间的轮换中提供了更多的平衡。也就是说，特定广告组中的广告在响应搜索者的查询时有类似的显示机会。如果广告质量较低，则广告的优先级较低，因此显示频率可能较低，或者根本不显示。 - RotateAdsEvenly 设置可以允许性能较低的广告像性能更好的广告一样频繁地显示。这可能会影响广告组性能。 - 如果使用自动出价策略（即 MaxClicks、MaxConversions、TargetCpa 或 TargetRoas），则 RotateAdsEvenly 设置将被忽略，因为这些出价策略优先考虑性能更好的广告。加：自选。默认值为 OptimizeForClicks。更新：自选。如果未为更新设置任何值，则不会更改此设置。	AdRotation
AdScheduleUseSearcherTimeZone	确定是使用帐户时区还是搜索用户的时区（可在其中投放广告）。如果希望广告显示在搜索用户的时区中，请将此属性设置为 true ，否则将其设置为 false。默认情况下不返回此元素。若要获取此元素，请在调用 GetAdGroupsByCampaignId 和 GetAdGroupsByIds 服务操作时，在 ReturnAdAditionalFields 元素中包含 AdScheduleUseSearcherTimeZone 值。加：自选。如果未指定此元素或将其留空，则将设置默认值 true ，并使用搜索用户的时区。 2020 年 9 月 30 日之后，如果未指定此字段或将其留空，则设置默认值 false 并使用帐户时区。更新：自选。如果未为更新设置任何值，则不会更改此设置。	boolean
AudienceAdsBidAdjustment	调整高于或低于基本广告组或关键字 (keyword) 出价的受众广告出价的百分比。如果客户启用了Microsoft受众网络，则此属性在搜索市场活动中可用。此属性不适用于智能购物市场活动。支持的值为负 100 (-100) 到正 900 (900) 。将出价调整设置为 -100% 将阻止为此广告组显示受众广告。如果不希望对受众广告进行任何出价调整，请将此元素设置为零 (0) 。如果此元素为 null，你将继承广告组市场活动的AudienceAdsBidAdjustment 设置。加：自选更新：自选。仅当同时将 UpdateAudienceAdsBidAdjustment 元素设置为 true 时，才会更新此属性，否则将忽略此属性。如果广告组已具有本机出价调整，并且你想要将其删除以有效继承广告组市场活动的AudienceAdsBidAdjustment 设置，请将此元素设置为 null。	int
BiddingScheme	要如何管理出价的出价策略类型。注意：自 2021 年 4 月起，无法为广告组或关键字设置任何出价策略。如果尝试为广告组或关键字设置出价策略，请求将被忽略，而不会出错。广告组和关键字将继承其市场活动的出价策略。加：自选。如果未设置此元素，则默认使用 InheritFromParentBiddingScheme 。更新：自选。如果未为更新设置任何值，则不会更改此设置。	BiddingScheme
佣金率	当有人预订酒店并留在那里时，向广告商收取的佣金率。	RateBid
CpcBid	当用户的查询与广告组的关键字匹配时，使用广泛、精确或短语匹配比较时使用的默认出价。最小和最大出价范围取决于帐户的货币。有关详细信息，请参阅货币。在关键字 (keyword) 级别指定广泛、精确或短语匹配出价会替代相应匹配类型的广告组 Cpc 出价值。加：自选。如果未设置出价，将根据帐户的货币将其设置为最低出价。更新：自选。如果未为更新设置任何值，则不会更改此设置。	竞价
CpmBid	手动 CPM 出价策略类型。使用 ManualCpm (每千次手动成本) 出价策略时，可以设置每千次展示要支付的最高金额，Microsoft广告每次都会使用这些出价。默认情况下不返回此元素。若要获取此元素，请在调用 GetAdGroupsByCampaignId 和 GetAdGroupsByIds 服务操作时，在 ReturnAdditionalFields 元素中包含 CpmBid 值。	竞价
CpvBid	手动 CPV 出价策略类型。使用 ManualCpv (手动每次查看成本) 出价策略，可以设置每次观看或每次点击视频广告时要支付的最高金额，Microsoft广告每次都会使用这些出价。默认情况下不返回此元素。若要获取此元素，请在调用 GetAdGroupsByCampaignId 和 GetAdGroupsByIds 服务操作时，在 ReturnAdditionalFields 元素中包含 Cpv 值。	竞价
EndDate	广告组中广告的到期日期。如果未指定结束日期，广告将不会过期。可以延长结束日期，使广告组的广告符合投放条件，即使在广告组过期后也是如此。结束日期是包含的。例如，如果将 EndDate 设置为 12/31/2020，广告组中的广告将在 2020 年 12 月 31 日晚上 11：59 过期。时间基于在市场活动级别指定的时区。加：自选。若要在添加广告组时不设置结束日期，请将此元素设置为 null。更新：自选。如果未为更新设置任何值，则不会更改此设置。若要删除现有的结束日期设置，并在更新广告组时有效地不设置结束日期，请将结束日期设置为等于或晚于 2050 年 1 月 2 日。下次检索广告组时，此元素将为零，即不会设置为 2050 年 1 月 2 日。	Date
FinalUrlSuffix	最终 URL 后缀可以包括跟踪参数，这些参数将追加到登陆页 URL 的末尾。建议将登陆页面所需的跟踪参数放在最终 URL 后缀中，以便始终将客户发送到登陆页面。有关更多详细信息和验证规则，请参阅技术指南中的最终 URL 后缀。加：自选更新：自选。如果未为更新设置任何值，则不会更改此设置。如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。	string
ForwardCompatibilityMap	用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。将来的版本中将在此处记录向前兼容性更改。此对象当前没有向前兼容性更改。	KeyValuePairOfstringstring 数组
FrequencyCapSettings	频率上限的设置。	FrequencyCapSettings 数组
ID	广告组的系统生成的标识符。加：不允许。更新：只读和必需	long
语言	广告语言设置决定了在撰写广告时将使用的语言，并且应是客户的语言。重要：如果在广告组和市场活动级别都设置了语言，则广告组级别语言将替代市场活动级别语言。搜索和购物市场活动支持的语言字符串包括：保加利亚语、克罗地亚语、捷克语、丹麦语、荷兰语、英语、爱沙尼亚语、芬兰语、法语、德语、希腊语、匈牙利语、意大利语、拉脱维亚语、立陶宛语、马耳他语、挪威语、葡萄牙语、罗马尼亚语、斯洛伐克语、斯洛文尼亚语、西班牙语、瑞典语和繁体中文。注意：以下语言尚未可供所有人使用：保加利亚语、克罗地亚语、捷克语、爱沙尼亚语、希腊语、匈牙利语、拉脱维亚语、立陶宛语、马耳他语、波兰语、罗马尼亚语、斯洛伐克语、斯洛文尼亚语。对于动态搜索广告市场活动，市场活动和广告组级别语言设置将被忽略，转而使用网站域语言。应将市场活动语言设置为“全部”，并将广告组级别语言留空。对于受众市场活动中的广告组，不支持广告组级别语言，并且必须将广告组市场活动的语言元素设置为“全部”。加：如果市场活动设置了一个或多个语言，则为可选语言，否则大多数市场活动类型都需要该语言。不允许为受众市场活动中的广告组设置此元素。更新：自选。如果未为更新设置任何值，则不会更改此设置。若要删除语言并遵循市场活动级别语言，请将此元素设置为空字符串值， (“”) 。	string
麦克帕比德	手动 CPA 出价策略类型。使用 ManualCpa (手动按操作成本) 出价策略，可以设置广告客户指定的大操作。	竞价
MultimediaAdsBidAdjustment	调整高于或低于基本广告组或关键字 (keyword) 出价的多媒体广告出价的百分比。	int
名称	广告组的名称。该名称在市场活动中的所有活动广告组中必须唯一。名称最多可以包含 256 个字符。加：必填更新：自选。如果未为更新设置任何值，则不会更改此设置。	string
网络	要在其中显示广告的搜索网络。大多数市场活动类型中广告组支持的网络值为 OwnedAndOperatedAndSyndicatedSearch 和 OwnedAndOperatedOnly。对于受众市场活动中的广告组，不支持广告组级网络。广告组位于Microsoft受众网络中。对于智能购物市场活动中的广告组，无法设置网络。该服务会将网络设置为 OwnedAndOperatedAndSyndicatedSearch。对于品牌购物活动中的广告组，除了 OwnedAndOperatedAndSyndicatedSearch 和 OwnedAndOperatedOnly 外，还支持 InHousePromotion 网络) (零售商网络。如果选择其中一个联合搜索选项，则可以调用 SetNegativeSitesToAdGroups 或 SetNegativeSitesToCampaigns 操作，以防止广告在特定联合搜索网站上显示。有关网络和广告分发的详细信息，请参阅关于广告分发帮助一文。加：自选。默认值为 OwnedAndOperatedAndSyndicatedSearch。更新：自选。如果未为更新设置任何值，则不会更改此设置。	网络
PercentCpcBid	CPC 出价策略类型的百分比 (每晚酒店总价格，包括) 税费。	RateBid
PrivacyStatus	指示广告组目标条件（例如 ProfileCriterion ）对于受众市场活动中的广告组来说是否太窄。加：只读更新：只读	AdGroupPrivacyStatus
设置	广告组设置通常因市场活动类型而异。在设置列表中，每个设置类型最多可以包含一个对象，例如，一个 TargetSetting。 TargetSetting 可用于任何市场活动类型，并确定与此广告组关联的年龄、受众、公司名称、性别、行业和 JobFunction 条件是否使用“目标和出价”选项或“仅出价”目标选项。在 TargetSetting 中，可以有多个 TargetSettingDetail 对象，即每个 CriterionTypeGroup 一个对象。加：自选。如果此元素不包括 TargetSetting 对象，则所有条件类型组的默认出价选项实际上是“仅出价”。更新：自选。如果未为更新设置任何值，则不会更改此设置。	设置数组
StartDate	广告组中的广告可以开始投放的日期;否则，服务可以在广告组处于活动状态的当天开始在广告组中投放广告。开始日期是包含的。例如，如果将开始日期设置为 2021 年 5 月 5 日，广告组中的广告将从 2021 年 5 月 5 日上午 12：00 开始。时间基于在市场活动级别指定的时区。加：自选。如果未设置开始日期，则默认为今天的日期，一旦广告组状态处于活动状态，服务就可以开始在广告组中投放广告。更新：自选。如果未为更新设置任何值，则不会更改此设置。在提交广告组后（即开始日期到达后）无法更新开始日期。	Date
状态	广告组的状态。可能的值为 Active、 Expired 和 Paused。 “已过期”状态为只读。加：自选。默认值为 Paused。更新：自选。如果未为更新设置任何值，则不会更改此设置。	AdGroupStatus
TrackingUrlTemplate	要用作广告组中所有 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}` ，并且未在市场活动、广告组、条件、关键字 (keyword) 或广告级别定义 {_season} 或 {_promocode}，则登陆页 URL 将相同。加：自选更新：自选。如果未为更新设置任何值，则不会更改此设置。如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。	string
UrlCustomParameters	用于 URL 跟踪的键和值参数的自定义集合。 Microsoft Advertising 将接受在 CustomParameters 对象中包含的前 8 个 CustomParameter 对象，如果包含 8 个以上的自定义参数，则会返回错误。每个 CustomParameter 都包含键和值元素。加：自选更新：自选。如果未为更新设置任何值，则不会更改此设置。将 UrlCustomParameters 元素设置为 null 或空，以保留任何现有自定义参数。若要删除所有自定义参数，请将 CustomParameters 对象的 Parameters 元素设置为 null 或空。若要删除自定义参数的子集，请指定要保留在 CustomParameters 对象的 Parameters 元素中的自定义参数。	CustomParameters
UseOptimizedTargeting	这将弃用。请改用 UsePredictiveTargeting 。	boolean
UsePredictiveTargeting	指示是否为 AdGroup 启用预测目标。注意：UsePredictiveTargeting 仅适用于受众市场活动。加：自选更新：自选。	boolean

要求

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

使用者

AddAdGroups
GetAdGroupsByCampaignId
GetAdGroupsByIds
UpdateAdGroups

通过

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

语法

元素

要求

使用者

反馈

其他资源