AssetGroupSelector

Enthält die Methoden zum Filtern und Sortieren einer Liste von Ressourcengruppen. Informationen zu Selektoren finden Sie unter Selektoren.

Anwendungsbeispiel:

    var iterator = Campaign.assetGroups()
        .withCondition("ClickConversionRate > 0.3")
        .forDateRange("LAST_WEEK")
        .orderBy("Clicks DESC")
        .get();

    while (iterator.hasNext()) {
        var assetGroup = iterator.next();
        var metrics = assetGroup.getStats();
    }

Methoden

Methodenname Rückgabetyp Beschreibung
get AssetGroupIterator Ruft einen Iterator ab, der zum Durchlaufen der Liste der Ressourcengruppen verwendet wird.
orderBy(string orderBy) AssetGroupSelector Wendet die angegebene Reihenfolge auf die ausgewählten Ressourcengruppen an.
withCondition(string condition) AssetGroupSelector Wendet Filterkriterien auf die Ressourcengruppen an.
withIds(string[] ids) AssetGroupSelector Ruft Ressourcengruppen mit den angegebenen IDs ab.
withLimit(int limit) AssetGroupSelector Ruft die obersten n Ressourcengruppen ab, die den Auswahlkriterien entsprechen.

Abrufen

Ruft einen Iterator ab, der zum Durchlaufen der Liste der Ressourcengruppen verwendet wird.

Rückgabewerte

Typ Beschreibung
AssetGroupIterator Ein Iterator, der zum Durchlaufen der ausgewählten Ressourcengruppen verwendet wird.

orderBy(String orderBy)

Wendet die angegebene Reihenfolge auf die ausgewählten Ressourcengruppen an.

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

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

Der folgende Aufruf gibt beispielsweise Ressourcengruppen in aufsteigender Reihenfolge nach AverageCpc zurück.

selector = selector.orderBy("AverageCpc");

Selektoren unterstützen die Sortierung von Entitäten nach nur einem Feld. Sie dürfen die Liste der Entitäten nicht nach dem Feld x und innerhalb von x nach dem Feld y usw. ordnen. 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
AssetGroupSelector Selektor mit angewendeter Reihenfolge.

withCondition(String condition)

Wendet Filterkriterien auf die Ressourcengruppen an.

Geben Sie den Bedingungsparameter im Format "Wert des Operators columnName" 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

Unterstützte Spalten für die Filterung von Ressourcengruppen. Bei den Namen wird zwischen Groß- und Kleinschreibung unterschieden.

Im Folgenden finden Sie die Spalten für Performance-Kennzahlen, die Sie angeben können.

Spalte Typ Beispiel
AbsoluteTopImpressionRate double withCondition("AbsoluteTopImpressionRate > 0.25")
AverageCpc double withCondition("AverageCpc < 2.75")
AverageCpm double withCondition("AverageCpm > 0.65")
ClickConversionRate double withCondition("ClickConversionRate > 0.25")
Klicks long withCondition("Clicks >= 33")
ConvertedClicks long withCondition("ConvertedClicks >= 10")
Kosten double withCondition("Cost > 3.25")

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

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

Im Folgenden finden Sie die Entitätseigenschaften, die Sie angeben können.

Spalte Typ Beispiel
Status Aufzählung Der Status der Ressourcengruppe. Mögliche Werte für die Groß- und Kleinschreibung sind:
  • AKTIVIERT
  • ANGEHALTEN
  • ENTFERNT
In diesem Beispiel werden nur aktivierte Ressourcengruppen zurückgegeben.

withCondition("Status = ENABLED")
Name string Der Name der Ressourcengruppe.

withCondition("Name CONTAINS_IGNORE_CASE 'sport'")
CampaignName string Der Name der Kampagne.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
KeywordMaxCpc double Das CPC-Gebot der Ressourcengruppe. Das Gebot wird in der Währung des Kontos angegeben.

withCondition("KeywordMaxCpc > 5.0")
CampaignStatus Aufzählung Der Status der Kampagne. Mögliche Werte für die Groß- und Kleinschreibung sind:
  • AKTIVIERT
  • ANGEHALTEN
  • ENTFERNT
In diesem Beispiel werden nur Ressourcengruppen zurückgegeben, deren übergeordnete Kampagne pausiert ist.

withCondition("CampaignStatus = PAUSED")
LabelNames Zeichenfolgensatz Eine Liste mit einem oder mehreren Bezeichnungsnamen unter Berücksichtigung der Groß-/Kleinschreibung. Wird verwendet, um Ressourcengruppen abzurufen, die den benannten Bezeichnungen zugeordnet sind.

withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
CampaignType Aufzählung Der Kampagnentyp. Mögliche Werte für die Groß- und Kleinschreibung sind:
  • SEARCH_AND_CONTENT
  • EINKAUFEN
  • DYNAMIC_SEARCH_ADS
In diesem Beispiel werden nur Ressourcengruppen zurückgegeben, bei denen der Typ der übergeordneten Kampagne "Shopping" lautet.

withCondition("CampaignType = SHOPPING")

Argumente

Name Typ Beschreibung
Bedingung string Die Bedingung, die auf den Selektor angewendet werden soll.

Rückgabewerte

Typ Beschreibung
AssetGroupSelector Selector mit der angewendeten Bedingung.

withIds(string[] ids)

Ruft Ressourcengruppen mit den angegebenen IDs ab.

Sie können eine oder mehrere Bedingungen auf einen Selektor anwenden. Eine Kette von Bedingungen wird als UND-Vorgang betrachtet. Beispielsweise wird das Objekt nur ausgewählt, wenn Bedingung A wahr UND Bedingung B wahr ist. Der folgende Aufruf wählt beispielsweise nur die Ressourcengruppe 33333 aus.

var selector = Campaign.assetGroups()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

Argumente

Name Typ Beschreibung
ids string[] Ein Array von Ressourcengruppen-IDs. Informationen zu Grenzwerten finden Sie unter Skriptausführungslimits.

Rückgabewerte

Typ Beschreibung
AssetGroupSelector Selector mit den angewendeten IDs.

withLimit(int limit)

Ruft die obersten n Ressourcengruppen ab, die den Auswahlkriterien entsprechen.

Argumente

Name Typ Beschreibung
Begrenzung int Die Anzahl der Ressourcengruppen, die zurückgegeben werden sollen. Die tatsächliche Anzahl kann geringer sein.

Rückgabewerte

Typ Beschreibung
AssetGroupSelector Selektor mit angewendetem Grenzwert.

Siehe auch

Campaign.assetGroups()

  • Last updated on