ProductCustomLabel

Enthält die Methoden zum Verwalten einer Produktgruppe für benutzerdefinierte Bezeichnungen. Dieses Objekt stammt von ProductGroup.

Wird vom Liefermodul verwendet, um zu bestimmen, ob ein Produkt aus dem Katalog des Inserenten bereitgestellt wird. Die Engine kann das Produkt bereitstellen, wenn die benutzerdefinierte Bezeichnung des Produkts genau mit der vongetType zurückgegebenen Bezeichnung ü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 "CUSTOM_LABEL": {
                // It's only necessary to cast the product group to a ProductCustomLabel product
                // group if you need to get the label's name by calling getType(). Otherwise,
                // you can simply use ProductGroup if you want to get the label's value by
                // calling getValue().

                var customLabel = productGroup.asCustomLabel();
                var labelName = customLabel.getType();
                var labelValue = customLabel.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	AdGroup	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 dieses Objekts ab.
getId	string	Ruft die ID ab, die diese Produktgruppe eindeutig identifiziert.
getMaxCpc	double	Ruft den maximalen Gebotsbetrag für die Kosten pro Klick für diese Produktgruppe ab.
getStats	Statistik	Ruft die Leistungsdaten für diese Produktgruppe ab.
getType	string	Ruft den benutzerdefinierten Etikettentyp des Produkts ab.
getValue	string	Ruft den Wert der benutzerdefinierten Bezeichnung ab.
isExcluded	Boolean	Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe ausgeschlossen wird.
isOtherCase	Boolean	Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe alle anderen Fälle darstellt, die nicht durch die gleichgeordnete Produktgruppe repräsentiert werden.
Übergeordnetes Element	ProductGroup	Ruft die übergeordnete Produktgruppe dieser Produktgruppe ab.
setMaxCpc(double cpc)	void	Legt den maximalen Gebotsbetrag für die Kosten pro Klick 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
AdGroup	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 CUSTOM_LABEL festgelegt ist.

getEntityType

Ruft den Typ dieses Objekts ab.

Rückgabewerte

Typ	Beschreibung
string	Der Typ dieser Entität, bei dem es sich um ProductCustomLabel handelt.

getId

Ruft die ID ab, die diese Produktgruppe eindeutig identifiziert.

Rückgabewerte

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

getMaxCpc

Ruft das maximale Gebot für die Kosten pro Klick dieser Produktgruppe ab.

Rückgabewerte

Typ	Beschreibung
double	Der Gebotsbetrag. Gibt Null zurück, wenn nicht festgelegt oder es sich um eine negative Produktgruppe handelt (isExluded ist wahr).

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 aufnehmen.

Rückgabewerte:

Typ	Beschreibung
Statistik	Die Performance-Daten für diese Produktgruppe.

getType

Ruft den benutzerdefinierten Etikettentyp des Produkts ab.

Rückgabewerte

Typ	Beschreibung
Zeichenfolge	Der benutzerdefinierte Etikettentyp des Produkts. Beispielsweise CustomLabel0 bis CustomLabel4.

getValue

Ruft den Wert der benutzerdefinierten Bezeichnung ab.

Rückgabewerte:

Typ	Beschreibung
string	Der Wert der benutzerdefinierten Bezeichnung.

isExcluded

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

Rückgabewerte:

Typ	Beschreibung
Boolean	Ist wahr , wenn es sich bei dieser Produktgruppe um eine negative Gruppe handelt; Andernfalls wird "false" verwendet. Anstatt beispielsweise alle Abfahrtsski einzubeziehen, schließen Sie sie aus.

isOtherCase

Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe alles andere darstellt, was nicht durch die gleichgeordnete Produktgruppe repräsentiert wird (auch bekannt als die andere Groß-/Kleinschreibung).

Rückgabewerte:

Typ

Beschreibung

Boolean

Ist wahr , wenn diese Produktgruppe den "anderen" Fall darstellt; Andernfalls wird "false" verwendet. Wenn Sie beispielsweise Alle Produkte (den Stammknoten) durch Sportartikel teilen, erstellt der Dienst eine gleichgeordnete Produktgruppe, die die Produkte darstellt, die nicht in Sportartikel enthalten sind, und legt dieses Feld auf "true" fest. Die übergeordnete ID dieser Produktgruppe und die Produktgruppe Sporting Goods zeigen auf den Wurzelknoten.

übergeordnetes Element

Ruft das übergeordnete Element dieser Produktgruppe ab.

Rückgabewerte:

Typ	Beschreibung
ProductGroup	Das übergeordnete Element dieser Produktgruppe.

setMaxCpc(double cpc)

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

Argumente

Name	Typ	Beschreibung
CPC	double	Der Gebotsbetrag. Der Gebotsbetrag wird in der Währung des Kontos angegeben, die den von Ihnen angegebenen minimalen und maximalen Gebotswert bestimmt. Legen Sie das Gebot nicht fest, wenn diese Produktgruppe unterteilt ist (untergeordnete Elemente hat) oder eine negative Produktgruppe ist (isExcludedist wahr).

Rückgabewerte

Typ	Beschreibung
void	Gibt Nothing zurück.