ProductChannelExclusivity

Contém os métodos para gerir um grupo de produtos de exclusividade de canal. Este objeto deriva de ProductGroup.

Utilizado pelo motor de entrega para determinar se um produto do catálogo do anunciante é servido. O motor poderá servir o produto se a exclusividade do canal do produto corresponder exatamente ao nome de exclusividade do canal que getChannelExclusivity devolve.

Utilização de exemplo:

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

Métodos

Nome do Método	Tipo de Devolução	Descrição
subordinados	ProductGroupSelector	Obtém um seletor utilizado para filtrar a lista de grupos de produtos subordinados deste grupo de produtos.
getAdGroup	AdGroup	Obtém o grupo de anúncios ao qual este grupo de produtos pertence.
getCampaign	Campanha	Obtém a campanha à qual este grupo de produtos pertence.
getChannelExclusivity	cadeia	Obtém o nome de exclusividade do canal do produto.
getDimension	cadeia	Obtém a dimensão deste grupo de produtos.
getEntityType	cadeia	Obtém o tipo desta entidade.
getId	cadeia	Obtém o ID que identifica exclusivamente este grupo de produtos.
getMaxCpc	duplo	Obtém o valor máximo de oferta de custo por clique para este grupo de produtos.
getStats	Estatísticas	Obtém os dados de desempenho deste grupo de produtos.
getValue	cadeia	Obtém o valor deste grupo de produtos.
isExcluded	Booleano	Obtém um valor Booleano que determina se este grupo de produtos está excluído.
isOtherCase	Booleano	Obtém um valor Booleano que determina se este grupo de produtos representa todos os outros casos não representados pelo respetivo grupo de produtos colaterais.
principal	Grupo de Produtos	Obtém o grupo de produtos principal deste grupo de produtos.
setMaxCpc(double cpc)	vazio	Define o valor máximo de oferta de custo por clique a utilizar para este grupo de produtos.

subordinados

Obtém um seletor utilizado para filtrar a lista de grupos de produtos subordinados deste grupo de produtos.

Devoluções

Tipo	Descrição
ProductGroupSelector	Um seletor utilizado para filtrar a lista de subordinados neste grupo de produtos.

getAdGroup

Obtém o grupo de anúncios ao qual este grupo de produtos pertence.

Devoluções

Tipo	Descrição
AdGroup	O grupo de anúncios a que este grupo de produtos pertence.

getCampaign

Obtém a campanha à qual este grupo de produtos pertence.

Devoluções

Tipo	Descrição
Campanha	A campanha à qual este grupo de produtos pertence.

getChannelExclusivity

Obtém o nome de exclusividade do canal do produto. Este método devolve o mesmo valor que o getValue() método .

Devoluções

Tipo	Descrição
cadeia	O nome de exclusividade do canal do produto. Por exemplo, Multi-channel ou Single-channel.

getDimension

Obtém a dimensão deste grupo de produtos.

Devoluções

Tipo	Descrição
Cadeia	A dimensão deste grupo de produtos, que está definida como CHANNEL_EXCLUSIVITY.

getEntityType

Obtém o tipo desta entidade.

Devoluções

Tipo	Descrição
cadeia	O tipo desta entidade, que é ProductChannelExclusivity.

getId

Obtém o ID que identifica exclusivamente este grupo de produtos.

Devoluções

Tipo	Descrição
cadeia	O ID que identifica exclusivamente este grupo de produtos.

getMaxCpc

Obtém o valor máximo de oferta de custo por clique deste grupo de produtos.

Devoluções

Tipo	Descrição
duplo	O montante da oferta. Devolve nulo se não estiver definido ou se for um grupo de produtos negativo (isExluded é verdadeiro).

getStats

Obtém os dados de desempenho deste grupo de produtos.

Para chamar este método, tem de incluir um dos forDateRange métodos na cadeia do seletor do grupo de produtos .

Devolve:

Tipo	Descrição
Estatísticas	Os dados de desempenho deste grupo de produtos.

getValue

Obtém o nome de exclusividade do canal do produto.

Devolve:

Tipo	Descrição
cadeia	O nome de exclusividade do canal do produto. Este é o mesmo valor que o método getChannelExclusivity devolve.

isExcluded

Obtém um valor Booleano que determina se este grupo de produtos é um grupo de produtos negativo.

Devolve:

Tipo	Descrição
Booleano	É verdadeiro se este grupo de produtos for um grupo negativo; caso contrário, falso. Por exemplo, em vez de incluir todos os esquis descendentes, exclui-os.

isOtherCase

Obtém um valor Booleano que determina se este grupo de produtos representa tudo o resto não representado pelo respetivo grupo de produtos colaterais (aka., o outro caso).

Devolve:

Tipo

Descrição

Booleano

É verdadeiro se este grupo de produtos representar o caso "outro"; caso contrário, falso. Por exemplo, se dividir Todos os produtos (o nó raiz) por Bens Desportivos, o serviço cria um grupo de produtos colateral que representa os produtos que não estão em Bens Desportivos e define este campo como verdadeiro. O ID principal deste grupo de produtos e o grupo de produtos Sporting Goods apontam para o nó raiz.

principal

Obtém o principal deste grupo de produtos.

Devolve:

Tipo	Descrição
Grupo de Produtos	O principal deste grupo de produtos.

setMaxCpc(double cpc)

Define o valor máximo de licitação por clique para este grupo de produtos.

Argumentos

Name	Tipo	Descrição
cpc	duplo	O montante da oferta. O valor da oferta está na moeda da conta, que determina os valores mínimos e máximos de licitação que pode especificar. Não defina a oferta se este grupo de produtos for subdividido (tiver filhos) ou for um grupo de produtos negativo (isExcluded é verdadeiro).

Devoluções

Tipo	Descrição
vazio	Não devolve nada.