Freigeben über

BiddableAdGroupCriterion-Datenobjekt – Kampagnenverwaltung

  • Artikel

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

Syntax

<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:q81="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q81:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q82="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q82: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>

Elemente

Das BiddableAdGroupCriterion-Objekt weist die folgenden Elemente auf: CriterionBid, CriterionCashback, DestinationUrl, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, TrackingUrlTemplate, UrlCustomParameters.

Element Beschreibung Datentyp
CriterionBid Das Gebot, das in der Auktion verwendet werden soll.

Wenn das geerbte Kriterium ein Webseitenkriterium ist, müssen Sie fixedBid verwenden. Wenn das geerbte Kriterium eine ProductPartition ist, müssen Sie ein FixedBid verwenden, es sei denn, die BidOption für gesponserte Produkte ist auf BidBoost festgelegt (ausführliche Informationen finden Sie unter ProductPartition Usage unten). Verwenden Sie für alle anderen Kriterien der gebotsfähigen Anzeigengruppe den BidMultiplier.For all other biddable ad group kriterien use the 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 die Kriterien AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, ProfileCriterion, RadiusCriterion, AudienceCriterion und Webseite nicht enthalten ist. Das Gebot gilt nicht für LocationIntentCriterion (Der Dienst gibt keinen Fehler zurück, und das Gebot wird ignoriert, auch wenn Sie es einschließen). Wenn Sie eine ProductPartition mit dem ApplyProductPartitionActions-Vorgang hinzufügen, ist das Gebot erforderlich, es sei denn, der Produktpartitionstyp ist Unterteilung. In diesem Fall ist das Gebot nicht zulässig.
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 (Der Dienst gibt keinen Fehler zurück, und das Gebot wird ignoriert, auch wenn Sie es einschließen). Für die Kriterien AudienceCriterion und Webseite ist das Gebot optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie eine ProductPartition mit dem ApplyProductPartitionActions-Vorgang aktualisieren, ist das Gebot optional. Wenn kein Wert für das Update festgelegt ist, wird diese Einstellung nicht geändert.		 CriterionBid
CriterionCashback Reserviert. CriterionCashback
DestinationUrl Die URL der Webseite, zu der der Benutzer weitergeleitet wird, wenn er auf die Anzeige klickt.

Dieses Element wird nur verwendet, wenn das geerbte Kriterium ein ProductPartition-Kriterium ist. Weitere Informationen finden Sie weiter unten unter Verwendung von ProductPartition .		 Zeichenfolge
EditorialStatus Reserviert für zukünftige Verwendung. AdGroupCriterionEditorialStatus
FinalAppUrls Reserviert für zukünftige Verwendung. AppUrl-Array
FinalMobileUrls Reserviert für zukünftige Verwendung. Zeichenfolgenarray
FinalUrls Reserviert für zukünftige Verwendung. Zeichenfolgenarray
FinalUrlSuffix Das endgültige URL-Suffix kann Nachverfolgungsparameter enthalten, die an das Ende ihrer Landing Page-URL angefügt werden. Es wird empfohlen, die für Ihre Landing Page benötigten Nachverfolgungsparameter in einem endgültigen URL-Suffix zu platzieren, damit Ihre Kunden immer an Ihre Landing Page gesendet werden. Weitere Informationen und Validierungsregeln finden Sie unter Endgültiges URL-Suffix in den technischen Leitfäden.

Dieses Element wird nur verwendet, wenn das geerbte Kriterium entweder ein ProductPartition-Kriterium oder ein Webseitenkriterium ist. Weitere Informationen finden Sie weiter unten unter Nutzung von ProductPartition und Webseitennutzung .		 Zeichenfolge
TrackingUrlTemplate In Nachverfolgungsvorlagen können Sie URL-Nachverfolgungsparameter angeben, die zusammen mit Ihrer endgültigen URL oder Landing Page verwendet werden.

Es wird empfohlen, die Nachverfolgungsvorlage auf Kontoebene hinzuzufügen, die dann auf alle URLs für Entitäten niedrigerer Ebene angewendet wird, z. B. Kampagnen, Anzeigengruppen und Anzeigen. Weitere Informationen finden Sie in den Microsoft Advertising-Hilfeartikeln zur URL-Nachverfolgung mit aktualisierten URLs.

