Freigeben über

Schlüsselwortdatenobjekt – Kampagnenverwaltung

  • Artikel

Definiert eine Schlüsselwort (keyword).

Schlüsselwörter sind die Wörter oder Ausdrücke, die bei der Suche nach einem Produkt oder einer Dienstleistung gesucht werden. Schlüsselwörter können z. B. eine der folgenden Sein:

  • Schuhe
  • Boote Kreuzfahrten Urlaub
  • Tennisunterricht in New York

Wie oben gezeigt, kann ein Schlüsselwort (keyword) nur ein einzelnes Wort, mehrere Wörter oder sogar ein Ausdruck sein. Im Rahmen der Suchwerbung werden all dies einfach als Schlüsselwort (keyword) bezeichnet.

Wichtig

Ab April 2021 können Sie keine Gebotsstrategien für Anzeigengruppen oder Schlüsselwörter festlegen. Wenn Sie versuchen, Gebotsstrategien für Anzeigengruppen oder Schlüsselwörter festzulegen, wird die Anforderung ohne Fehler ignoriert. Anzeigengruppen und Schlüsselwörter erben die Gebotsstrategie ihrer Kampagne.

Syntax

<xs:complexType name="Keyword" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Bid" nillable="true" type="tns:Bid" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:KeywordEditorialStatus" />
    <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
    <xs:element xmlns:q32="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q32:ArrayOfstring" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q33="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q33:ArrayOfstring" />
    <xs:element xmlns:q34="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q34:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MatchType" nillable="true" type="tns:MatchType" />
    <xs:element minOccurs="0" name="Param1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param3" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:KeywordStatus" />
    <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
  </xs:sequence>
</xs:complexType>

Elemente

Das Keyword-Objekt verfügt über die folgenden Elemente: Bid, BidScheme, DestinationUrl, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, MatchType, Param1, Param2, Param3, Status, Text, TrackingUrlTemplate, UrlCustomParameters.

Element Beschreibung Datentyp
Gebot Der maximale Betrag, den Sie jedes Mal bezahlen möchten, wenn jemand auf Ihre Anzeige klickt.

Sie bieten gegen andere Inserenten mit demselben Schlüsselwort (keyword), sodass höhere Gebote im Allgemeinen dazu beitragen, dass Ihre Anzeige an den gewünschten Stellen auf der Suchergebnisseite angezeigt wird.

Anstatt das Standardgebot auf Anzeigengruppenebene zu verwenden, können Sie benutzerdefinierte Gebote für jedes Schlüsselwort (keyword) festlegen. Benutzerdefinierte Gebote für Schlüsselwörter überschreiben das Standardgebot der Anzeigengruppe für diese spezifischen Schlüsselwörter. Mit benutzerdefinierten Geboten können Sie Ihre Zeit und Ihr Geld auf die profitabelsten Schlüsselwörter konzentrieren, müssen aber mehr Zeit für die Verwaltung der einzelnen Gebote aufwenden.

Wenn das Schlüsselwort (keyword)-Gebots nicht festgelegt ist, wird das Anzeigengruppen-CpcBid verwendet. Weitere Informationen finden Sie unter Budget- und Gebotsstrategien.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Um das Schlüsselwort (keyword) Gebot zu löschen und das Standardgebot des AdGroup-Übereinstimmungstyps zu verwenden, legen Sie das Amount-Element des Bid-Objekts auf NULL fest.		 Gebot
BiddingScheme Der Gebotsstrategietyp, der bestimmt, wie Sie Ihre Gebote verwalten möchten.

Ausführliche Informationen zu unterstützten Gebotsstrategien pro Kampagnentyp finden Sie unter Budget- und Gebotsstrategien.

HINWEIS: Ab April 2021 können Sie keine Gebotsstrategien für Anzeigengruppen oder Schlüsselwörter festlegen. Wenn Sie versuchen, Gebotsstrategien für Anzeigengruppen oder Schlüsselwörter festzulegen, wird die Anforderung ohne Fehler ignoriert. Anzeigengruppen und Schlüsselwörter erben die Gebotsstrategie ihrer Kampagne.

Hinzufügen: Optional. Wenn Sie dieses Element nicht festlegen, wird standardmäßig InheritFromParentBiddingScheme verwendet.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 BiddingScheme
DestinationUrl Die URL der Webseite, zu der der Benutzer gelangen soll, wenn er auf die Anzeige klickt. Wenn angegeben, wird die Ziel-URL des Schlüsselwort (keyword) verwendet. Andernfalls wird die Ziel-URL der Anzeige verwendet.

Wichtig: Seit November 2018 kann die Schlüsselwort (keyword) Ziel-URL nicht hinzugefügt oder aktualisiert werden. Sie können stattdessen Endgültige URLs verwenden. Weitere Informationen finden Sie unter Migrieren Ihrer Schlüsselwort (keyword) Ziel-URLs zu endgültigen URLs.

