Schlüsselwort

Enthält die Methoden zum Verwalten eines Schlüsselworts (Keyword). Weitere Informationen zu Keywords finden Sie unter Keyword.

Methoden

Methodenname Rückgabetyp Beschreibung
adParams AdParamSelector Ruft einen Selektor ab, mit dem alle in der Anzeige für dieses Schlüsselwort (Keyword) verwendeten Ersetzungsparameter abgerufen werden.
applyLabel(string name) void Wendet die Bezeichnung auf dieses Schlüsselwort (Keyword) an.
Bieten KeywordBidding Ruft die Methoden ab, die zum Verwalten des Gebotsbetrags dieses Schlüsselworts (Keyword) verwendet werden.
clearDestinationUrl void Entfernt die Ziel-URL dieses Schlüsselworts (Keyword).
aktivieren void Aktiviert dieses Schlüsselwort (keyword).
getAdGroup AdGroup Ruft die Anzeigengruppe ab, zu der dieses Schlüsselwort (Keyword) gehört.
getApprovalStatus string Ruft den Status der redaktionellen Genehmigung dieses Schlüsselworts (keyword) ab.
getCampaign Kampagnen Ruft die Kampagne ab, zu der dieses Schlüsselwort (Keyword) gehört.
getEntityType string Ruft den Typ dieses Objekts ab.
getFirstPageCpc double Ruft das geschätzte Gebot ab, das auf der ersten Seite der Suchergebnisse angezeigt werden muss.
getId string Ruft die ID ab, mit der dieses Schlüsselwort (Keyword) eindeutig identifiziert wird.
getMatchType string Ruft die Match-Option für dieses Schlüsselwort (Keyword) ab.
getQualityScore ganze Zahl Ruft die Qualitätsauswertung dieses Schlüsselworts (keyword) ab.
getStats Statistik Ruft die Performance-Daten dieses Schlüsselworts (keyword) ab.
getText string Ruft den Text des Schlüsselworts (Keyword) ab.
getTopOfPageCpc double Ruft das geschätzte Gebot ab, das erforderlich ist, um ganz oben in den Suchergebnissen zu stehen.
isEnabled Boolean Ruft einen booleschen Wert ab, der angibt, ob dieses Schlüsselwort (keyword) aktiviert ist.
isPaused Boolean Ruft einen booleschen Wert ab, der angibt, ob dieses Schlüsselwort (Keyword) angehalten wurde.
Bezeichnungen LabelSelector Ruft einen Selektor ab, der zum Filtern der Liste der Bezeichnungen verwendet wird, die diesem Schlüsselwort (Keyword) zugeordnet sind.
Anhalten void Pausiert dieses Schlüsselwort (keyword).
remove void Entfernt dieses Schlüsselwort (keyword).
removeLabel(string name) void Entfernt die Bezeichnung von diesem Schlüsselwort (Keyword).
setAdParam(int index, string insertionText) void Addiert den Substitutionsparameter und legt seinen Wert auf den angegebenen Text fest.
URLs KeywordUrls Ruft die Methoden ab, die zum Verwalten der endgültigen URLs, der Vorlage für die Nachverfolgung und der benutzerdefinierten Parameter dieser Schlüsselwörter verwendet werden.

adParams

Ruft eine Auswahl aller Ersetzungsparameter ab, die in Anzeigen für dieses Schlüsselwort (Keyword) verwendet werden.

Die Ersetzungswerte werden in einer Anzeige verwendet, wenn der Titel, der Text, die Anzeige-URL oder die Ziel-URL der Anzeige die dynamische Ersetzungszeichenfolge {Param1}, {Param2} oder {Param3} enthält.

Rückgabewerte

Typ Beschreibung
AdParamSelector Der Selektor, der die Liste der Ersetzungsparameter für dieses Schlüsselwort (keyword) enthält.

applyLabel(string name)

Wendet die Bezeichnung auf das Schlüsselwort (Keyword) an.

Sie können maximal 50 Bezeichnungen auf ein Schlüsselwort (Keyword) anwenden. Ein Beispiel, in dem einem Schlüsselwort (Keyword) eine Bezeichnung hinzugefügt wird, finden Sie unter Verwenden von Bezeichnungen.

Argumente

Name Typ Beschreibung
name string Der Name der Bezeichnung unter Berücksichtigung der Groß-/Kleinschreibung. Eine Liste der Bezeichnungen in diesem Konto, die Sie anwenden können, finden Sie unter AdsApp.labels.

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

