Freigeben über


KeywordSelector

Enthält die Methoden zum Filtern und Sortieren einer Liste von Schlüsselwörtern. Informationen zu Selektoren finden Sie unter Selektoren.

Anwendungsbeispiel:

    var iterator = AdsApp.keywords()
        .withCondition("AdGroupName = 'AD GROUP NAME GOES HERE'")
        .withCondition("CampaignName = 'CAMPAIGN NAME GOES HERE'")
        .get();

    while (iterator.hasNext()) {
        var keyword = iterator.next();
    }

Methoden

Methodenname Rückgabetyp Beschreibung
forDateRange(Object dateFrom, Object dateTo) KeywordSelector Wendet das Start- und Enddatum für die Auswahl von Leistungsmetriken an.
forDateRange(string dateRange) KeywordSelector Wendet den vordefinierten Datumsbereich für die Auswahl von Leistungsmetriken an.
get KeywordIterator Ruft einen Iterator ab, der zum Durchlaufen der Liste der Schlüsselwörter verwendet wird.
orderBy(string orderBy) KeywordSelector Wendet die angegebene Reihenfolge auf die ausgewählten Schlüsselwörter an.
withCondition(string condition) KeywordSelector Wendet Filterkriterien auf die Schlüsselwörter an.
withIds(string[] ids) KeywordSelector Ruft Schlüsselwörter mit den angegebenen IDs ab.
withLimit(int limit) KeywordSelector Ruft die obersten n Schlüsselwörter ab, die den Auswahlkriterien entsprechen.

forDateRange(Object dateFrom, Object dateTo)

Wendet das Start- und Enddatum für die Auswahl von Leistungsmetriken an.

Geben Sie einen Datumsbereich nur an, wenn:

  • Sie wenden Bedingungen oder Reihenfolgen an, die auf Leistungsmetrikfelder verweisen.
  • Sie möchten Leistungsdaten für die objekte abrufen, die Sie auswählen. Beispielsweise, wenn Sie planen, die getStats() -Methode aufzurufen.

Sie können die Datumsparameter mithilfe von Zeichenfolgen oder Objekten angeben. Um Zeichenfolgen zu verwenden, geben Sie das Datum im Formular YYYYMMDD an. Wenn Sie -Objekte verwenden, erstellen Sie ein -Objekt mit den folgenden Feldern:

  • Jahr
  • Monat
  • Tag

Zum Beispiel:

var date = {year: 2018, month: 5, day: 13};

Der Monat ist einsbasiert, wobei 1 für Januar und 12 für Dezember steht.

Der Datumsbereich ist inklusiv. Wenn Sie mehrere Datumsbereiche angeben, wird nur der letzte Datumsbereich verwendet.

Argumente

Name Typ Beschreibung
dateFrom Objekt Das Startdatum des Datumsbereichs, der die Leistungsdaten angibt, die in die Auswahl eingeschlossen werden sollen.
dateTo Objekt Das Enddatum des Datumsbereichs, der die Leistungsdaten angibt, die in die Auswahl eingeschlossen werden sollen.

Rückgabewerte

Typ Beschreibung
KeywordSelector Selektor mit angewendetem Datumsbereich.

forDateRange(String dateRange)

Wendet den vordefinierten Datumsbereich für die Auswahl von Leistungsmetriken an.

Unterstützte Datumsbereichswerte:

  • HEUTE
  • GESTERN
  • LAST_WEEK
  • LAST_BUSINESS_WEEK
  • LAST_7_DAYS
  • THIS_WEEK_SUN_TODAY
  • LAST_14_DAYS
  • LAST_30_DAYS
  • LAST_WEEK_SUN_SAT
  • THIS_MONTH
  • LAST_MONTH
  • ALL_TIME

