Freigeben über

AdGroupExcludedAudienceSelector

  • Artikel

Enthält die Methoden zum Filtern und Sortieren einer Liste ausgeschlossener Zielgruppen für Anzeigengruppen. Informationen zu Selektoren finden Sie unter Selektoren.

Anwendungsbeispiel:

    // Gets the iterator that iterates all ad group excluded 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 excluded audiences
        // in the ad group excluded audience.
        var audienceIterator = adGroup.targeting().audiences()
            .withLimit(10)
            .withIds("123456789")
            .get();
    
        // Loops through all ad group excluded audiences in the ad group excluded audience.
        while (audienceIterator.hasNext()) {
            var audience = audienceIterator.next();
        }
    }

Methoden

Methodenname Rückgabetyp Beschreibung
get AdGroupExcludedAudienceIterator Ruft einen Iterator ab, der verwendet wird, um die Liste der ausgeschlossenen Zielgruppen der Anzeigengruppe zu durchlaufen.
orderBy(string orderBy) AdGroupExcludedAudienceSelector Wendet die angegebene Reihenfolge auf die ausgeschlossenen Zielgruppen der ausgewählten Anzeigengruppe an.
withCondition(string condition) AdGroupExcludedAudienceSelector Wendet Filterkriterien auf die ausgeschlossenen Zielgruppen der Anzeigengruppe an.
withIds(string[] ids) AdGroupExcludedAudienceSelector Ruft die ausgeschlossenen Zielgruppen der Anzeigengruppe mit den angegebenen IDs ab.
withLimit(int limit) AdGroupExcludedAudienceSelector Ruft die höchsten n ausgeschlossenen Zielgruppen der Anzeigengruppe ab, die den Auswahlkriterien entsprechen.

Erhalten

Ruft einen Iterator ab, der verwendet wird, um die Liste der ausgeschlossenen Zielgruppen der Anzeigengruppe zu durchlaufen.

Rückgabewerte

Typ Beschreibung
AdGroupExcludedAudienceIterator Ein Iterator, der verwendet wird, um die ausgeschlossenen Zielgruppen der ausgewählten Anzeigengruppe zu durchlaufen.

orderBy(String orderBy)

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

withCondition(String condition)

Wendet Filterkriterien auf die ausgeschlossenen Zielgruppen der Anzeigengruppe 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

Unterstützte Spalten für die Filterung ausgeschlossener Zielgruppen in Anzeigengruppen. Bei den Namen wird die Groß-/Kleinschreibung beachtet.

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

Spalte Typ Beispiel
AdGroupName string Der Name der Anzeigengruppe der Zuordnung.

withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus Enumeration Die status der Anzeigengruppe der Zuordnung. Mögliche Werte, bei denen die Groß-/Kleinschreibung beachtet wird, sind:
  • AKTIVIERT
  • ANGEHALTEN
  • ENTFERNT
In diesem Beispiel werden nur Zielgruppen zurückgegeben, für die eine Anzeigengruppe ausgeschlossen ist, deren übergeordnete Anzeigengruppe angehalten ist.

withCondition("AdGroupStatus = PAUSED")
AudienceId long Die ID der zugeordneten Zielgruppe.

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

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus Enumeration Die status der Kampagne, die die Anzeigengruppe der Zuordnung enthält. Mögliche Werte, bei denen die Groß-/Kleinschreibung beachtet wird, sind:
  • AKTIVIERT
  • ANGEHALTEN
  • ENTFERNT
In diesem Beispiel werden nur zielgruppen-ausgeschlossene Anzeigengruppen zurückgegeben, deren übergeordnete Kampagne angehalten ist.

withCondition("CampaignStatus = PAUSED")
Status Enumeration Die status der Zuordnung. Mögliche Werte, bei denen die Groß-/Kleinschreibung beachtet wird, sind:
  • AKTIVIERT
  • ANGEHALTEN
  • ENTFERNT
In diesem Beispiel werden nur aktivierte zielgruppenseitig ausgeschlossene Anzeigengruppen zurückgegeben.

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

withCondition("UserListName = 'foo'")

Argumente

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

Rückgabewerte

Typ Beschreibung
AdGroupExcludedAudienceSelector Selektor mit angewendeter Bedingung.

withIds(string[] ids)

Ruft die ausgeschlossenen Zielgruppen der Anzeigengruppe 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 die ausgeschlossene Zielgruppe 33333 der Anzeigengruppe aus.

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

Argumente

Name Typ Beschreibung
ids string[] Ein Array ausgeschlossener Zielgruppen-IDs der Anzeigengruppe. Informationen zu Grenzwerten finden Sie unter Skriptausführungslimits.

Rückgabewerte

Typ Beschreibung
AdGroupExcludedAudienceSelector Selektor mit den angewendeten IDs.

withLimit(int limit)

Ruft die höchsten n ausgeschlossenen Zielgruppen der Anzeigengruppe ab, die den Auswahlkriterien entsprechen.

Argumente

Name Typ Beschreibung
Begrenzung int Die Anzahl der zurückzugebenden Zielgruppen, die von der Anzeigengruppe ausgeschlossen werden sollen. Die tatsächliche Zahl kann kleiner sein.

Rückgabewerte

Typ Beschreibung
AdGroupExcludedAudienceSelector Selektor mit angewendetem Limit.