Dados brutos de eventos sobre conversões.
Esse relatório só pode ser retornado por uma solicitação assíncrona (ou seja, pelo método Reports.request()).
Como os eventos ocorrem em datas específicas, uma solicitação para esse relatório precisa especificar um timeRange. É possível especificar uma das seguintes opções:
- startDate e endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp não é válido para eventos)
Trecho de solicitação
Envie um corpo de solicitação Reports.request(), mas especifique "reportType": "conversion".
{
...
"reportType": "conversion",
"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 conversão: Active ou Removed. |
atributo | Status |
Sim |
deviceSegment |
É o segmento do dispositivo atribuído à conversão: Desktop, Mobile, Tablet ou Other. |
atributo | Device segment |
Sim |
floodlightGroup |
Nome do grupo do Floodlight. | atributo | String |
Sim |
floodlightGroupConversionType |
É o tipo de conversão gerado pelas atividades do Floodlight neste grupo: Action ou Transaction. |
atributo | Conversion type |
Sim |
floodlightGroupId |
ID do grupo do Floodlight do DS. | atributo | ID |
Sim |
floodlightGroupTag |
Tag do grupo do Floodlight. | atributo | String |
Sim |
floodlightActivity |
Nome da atividade do Floodlight. | atributo | String |
Sim |
floodlightActivityId |
ID da atividade do Floodlight do DS. | atributo | ID |
Sim |
floodlightActivityTag |
Tag de atividade do Floodlight. | atributo | String |
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 |
keywordId |
ID de palavra-chave do DS Um valor de 0 indica que a palavra-chave não está atribuída. | atributo | ID |
Sim |
keywordMatchType |
Tipo de correspondência de palavra-chave: Broad, Exact, Phrase ou Content. |
atributo | Match type |
Sim |
keywordText |
O texto da palavra-chave. | atributo | String |
Sim |
productTargetId |
ID do destino de produto do DS. | atributo | ID |
Sim |
productGroupId |
O ID do grupo de produtos associado a esta conversão. Somente as conversões de campanhas do Shopping têm IDs de grupo de produtos. Os IDs dos grupos de produtos não devem ser usados para mesclagem. | atributo | ID |
Sim |
ad |
Nome do anúncio. | atributo | String |
Sim |
adId |
ID do anúncio do DS. Um valor de 0 indica que o anúncio não está atribuído. | atributo | ID |
Sim |
isUnattributedAd |
Indica se as métricas nessa linha não são atribuíveis a um anúncio específico. Por exemplo, um anúncio com um formato incompatível ou um URL do servidor de cliques incorreto pode impedir que o DS atribua métricas a um anúncio. | atributo | Boolean |
Sim |
inventoryAccountId |
O ID da conta de inventário do DS que contém o produto associado à conversão. O DS gera esse código quando você vincula uma conta de inventário no DS. | atributo | ID |
Sim |
productId |
O ID do produto associado a esta conversão. | atributo | String |
Sim |
productCountry |
É o país (formato ISO 3166) registrado para o feed de inventário que contém o produto associado à conversão. | atributo | String |
Sim |
productLanguage |
O idioma (ISO 639-1) do produto associado a essa conversão. | atributo | String |
Sim |
productStoreId |
A loja no anúncio de inventário local associado à conversão. Ele deve corresponder aos IDs de loja usados no seu feed de produtos locais. | atributo | String |
Sim |
productChannel |
O canal de vendas do produto associado à conversão: Online ou Local. |
atributo | Product channel |
Sim |
conversionId |
ID que o Search Ads 360 gera para cada conversão. | atributo | ID |
Sim |
advertiserConversionId |
No caso de conversões off-line, esse é um ID fornecido pelos anunciantes. Se um anunciante não especificar um ID, o Search Ads 360 vai gerar um. Para conversões on-line, isso é igual à coluna conversionId ou à coluna floodlightOrderId, dependendo das instruções do Floodlight do anunciante. | atributo | String |
Sim |
conversionType |
O tipo de conversão: Action ou Transaction. |
atributo | Conversion type |
Sim |
conversionRevenue |
É o valor total em dólares da conversão. | atributo | Money |
Sim |
conversionQuantity |
É a quantidade de itens registrados pela conversão, conforme determinado pelo parâmetro qty. O anunciante é responsável por preencher dinamicamente o parâmetro (como número de itens vendidos na conversão). Caso contrário, o padrão é 1. | atributo | Number |
Sim |
conversionDate |
É a data no fuso horário da rede do Campaign Manager em que a conversão ocorreu. Essa data é usada para agregação de métricas de conversão. Por exemplo, quando o DS agrega ações para 1o de maio, ele conta todas as conversões de ação com conversionDate como 1o de maio. |
atributo | Date |
Sim |
conversionTimestamp |
É o carimbo de data/hora em UTC quando a conversão ocorreu. | atributo | Timestamp |
Sim |
conversionLastModifiedTimestamp |
É o carimbo de data/hora em UTC da modificação mais recente da conversão. | atributo | Timestamp |
Sim |
conversionAttributionType |
O que a conversão é atribuída: Visit ou Keyword+Ad. |
atributo | Conversion attribution type |
Sim |
conversionVisitId |
O ID de visita do DS ao qual a conversão é atribuída. | atributo | ID |
Sim |
conversionVisitTimestamp |
É o carimbo de data/hora em UTC da visita a que a conversão é atribuída. | atributo | Timestamp |
Sim |
conversionVisitExternalClickId |
Uma string única, para a visita à qual a conversão foi atribuída, que foi transmitida para a página de destino como o parâmetro de URL gclid. Ativada somente para anunciantes com integração da API Conversion ou do Google Analytics. | atributo | String |
Sim |
conversionSearchTerm |
O termo de pesquisa que levou à conversão. | atributo | String |
Sim |
floodlightOriginalRevenue |
A receita inalterada original associada ao evento do Floodlight (na moeda do relatório atual) antes das modificações na instrução da moeda do Floodlight. | atributo | Money |
Sim |
floodlightEventRequestString |
É a string de solicitação do Floodlight da conversão. | atributo | String |
Sim |
floodlightReferrer |
É o site do referenciador do Floodlight da conversão. | atributo | String |
Sim |
floodlightOrderId |
É o código do pedido do Floodlight fornecido pelo anunciante para a conversão. | atributo | String |
Sim |
feedItemId |
O código da linha do item do feed associada a essa conversão. | atributo | ID |
Sim |
feedId |
O ID da tabela de feed associada a esta conversão. | atributo | ID |
Sim |
feedType |
É o tipo de feed associado a esta conversão. | atributo | Feed type |
Sim |