Bieten

Ruft die Methoden ab, die zum Verwalten des Gebotsbetrags dieses Schlüsselworts (Keyword) verwendet werden.

Rückgabewerte

Typ Beschreibung
KeywordBidding Enthält die Methoden, die zum Verwalten des Gebotsbetrags dieses Schlüsselworts (Keyword) verwendet werden.

clearDestinationUrl

Entfernt die Ziel-URL dieses Schlüsselworts (Keyword).

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

aktivieren

Aktiviert dieses Schlüsselwort (keyword).

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

getAdGroup

Ruft die Anzeigengruppe ab, zu der dieses Schlüsselwort (Keyword) gehört.

Rückgabewerte

Typ Beschreibung
AdGroup Die Anzeigengruppe, zu der dieses Schlüsselwort (Keyword) gehört.

getApprovalStatus

Ruft den Status der redaktionellen Genehmigung dieses Schlüsselworts (keyword) ab.

Rückgabewerte

Typ Beschreibung
string Der Status der redaktionellen Genehmigung des Schlüsselworts. Der Status gibt an, ob das Schlüsselwort (Keyword) überprüft wird, genehmigt ist oder nicht zulässig ist. Die folgenden Werte sind möglich:
  • GENEHMIGT
  • APPROVED_LIMITED
  • ABGELEHNT
  • UNDER_REVIEW
Informationen dazu, wie diese status-Werte der Bing Ads-API zugeordnet werden, finden Sie unter Zuordnen der Werte für die redaktionelle Genehmigung status.

getCampaign

Ruft die Kampagne ab, zu der dieses Schlüsselwort (Keyword) gehört.

Rückgabewerte

Typ Beschreibung
Kampagnen Die Kampagne, zu der dieses Schlüsselwort (Keyword) gehört.

getEntityType

Gibt den Typ dieser Entität zurück.

Rückgabewerte

Typ Beschreibung
string Der Typ dieser Entität, der Schlüsselwort ist.

getId

Ruft die ID ab, mit der dieses Schlüsselwort (Keyword) eindeutig identifiziert wird.

Rückgabewerte

Typ Beschreibung
string Die ID, die dieses Schlüsselwort (Keyword) eindeutig identifiziert.

getFirstPageCpc

Ruft das geschätzte Gebot ab, das erforderlich ist, damit die Anzeige auf der Randleiste geschaltet wird.

Rückgabewerte

Typ Beschreibung
double Das geschätzte Gebot, das erforderlich ist, damit die Anzeige auf der Randleiste geschaltet wird.

getMatchType

Ruft die Match-Option für dieses Schlüsselwort (Keyword) ab.

Rückgabewerte

Typ Beschreibung
string Die Match-Option des Schlüsselworts (keyword). Die folgenden Werte sind möglich:
  • WEIT
  • PHRASE
  • GENAU
Weitere Informationen zu diesen Typen finden Sie unter Was sind Schlüsselwort (Keyword)-Match-Optionen, und wie verwende ich sie?

getQualityScore

Ruft die Qualitätsauswertung dieses Schlüsselworts (keyword) ab.

Rückgabewerte

Typ Beschreibung
ganze Zahl Die Qualitätsauswertung des Schlüsselworts (keyword). Die Punktzahl liegt im Bereich von 1 bis 10 (höchste Punktzahl). Wenn die Qualitätsauswertung des Schlüsselworts (keyword) nicht berechnet werden kann, gibt diese Methode NULL zurück.

Die Bewertung zeigt Ihnen, wie wettbewerbsfähig Ihre Anzeigen auf dem Markt sind, indem Sie messen, wie relevant Ihre Schlüsselwörter und Zielseiten für die Suchbegriffe der Kunden sind. Weitere Informationen finden Sie unter Bericht zur Schlüsselwortleistung.

getStats

Ruft die Leistungsdaten dieses Keywords ab.

Um diese Methode aufzurufen, müssen Sie eine der forDateRange Methoden in die Selektorkette des Schlüsselworts (Keyword) einschließen.

Rückgabewerte

Typ Beschreibung
Statistik Die Performance-Daten des Schlüsselworts (keyword). Beispielsweise Klicks und Impressionen.

getText

