BiddableCampaignCriterion-Datenobjekt – Kampagnenverwaltung

Artikel
11/13/2024

Definiert ein gebotsfähiges Kriterium, das auf die angegebene Kampagne angewendet werden soll.

Syntax

XML
JSON

<xs:complexType name="BiddableCampaignCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:CampaignCriterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="CriterionBid" nillable="true" type="tns:CriterionBid" />
        <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>

{
  "CampaignId": "LongValueHere",
  "Criterion": {
    "Type": "AgeCriterion",
    "AgeRange": "ValueHere"
  },
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Status": "ValueHere",
  "Type": "BiddableCampaignCriterion",
  "CriterionBid": {
    "Type": "BidMultiplier",
    "Multiplier": DoubleValueHere
  },
  "CriterionCashback": {
    "Type": "CashbackAdjustment",
    "CashbackPercent": DoubleValueHere
  }
}

Elemente

Das BiddableCampaignCriterion-Objekt weist die folgenden Elemente auf: CriterionBid, CriterionCashback.

Element	Beschreibung	Datentyp
CriterionBid	Das Gebot, das in der Auktion verwendet werden soll. Wenn das geerbte Kriterium ein ProductScope-Kriterium ist, können Sie fixedBid verwenden. Verwenden Sie für alle anderen Biddable-Kampagnenkriterien den BidMultiplier. Wenn Sie nicht den richtigen Objekttyp verwenden, wird das angeforderte Gebot ignoriert: Wenn das Gebot erforderlich ist, schlägt der Vorgang fehl; Wenn das Gebot optional ist, wird das Standardgebot verwendet. Hinzufügen: Die Anforderungen variieren je nach geerbtem Kriteriumtyp . Das Gebot ist optional und wird auf den Standardwert 0 festgelegt, wenn es für AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, ProfileCriterion und RadiusCriterion nicht enthalten ist. Das Gebot gilt nicht für LocationIntentCriterion und ProductScope (Der Dienst gibt keinen Fehler zurück, und das Gebot wird ignoriert, selbst wenn Sie es einschließen). Aktualisieren: Die Anforderungen variieren je nach geerbtem Kriteriumtyp . Das Gebot ist für AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, ProfileCriterion und RadiusCriterion erforderlich. Das Gebot gilt nicht für LocationIntentCriterion und ProductScope (Der Dienst gibt keinen Fehler zurück, und das Gebot wird ignoriert, selbst wenn Sie es einschließen).	CriterionBid
CriterionCashback	Definiert das CriterionCashback-Datenobjekt.	CriterionCashback

Das BiddableCampaignCriterion-Objekt verfügt über geerbte Elemente.

Geerbte Elemente

Geerbte Elemente von CampaignCriterion

Das BiddableCampaignCriterion-Objekt wird vom CampaignCriterion-Objekt abgeleitet und erbt die folgenden Elemente: CampaignId, Criterion, ForwardCompatibilityMap, Id, Status, Type. Die folgenden Beschreibungen sind spezifisch für BiddableCampaignCriterion und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom CampaignCriterion-Objekt erben.

Element	Beschreibung	Datentyp
CampaignId	Der Bezeichner der Kampagne, auf die das Kriterium angewendet werden soll. Hinzufügen: Erforderlich Aktualisieren: Erforderlich	lang
Kriterium	Das Kriterium, das auf die Kampagne angewendet werden soll. Das Kriterium hilft zu bestimmen, ob Anzeigen in der Kampagne bedient werden. Eine Liste der verfügbaren Kriterientypen finden Sie unter CampaignCriterionType. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	Kriterium
ForwardCompatibilityMap	Die Liste der Schlüssel- und Wertzeichenfolgen für die Vorwärtskompatibilität, um andere Breaking Changes zu vermeiden, wenn neue Elemente in der aktuellen API-Version hinzugefügt werden.	KeyValuePairOfstring-Array
Id	Der eindeutige Microsoft Advertising-Bezeichner für das Kampagnenkriterium. Hinzufügen: Schreibgeschützt Aktualisieren: Erforderlich	lang
Status	Ein status Wert, der bestimmt, ob das Kriterium für die Kampagne gilt. Die einzige unterstützte status für angebotsfähige Kampagnenkriterien ist derzeit Aktiv. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	CampaignCriterionStatus
Typ	Der Typ des Kampagnenkriteriums. Dieser Wert ist BiddableCampaignCriterion , wenn Sie ein gebotsfähiges Kampagnenkriterium abrufen. Weitere Informationen zu Kampagnenkriteriumstypen finden Sie in den CampaignCriterion-Datenobjekthinweisen. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	Zeichenfolge

Anforderungen

Dienst: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Freigeben über