Geben Sie einen Datumsbereich nur an, wenn:

  • Sie wenden Bedingungen oder Reihenfolgen an, die auf Leistungsmetrikfelder verweisen.
  • Sie möchten Leistungsdaten für die objekte abrufen, die Sie auswählen. Beispielsweise, wenn Sie planen, die getStats() -Methode aufzurufen.

Wenn Sie mehrere Datumsbereiche angeben, wird nur der letzte Datumsbereich verwendet.

Argumente

Name Typ Beschreibung
dateRange Zeichenfolge Die vordefinierte Datumsbereichszeichenfolge, die die Leistungsdaten angibt, die in die Auswahl eingeschlossen werden sollen. Bei der vordefinierten Datumsbereichszeichenfolge wird die Groß-/Kleinschreibung beachtet.

Rückgabewerte

Typ Beschreibung
KeywordSelector Selektor mit angewendetem Datumsbereich.

Erhalten

Ruft einen Iterator ab, der zum Durchlaufen der Liste der Schlüsselwörter verwendet wird.

Rückgabewerte

Typ Beschreibung
KeywordIterator Ein Iterator, der zum Durchlaufen der ausgewählten Schlüsselwörter verwendet wird.

orderBy(string orderBy)

Wendet die angegebene Reihenfolge auf die ausgewählten Schlüsselwörter an.

Geben Sie den orderBy-Parameter im Format "columnName orderDirection" an, wobei:

  • columnName ist eine der unterstützten Spalten.
  • orderDirection ist die Reihenfolge, in der die Ergebnisse sortiert werden. Legen Sie auf ASC fest, um die Ergebnisse in aufsteigender Reihenfolge zu sortieren, oder AUF DESC, um die Ergebnisse in absteigender Reihenfolge zu sortieren. Der Standardwert ist ASC.

Der folgende Aufruf gibt z. B. Ergebnisse in aufsteigender Reihenfolge nach AverageCpc zurück.

selector = selector.orderBy("AverageCpc");

Selektoren unterstützen das Sortieren von Entitäten nur nach einem Feld. Sie dürfen die Liste der Entitäten nicht nach Feld x und innerhalb von x nach Feld y usw. sortieren. Wenn Sie mehr als einen orderBy() Aufruf in einer Kette oder in separaten Selektoraufrufen angeben, sortiert Scripts die Liste der Entitäten mithilfe des im letzten orderBy() Aufruf angegebenen Felds. 

Argumente

Name Typ Beschreibung
Orderby string Die anzuwendende Reihenfolge.

Rückgabewerte

Typ Beschreibung
KeywordSelector Selektor mit angewendeter Reihenfolge.

withCondition(String condition)

Wendet Filterkriterien auf die Schlüsselwörter an.

Geben Sie den Bedingungsparameter im Format "columnName-Operatorwert" an, wobei:

Operatoren

Der operator, den Sie verwenden, hängt vom Typ der Spalte ab. Bei Operatoren wird die Groß-/Kleinschreibung beachtet. Verwenden Sie beispielsweise STARTS_WITH anstelle von starts_with.

Operatoren für Spalten, die ganze Zahlen und lange Werte enthalten:

<
<=
>
>=
=
!=

Operatoren für Spalten, die doppelte Werte enthalten:

<
>

Operatoren für Spalten, die Zeichenfolgenwerte enthalten:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operatoren für Spalten, die Enumerationswerte enthalten:

=
!=
IN []
NOT_IN []

Operatoren für Spalten, die ein Array von Zeichenfolgen enthalten:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Unterstützte Spalten für Schlüsselwort (keyword) Filterung. Bei Spaltennamen wird die Groß-/Kleinschreibung beachtet.

Im Folgenden sind die Leistungsmetrikspalten aufgeführt, die Sie angeben können.

