Tipo de relatório: conversão

Dados de eventos brutos 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:

Solicitar trecho

Envie um corpo de solicitação Reports.request() regular, 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ões geradas 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 DS Floodlight. 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 do 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 o 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 da palavra-chave do DS. Um valor de 0 indica que a palavra-chave não foi 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 de destino do produto do DS. atributo ID Sim
productGroupId O ID do grupo de produtos associado a essa 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 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 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 um formato não compatível ou um URL de 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 ID quando você vincula uma conta de inventário nele. 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. Em conversões on-line, ele é igual à coluna "conversionId" ou à coluna "floodlightOrderId", dependendo das instruções do Floodlight fornecidas pelo 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 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 1º de maio, ele conta todas as conversões de ação com conversionDate igual a 1º de maio. atributo Date Sim
conversionTimestamp O carimbo de data/hora UTC em que 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 da visita do DSA a que a conversão é atribuída. atributo ID Sim
conversionVisitTimestamp O carimbo de data/hora UTC da visita à qual a conversão é atribuída. atributo Timestamp Sim
conversionVisitExternalClickId Uma string única para a visita à qual a conversão é atribuída, que é transmitida para a página de destino como o parâmetro de URL gclid. Só é ativado 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 de referência 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 associado a essa conversão. atributo ID Sim
feedId O ID da tabela de feed associada a essa conversão. atributo ID Sim
feedType O tipo de feed associado a essa conversão. atributo Feed type Sim