Tipo de relatório: conversão

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:

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.

columnNameDescriçãoComportamentoTipoFiltrá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