Spalte Typ Beispiel Microsoft Advertising-Web-UI-Filter
AbsoluteTopImpressionRate double withCondition("AbsoluteTopImpressionRate > 0.25") Abs. Top Impr. Zins
AverageCpc double withCondition("AverageCpc < 2.75") Durchschn. CPC
AverageCpm double withCondition("AverageCpm > 0.65") Durchschn. CPM
ClickConversionRate double withCondition("ClickConversionRate > 0.25") Konv. Rate
Klicks long withCondition("Clicks >= 33") Klicks
ConvertedClicks long withCondition("ConvertedClicks >= 10") Conv.
Kosten double withCondition("Cost > 3.25")

Die Kosten werden in der Währung des Kontos angegeben.
Verbringen
Ctr double withCondition("Ctr > 0.05")

Die CTR liegt im Bereich 0,.1. Verwenden Sie daher 0,05 für eine CtR von 5 %.
CTR
Eindrücke long withCondition("Impressions > 10") Impr.
TopImpressionRate double withCondition("TopImpressionRate > 0.25") Top Impr. Zins

Im Folgenden sind die Entitätseigenschaften aufgeführt, die Sie angeben können.

Spalte Typ Beispiel Microsoft Advertising-Web-UI-Filter
Status Enumeration Die status des Schlüsselwort (keyword). Mögliche Werte, bei denen die Groß-/Kleinschreibung beachtet wird, sind:
  • AKTIVIERT
  • ANGEHALTEN
  • ENTFERNT
withCondition("Status = ENABLED")
Status
CombinedApprovalStatus string Die genehmigungs-status des Schlüsselwort (keyword). Mögliche Werte, bei denen die Groß-/Kleinschreibung beachtet wird, sind:
  • GENEHMIGT
  • APPROVED_LIMITED
  • UNDER_REVIEW
  • ABGELEHNT
Informationen zu diesen Werten finden Sie unter Redaktionelle Genehmigung status Werten.

In diesem Beispiel werden Schlüsselwörter zurückgegeben, die Aufmerksamkeit erfordern.

withCondition("CombinedApprovalStatus IN ['APPROVED_LIMITED', 'DISAPPROVED']")
Text string Der Text des Schlüsselwort (keyword). Schließen Sie nur den Text des Schlüsselwort (keyword) ein. Schließen Sie den Übereinstimmungstyp des Schlüsselwort (keyword) nicht in den Text ein. Wenn der Schlüsselwort (keyword) z. B. eine genaue Übereinstimmung Schlüsselwort (keyword) wie [Bücher] ist, verwenden Sie Bücher und nicht [Bücher].

withCondition("Text STARTS_WITH 'flowers'")
Schlüsselworttext
KeywordMatchType Enumeration Der Übereinstimmungstyp des Schlüsselwort (keyword). Mögliche Werte, bei denen die Groß-/Kleinschreibung beachtet wird, sind:
  • BREIT
  • GENAUE
  • PHRASE
withCondition("KeywordMatchType = EXACT")
Übereinstimmungstyp
MaxCpc double Der maximale CPC-Gebotsbetrag des Schlüsselwort (keyword). Der CPC befindet sich in der Währung des Kontos.

withCondition("MaxCpc > 0.40")
Gebot
DestinationUrl string withCondition("DestinationUrl STARTS_WITH 'http://www.contoso.com'") Ziel-URL
FinalUrls string withCondition("FinalUrls CONTAINS 'http://www.contoso.com'")
QualityScore int withCondition("QualityScore > 5") Quali. Ergebnis
FirstPageCpc double Der durchschnittliche Betrag, den ein Werbetreibender jedes Mal in Rechnung stellt, wenn seine Anzeige auf der Seitenleiste angezeigt wird. Wenn ein Werbetreibender beispielsweise insgesamt 48,35 US-Dollar für 300 Klicks bezahlt hat, beträgt der durchschnittliche CPC des Inserenten 0,16 US-Dollar. Verwenden Sie diese Informationen, um zu entscheiden, ob Sie Ihr Schlüsselwort (keyword) Gebot erhöhen möchten, um die Wahrscheinlichkeit zu verbessern, dass Ihre Anzeige auf der Randleiste angezeigt wird. Der CPC befindet sich in der Währung des Kontos.