Hinzufügen: Nicht zulässig
Aktualisieren: Nicht zulässig		 Zeichenfolge
EditorialStatus Die redaktionelle Überprüfung status der Schlüsselwort (keyword), die angibt, ob die Schlüsselwort (keyword) eine Überprüfung aussteht, genehmigt oder abgelehnt wurde.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 KeywordEditorialStatus
FinalAppUrls Reserviert für zukünftige Verwendung. AppUrl-Array
FinalMobileUrls Die URL der mobilen Landing Page. Wenn angegeben, wird die endgültige mobile URL des Schlüsselwort (keyword) verwendet. Andernfalls wird die endgültige mobile URL der Anzeige verwendet.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 Zeichenfolgenarray
FinalUrls Die URL der Landing Page. Falls angegeben, wird die endgültige URL des Schlüsselwort (keyword) verwendet, andernfalls wird die endgültige URL der Anzeige verwendet.

Die folgenden Überprüfungsregeln gelten für endgültige URLs und endgültige mobile URLs.
– Die Länge der URL ist auf 2.048 Zeichen beschränkt. Die HTTP- oder HTTPS-Protokollzeichenfolge wird auf den Grenzwert von 2.048 Zeichen angerechnet.
– Sie können bis zu 10 Elemente für FinalUrls und FinalMobileUrls angeben. für die Lieferung wird jedoch nur der erste Artikel in jeder Liste verwendet. Der Dienst ermöglicht bis zu 10, um potenzielle Vorwärtskompatibilität zu erzielen.
- Die Verwendung von "{" und "}" ist nur zum Abgrenzen von Tags zulässig, z. B. {lpurl}.
- Endgültige URLs müssen jeweils eine wohlgeformte URL sein, die entweder mit http:// oder https:// beginnt.
– Wenn Sie FinalMobileUrls angeben, müssen Sie auch FinalUrls angeben.
– Sie dürfen FinalMobileUrls nicht angeben, wenn die Geräteeinstellung auf "Mobil" festgelegt ist. Beachten Sie außerdem, dass, wenn die Elemente TrackingUrlTemplate oder UrlCustomParameters festgelegt sind, mindestens eine endgültige URL erforderlich ist. Weitere Informationen finden Sie unter URL-Nachverfolgung mit aktualisierten URLs.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 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.

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.		 Zeichenfolge
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.

Änderungen an der Vorwärtskompatibilität werden in zukünftigen Versionen hier notiert. Es gibt derzeit keine Änderungen an der Vorwärtskompatibilität für dieses Objekt.		 KeyValuePairOfstring-Array
Id Der vom System generierte Bezeichner des Schlüsselwort (keyword).

Hinzufügen: Schreibgeschützt
Aktualisieren: Erforderlich		 Lange
Matchtype Der Typ der Übereinstimmung zum Vergleichen der Schlüsselwort (keyword) und des Suchbegriffs des Benutzers.

Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 Matchtype
Param1 Die Zeichenfolge, die als Ersetzungswert in einer Anzeige verwendet werden soll, wenn Titel, Text, Anzeige-URL oder Ziel-URL der Anzeige die dynamische Ersetzungszeichenfolge {Param1} enthält.

Obwohl Sie {Param1} verwenden können, um die Ziel-URL einer Anzeige anzugeben, sollten Sie dies nicht verwenden. Stattdessen sollten Sie das DestinationUrl-Element des Schlüsselwort (keyword) festlegen.

Die Zeichenfolge darf maximal 1.022 Zeichen enthalten. Der tatsächliche Grenzwert hängt von der Länge des Elements ab, das auf die Ersetzungszeichenfolge verweist. Beispielsweise kann die Länge des Titels einer Textanzeige maximal 25 Zeichen enthalten.

Wenn Sie dynamischen Text in Ihrer Anzeigenkopie implementieren, sollten Sie eine Standardzeichenfolge angeben, z. B. {Param1:default}, die vom System verwendet wird, wenn Param1 für ein Schlüsselwort (keyword) NULL oder leer ist oder wenn das Einschließen des Param1-Ersetzungswerts dazu führt, dass die erweiterte Zeichenfolge den Grenzwert des Elements überschreitet. Andernfalls wird die Anzeige nicht mit diesem Schlüsselwort (keyword) bereitgestellt. Weitere Informationen finden Sie im Microsoft Advertising-Hilfeartikel Automatisches Anpassen Ihrer Anzeigen mit dynamischen Textparametern.

Beachten Sie außerdem, dass Sie einen gültigen Param1-Wert für diese Ersetzung angeben müssen, wenn die Anzeigengruppe nur über eine Anzeige verfügt und {Param1} nur {Param1} verwendet wird, aber keine Standardzeichenfolge bereitstellt. Andernfalls kann dieser Schlüsselwort (keyword) nicht hinzugefügt oder aktualisiert werden.

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.		 Zeichenfolge
Param2 Die Zeichenfolge, die als Ersetzungswert in einer Anzeige verwendet werden soll, wenn der Titel, text, die Anzeige-URL oder die Ziel-URL die dynamische Ersetzungszeichenfolge {Param2} enthält.