Dieses Element wird nur verwendet, wenn das geerbte Kriterium entweder ein ProductPartition-Kriterium oder ein Webseitenkriterium ist. Weitere Informationen finden Sie weiter unten unter Nutzung von ProductPartition und Webseitennutzung .		 Zeichenfolge
UrlCustomParameters Ihre benutzerdefinierte Sammlung von Schlüssel- und Wertparametern für die URL-Nachverfolgung.

Dieses Element wird nur verwendet, wenn das geerbte Kriterium entweder ein ProductPartition-Kriterium oder ein Webseitenkriterium ist. Weitere Informationen finden Sie weiter unten unter Nutzung von ProductPartition und Webseitennutzung .		 CustomParameters

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

Geerbte Elemente

Geerbte Elemente von AdGroupCriterion

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

Element Beschreibung Datentyp
AdGroupId Der Bezeichner der Anzeigengruppe, auf die das Kriterium angewendet werden soll.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich		 Lange
Kriterium Das Kriterium, das auf die Anzeigengruppe angewendet werden soll. Das Kriterium hilft zu bestimmen, ob Anzeigen in der Anzeigengruppe geschaltet werden.

Eine Liste der verfügbaren Kriterientypen finden Sie unter AdGroupCriterionType.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 Kriterium
Id Der eindeutige Microsoft Advertising-Bezeichner für das Anzeigengruppenkriterium.

Hinzufügen: Schreibgeschützt
Aktualisieren: Erforderlich		 Lange
Status Ein status Wert, der bestimmt, ob das Kriterium für die Anzeigengruppe gilt.

Für die meisten Kriterien der gebotsfähigen Anzeigengruppe wird nur status Wert "Aktiv" unterstützt. Ausnahmen finden Sie weiter unten unter Webseitennutzung .

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 AdGroupCriterionStatus
Typ Der Typ des Anzeigengruppenkriteriums. Dieser Wert ist BiddableAdGroupCriterion , wenn Sie ein gebotsfähiges Anzeigengruppenkriterium abrufen. Weitere Informationen zu Kriterientypen für Anzeigengruppen finden Sie in den AdGroupCriterion-Datenobjekthinweisen.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Zeichenfolge

Hinweise

ProductPartition-Verwendung

Wenn das geerbte Kriterium ein ProductPartition-Kriterium ist, beachten Sie die folgende Verwendung von BiddableAdGroupCriterion-Eigenschaften .

CriterionBid

Standardmäßig wird für die Auktion ein FixedBid für Produktgruppen verwendet. Sie müssen fixedBid verwenden, es sei denn, die BidOption für gesponserte Produkte ist auf BidBoost festgelegt. Wenn die BidOption für gesponserte Produkte auf BidBoost festgelegt ist, stellt bidMultiplier den Prozentsatz (größer als 0) dar, der zur Verstärkung des Gebots Ihres Partners verwendet wird.

Angenommen, Ihr Partner bietet 5 USD in seiner Produktgruppe (FixedBid über CriterionBid). Wenn Ihre Gebotsanpassung (BidMultiplier über CriterionBid) auf 20 (Prozent) und der BidMaxValue Ihrer Anzeigengruppe 0,50 (50 Cent) beträgt, beträgt Ihre Aktie 50 Cent und nicht 1 USD.

DestinationUrl

Wenn Sie derzeit Ziel-URLs verwenden, müssen Sie diese schließlich durch Nachverfolgungsvorlagen ersetzen. Weitere Informationen finden Sie unter URL-Nachverfolgung mit aktualisierten URLs.

Die URL kann dynamische Parameter wie {MatchType} enthalten. Eine Liste der unterstützten Parameter finden Sie im Microsoft Advertising-Hilfeartikel Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?.

Die URL darf maximal 1.024 Zeichen enthalten. Wenn die URL kein Protokoll angibt, verwendet das System das HTTP-Protokoll, wenn ein Benutzer auf die Anzeige klickt. Wenn die URL das HTTP-Protokoll angibt, wenn Sie eine Anzeige hinzufügen, entfernt der Dienst die http:// Protokollzeichenfolge (die HTTP-Protokollzeichenfolge zählt nicht auf den Grenzwert von 1.024 Zeichen); Der Dienst entfernt jedoch keine HTTPS-Protokollzeichenfolge (https://) aus der URL.

