BiddableAdGroupCriterion 數據物件 - 行銷活動管理

定義您想要套用至指定廣告群組的可比對準則。

語法

XML

<xs:complexType name="BiddableAdGroupCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdGroupCriterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="CriterionBid" nillable="true" type="tns:CriterionBid" />
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdGroupCriterionEditorialStatus" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q82="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q82:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q83="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q83:ArrayOfstring" />
        <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="CriterionCashback" nillable="true" type="tns:CriterionCashback">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

JSON

{
  "AdGroupId": "LongValueHere",
  "Criterion": {
    "Type": "AgeCriterion",
    "AgeRange": "ValueHere"
  },
  "Id": "LongValueHere",
  "Status": "ValueHere",
  "Type": "BiddableAdGroupCriterion",
  "CriterionBid": {
    "Type": "BidMultiplier",
    "Multiplier": DoubleValueHere
  },
  "CriterionCashback": {
    "Type": "CashbackAdjustment",
    "CashbackPercent": DoubleValueHere
  },
  "DestinationUrl": "ValueHere",
  "EditorialStatus": "ValueHere",
  "FinalAppUrls": [
    {
      "OsType": "ValueHere",
      "Url": "ValueHere"
    }
  ],
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "FinalUrlSuffix": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  }
}

元素

BiddableAdGroupCriterion 物件具有下列元素：CriterionBid、CriterionCashback、DestinationUrl、ApprovalStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、TrackingUrlTemplate、UrlCustomParameters。

元素	描述	資料類型
CriterionBid	要在收購中使用的報價。 如果繼承的 準則 是 網頁 準則，則您必須使用 FixedBid。 如果繼承的 準則 是 ProductPartition，則您必須使用 FixedBid ，除非贊助產品 BidOption 設定為 BidBoost (，如需詳細資訊，請參閱下方的 ProductPartition Usage) 。 對於所有其他可標價的廣告群組準則，請使用 BidMultiplier。 如果您未使用正確的物件類型，則會忽略您要求的報價：如果需要進行中標，作業將會失敗;如果是選擇性的，則會使用預設的中標。 加： 需求會根據繼承的 準則 類型而有所不同。 如果 AgeCriterion、DayTimeCriterion、DeviceCriterion、GenderCriterion、LocationCriterion、ProfileCriterion、RadiusCriterion、AudienceCriterion 和 Webpage 準則未包含，則此比對是選擇性的，而且會設定為預設值 0。 此比對不適用於 LocationIntentCriterion (服務不會傳回任何錯誤，即使您將它包含在) ，也會忽略該) 。 當您使用 ApplyProductPartitionActions 作業新增 ProductPartition 時，除非產品數據分割類型為 Subdivision，否則需要進行比對，在此情況下不允許進行比對。 更新： 需求會根據繼承的 準則 類型而有所不同。 AgeCriterion、DayTimeCriterion、DeviceCriterion、GenderCriterion、LocationCriterion、ProfileCriterion 和 RadiusCriterion 需要進行申請。 此比對不適用於 LocationIntentCriterion (服務不會傳回任何錯誤，即使您將它包含在) ，也會忽略該) 。 針對 AudienceCriterion 和 網頁 準則，此比對是選擇性的，如果未設定更新的值，則不會變更此設定。 當您使用 ApplyProductPartitionActions 作業更新 ProductPartition 時，此比對是選擇性的，如果未設定更新的值，則不會變更此設定。	CriterionBid
CriterionCashback	定義 CriterionCashback 資料物件。	CriterionCashback
DestinationUrl	用戶按下廣告時所前往的網頁 URL。 只有在繼承的 準則 是 ProductPartition 準則時，才會使用這個專案。 如需詳細資訊，請參閱下方 的 ProductPartition 使用量 。	string
編輯狀態	供日後使用。	AdGroupCriterionEditorialStatus
FinalAppUrls	供日後使用。	AppUrl 陣 列
FinalMobileUrls	供日後使用。	字串陣列
FinalUrls	供日後使用。	字串陣列
FinalUrlSuffix	最終的 URL 後綴可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 後綴中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 後綴 。 只有在繼承的 準則 是 ProductPartition 或 Webpage 準則時，才會使用這個專案。 如需詳細資訊，請參閱下方 的 ProductPartition Usage 和 Webpage Usage 。	string
TrackingUrlTemplate	追蹤範本可讓您指定與最終 URL 或登陸頁面一起使用的 URL 追蹤參數。 建議您在帳戶層級新增追蹤範本，然後將它套用至較低層級實體的所有 URL，例如行銷活動、廣告群組和廣告。 若要深入瞭解，請參閱 Microsoft Advertising 說明文章 使用升級的 URL 追蹤 URL。 只有在繼承的 準則 是 ProductPartition 或 Webpage 準則時，才會使用這個專案。 如需詳細資訊，請參閱下方 的 ProductPartition Usage 和 Webpage Usage 。	string
UrlCustomParameters	用於 URL 追蹤的自訂索引鍵和值參數集合。 只有在繼承的 準則 是 ProductPartition 或 Webpage 準則時，才會使用這個專案。 如需詳細資訊，請參閱下方 的 ProductPartition Usage 和 Webpage Usage 。	CustomParameters

