AdGroupAudienceSelector

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

Anwendungsbeispiel:

    // Gets the iterator that iterates all ad group audiences
    // in the account.
    var iterator = AdsApp.adGroups().get();

    // Loops through all ad groups in the account.
    while (iterator.hasNext()) {
        var adGroup = iterator.next();

        // Gets the iterator that iterates all ad group audiences
        // in the ad group audience.
        var audienceIterator = adGroup.targeting().audiences()
            .withLimit(10)
            .withIds("123456789")
            .get();
    
        // Loops through all ad group audiences in the ad group audience.
        while (audienceIterator.hasNext()) {
            var audience = iterator.next();
        }
    }

Methoden

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

forDateRange(Object dateFrom, Object dateTo)

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

Geben Sie nur einen Datumsbereich an, wenn:

  • Sie wenden Bedingungen oder Reihenfolgen an, die auf Felder für Performance-Kennzahlen verweisen.
  • Sie möchten Leistungsdaten für die Objekte abrufen, die Sie auswählen. Beispielsweise, wenn Sie die getStats() Methode aufrufen möchten.

Sie können die Datumsparameter mithilfe von Zeichenfolgen oder Objekten angeben. Um Zeichenfolgen zu verwenden, geben Sie das Datum im Formular JJJJMMTT 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};

Es handelt sich um einen Monat, wobei 1 für Januar und 12 für Dezember steht.

Der Datumsbereich ist einschließlich Datum. 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 den Selektor aufgenommen werden sollen. Geben Sie das Datum mithilfe einer Zeichenfolge im Formular YYYYMMDD oder eines Objekts im Formular {year: 2020, month: 12, day: 31} an.
dateTo Objekt Das Enddatum des Datumsbereichs, der die Leistungsdaten angibt, die in den Selektor aufgenommen werden sollen. Geben Sie das Datum mithilfe einer Zeichenfolge im Formular YYYYMMDD oder eines Objekts im Formular {year: 2020, month: 12, day: 1} an.

Rückgabewerte

Typ Beschreibung
AdGroupAudienceSelector Selektor mit angewendetem Datumsbereich.

forDateRange(String dateRange)

Wendet den vordefinierten Datumsbereich für die Auswahl von Performance-Kennzahlen an.

Geben Sie nur einen Datumsbereich an, wenn:

  • Sie wenden Bedingungen oder Reihenfolgen an, die auf Felder für Performance-Kennzahlen verweisen.
  • Sie möchten Leistungsdaten für die Objekte abrufen, die Sie auswählen. Beispielsweise, wenn Sie die getStats() Methode aufrufen möchten.

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

Unterstützte Datumsbereichswerte:

  • TODAY
  • 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

Argumente

Name Typ Beschreibung
dateRange Zeichenfolge Die vordefinierte Zeichenfolge für den Datumsbereich, die die Leistungsdaten angibt, die in den Selektor aufgenommen werden sollen. Bei der vordefinierten Zeichenfolge für den Datumsbereich wird zwischen Groß- und Kleinschreibung unterschieden. Mögliche Werte für die Groß- und Kleinschreibung sind: 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.

Rückgabewerte

Typ Beschreibung
AdGroupAudienceSelector Selektor mit angewendetem Datumsbereich.

Abrufen

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

Rückgabewerte

Typ Beschreibung
AdGroupAudienceIterator Ein Iterator, der zum Durchlaufen der ausgewählten Anzeigengruppenzielgruppen verwendet wird.

orderBy(String orderBy)

Wendet die angegebene Reihenfolge auf die ausgewählten Zielgruppen der Anzeigengruppe 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 Anzeigengruppenzielgruppen 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
AdGroupAudienceSelector Selektor mit angewendeter Reihenfolge.

withCondition(String condition)

Wendet Filterkriterien auf die Zielgruppen der Anzeigengruppe 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 Anzeigengruppenzielgruppen. 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
AdGroupName string Der Name der Anzeigengruppe der Zuordnung.

withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus Aufzählung Der Status der Anzeigengruppe der Zuordnung. Mögliche Werte für die Groß- und Kleinschreibung sind:
  • AKTIVIERT
  • ANGEHALTEN
  • ENTFERNT
In diesem Beispiel werden nur Anzeigengruppenzielgruppen zurückgegeben, deren übergeordnete Anzeigengruppe pausiert ist.

withCondition("AdGroupStatus = PAUSED")
Zielgruppen-ID long Die ID der zugehörigen Zielgruppe.

withCondition("AudienceId = 123456789")
CampaignName string Der Name der Kampagne, die die Anzeigengruppe der Zuordnung enthält.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus Aufzählung Der Status der Kampagne, die die Anzeigengruppe der Zuordnung enthält. Mögliche Werte für die Groß- und Kleinschreibung sind:
  • AKTIVIERT
  • ANGEHALTEN
  • ENTFERNT
In diesem Beispiel werden nur Anzeigengruppenzielgruppen zurückgegeben, deren übergeordnete Kampagne pausiert ist.

withCondition("CampaignStatus = PAUSED")
Status Aufzählung Der Status der Vereinigung. Mögliche Werte für die Groß- und Kleinschreibung sind:
  • AKTIVIERT
  • ANGEHALTEN
  • ENTFERNT
In diesem Beispiel werden nur aktivierte Anzeigengruppenzielgruppen zurückgegeben.

withCondition("Status = ENABLED")
UserListName string Der Name der zugeordneten Zielgruppe.

withCondition("UserListName = 'foo'")

Argumente

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

Rückgabewerte

Typ Beschreibung
AdGroupAudienceSelector Selector mit der angewendeten Bedingung.

withIds(string[] ids)

Ruft Anzeigengruppenzielgruppen 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. Im folgenden Aufruf wird beispielsweise nur die Zielgruppe 33333 der Anzeigengruppe ausgewählt.

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

Argumente

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

Rückgabewerte

Typ Beschreibung
AdGroupAudienceSelector Selector mit den angewendeten IDs.

withLimit(int limit)

Ruft die ersten n Zielgruppen der Anzeigengruppe ab, die den Auswahlkriterien entsprechen.

Argumente

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

Rückgabewerte

Typ Beschreibung
AdGroupAudienceSelector Selektor mit angewendetem Grenzwert.
  • Last updated on