ProductCustomLabel

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

Utilizzato dal motore di distribuzione 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.

Esempio di utilizzo:

    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	Consente di ottenere un selettore usato per filtrare l'elenco dei gruppi di prodotti figlio di questo gruppo di prodotti.
getAdGroup	Gruppo annunci	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 di questo 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 cost per click per questo gruppo di prodotti.
getStats	Statistiche	Consente di ottenere i dati sul rendimento per questo gruppo di prodotti.
getType	stringa	Ottiene il tipo di etichetta personalizzata del prodotto.
getValue	stringa	Consente di ottenere 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 il gruppo di prodotti rappresenta tutti gli altri casi non rappresentati dal gruppo di prodotti di pari livello.
padre	Gruppo di prodotti	Ottiene il gruppo di prodotti padre di questo gruppo di prodotti.
setMaxCpc(doppio cpc)	void	Imposta l'importo massimo dell'offerta cost per click da utilizzare per questo gruppo di prodotti.

bambini

Consente di ottenere un selettore usato per filtrare l'elenco dei 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
Gruppo annunci	Il 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 di questo gruppo di prodotti.

Restituisce

Tipo	Descrizione
Stringa	La dimensione di questo 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 cost per click del gruppo di prodotti.

Restituisce

Tipo	Descrizione
doppia	Importo dell'offerta. Restituisce null se non impostato o se si tratta di un gruppo di prodotti negativo (isExluded è vero).

getStats

Consente di ottenere i dati sul rendimento per questo gruppo di prodotti.

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

Restituisce:

Tipo	Descrizione
Statistiche	Dati sul rendimento 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

Consente di ottenere 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 in uso è un gruppo di prodotti negativo.

Restituisce:

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

isOtherCase

Ottiene un valore booleano che determina se questo gruppo di prodotti rappresenta tutto il resto non rappresentato dal gruppo di prodotti di pari livello (ovvero l'altro caso).

Restituisce:

Tipo

Descrizione

Booleano

Restituisce True se questo gruppo di prodotti rappresenta l'"altro" caso; 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 Articoli sportivi puntano al nodo radice.

padre

Ottiene l'elemento padre di questo gruppo di prodotti.

Restituisce:

Tipo	Descrizione
Gruppo di prodotti	Padre di questo gruppo di prodotti.

setMaxCpc(doppio cpc)

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

Argomenti

Nome	Tipo	Descrizione
CPC	doppia	Importo dell'offerta. L'importo dell'offerta è nella valuta dell'account, che determina i valori minimo e massimo delle offerte che è possibile specificare. Non impostare l'offerta se questo gruppo di prodotti è suddiviso (include elementi figlio) o è un gruppo di prodotti negativo (isExcluded è vero).

Restituisce

Tipo	Descrizione
void	Non restituisce nulla.