BiddableAdGroupCriterion 物件具有 Inherited Elements。

繼承的專案

從 AdGroupCriterion 繼承的元素

BiddableAdGroupCriterion 物件衍生自 AdGroupCriterion 物件，並繼承下列元素：AdGroupId、準則、標識符、狀態、類型。 下列描述專屬於 BiddableAdGroupCriterion，而且可能不適用於從 AdGroupCriterion 物件繼承相同元素的其他物件。

元素	描述	資料類型
AdGroupId	要套用準則之廣告群組的標識碼。 加： 必填 更新： 必填	長
標準	要套用至廣告群組的準則。 此準則可協助判斷是否提供廣告群組中的廣告。 如需可用準則類型的清單，請參閱 AdGroupCriterionType。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。	標準
標識碼	廣告群組準則的唯Microsoft廣告標識符。 加： 唯讀 更新： 必填	長
地位	狀態值，決定準則是否適用於廣告群組。 對於大部分可申請的廣告群組準則，唯一支援的狀態值是 Active。 如需例外狀況，請參閱下方 的網頁使用量 。 加： 唯讀 更新： 唯讀	AdGroupCriterionStatus
類型	廣告群組準則的類型。 當您擷取可標示的廣告群組準則時，此值為 BiddableAdGroupCriterion 。 如需廣告群組準則類型的詳細資訊，請參閱 AdGroupCriterion 資料物件備註。 加： 唯讀 更新： 唯讀	string

註解

ProductPartition 使用方式

如果繼承的 準則 是 ProductPartition 準則，請注意 BiddableAdGroupCriterion 屬性的下列用法。

CriterionBid

根據預設，發行者會針對產品群組使用 FixedBid 。 除非贊助產品 BidOption 設定為 BidBoost，否則您必須使用 FixedBid。 如果贊助產品 BidOption 設定為 BidBoost，則 BidMultiplier 代表百分比 (大於零) 用來放大合作夥伴的申請。

