Productcategory

Enthält die Methoden zum Verwalten einer Kategorieproduktgruppe. Dieses Objekt wird von ProductGroup abgeleitet.

Wird von der Übermittlungs-Engine verwendet, um zu bestimmen, ob ein Produkt aus dem Katalog des Inserenten bereitgestellt wird. Die Engine kann das Produkt bedienen, wenn die Kategorie des Produkts genau mit dem von getName zurückgegebenen Kategorienamen übereinstimmt.

Anwendungsbeispiel:

    var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();

    var productGroups = shoppingCampaign.productGroups().get();

    while (productGroups.hasNext()) {
        var group = productGroups.next();

        switch (group.getDimension()) {
            case "CATEGORY": {
                // It's not necessary to cast the product group to a category product
                // group since the getValue() method returns the same value as getName().
                // var category = group.asCategory().getName();

                var category = group.getValue();
                break;
            }
            // Other cases
        }
    }

Methoden

Methodenname	Rückgabetyp	Beschreibung
children	ProductGroupSelector	Ruft einen Selektor ab, der zum Filtern der Liste der untergeordneten Produktgruppen dieser Produktgruppe verwendet wird.
getAdGroup	Anzeigengruppe	Ruft die Anzeigengruppe ab, zu der diese Produktgruppe gehört.
getCampaign	Kampagnen	Ruft die Kampagne ab, zu der diese Produktgruppe gehört.
getDimension	string	Ruft die Dimension dieser Produktgruppe ab.
getEntityType	string	Ruft den Typ dieser Entität ab.
Getid	string	Ruft die ID ab, die diese Produktgruppe eindeutig identifiziert.
getMaxCpc	double	Ruft den maximalen Kosten-pro-Klick-Gebotsbetrag für diese Produktgruppe ab.
Getname	string	Ruft den Kategorienamen des Produkts ab.
Getstats	Statistiken	Ruft die Leistungsdaten für diese Produktgruppe ab.
Getvalue	string	Ruft den Wert dieser Produktgruppe ab.
isExcluded	Boolesch	Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe ausgeschlossen wird.
isOtherCase	Boolesch	Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe alle anderen Fälle darstellt, die nicht durch ihre gleichgeordnete Produktgruppe dargestellt werden.
Elternteil	ProductGroup	Ruft die übergeordnete Produktgruppe dieser Produktgruppe ab.
setMaxCpc(double cpc)	void	Legt den maximalen Kosten-pro-Klick-Gebotsbetrag fest, der für diese Produktgruppe verwendet werden soll.

Untergeordnetes Element

Ruft einen Selektor ab, der zum Filtern der Liste der untergeordneten Produktgruppen dieser Produktgruppe verwendet wird.

Rückgabewerte

Typ	Beschreibung
ProductGroupSelector	Ein Selektor, der zum Filtern der Liste der untergeordneten Elemente in dieser Produktgruppe verwendet wird.

getAdGroup

Ruft die Anzeigengruppe ab, zu der diese Produktgruppe gehört.

Rückgabewerte

Typ	Beschreibung
Anzeigengruppe	Die Anzeigengruppe, zu der diese Produktgruppe gehört.

getCampaign

Ruft die Kampagne ab, zu der diese Produktgruppe gehört.

Rückgabewerte

Typ	Beschreibung
Kampagnen	Die Kampagne, zu der diese Produktgruppe gehört.

getDimension

Ruft die Dimension dieser Produktgruppe ab.

Rückgabewerte

Typ	Beschreibung
Zeichenfolge	Die Dimension dieser Produktgruppe, die auf CATEGORY festgelegt ist.

getEntityType

Ruft den Typ dieser Entität ab.

Rückgabewerte

Typ	Beschreibung
string	Der Typ dieser Entität ist ProductCategory.

Getid

Ruft die ID ab, die diese Produktgruppe eindeutig identifiziert.

Rückgabewerte

Typ	Beschreibung
string	Die ID, die diese Produktgruppe eindeutig identifiziert.

getMaxCpc

Ruft den maximalen Kosten-pro-Klick-Gebotsbetrag dieser Produktgruppe ab.

Rückgabewerte

Typ	Beschreibung
double	Der Gebotsbetrag. Gibt NULL zurück, wenn nicht festgelegt ist oder dies eine negative Produktgruppe ist (isExluded ist true).

Getname

Ruft den Kategorienamen des Produkts ab. Diese Methode gibt denselben Wert wie die getValue() -Methode zurück.

Rückgabewerte

Typ	Beschreibung
string	Der Kategoriename des Produkts. Beispiel: Tiere & Tierbedarf.

Getstats

Ruft die Leistungsdaten für diese Produktgruppe ab.

Um diese Methode aufzurufen, müssen Sie eine der forDateRange Methoden in die Kette der Produktgruppenauswahl einschließen.

Rückgabewerte:

Typ	Beschreibung
Statistiken	Die Leistungsdaten für diese Produktgruppe.

Getvalue

Ruft den Kategorienamen des Produkts ab.

Rückgabewerte:

Typ	Beschreibung
string	Der Kategoriename des Produkts. Dies ist derselbe Wert, den die getName-Methode zurückgibt.

isExcluded

Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe eine negative Produktgruppe ist.

Rückgabewerte:

Typ	Beschreibung
Boolescher Wert	Ist true , wenn diese Produktgruppe eine negative Gruppe ist; andernfalls false. Anstatt beispielsweise alle Abfahrtsskis einzuschließen, schließen Sie sie aus.

isOtherCase

Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe alles darstellt, was nicht durch die nebengeordnete Produktgruppe (aka., der andere Fall) dargestellt wird.

Rückgabewerte:

Typ

Beschreibung

Boolescher Wert

Ist true , wenn diese Produktgruppe den "anderen" Fall darstellt; andernfalls false. Wenn Sie beispielsweise Alle Produkte (der Stammknoten) durch Sportartikel unterteilen, erstellt der Dienst eine gleichgeordnete Produktgruppe, die die Produkte darstellt, die nicht in Sportartikeln enthalten sind, und legt dieses Feld auf true fest. Die übergeordnete ID dieser Produktgruppe und die Produktgruppe Sportartikel verweisen auf den Stammknoten.

übergeordnetes Element

Ruft das übergeordnete Element dieser Produktgruppe ab.

Rückgabewerte:

Typ	Beschreibung
ProductGroup	Übergeordnetes Element dieser Produktgruppe.

setMaxCpc(double cpc)

Legt den maximalen Kosten-pro-Klick-Gebotsbetrag für diese Produktgruppe fest.

Argumente

Name	Typ	Beschreibung
Cpc	double	Der Gebotsbetrag. Der Gebotsbetrag ist in der Währung des Kontos, die die minimalen und maximalen Gebotswerte bestimmt, die Sie angeben können. Legen Sie das Gebot nicht fest, wenn diese Produktgruppe unterteilt ist (über untergeordnete Elemente verfügt) oder eine negative Produktgruppe ist (isExcludedist true).

Rückgabewerte

Typ	Beschreibung
void	Gibt Nothing zurück.