Ruft den Text des Schlüsselworts (Keyword) ab. Der Text enthält die Syntax für die Match-Option des Schlüsselworts (keyword), falls vorhanden. Zum Beispiel:

  • Das Schlüsselwort (keyword) ist "Bücher", wenn der Übereinstimmungstyp "weit" ist, oder "+Bücher", wenn das Schlüsselwort (Schlüsselwort) den Modifizierer für den weiten Typ verwendet
  • Das Schlüsselwort (keyword) ist "Bücher", wenn die Match-Option "Ausdruck" ist
  • Das Schlüsselwort (keyword) ist [Hardcover-Bücher], wenn die Match-Option exakt ist

Weitere Informationen zu diesen Typen finden Sie unter Was sind Schlüsselwort (Keyword)-Match-Optionen, und wie verwende ich sie?

Rückgabewerte

Typ Beschreibung
string Der Text des Schlüsselworts (keyword).

getTopOfPageCpc

Ruft das geschätzte Gebot ab, das erforderlich ist, damit die Anzeige über den organischen Suchergebnissen geschaltet wird.

Rückgabewerte

Typ Beschreibung
double Das geschätzte Gebot, das erforderlich ist, damit die Anzeige über den organischen Suchergebnissen geschaltet wird.

isEnabled

Ruft einen booleschen Wert ab, der angibt, ob dieses Schlüsselwort (keyword) aktiviert ist.

Rückgabewerte

Typ Beschreibung
Boolean Ist "True", wenn dieses Schlüsselwort (Keyword) aktiviert ist, andernfalls "False".

isPaused

Ruft einen booleschen Wert ab, der angibt, ob dieses Schlüsselwort (Keyword) angehalten wurde.

Rückgabewerte

Typ Beschreibung
Boolean Ist "True", wenn dieses Schlüsselwort (Keyword) angehalten wurde, andernfalls "False".

Bezeichnungen

Ruft einen Selektor ab, der zum Filtern der Liste der Bezeichnungen verwendet wird, die diesem Schlüsselwort (Keyword) zugeordnet sind.

Rückgabewerte

Typ Beschreibung
LabelSelector Ein Selektor, der zum Filtern der Liste der Bezeichnungen verwendet wird, die diesem Schlüsselwort (Keyword) zugeordnet sind.

Anhalten

Pausiert dieses Schlüsselwort (keyword).

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

entfernen

Entfernt dieses Schlüsselwort (keyword).

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

removeLabel(string name)

Entfernt die Bezeichnung vom Schlüsselwort (Keyword).

Argumente

Name Typ Beschreibung
name string Der Name der Bezeichnung unter Berücksichtigung der Groß-/Kleinschreibung. Eine Liste der Bezeichnungen, die diesem Schlüsselwort (Keyword) zugeordnet sind, finden Sie unter Bezeichnungen.

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

setAdParam(int index, string insertionText)

Addiert den Substitutionsparameter und legt seinen Wert auf den angegebenen Text fest. Wenn der Ersatzparameter vorhanden ist, wird sein Text überschrieben.

Die Ersetzungswerte werden in einer Anzeige verwendet, wenn der Titel, der Text, die Anzeige-URL oder die endgültige URL der Anzeige dynamische Ersetzungszeichenfolgen {Param1}, {Param2} oder {Param3} enthält. Einschränkungen und Informationen zur Verwendung dieser Parameter finden Sie unter Param1, Param2 und Param3.

Die Ersetzungswerte werden auch in der Vorlage für die Nachverfolgung verwendet, wenn die Vorlage die Platzhalter {param1:default}, {param2:default} oder {param3:default} angibt.

Argumente

Name Typ Beschreibung
Index int Der Index des festzulegenden Ersetzungsparameters. Gültige Indexwerte sind 1 bis einschließlich 3. Verwenden Sie 1 für Param1, 2 für Param2 und 3 für Param3.
insertionText string Der Text, auf den der Ersetzungsparameter gesetzt werden soll.

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

urls

Ruft die Methoden ab, die zum Verwalten der endgültigen URLs, der Vorlage für die Nachverfolgung und der benutzerdefinierten Parameter dieser Schlüsselwörter verwendet werden.

Rückgabewerte

Typ Beschreibung
KeywordUrls Enthält die Methoden, die verwendet werden: die endgültigen URLs des Schlüsselworts (Keyword), die Vorlage für die Nachverfolgung und benutzerdefinierte Parameter.

Siehe auch