In der Regel verwenden Sie die {Param2}-Ersetzungszeichenfolge in den Titel- oder Textelementen (Beschreibung der Anzeigenkopie) einer Anzeige.

Die Zeichenfolge darf maximal 70 Zeichen enthalten. Der tatsächliche Grenzwert hängt von der Länge des Elements ab, das auf die Ersetzungszeichenfolge verweist. Beispielsweise kann die Länge des Titels einer Textanzeige maximal 25 Zeichen enthalten.

Wenn Sie dynamischen Text in Ihrer Anzeigenkopie implementieren, sollten Sie eine Standardzeichenfolge angeben, z. B. {Param2:default}, die das System verwendet, wenn Param2 für ein Schlüsselwort (keyword) NULL oder leer ist oder wenn das Einschließen des Param2-Ersetzungswerts dazu führt, dass die erweiterte Zeichenfolge den Grenzwert des Elements überschreitet. Andernfalls wird die Anzeige nicht mit diesem Schlüsselwort (keyword) bereitgestellt. Weitere Informationen finden Sie im Microsoft Advertising-Hilfeartikel Automatisches Anpassen Ihrer Anzeigen mit dynamischen Textparametern.

Beachten Sie außerdem, dass Sie einen gültigen Param2-Wert für diese Ersetzung angeben müssen, wenn die Anzeigengruppe nur über eine Anzeige verfügt und {Param2}, aber keine Standardzeichenfolge verwendet, z. B. {Param2:default}. Andernfalls kann dieser Schlüsselwort (keyword) nicht hinzugefügt oder aktualisiert werden.

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.		 Zeichenfolge
Param3 Die Zeichenfolge, die als Ersetzungswert in einer Anzeige verwendet werden soll, wenn titel, Text, Anzeige-URL oder Ziel-URL die dynamische Ersetzungszeichenfolge {Param3} enthält.

In der Regel verwenden Sie die {Param3}-Ersetzungszeichenfolge in den Titel- oder Textelementen (Beschreibung der Anzeigenkopie) einer Anzeige.

Die Zeichenfolge darf maximal 70 Zeichen enthalten. Der tatsächliche Grenzwert hängt von der Länge des Elements ab, das auf die Ersetzungszeichenfolge verweist. Beispielsweise kann die Länge des Titels einer Textanzeige maximal 25 Zeichen enthalten.

Wenn Sie dynamischen Text in Ihrer Anzeigenkopie implementieren, sollten Sie eine Standardzeichenfolge angeben, z. B. {Param3:default}, die das System verwendet, wenn Param3 für ein Schlüsselwort (keyword) NULL oder leer ist oder wenn das Einschließen des Param3-Ersetzungswerts dazu führt, dass die erweiterte Zeichenfolge den Grenzwert des Elements überschreitet. Andernfalls wird die Anzeige nicht mit diesem Schlüsselwort (keyword) bereitgestellt. Weitere Informationen finden Sie im Microsoft Advertising-Hilfeartikel Automatisches Anpassen Ihrer Anzeigen mit dynamischen Textparametern.

Beachten Sie außerdem, dass Sie einen gültigen Param3-Wert für diese Ersetzung angeben müssen, wenn die Anzeigengruppe nur über eine Anzeige verfügt und {Param3} {Param3} verwendet wird, aber keine Standardzeichenfolge bereitstellt. Andernfalls kann dieser Schlüsselwort (keyword) nicht hinzugefügt oder aktualisiert werden.

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.		 Zeichenfolge
Status Die status des Schlüsselwort (keyword). Standardmäßig ist die status auf Aktiv festgelegt.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 KeywordStatus
Text Der Schlüsselwort (keyword) Text. Der Text darf maximal 100 Zeichen enthalten. Sie sollten die Schlüsselwort (keyword) im Gebietsschema des Language-Werts angeben, den Sie für die Anzeigengruppe angegeben haben, zu der die Schlüsselwort (keyword) gehört.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt		 Zeichenfolge
TrackingUrlTemplate Die Nachverfolgungsvorlage, die als Standard für alle FinalUrls und FinalMobileUrls verwendet werden soll.

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, überschreiben diejenigen, 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 beispielsweise lautet https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} und weder {_season} noch {_promocode} auf Kampagnen-, Anzeigengruppen-, Kriterium-, Schlüsselwort (keyword)- oder 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.		 Zeichenfolge
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.		 CustomParameters

Anforderungen

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

Verwendet von

AddKeywords
GetKeywordsByAdGroupId
GetKeywordsByEditorialStatus
GetKeywordsByIds
UpdateKeywords