Wenn angegeben, wird die Ziel-URL verwendet. Andernfalls wird die Ziel-URL durch den entsprechenden Wert des "Links" bestimmt, den Sie für das Produktangebot in Ihrem Microsoft Merchant Center-Katalog angegeben haben.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.

FinalUrlSuffix

Das endgültige URL-Suffix kann Nachverfolgungsparameter enthalten, die an das Ende ihrer Landing Page-URL angefügt werden. Es wird empfohlen, die für Ihre Landing Page benötigten Nachverfolgungsparameter in einem endgültigen URL-Suffix zu platzieren, damit Ihre Kunden immer an Ihre Landing Page gesendet werden. Weitere Informationen und Validierungsregeln finden Sie unter Endgültiges URL-Suffix in den technischen Leitfäden.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.

TrackingUrlTemplate

Die Nachverfolgungsvorlagen können zusammen mit der URL verwendet werden, die im Feld "Link" für das Produktangebot angegeben ist, das Sie über die Inhalts-API übermittelt haben. Durch Kombination der Feed-URL mit der Nachverfolgungsvorlage wird die URL der Landing Page an die Stelle zusammengestellt, an die ein Benutzer weitergeleitet wird, nachdem er auf die Anzeige geklickt hat. Wenn Sie das TrackingUrlTemplate-Element verwenden, um die URL-Parameter zu aktualisieren, anstatt sie in der Feed-URL zu aktualisieren, muss die Feed-URL keine redaktionelle Überprüfung durchlaufen, und Ihre Anzeigen werden weiterhin ununterbrochen bereitgestellt. Wenn Ihre Produktangebots-URL im Katalogfeed beispielsweise lautet https://contoso.com/, können Sie die folgende Nachverfolgungsvorlage angeben: {lpurl}?matchtype={matchtype}&device={device}.

Die folgenden Validierungsregeln gelten für Nachverfolgungsvorlagen. Weitere Informationen zu unterstützten Vorlagen und Parametern finden Sie im Microsoft Advertising-Hilfeartikel Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?

  • Nachverfolgungsvorlagen, die für Entitäten auf niedrigerer Ebene definiert sind, z. B. Anzeigen, setzen diejenigen außer Kraft, die für Entitäten höherer Ebene festgelegt wurden, z. B. Kampagnen. Weitere Informationen finden Sie unter Entitätsgrenzwerte.

  • Die Länge der Nachverfolgungsvorlage ist auf 2.048 Zeichen beschränkt. Die HTTP- oder HTTPS-Protokollzeichenfolge wird auf den Grenzwert von 2.048 Zeichen angerechnet.

  • Die Nachverfolgungsvorlage muss eine wohlgeformte URL sein, die mit einer der folgenden Beginnt: http://, https://, {lpurl} oder {unescapedlpurl}.

  • Microsoft Advertising überprüft nicht, ob benutzerdefinierte Parameter vorhanden sind. Wenn Sie benutzerdefinierte Parameter in Ihrer Nachverfolgungsvorlage verwenden und diese nicht vorhanden sind, enthält die URL der Angebotsseite die Schlüssel- und Wertplatzhalter Ihrer benutzerdefinierten Parameter ohne Ersetzung. Wenn Ihre Nachverfolgungsvorlage z. B. lautet https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}und weder {_season} noch {_promocode} in der Kampagne, der Anzeigengruppe, dem Kriterium, Schlüsselwort (keyword) oder der Anzeigenebene definiert sind, ist die URL der Landing Page identisch.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.

UrlCustomParameters

Ihre benutzerdefinierte Sammlung von Schlüssel- und Wertparametern für die URL-Nachverfolgung.

Microsoft Advertising akzeptiert die ersten 8 CustomParameter-Objekte , die Sie in das CustomParameters-Objekt einschließen, und wenn Sie mehr als 8 benutzerdefinierte Parameter einschließen, wird ein Fehler zurückgegeben. Jeder CustomParameter enthält Key - und Value-Elemente .

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Legen Sie das UrlCustomParameters-Element auf NULL oder leer fest, um alle vorhandenen benutzerdefinierten Parameter beizubehalten. Um alle benutzerdefinierten Parameter zu entfernen, legen Sie das Parameters-Element des CustomParameters-Objekts auf NULL oder leer fest. Um eine Teilmenge benutzerdefinierter Parameter zu entfernen, geben Sie die benutzerdefinierten Parameter an, die Sie im Parameters-Element des CustomParameters-Objekts beibehalten möchten.

