Condividi tramite

ProductCustomLabel

  • Articolo

Contiene i metodi per la gestione di un gruppo di prodotti di etichette personalizzate. Questo oggetto deriva da ProductGroup.

Usato dal motore di consegna per determinare se un prodotto del catalogo dell'inserzionista viene servito. Il motore può servire il prodotto se l'etichetta personalizzata del prodotto corrisponde esattamente all'etichetta restituita dagetType.

Utilizzo di esempio:

    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
        }
    }

Metodi

Nome metodo Tipo restituito Descrizione
Bambini ProductGroupSelector Ottiene un selettore utilizzato per filtrare l'elenco di gruppi di prodotti figlio di questo gruppo di prodotti.
getAdGroup AdGroup Ottiene il gruppo di annunci a cui appartiene questo gruppo di prodotti.
getCampaign Campagna Ottiene la campagna a cui appartiene questo gruppo di prodotti.
getDimension stringa Ottiene la dimensione del gruppo di prodotti.
getEntityType stringa Ottiene il tipo di questa entità.
getId stringa Ottiene l'ID che identifica in modo univoco questo gruppo di prodotti.
getMaxCpc Doppia Ottiene l'importo massimo dell'offerta di costo per clic per questo gruppo di prodotti.
getStats Statistiche Ottiene i dati sulle prestazioni per questo gruppo di prodotti.
getType stringa Ottiene il tipo di etichetta personalizzata del prodotto.
Getvalue stringa Ottiene il valore dell'etichetta personalizzata.
isExcluded Booleano Ottiene un valore booleano che determina se questo gruppo di prodotti è escluso.
isOtherCase Booleano Ottiene un valore booleano che determina se questo gruppo di prodotti rappresenta tutti gli altri casi non rappresentati dal gruppo di prodotti di pari livello.
padre ProductGroup Ottiene il gruppo di prodotti padre del gruppo di prodotti.
setMaxCpc(double cpc) Vuoto Imposta l'importo massimo dell'offerta con costo per clic da usare per questo gruppo di prodotti.

Bambini

Ottiene un selettore utilizzato per filtrare l'elenco di gruppi di prodotti figlio di questo gruppo di prodotti.

Restituisce

Tipo Descrizione
ProductGroupSelector Selettore utilizzato per filtrare l'elenco di elementi figlio in questo gruppo di prodotti.

getAdGroup

Ottiene il gruppo di annunci a cui appartiene questo gruppo di prodotti.

Restituisce

Tipo Descrizione
AdGroup Gruppo di annunci a cui appartiene questo gruppo di prodotti.

getCampaign

Ottiene la campagna a cui appartiene questo gruppo di prodotti.

Restituisce

Tipo Descrizione
Campagna Campagna a cui appartiene questo gruppo di prodotti.

getDimension

Ottiene la dimensione del gruppo di prodotti.

Restituisce

Tipo Descrizione
Stringa Dimensione del gruppo di prodotti impostata su CUSTOM_LABEL.

getEntityType

Ottiene il tipo di questa entità.

Restituisce

Tipo Descrizione
stringa Tipo di questa entità, ovvero ProductCustomLabel.

getId

Ottiene l'ID che identifica in modo univoco questo gruppo di prodotti.

Restituisce

Tipo Descrizione
stringa ID che identifica in modo univoco questo gruppo di prodotti.

getMaxCpc

Ottiene l'importo massimo dell'offerta di costo per clic del gruppo di prodotti.

Restituisce

Tipo Descrizione
Doppia Importo dell'offerta. Restituisce Null se non è impostato o si tratta di un gruppo di prodotti negativo (isExluded è true).

getStats

Ottiene i dati sulle prestazioni per questo gruppo di prodotti.

Per chiamare questo metodo, è necessario includere uno dei forDateRange metodi nella catena del selettore del gruppo di prodotti .

Restituisce:

Tipo Descrizione
Statistiche Dati sulle prestazioni per questo gruppo di prodotti.

getType

Ottiene il tipo di etichetta personalizzata del prodotto.

Restituisce

Tipo Descrizione
Stringa Tipo di etichetta personalizzata del prodotto. Ad esempio, da CustomLabel0 a CustomLabel4.

Getvalue

Ottiene il valore dell'etichetta personalizzata.

Restituisce:

Tipo Descrizione
stringa Valore dell'etichetta personalizzata.

isExcluded

Ottiene un valore booleano che determina se il gruppo di prodotti è un gruppo di prodotti negativo.

Restituisce:

Tipo Descrizione
Booleano È true se questo gruppo di prodotti è un gruppo negativo; in caso contrario, false. Ad esempio, invece di includere tutti gli sci in discesa, li escludi.

isOtherCase

Ottiene un valore booleano che determina se questo gruppo di prodotti rappresenta tutti gli altri elementi non rappresentati dal gruppo di prodotti di pari livello ,ovvero l'altro caso.

Restituisce:

Tipo Descrizione
Booleano È true se questo gruppo di prodotti rappresenta il caso "other"; in caso contrario, false. Ad esempio, se si divide Tutti i prodotti (il nodo radice) per Articoli sportivi, il servizio crea un gruppo di prodotti di pari livello che rappresenta i prodotti non inclusi in Articoli sportivi e imposta questo campo su true. L'ID padre di questo gruppo di prodotti e il gruppo di prodotti Sporting Goods puntano al nodo radice.

padre

Ottiene l'elemento padre del gruppo di prodotti.

Restituisce:

Tipo Descrizione
ProductGroup Padre del gruppo di prodotti.

setMaxCpc(double cpc)

Imposta l'importo massimo del costo per clic dell'offerta per questo gruppo di prodotti.

Argomenti

Nome Tipo Descrizione
Cpc Doppia Importo dell'offerta. L'importo dell'offerta si trova nella valuta del conto, che determina i valori di offerta minimo e massimo che è possibile specificare. Non impostare l'offerta se questo gruppo di prodotti è suddiviso (ha figli) o è un gruppo di prodotti negativo (isExcluded è true).

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.