Dados brutos de eventos sobre conversões.
Esse relatório só pode ser retornado por uma solicitação assíncrona (ou seja, por meio do método Reports.request()).
Como os eventos ocorrem em datas específicas, uma solicitação para esse relatório deve especificar um timeRange. É possível especificar uma das seguintes opções:
- startDate e endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp não é válido para eventos).
Trecho da solicitação
Envie uma
Reports.request()
corpo da solicitação, 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 de dispositivo a que a conversão é atribuída: Desktop, Mobile, Tablet ou Other. |
atributo | Device segment |
Sim |
floodlightGroup |
Nome do grupo do Floodlight. | atributo | String |
Sim |
floodlightGroupConversionType |
É o tipo de conversão gerada 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 de grupo do Floodlight. | atributo | String |
Sim |
floodlightActivity |
Nome da atividade do Floodlight. | atributo | String |
Sim |
floodlightActivityId |
ID da atividade do Floodlight no 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 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 |
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 grupos de produtos. Os IDs de grupos de produtos não devem ser usados para agrupamento. | 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 foi atribuído. | atributo | ID |
Sim |
isUnattributedAd |
Indica se as métricas nessa linha não podem ser atribuídas a um anúncio específico. Por exemplo, um anúncio com formato não compatí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 no feed de inventário que contém o produto associado a essa 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. Precisa corresponder aos IDs de loja usados no 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 gerado pelo Search Ads 360 para cada conversão. | atributo | ID |
Sim |
advertiserConversionId |
Em 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, é igual à coluna conversionId ou floodlightOrderId, dependendo das instruções do Floodlight do anunciante. | atributo | String |
Sim |
conversionType |
O tipo da 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 registrada pela conversão, conforme determinado pelo parâmetro qty. O anunciante é responsável por preencher o parâmetro de modo dinâmico (como o número de itens vendidos na conversão). Caso contrário, o padrão será 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 a 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 para 1o de maio. |
atributo | Date |
Sim |
conversionTimestamp |
É o carimbo de data/hora em UTC de quando a conversão ocorreu. | atributo | Timestamp |
Sim |
conversionLastModifiedTimestamp |
O carimbo de data/hora UTC da modificação mais recente da conversão. | atributo | Timestamp |
Sim |
conversionAttributionType |
A 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 exclusiva para a visita à qual a conversão é atribuída, que é transmitida para a página de destino como o parâmetro de URL gclid. Ativado apenas 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 original e inalterada associada ao evento do Floodlight (na moeda do relatório atual), antes das modificações na instrução de 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 ID do pedido do Floodlight fornecido pelo anunciante para a conversão. | atributo | String |
Sim |
feedItemId |
O ID da linha do item do feed associada a esta conversão. | atributo | ID |
Sim |
feedId |
O ID da tabela de feeds associada a esta conversão. | atributo | ID |
Sim |
feedType |
O tipo de feed associado a esta conversão. | atributo | Feed type |
Sim |