Freigeben über


ProductChannelExclusivity

Enthält die Methoden zum Verwalten einer Kanalexklusivitätsproduktgruppe. 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 Kanalexklusivität des Produkts genau dem Kanalexklusivitätsnamen entspricht, der von getChannelExclusivity zurückgegeben wird.

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 "CHANNEL_EXCLUSIVITY": {
                // It's not necessary to cast the product group to a channel exclusivity product
                // group since the getValue() method returns the same value as getChannelExclusivity().
                // var channelExclusivity = group.asChannelExclusivity().getChannelExclusivity();

                var channelExclusivity = 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.
getChannelExclusivity string Ruft den Kanalexklusivitätsnamen des Produkts ab.
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.
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.

getChannelExclusivity

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

Rückgabewerte

Typ Beschreibung
string Der Name der Kanalexklusivität des Produkts. Beispiel: Mehrkanal oder Einzelkanal.

getDimension

Ruft die Dimension dieser Produktgruppe ab.

Rückgabewerte

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

getEntityType

Ruft den Typ dieser Entität ab.

Rückgabewerte

Typ Beschreibung
string Der Typ dieser Entität, d. h. ProductChannelExclusivity.

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

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 Kanalexklusivitätsnamen des Produkts ab.

Rückgabewerte:

Typ Beschreibung
string Der Name der Kanalexklusivität des Produkts. Dies ist derselbe Wert, den die getChannelExclusivity-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.