Métricas de desempenho e atributos de configuração dos grupos de produtos. Os relatórios do grupo de produtos diferem dos relatórios de palavras-chave de várias maneiras. Saiba mais.
Esse relatório só pode ser retornado por uma solicitação assíncrona (ou seja, pelo método Reports.request()).
Trecho de solicitação
Envie um corpo de solicitação Reports.request(), 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.
columnName | Descrição | Comportamento | Tipo | Filtrá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 externa. | 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 |
Status da campanha que contém este 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 |
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="Eletrônicos",MARCA = "exemplo"). | 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 usado pelo DS para rastrear a atividade. O usuário que clica em um anúncio acessa primeiro o URL do servidor de cliques e, em seguida, é 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áximo que foi definido para este grupo de produtos, se houver um. Se o CPC máx. não tiver sido definido para esse grupo de produtos, esse campo estará vazio e o grupo herdará a configuração de CPC máx. do grupo de anúncios. | atributo | Money |
Sim |
effectiveProductGroupMaxCpc |
O CPC máximo (custo máximo por clique) que está em vigor para esse grupo de produtos. Ele terá o mesmo valor que o CPC máximo do grupo de anúncios ou, se a segmentação do produto substituir a configuração do grupo de anúncios, o próprio CPC máximo da segmentação de produto. | atributo | Money |
Sim |
productGroupMaxBid |
Se esse grupo de produtos for gerenciado por uma estratégia de lances do DS, ela 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, ela nunca vai reduzir 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 esta 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 dessa 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 |
Receita agregada gerada por 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 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 |
Receita agregada gerada por transações do Campaign Manager em vários 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 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 |
Cliques agregados. | 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órios 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 mês. 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 mês. 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 trimestre. 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 trimestre. 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 (de domingo a sábado), e cada linha e as métricas agregadas dela 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 (de domingo a sábado), e cada linha e as métricas agregadas dela 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 as respectivas métricas agregadas são divididas em várias linhas, até uma para cada segmento de dispositivo. Essa coluna retorna o segmento do dispositivo de cada linha. | segmentar | Device segment |
Sim |