例如，假設您的合作夥伴透過 CriterionBid) ，在其產品群組中 (FixedBid 中申請美金 $5 美元。 如果您透過 CriterionBid) 的 (BidMultiplier 調整設為 20 (%) ，而且廣告群組的 BidMaxValue 為 0.50 (50) ，則您的共用會是 50 美元，而不是 $1 美元。

DestinationUrl

如果您目前使用目的地 URL，您最終必須將它們取代為追蹤範本。 如需詳細資訊，請參閱 URL 追蹤與升級的 URL。

URL 可以包含動態參數，例如 {MatchType}。 如需支持的參數清單，請參閱 Microsoft Advertising 說明文章 我可以使用哪些追蹤或 URL 參數？。

URL 最多可以包含 1,024 個字元。 如果 URL 未指定通訊協定，系統會在使用者按下廣告時使用 HTTP 通訊協定。 如果 URL 在您新增廣告時指定 HTTP 通訊協定，服務會移除 http:// 通訊協定字串， (HTTP 通訊協定字串不會計入 1,024 個字元的限制) ;不過，服務不會從 URL 移除 HTTPs：//) (HTTPS 通訊協定字串。

如果指定，則會使用目的地 URL;否則，目的地 URL 取決於您在Microsoft商家中心目錄中為產品供應專案指定之 『Link』 的對應值。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。

FinalUrlSuffix

最終的 URL 後綴可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 後綴中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 後綴 。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。

TrackingUrlTemplate

追蹤範本可以與您透過 內容 API 提交之產品供應專案的 [連結] 欄位中指定的 URL 搭配使用。 藉由結合摘要 URL 與追蹤範本，登陸頁面 URL 會組合在按兩下廣告之後引導使用者的位置。 當您使用 TrackingUrlTemplate 元素來更新 URL 參數，而不是在摘要 URL 中更新它們時，摘要 URL 不需要經過編輯檢閱，而且您的廣告會繼續不中斷地提供。 例如，如果您在目錄摘要中的產品供應專案 URL 是 https://contoso.com/，您可以指定下列追蹤範本： {lpurl}？matchtype={matchtype}&device={device}。

下列驗證規則適用於追蹤範本。 如需支援的範本和參數的詳細資訊，請參閱 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 會相同。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。

UrlCustomParameters

用於 URL 追蹤的自訂索引鍵和值參數集合。

Microsoft Advertising 會接受您在 CustomParameters 物件中包含的前 8 個 CustomParameter 物件，而且如果您包含超過 8 個自定義參數，則會傳回錯誤。 每個 CustomParameter 都包含 Key 和 Value 元素。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 將 UrlCustomParameters 元素設定為 null 或空白，以保留任何現有的自定義參數。 若要移除所有自定義參數，請將 CustomParameters 物件的 Parameters 元素設定為 null 或空白。 若要移除自定義參數的子集，請在 CustomParameters 物件的 Parameters 元素中指定您想要保留的自定義參數。

網頁使用量

如果繼承的 準則 是 網頁 準則，請注意 BiddableAdGroupCriterion 屬性的下列用法。

FinalUrlSuffix

最終的 URL 後綴可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 後綴中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 後綴 。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。

狀態

狀態值，決定準則是否適用於廣告群組。

您可以將狀態設定為 [ 作用中 ] 或 [ 已暫停]。 您無法將狀態設定為 [已刪除]。

加： 自選。
更新： 自選。 如果未設定更新的值，則此設定不會變更。

TrackingUrlTemplate

針對 網頁 準則，追蹤範本可以與從您為動態搜尋廣告營銷活動指定的網域動態產生的登陸頁面 URL 搭配使用。 藉由結合網域與追蹤範本，登陸頁面 URL 會組合在單擊廣告之後引導使用者的位置。 以下是追蹤範本的範例： {lpurl}？matchtype={matchtype}&device={device}。

下列驗證規則適用於追蹤範本。 如需支援的範本和參數的詳細資訊，請參閱 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 會相同。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。

UrlCustomParameters

用於 URL 追蹤的自訂索引鍵和值參數集合。

Microsoft Advertising 會接受您在 CustomParameters 物件中包含的前 8 個 CustomParameter 物件，而且如果您包含超過 8 個自定義參數，則會傳回錯誤。 每個 CustomParameter 都包含 Key 和 Value 元素。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 將 UrlCustomParameters 元素設定為 null 或空白，以保留任何現有的自定義參數。 若要移除所有自定義參數，請將 CustomParameters 物件的 Parameters 元素設定為 null 或空白。 若要移除自定義參數的子集，請在 CustomParameters 物件的 Parameters 元素中指定您想要保留的自定義參數。

需求

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