Tipo de relatório: productGroup

Métricas de desempenho e atributos de configuração para grupos de produtos. Os relatórios de grupos de produtos diferem dos relatórios de palavras-chave em vários aspectos. Saiba mais.

Esse relatório só pode ser retornado por uma solicitação assíncrona (ou seja, por meio do método Reports.request()).

Trecho da solicitação

Envie uma Reports.request() corpo da solicitação, mas especifique "reportType": "productGroup".

{
...
  "reportType": "productGroup",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Para cada coluna que você quer retornar ou filtrar no relatório, especifique o columnName listado na tabela abaixo. Também é possível especificar headerText; startDate, e endDate. Algumas colunas não podem ser filtradas. consulte "Filtrável" na tabela abaixo.

columnNameDescriçãoComportamentoTipoFiltrável
status O status do grupo de produtos. É sempre Active. atributo Status Sim
engineStatus Status adicional do grupo de produtos na conta de mecanismo externo. Os status possíveis (dependendo do tipo de conta externa) incluem review, campaign paused etc. atributo String Sim
creationTimestamp Carimbo de data/hora da criação do grupo de produtos, formatado em ISO 8601. atributo Timestamp Sim
lastModifiedTimestamp Carimbo de data/hora da modificação mais recente do grupo de produtos, formatado em ISO 8601. atributo Timestamp Sim
agency Nome da agência. atributo String Sim
agencyId ID da agência do DS. atributo ID Sim
advertiser Nome do anunciante. atributo String Sim
advertiserId ID do anunciante do DS. atributo ID Sim
account Nome da conta de mecanismo. atributo String Sim
accountId ID da conta de mecanismo do DS. atributo ID Sim
accountEngineId ID da conta na conta de mecanismo externo. atributo String Sim
accountType Tipo de conta de mecanismo: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu ou Comparison Shopping. atributo Engine type Sim
campaign Nome da campanha. atributo String Sim
campaignId ID da campanha do DS. atributo ID Sim
campaignStatus O status da campanha que contém esse item. atributo Status Sim
adGroup Nome do grupo de anúncios. atributo String Sim
adGroupId ID do grupo de anúncios do DS. atributo ID Sim
adGroupStatus O status do grupo de anúncios que contém esse item. atributo Status Sim
productGroupId ID do grupo de produtos do DS. O DS gera esses IDs, que podem mudar mesmo que a árvore do grupo de produtos resultante não seja alterada. Saiba mais. atributo ID Sim
productGroup Os critérios usados para definir o grupo de produtos, como AND(CATEGORY="Electronics",BRAND = "example"). atributo String Não
productGroupPartitionType O tipo de partição do grupo de produtos: Subdivided, Excluded ou Biddable. atributo Product group partition type Sim
productGroupLandingPage Página de destino do grupo de produtos. Consulte URLs da página de destino e do servidor de cliques. atributo String Sim
productGroupClickserverUrl O URL que o DS usa para rastrear a atividade. Um usuário que clica em um anúncio visita primeiro o URL do servidor de cliques e depois é redirecionado para a página de destino final. Consulte URLs da página de destino e do servidor de cliques. atributo String Sim
productGroupMaxCpc Retorna o CPC máx. que foi definido para esse grupo de produtos, se houver. Se o CPC máx. não tiver sido definido para esse grupo de produtos, esse campo ficará vazio e o grupo herdará a configuração de CPC máx. do grupo de anúncios. atributo Money Sim
effectiveProductGroupMaxCpc O CPC (custo por clique) máximo em vigor para este grupo de produtos. Esse valor será o mesmo que o CPC máx. do grupo de anúncios ou, se a segmentação de produto substituir a configuração do grupo de anúncios, o CPC máx. da própria segmentação de produto. atributo Money Sim
productGroupMaxBid Se esse grupo de produtos for gerenciado por uma estratégia de lances do DS, a estratégia nunca aumentará os lances acima desse limite. Consulte Aplicar uma estratégia de lances a um grupo de produtos. atributo Money Sim
productGroupMinBid Se esse grupo de produtos for gerenciado por uma estratégia de lances do DS, a estratégia nunca diminuirá os lances abaixo desse limite. Consulte Aplicar uma estratégia de lances a um grupo de produtos. atributo Money Sim
effectiveBidStrategyId ID do DS da estratégia de lances atribuída a essa entidade ou herdada por ela. atributo ID Sim
effectiveBidStrategy O nome da estratégia de lances atribuída a essa entidade ou herdada por ela. atributo String Sim
bidStrategyInherited Indica se a estratégia de lances desta entidade é herdada. atributo Boolean Sim
effectiveLabels Nomes de todos os rótulos herdados ou atribuídos diretamente a este grupo de produtos. atributo String list Sim
dfaActions O número total de ações do Campaign Manager. métrica Integer Sim
dfaRevenue A receita agregada gerada pelas transações do Campaign Manager. métrica Money Sim
dfaTransactions O número total de transações do Campaign Manager. métrica Integer Sim
dfaWeightedActions Soma ponderada das ações do Campaign Manager. métrica Number Sim
dfaActionsCrossEnv O número total de ações do Campaign Manager em vários ambientes. métrica Number Sim
dfaRevenueCrossEnv A receita agregada gerada por transações do Campaign Manager em diferentes ambientes. métrica Money Sim
dfaTransactionsCrossEnv O número total de transações do Campaign Manager em vários ambientes. métrica Number Sim
dfaWeightedActionsCrossEnv Soma ponderada das ações do Campaign Manager em vários ambientes. métrica Number Sim
avgCpc Custo médio por clique. métrica Money Sim
avgCpm Custo médio por mil impressões métrica Money Sim
avgPos Posição média. métrica Number Sim
clicks Agregar cliques. métrica Integer Sim
cost Custo agregado pago às contas de mecanismo. métrica Money Sim
ctr Taxa de cliques média. métrica Number Sim
impr O número total de impressões. métrica Integer Sim
adWordsConversions Os dados que o anunciante configurou para serem informados na coluna "Conversões do Google Ads". Quando uma ação de conversão do Google Ads é criada, o anunciante pode escolher se quer contabilizar essas conversões na coluna "Relatório de conversões". métrica Number Sim
adWordsConversionValue Valor agregado das conversões do Google Ads. métrica Number Sim
adWordsViewThroughConversions O número total de conversões de visualização do Google Ads. métrica Integer Sim
visits O número total de visitas do DS. métrica Integer Sim
date Segmenta o relatório por dias. cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada dia. Essa coluna retorna a data de cada linha. segmentar Date Sim
monthStart Segmenta o relatório por meses. cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada mês. Essa coluna retorna o primeiro dia do mês de cada linha. segmentar Date Sim
monthEnd Segmenta o relatório por meses. cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada mês. Essa coluna retorna o último dia do mês de cada linha. segmentar Date Sim
quarterStart Segmenta o relatório por trimestres. cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada trimestre. Essa coluna retorna o primeiro dia do trimestre de cada linha. segmentar Date Sim
quarterEnd Segmenta o relatório por trimestres. cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada trimestre. Essa coluna retorna o último dia do trimestre de cada linha. segmentar Date Sim
weekStart Segmenta o relatório por semanas (domingo a sábado); cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada semana. Essa coluna retorna o primeiro dia (domingo) de cada linha. segmentar Date Sim
weekEnd Segmenta o relatório por semanas (domingo a sábado); cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada semana. Essa coluna retorna o último dia (sábado) de cada linha. segmentar Date Sim
yearStart Segmenta o relatório por anos. cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada ano. Essa coluna retorna o primeiro dia do ano de cada linha. segmentar Date Sim
yearEnd Segmenta o relatório por anos. cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada ano. Essa coluna retorna o último dia do ano de cada linha. segmentar Date Sim
deviceSegment Segmenta o relatório por dispositivo. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada segmento de dispositivo. Essa coluna retorna o segmento de dispositivo de cada linha. segmentar Device segment Sim