Métricas de desempenho e atributos de configuração para segmentações de produto. As segmentações de produto eram usadas por campanhas de PLA do Google Ads para especificar quais produtos de uma conta do Google Merchant Center deveriam acionar a exibição de anúncios da lista de produtos (anúncios do Shopping) em pesquisas relacionadas no Google. As segmentações de produtos e as campanhas de PLA foram substituídas pelas campanhas do Shopping do Google Ads. No DS, ainda é possível solicitar relatórios de métricas históricas que foram atribuídas às suas campanhas de PLA antes do upgrade para as campanhas do Shopping.
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": "productTarget".
{
...
"reportType": "productTarget",
"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 da segmentação do produto: Active, Paused ou Removed. As campanhas, os grupos de anúncios, as segmentações de produtos e os anúncios têm status próprios. Consulte o status. |
atributo | Status |
Sim |
engineStatus |
Status adicional da segmentação do produto 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 da segmentação do produto, formatado em ISO 8601. | atributo | Timestamp |
Sim |
lastModifiedTimestamp |
Carimbo de data/hora da modificação mais recente do destino de produto, 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 |
productTargetId |
ID do destino de produto do DS. | atributo | ID |
Sim |
productTargetFilter |
Filtra produtos em uma conta do Google Merchant Center com essa segmentação de produto. É possível especificar critérios de correspondência usando atributos como IDs de produtos, marca etc. | atributo | String |
Não |
productTargetEngineId |
Código da segmentação do produto na conta de mecanismo externo. | atributo | ID |
Sim |
productTargetLandingPage |
O valor que indica o URL final que um usuário visitaria depois de clicar no seu anúncio do Shopping. Consulte Páginas de destino dos anúncios do Shopping. | atributo | String |
Sim |
productTargetClickserverUrl |
O URL que o DS usa para rastrear a atividade. Um usuário que clica em um anúncio do Shopping visita primeiro o URL do servidor de cliques e depois é redirecionado para a página de destino final. Consulte Páginas de destino dos anúncios do Shopping. | atributo | String |
Sim |
productTargetLabels |
Nomes de rótulos atribuídos diretamente a esse destino de produto. e os rótulos herdados não são incluídos. | atributo | String list |
Sim |
productTargetMaxCpc |
Substitui o CPC máximo do grupo de anúncios e define um valor máximo que você deseja pagar se alguém clicar em um anúncio de produto para essa segmentação de produto específica. Se esse campo estiver vazio, a segmentação de produto usará o CPC máx. do grupo de anúncios. | atributo | Money |
Sim |
effectiveProductTargetMaxCpc |
O CPC (custo por clique máximo) máximo em vigor para essa segmentação de produto. 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 |
productTargetMaxBid |
Se essa segmentação de produto for gerenciada 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 às segmentações de produto. | atributo | Money |
Sim |
productTargetMinBid |
Se essa segmentação de produto for gerenciada 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 às segmentações de produto. | 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 esta segmentação de produto. | 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 |
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. Esta coluna retorna o código do grupo do Floodlight no 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. Esta coluna retorna a tag de 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 código de 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. Esta 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 |