Webseitennutzung

Wenn das geerbte Kriterium ein Webseitenkriterium ist, beachten Sie die folgende Verwendung der BiddableAdGroupCriterion-Eigenschaften .

FinalUrlSuffix

Das endgültige URL-Suffix kann Nachverfolgungsparameter enthalten, die an das Ende ihrer Landing Page-URL angefügt werden. Es wird empfohlen, die für Ihre Landing Page benötigten Nachverfolgungsparameter in einem endgültigen URL-Suffix zu platzieren, damit Ihre Kunden immer an Ihre Landing Page gesendet werden. Weitere Informationen und Validierungsregeln finden Sie unter Endgültiges URL-Suffix in den technischen Leitfäden.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.

Status

Ein status Wert, der bestimmt, ob das Kriterium für die Anzeigengruppe gilt.

Sie können die status auf Aktiv oder Angehalten festlegen. Sie können die status nicht auf Gelöscht festlegen.

Hinzufügen: Optional.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.

TrackingUrlTemplate

Für das Webseitenkriterium können die Nachverfolgungsvorlagen zusammen mit der Url der Landing Page verwendet werden, die dynamisch aus der Domäne generiert wird, die Sie für Ihre Kampagne für dynamische Suchanzeigen angegeben haben. Durch Die Kombination der Domäne mit der Tracking-Vorlage wird die URL der Landing Page an die Stelle zusammengestellt, an die ein Benutzer weitergeleitet wird, nachdem er auf die Anzeige geklickt hat. Hier sehen Sie eine Beispielvorlage für die Nachverfolgung: {lpurl}?matchtype={matchtype}&device={device}.

Die folgenden Validierungsregeln gelten für Nachverfolgungsvorlagen. Weitere Informationen zu unterstützten Vorlagen und Parametern finden Sie im Microsoft Advertising-Hilfeartikel Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?

  • Nachverfolgungsvorlagen, die für Entitäten auf niedrigerer Ebene definiert sind, z. B. Anzeigen, setzen diejenigen außer Kraft, die für Entitäten höherer Ebene festgelegt wurden, z. B. Kampagnen. Weitere Informationen finden Sie unter Entitätsgrenzwerte.

  • Die Länge der Nachverfolgungsvorlage ist auf 2.048 Zeichen beschränkt. Die HTTP- oder HTTPS-Protokollzeichenfolge wird auf den Grenzwert von 2.048 Zeichen angerechnet.

  • Die Nachverfolgungsvorlage muss eine wohlgeformte URL sein, die mit einer der folgenden Beginnt: http://, https://, {lpurl} oder {unescapedlpurl}.

  • Microsoft Advertising überprüft nicht, ob benutzerdefinierte Parameter vorhanden sind. Wenn Sie benutzerdefinierte Parameter in Ihrer Nachverfolgungsvorlage verwenden und diese nicht vorhanden sind, enthält die URL der Angebotsseite die Schlüssel- und Wertplatzhalter Ihrer benutzerdefinierten Parameter ohne Ersetzung. Wenn Ihre Nachverfolgungsvorlage z. B. lautet https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}und weder {_season} noch {_promocode} in der Kampagne, der Anzeigengruppe, dem Kriterium, Schlüsselwort (keyword) oder der Anzeigenebene definiert sind, ist die URL der Landing Page identisch.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.

UrlCustomParameters

Ihre benutzerdefinierte Sammlung von Schlüssel- und Wertparametern für die URL-Nachverfolgung.

Microsoft Advertising akzeptiert die ersten 8 CustomParameter-Objekte , die Sie in das CustomParameters-Objekt einschließen, und wenn Sie mehr als 8 benutzerdefinierte Parameter einschließen, wird ein Fehler zurückgegeben. Jeder CustomParameter enthält Key - und Value-Elemente .

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Legen Sie das UrlCustomParameters-Element auf NULL oder leer fest, um alle vorhandenen benutzerdefinierten Parameter beizubehalten. Um alle benutzerdefinierten Parameter zu entfernen, legen Sie das Parameters-Element des CustomParameters-Objekts auf NULL oder leer fest. Um eine Teilmenge benutzerdefinierter Parameter zu entfernen, geben Sie die benutzerdefinierten Parameter an, die Sie im Parameters-Element des CustomParameters-Objekts beibehalten möchten.

Anforderungen

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