withCondition("FirstPageCpc > 6.00")
Est. Gebot der ersten Seite
TopOfPageCpc double Der durchschnittliche Betrag, den ein Werbetreibender bei jedem Klick auf seine Anzeige in Rechnung stellt, wenn sie über den organischen Suchergebnissen angezeigt wird. Wenn ein Werbetreibender beispielsweise insgesamt 48,35 US-Dollar für 300 Klicks bezahlt hat, beträgt der durchschnittliche CPC des Inserenten 0,16 US-Dollar. Verwenden Sie diese Informationen, um zu entscheiden, ob Sie Ihr Schlüsselwort (keyword) Gebot erhöhen möchten, um die Wahrscheinlichkeit zu verbessern, dass Ihre Anzeige über den organischen Suchergebnissen angezeigt wird. Der CPC ist in der Währung des Laufenden Kontos.

withCondition("TopOfPageCpc > 8.00")
Beste Position
AdGroupName string Der Name der Anzeigengruppe, die die Schlüsselwörter enthält.

withCondition("AdGroupName = 'foo'")
AdGroupStatus Enumeration Die status der Anzeigengruppe. Mögliche Werte, bei denen die Groß-/Kleinschreibung beachtet wird, sind:
  • AKTIVIERT
  • ANGEHALTEN
  • ENTFERNT
withCondition("AdGroupStatus = ENABLED")
CampaignName string Der Name der Kampagne, die die Schlüsselwörter enthält.

withCondition("CampaignName = 'bar'")
CampaignStatus Enumeration Die status der Kampagne. Mögliche Werte, bei denen die Groß-/Kleinschreibung beachtet wird, sind:
  • AKTIVIERT
  • ANGEHALTEN
  • ENTFERNT
withCondition("CampaignStatus = ENABLED")
LabelNames Zeichenfolgensatz Eine Liste von Bezeichnungsnamen, bei dem die Groß-/Kleinschreibung beachtet wird. Verwenden Sie , um Schlüsselwörter abzurufen, die den benannten Bezeichnungen zugeordnet sind.

withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
Id Long Die ID des zu testden Schlüsselwort (keyword). Sie können diese Spalte beispielsweise verwenden, um nach Schlüsselwörtern zu suchen, deren IDs größer als die angegebene ID sind.

withCondition('Id > 1234')

Argumente

Name Typ Beschreibung
Zustand string Die Bedingung, die dem Selektor hinzugefügt werden soll.

Rückgabewerte

Typ Beschreibung
KeywordSelector Selektor mit angewendeter Bedingung.

withIds(string[] ids)

Ruft Schlüsselwörter mit den angegebenen IDs ab.

Sie können eine oder mehrere Bedingungen auf einen Selektor anwenden. Eine Kette von Bedingungen wird als AND-Vorgang betrachtet. Beispielsweise wird die Entität nur ausgewählt, wenn Bedingung A true ist UND Bedingung B wahr ist. Der folgende Aufruf wählt beispielsweise nur Schlüsselwort (keyword) 33333 aus.

AdsApp.keywords()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

Argumente

Name Typ Beschreibung
ids string[] Ein Array von Schlüsselwort (keyword) IDs. Informationen zu Grenzwerten finden Sie unter Skriptausführungslimits.

Rückgabewerte

Typ Beschreibung
KeywordSelector Selektor mit den angewendeten IDs.

withLimit(int limit)

Ruft die obersten n Schlüsselwörter ab, die den Auswahlkriterien entsprechen.

Argumente

Name Typ Beschreibung
Begrenzung int Die Anzahl der zurückzugebenden Schlüsselwörter. Die tatsächliche Zahl kann kleiner sein.

Rückgabewerte

Typ Beschreibung
KeywordSelector Selektor mit angewendetem Limit.

Siehe auch