ProductChannel
Contém os métodos para gerir um grupo de produtos 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 o canal do produto corresponder exatamente ao nome do canal devolvido por getChannel .
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": {
// It's not necessary to cast the product group to a channel product
// group since the getValue() method returns the same value as getChannel().
// var channel = group.asChannel().getChannel();
var channel = 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. |
| getChannel | cadeia | Obtém o nome 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. |
getChannel
Obtém o nome do canal do produto. Este método devolve o mesmo valor que o getValue() método .
Devoluções
| Tipo | Descrição |
|---|---|
| cadeia | O nome do canal do produto. Por exemplo, Lojas Online ou Locais. |
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 CANAL. |
getEntityType
Obtém o tipo desta entidade.
Devoluções
| Tipo | Descrição |
|---|---|
| cadeia | O tipo desta entidade, que é ProductChannel. |
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 do canal do produto.
Devolve:
| Tipo | Descrição |
|---|---|
| cadeia | O nome do canal do produto. Este é o mesmo valor devolvido pelo método getChannel . |
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. |