Métricas de desempenho, atributos de configuração e atributos de inventário para produtos definidos em um feed de inventário e anunciados em uma campanha do Shopping.
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": "productAdvertised".
{
...
"reportType": "productAdvertised",
"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 produto, conforme indicado na conta do inventário: Active ou Removed. |
atributo | Status |
Sim |
creationTimestamp |
Carimbo de data/hora de criação do produto, conforme indicado na conta do inventário, formatado em ISO 8601. | atributo | Timestamp |
Sim |
lastModifiedTimestamp |
Carimbo de data/hora da modificação mais recente do produto, conforme indicado na conta do inventário, modificação, 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 |
productId |
O código do item do produto. | atributo | String |
Sim |
productCountry |
O país registrado para o feed de inventário do produto. | atributo | String |
Sim |
productLanguage |
O idioma registrado para o feed de inventário do produto. | atributo | String |
Sim |
productMpn |
O atributo MPN (Número de peça do fabricante) de um item do produto. | atributo | String |
Sim |
productColor |
O atributo color de um item do produto. | atributo | String |
Sim |
productSize |
O atributo size de um item de produto. | atributo | String |
Sim |
productMaterial |
O atributo material de um item do produto. | atributo | String |
Sim |
productPattern |
O atributo pattern de um item de produto. | atributo | String |
Sim |
productAvailability |
O atributo availability [disponibilidade] de um item de produto. | atributo | Product availability |
Sim |
productGender |
O atributo gender de um item do produto. | atributo | String |
Sim |
productAgeGroup |
O atributo de idade de um item do produto. | atributo | String |
Sim |
productLandingPageUrl |
O atributo landing page de um item do produto. | atributo | String |
Sim |
productCategory |
O atributo google product category de um item de produto. | atributo | String |
Sim |
productCategoryLevel1 |
O atributo google product category level 1 de um item de produto. | atributo | String |
Sim |
productCategoryLevel2 |
O atributo google product category level 2 de um item de produto. | atributo | String |
Sim |
productCategoryLevel3 |
O atributo google product category level 3 de um item de produto. | atributo | String |
Sim |
productCategoryLevel4 |
O atributo google product category nível 4 de um item de produto. | atributo | String |
Sim |
productCategoryLevel5 |
O atributo google product category level 5 de um item de produto. | atributo | String |
Sim |
productBrand |
O atributo brand de um item de produto. | atributo | String |
Sim |
productGtin |
O atributo GTIN (Número global de item comercial) de um item de produto. | atributo | String |
Sim |
productPrice |
O atributo price de um item do produto. | atributo | Money |
Sim |
productSalePrice |
O atributo price de um item do produto. | atributo | Money |
Sim |
productTypeLevel1 |
O atributo altura do tipo de produto 1 de um item do produto. | atributo | String |
Sim |
productTypeLevel2 |
O atributo product type leve 2 de um item do produto. | atributo | String |
Sim |
productTypeLevel3 |
O atributo product type leve 3 de um item do produto. | atributo | String |
Sim |
productTypeLevel4 |
O atributo altura do tipo de produto 4 de um item do produto. | atributo | String |
Sim |
productTypeLevel5 |
O atributo altura do tipo de produto 5 de um item do produto. | atributo | String |
Sim |
productCondition |
O atributo condition de um item de produto. | atributo | String |
Sim |
productCustomLabel0 |
O atributo custom label 0 de um item de produto. | atributo | String |
Sim |
productCustomLabel1 |
O atributo de rótulo personalizado 1 de um item de produto. | atributo | String |
Sim |
productCustomLabel2 |
O atributo de rótulo personalizado 2 de um item de produto. | atributo | String |
Sim |
productCustomLabel3 |
O atributo de rótulo personalizado 3 de um item de produto. | atributo | String |
Sim |
productCustomLabel4 |
O atributo de rótulo personalizado 4 de um item de produto. | atributo | String |
Sim |
productCostOfGoodsSold |
É o custo total da venda de um produto conforme especificado no feed de inventário. | atributo | Money |
Sim |
productStoreId |
A loja em que um produto foi anunciado em um anúncio de inventário local. Ele deve corresponder aos IDs de loja usados no seu feed de produtos locais. | atributo | String |
Sim |
productChannel |
O atributo do canal de vendas de um item de produto: Online ou Local. |
atributo | Product channel |
Sim |
productChannelExclusivity |
O atributo de exclusividade de canal de um item de produto. | atributo | Product channel exclusivity |
Sim |
productItemGroupId |
O atributo de código do grupo de itens de um item do produto. | atributo | String |
Sim |
productTitle |
O atributo título de um item de produto. | atributo | String |
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 |
floodlightGroup |
Segmenta o relatório por grupos do Floodlight. Cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada grupo do Floodlight. Essa coluna retorna o nome do grupo do Floodlight de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | String |
Sim |
floodlightGroupId |
Segmenta o relatório por grupos do Floodlight. Cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada grupo do Floodlight. Essa coluna retorna o código do grupo do DS de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | ID |
Sim |
floodlightGroupTag |
Segmenta o relatório por grupos do Floodlight. Cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada grupo do Floodlight. Essa coluna retorna a tag do grupo do Floodlight de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | String |
Sim |
floodlightActivity |
Segmenta o relatório por atividades do Floodlight. Cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada atividade do Floodlight. Essa coluna retorna o nome da atividade do Floodlight de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | String |
Sim |
floodlightActivityId |
Segmenta o relatório por atividades do Floodlight. Cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada atividade do Floodlight. Esta coluna retorna o ID da atividade do Floodlight do DS de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | ID |
Sim |
floodlightActivityTag |
Segmenta o relatório por atividades do Floodlight. Cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada atividade do Floodlight. Essa coluna retorna a tag de atividade do Floodlight de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | String |
Sim |
accountId |
ID da conta de mecanismo do DS. | segmentar | ID |
Sim |
campaignId |
Segmenta o relatório por campanha. Essa linha retorna o código da campanha do DS associado a ela. | segmentar | ID |
Sim |
adGroupId |
Segmenta o relatório por grupo de anúncios. Essa linha retorna o ID do grupo de anúncios associado a ela. | segmentar | ID |
Sim |