Ir para o conteúdo

Detalhes de Conexão do Google Ads

Introdução

Versão do conector

Esta documentação é baseada na versão 21.0.8361 do conector.

Começando

Suporte à versão do Google Ads

O conector fornece uma visualização relacional dos dados do Google Ads para sua conta do Google ou domínio do Google Apps. O conector inclui tabelas contendo dimensões e métricas usadas com frequência; além disso, você pode personalizar os esquemas de tabela ou escrever seus próprios para combinar qualquer conjunto válido de dimensões e métricas. O conector exibe as colunas disponíveis por meio da versão v201809 da API do AdWords.

Estabelecendo uma Conexão

Conectando-se ao Google Ads

Forneça as seguintes propriedades de conexão antes de adicionar as propriedades de autenticação.

  • DeveloperToken: Defina isso como o token de desenvolvedor da conta do AdWords. Você pode obter um token de desenvolvedor inscrevendo-se na API do AdWords. Para fazer isso, faça login no site do AdWords com sua conta da MCC e navegue até Configurações -> Configurações da conta -> Centro de API do Google AdWords. Inscreva-se para acesso à API e aguarde o Google entrar em contato com você por e-mail com mais instruções. Você deve receber um token com status pendente. Este token é apenas para teste e não permite que você se conecte a dados ativos. O Google deve entrar em contato com você para preencher um questionário e, assim que for recebido e aprovado pelo Google, você receberá seu token de desenvolvedor ativo.

  • ClientCustomerId: Defina como seu ID de cliente do Google Ads. Você pode encontrar o seu ClientCustomerId na parte inferior do menu de ajuda após clicar no ícone de ajuda no canto superior direito da IU do Google Ads.

    Observação: Esta propriedade de conexão é necessária apenas ao usar o 'AdWords' Schema.

Recuperando Dados de Várias Contas

Um uso comum para o driver é recuperar dados de vários IDs de clientes. Isso é útil quando você tem uma conta MCC do Google Ads que inclui várias contas/ClientCustomerIds. Você pode consultar e obter dados das contas que deseja especificando CustomerId na cláusula WHERE, por exemplo:

SELECT * FROM AdGroupAd WHERE CustomerId='3333333333'
SELECT * FROM AdGroupAd WHERE CustomerId IN ('1111111111', '2222222222')

O driver ignora o ClientCustomerId propriedade de conexão quando você especifica o CustomerId em cláusulas WHERE.

Autenticação no Google Ads

Todas as conexões com o Google Ads são autenticadas usando OAuth. O conector oferece suporte ao uso de contas de usuário, contas de serviço e contas de instância do GCP para autenticação.

Autenticar com uma Conta de Usuário

AuthScheme deve ser definido como OAuth em todos os fluxos da conta do usuário. Para aplicativos de desktop, o aplicativo padrão do conector é a maneira mais simples de autenticação. O único requisito adicional é definir InitiateOAuth para GETANDREFRESH.

Quando o driver for iniciado, ele abrirá um navegador e o Google Ads solicitará suas informações de login. O conector usará as credenciais que você fornecer para acessar seus dados do Google Ads. Essas credenciais serão salvas e atualizadas automaticamente conforme necessário.

Consulte Usando autenticação OAuth para obter um guia de autenticação que abrange todos os métodos suportados em detalhes.

Autenticar com uma Conta de Serviço

Para autenticar usando uma conta de serviço, você deve criar uma nova conta de serviço e ter uma cópia do certificado de contas.

Para um arquivo JSON, você precisará definir estas propriedades:

  • AuthScheme: Obrigatório. Defina isso como OAuthJWT.
  • InitiateOAuth: Obrigatório. Defina isso como GETANDREFRESH.
  • OAuthJWTCertType: Obrigatório. Defina isso como GOOGLEJSON.
  • OAuthJWTCert: Obrigatório. Defina isso como o caminho para o arquivo .json fornecido pelo Google.
  • OAuthJWTSubject: Obrigatório. A conta de serviço deve fazer parte de um domínio G Suite, com delegação habilitada. O valor desta propriedade deve ser o endereço e-mail do usuário cujos dados você deseja acessar.

Para um arquivo PFX, você precisará definir estas propriedades:

  • AuthScheme: Obrigatório. Defina isso como OAuthJWT.
  • InitiateOAuth: Obrigatório. Defina isso como GETANDREFRESH.
  • OAuthJWTCertType: Obrigatório. Defina isso como PFXFILE.
  • OAuthJWTCert: Obrigatório. Defina isso como o caminho para o arquivo .pfx fornecido pelo Google.
  • OAuthJWTCertPassword: Opcional. Defina isso como a senha do arquivo .pfx. Na maioria dos casos, isso precisará ser fornecido, pois o Google criptografa os certificados PFX.
  • OAuthJWTCertSubject: Opcional. Defina isso apenas se você estiver usando um OAuthJWTCertType que armazena vários certificados. Não deve ser definido para certificados PFX gerados pelo Google.
  • OAuthJWTIssuer: Obrigatório. Defina isso como o endereço e-mail da conta de serviço. Este endereço geralmente incluirá o domínio iam.gserviceaccount.com.
  • OAuthJWTSubject: Obrigatório. A conta de serviço deve fazer parte de um domínio G Suite, com delegação habilitada. O valor desta propriedade deve ser o endereço e-mail do usuário cujos dados você deseja acessar.

Se você ainda não tiver uma conta de serviço, poderá criar uma seguindo o procedimento em Criando um aplicativo OAuth personalizado.

Autenticar com uma Conta de Instância do GCP

Ao executar em uma máquina virtual GCP, o conector pode autenticar usando uma conta de serviço vinculada à máquina virtual. Para usar este modo, defina AuthScheme para GCPInstanceAccount.

Usando Autenticação OAuth

Use o padrão de autenticação OAuth para se conectar ao Google Ads. Você pode autenticar com uma conta de usuário ou uma conta de serviço. O conector facilita isso conforme descrito abaixo.

Usando uma Conta de Usuário para Autenticar no Google Ads

O fluxo da conta do usuário exige que o usuário autenticado interaja com o Google Ads por meio do navegador.

Credenciais Personalizadas

Quando Criar um Aplicativo OAuth Personalizado

Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem login no endpoint OAuth do Google Ads para conceder permissões ao conector.

Usando uma Conta de Serviço para Se Conectar ao Google Ads

As contas de serviço têm autenticação silenciosa, sem autenticação do usuário no navegador. Você também pode usar uma conta de serviço para delegar escopos de acesso em toda a empresa ao conector.

Você precisa criar um aplicativo OAuth neste fluxo. Você pode se conectar aos dados do Google Ads que a conta de serviço tem permissão para acessar. Consulte Credenciais personalizadas para obter um guia de autenticação.

Criando um Aplicativo OAuth Personalizado

Consulte Criando um aplicativo OAuth personalizado para um procedimento.

Credenciais Personalizadas

Você pode usar um aplicativo OAuth personalizado para autenticar com uma conta de serviço ou uma conta de usuário. Consulte Usando autenticação OAuth Para maiores informações.

Autenticar com uma Conta de Usuário
Autenticação de Desktop com um Aplicativo OAuth Personalizado

Siga as etapas abaixo para autenticar com as credenciais de um aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado.

Obtenha e atualize o token de acesso OAuth

Depois de definir o seguinte, você está pronto para se conectar:

  • OAuthClientId: Defina isso para o ID do cliente atribuído quando você registrou seu aplicativo.
  • OAuthClientSecret: Defina isso para o segredo do cliente atribuído quando você registrou seu aplicativo.
  • InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.
  • DeveloperToken: Defina isso como o token de desenvolvedor da conta do AdWords. Você pode obter um token de desenvolvedor inscrevendo-se na API do AdWords. Para fazer isso, faça login no site do AdWords com sua conta da MCC e navegue até Configurações -> Configurações da conta -> Centro de API do Google AdWords. Inscreva-se para acesso à API e aguarde o Google entrar em contato com você por e-mail com mais instruções. Você deve receber um token com status pendente. Este token é apenas para teste e não permite que você se conecte a dados ativos. O Google deve entrar em contato com você para preencher um questionário e, assim que for recebido e aprovado pelo Google, você receberá seu token de desenvolvedor ativo.
  • ClientCustomerId: defina como o ID de cliente da conta do AdWords. Você pode encontrar esse valor em sua conta do AdWords. Esse valor não é igual ao ID da conta MCC. Você precisa fornecer os IDs de nível mais baixo para recuperar dados.

Quando você conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo OAuth:

  1. Extrai o token de acesso da URL de retorno de chamada e autentica as solicitações.
  2. Atualiza o token de acesso quando ele expira.
  3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.
Autenticar com uma Conta de Serviço

As contas de serviço têm autenticação silenciosa, sem autenticação do usuário no navegador. Você também pode usar uma conta de serviço para delegar escopos de acesso em toda a empresa ao conector.

Você precisa criar um aplicativo OAuth neste fluxo. Consulte Criando um aplicativo OAuth personalizado para criar e autorizar um aplicativo. Você pode se conectar aos dados do Google Ads que a conta de serviço tem permissão para acessar.

Depois de definir as seguintes propriedades de conexão, você está pronto para se conectar:

  • InitiateOAuth: Defina como GETANDREFRESH.
  • OAuthJWTCertType: Defina como "PFXFILE".
  • OAuthJWTCert: Defina isso como o caminho para o arquivo .p12 que você gerou.
  • OAuthJWTCertPassword: Defina isso como a senha do arquivo .pem.
  • OAuthJWTCertSubject: Defina como "*" para escolher o primeiro certificado no armazenamento de certificados.
  • OAuthJWTIssuer: Na seção de contas de serviço, clique em Gerenciar contas de serviço e defina este campo para o endereço de e-mail exibido no campo ID da conta de serviço.
  • OAuthJWTSubject: Defina como o endereço e-mail do usuário para quem o aplicativo está solicitando acesso delegado. Observe que o acesso delegado deve ser concedido por um administrador.
  • DeveloperToken: Defina isso como o token de desenvolvedor da conta do AdWords. Você pode obter um token de desenvolvedor inscrevendo-se na API do AdWords. Para fazer isso, faça login no site do AdWords com sua conta da MCC e navegue até Configurações -> Configurações da conta -> Centro de API do Google AdWords. Inscreva-se para acesso à API e aguarde o Google entrar em contato com você por e-mail com mais instruções. Você deve receber um token com status pendente. Este token é apenas para teste e não permite que você se conecte a dados ativos. O Google deve entrar em contato com você para preencher um questionário e, assim que for recebido e aprovado pelo Google, você receberá seu token de desenvolvedor ativo.
  • ClientCustomerId: defina como o ID de cliente da conta do AdWords. Você pode encontrar esse valor em sua conta do AdWords. Esse valor não é igual ao ID da conta MCC. Você precisa fornecer os IDs de nível mais baixo para recuperar dados.

Quando você conecta, o conector conclui o fluxo OAuth para uma conta de serviço.

  1. Cria e assina o JWT com o conjunto de declarações exigido pelo conector.
  2. Troca o JWT pelo token de acesso.
  3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.
  4. Envia o JWT para um novo token de acesso quando o token expira.

Máquinas Sem Cabeça

Usando OAuth em uma Máquina Sem Periféricos

As seções a seguir mostram como autenticar um servidor headless ou outra máquina na qual o conector não pode abrir um navegador. Você pode autenticar com uma conta de usuário ou com uma conta de serviço.

Autenticar com uma Conta de Usuário

Para autenticar com uma conta de usuário, você precisa autenticar de outra máquina. A autenticação é um processo de duas etapas.

  1. Ao invés de instalar o conector em outra máquina, você pode seguir os passos abaixo para obter o OAuthVerifier valor. Ou você pode instalar o conector em outra máquina e transferir os valores de autenticação OAuth, depois de autenticar por meio do fluxo normal baseado em navegador.
  2. Em seguida, você pode configurar o conector para atualizar automaticamente o token de acesso da máquina sem periféricos.

Você pode seguir o fluxo de autenticação OAuth headless usando as credenciais OAuth para seu aplicativo OAuth personalizado.

Usando as Credenciais para um Aplicativo OAuth Personalizado

Crie um aplicativo OAuth personalizado

Consulte Criando um aplicativo OAuth personalizado para um procedimento. Você pode seguir os procedimentos abaixo para autenticar e conectar-se aos dados.

Obtenha um código verificador

Defina as seguintes propriedades na máquina sem periféricos:

  • InitiateOAuth: Defina como DESLIGADO.
  • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
  • OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
  • DeveloperToken: Defina isso como o token de desenvolvedor da conta do AdWords. Você pode obter um token de desenvolvedor inscrevendo-se na API do AdWords. Para fazer isso, faça login no site do AdWords com sua conta da MCC e navegue até Configurações -> Configurações da conta -> Centro de API do Google AdWords. Inscreva-se para acesso à API e aguarde o Google entrar em contato com você por e-mail com mais instruções. Você deve receber um token com status pendente. Este token é apenas para teste e não permite que você se conecte a dados ativos. O Google deve entrar em contato com você para preencher um questionário e, assim que for recebido e aprovado pelo Google, você receberá seu token de desenvolvedor ativo.
  • ClientCustomerId: defina como o ID de cliente da conta do AdWords. Você pode encontrar esse valor em sua conta do AdWords. Esse valor não é igual ao ID da conta MCC. Você precisa fornecer os IDs de nível mais baixo para recuperar dados.

Você pode seguir as etapas abaixo para autenticar em outra máquina e obter o OAuthVerifier propriedade de conexão.

  1. Chame o GetOAuthAuthorizationURL procedimento armazenado* com o parâmetro de entrada CallbackURL definido para o URI de redirecionamento exato que você especificou nas configurações do aplicativo.
  2. Abra o URL retornado em um navegador. Faça login e conceda permissões ao conector. Você será redirecionado para o URL de retorno de chamada, que contém o código do verificador.
  3. Salve o valor do código do verificador. Você definirá isso no OAuthVerifier propriedade de conexão.

Na máquina sem periféricos, defina as seguintes propriedades de conexão para obter os valores de autenticação OAuth:

  • OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
  • OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
  • OAuthVerifier: Defina isso para o código do verificador.
  • OAuthSettingsLocation: Defina para manter os valores de autenticação OAuth criptografados no arquivo especificado.
  • InitiateOAuth: Configure para ATUALIZAR.
  • DeveloperToken: Defina isso como o token de desenvolvedor da conta do AdWords. Você pode obter um token de desenvolvedor inscrevendo-se na API do AdWords. Para fazer isso, faça login no site do AdWords com sua conta da MCC e navegue até Configurações -> Configurações da conta -> Centro de API do Google AdWords. Inscreva-se para acesso à API e aguarde o Google entrar em contato com você por e-mail com mais instruções. Você deve receber um token com status pendente. Este token é apenas para teste e não permite que você se conecte a dados ativos. O Google deve entrar em contato com você para preencher um questionário e, assim que for recebido e aprovado pelo Google, você receberá seu token de desenvolvedor ativo.
  • ClientCustomerId: defina como o ID de cliente da conta do AdWords. Você pode encontrar esse valor em sua conta do AdWords. Esse valor não é igual ao ID da conta MCC. Você precisa fornecer os IDs de nível mais baixo para recuperar dados.

Depois que o arquivo de configurações OAuth for gerado, defina as seguintes propriedades para se conectar aos dados:

  • OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
  • OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
  • OAuthSettingsLocation: Defina isso para o arquivo que contém os valores de autenticação OAuth criptografados. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao provedor para ativar a atualização automática do token de acesso.
  • InitiateOAuth: Configure para ATUALIZAR.
  • DeveloperToken: Defina isso como o token de desenvolvedor da conta do AdWords. Você pode obter um token de desenvolvedor inscrevendo-se na API do AdWords. Para fazer isso, faça login no site do AdWords com sua conta da MCC e navegue até Configurações -> Configurações da conta -> Centro de API do Google AdWords. Inscreva-se para acesso à API e aguarde o Google entrar em contato com você por e-mail com mais instruções. Você deve receber um token com status pendente. Este token é apenas para teste e não permite que você se conecte a dados ativos. O Google deve entrar em contato com você para preencher um questionário e, assim que for recebido e aprovado pelo Google, você receberá seu token de desenvolvedor ativo.
  • ClientCustomerId: defina como o ID de cliente da conta do AdWords. Você pode encontrar esse valor em sua conta do AdWords. Esse valor não é igual ao ID da conta MCC. Você precisa fornecer os IDs de nível mais baixo para recuperar dados.

Configurações de transferência OAuth

Siga as etapas abaixo para instalar o conector em outra máquina, autenticar e depois transferir os valores OAuth resultantes.

Em uma segunda máquina, instale o conector e conecte-se com o seguinte conjunto de propriedades:

  • OAuthSettingsLocation: Defina isso como um arquivo de texto gravável.
  • InitiateOAuth: Defina como GETANDREFRESH.
  • OAuthClientId: Defina isso para o ID do cliente atribuído quando você registrou seu aplicativo.
  • OAuthClientSecret: Defina isso como o segredo do cliente atribuído quando você registrou seu aplicativo.
  • DeveloperToken: Defina isso como o token de desenvolvedor da conta do AdWords. Você pode obter um token de desenvolvedor inscrevendo-se na API do AdWords. Para fazer isso, faça login no site do AdWords com sua conta da MCC e navegue até Configurações -> Configurações da conta -> Centro de API do Google AdWords. Inscreva-se para acesso à API e aguarde o Google entrar em contato com você por e-mail com mais instruções. Você deve receber um token com status pendente. Este token é apenas para teste e não permite que você se conecte a dados ativos. O Google deve entrar em contato com você para preencher um questionário e, assim que for recebido e aprovado pelo Google, você receberá seu token de desenvolvedor ativo.
  • ClientCustomerId: defina como o ID de cliente da conta do AdWords. Você pode encontrar esse valor em sua conta do AdWords. Esse valor não é igual ao ID da conta MCC. Você precisa fornecer os IDs de nível mais baixo para recuperar dados.

Teste a conexão para autenticar. Os valores de autenticação resultantes são gravados, criptografados, no caminho especificado por OAuthSettingsLocation. Depois de testar a conexão com sucesso, copie o arquivo de configurações OAuth para sua máquina sem periféricos. Na máquina sem periféricos, defina as seguintes propriedades de conexão para se conectar aos dados:

  • InitiateOAuth: Configure para ATUALIZAR.
  • OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
  • OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
  • OAuthSettingsLocation: Defina isso como o caminho para o arquivo de configurações OAuth. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.
  • DeveloperToken: Defina isso como o token de desenvolvedor da conta do AdWords. Você pode obter um token de desenvolvedor inscrevendo-se na API do AdWords. Para fazer isso, faça login no site do AdWords com sua conta da MCC e navegue até Configurações -> Configurações da conta -> Centro de API do Google AdWords. Inscreva-se para acesso à API e aguarde o Google entrar em contato com você por e-mail com mais instruções. Você deve receber um token com status pendente. Este token é apenas para teste e não permite que você se conecte a dados ativos. O Google deve entrar em contato com você para preencher um questionário e, assim que for recebido e aprovado pelo Google, você receberá seu token de desenvolvedor ativo.
  • ClientCustomerId: defina como o ID de cliente da conta do AdWords. Você pode encontrar esse valor em sua conta do AdWords. Esse valor não é igual ao ID da conta MCC. Você precisa fornecer os IDs de nível mais baixo para recuperar dados.
Autenticar com uma Conta de Serviço

As contas de serviço têm autenticação silenciosa, sem autenticação do usuário no navegador. Você também pode usar uma conta de serviço para delegar escopos de acesso em toda a empresa ao conector.

Você precisa criar um aplicativo OAuth neste fluxo. Consulte Criando um aplicativo OAuth personalizado para criar e autorizar um aplicativo. Você pode se conectar aos dados do Google Ads que a conta de serviço tem permissão para acessar.

Depois de definir as seguintes propriedades de conexão, você está pronto para se conectar:

  • InitiateOAuth: Defina como GETANDREFRESH.
  • OAuthJWTCertType: Defina como "PFXFILE".
  • OAuthJWTCert: Defina isso como o caminho para o arquivo .p12 que você gerou.
  • OAuthJWTCertPassword: Defina isso como a senha do arquivo .pem.
  • OAuthJWTCertSubject: Defina como "*" para escolher o primeiro certificado no armazenamento de certificados.
  • OAuthJWTIssuer: Na seção de contas de serviço, clique em Gerenciar contas de serviço e defina este campo para o endereço de e-mail exibido no campo ID da conta de serviço.
  • OAuthJWTSubject: Defina como o endereço e-mail do usuário para quem o aplicativo está solicitando acesso delegado. Observe que o acesso delegado deve ser concedido por um administrador.
  • DeveloperToken: Defina isso como o token de desenvolvedor da conta do AdWords. Você pode obter um token de desenvolvedor inscrevendo-se na API do AdWords. Para fazer isso, faça login no site do AdWords com sua conta da MCC e navegue até Configurações -> Configurações da conta -> Centro de API do Google AdWords. Inscreva-se para acesso à API e aguarde o Google entrar em contato com você por e-mail com mais instruções. Você deve receber um token com status pendente. Este token é apenas para teste e não permite que você se conecte a dados ativos. O Google deve entrar em contato com você para preencher um questionário e, assim que for recebido e aprovado pelo Google, você receberá seu token de desenvolvedor ativo.
  • ClientCustomerId: defina como o ID de cliente da conta do AdWords. Você pode encontrar esse valor em sua conta do AdWords. Esse valor não é igual ao ID da conta MCC. Você precisa fornecer os IDs de nível mais baixo para recuperar dados.

Quando você conecta, o conector conclui o fluxo OAuth para uma conta de serviço.

  1. Cria e assina o JWT com o conjunto de declarações exigido pelo conector.
  2. Troca o JWT pelo token de acesso.
  3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.
  4. Envia o JWT para um novo token de acesso quando o token expira.

Criando um Aplicativo OAuth Personalizado

Você pode usar um aplicativo OAuth personalizado para autenticar uma conta de serviço ou uma conta de usuário. Consulte Usando autenticação OAuth Para maiores informações.

Crie um Aplicativo OAuth para Autenticação de Conta de Usuário

Siga o procedimento abaixo para registrar um aplicativo e obter o OAuthClientId e OAuthClientSecret.

Crie um Aplicativo OAuth Personalizado: Área de Trabalho
  1. Faça login no Google API Console e abra um projeto. Selecione o API Manager no menu principal.
  2. Clique em Credenciais -> Criar credenciais -> ID do cliente OAuth. Clique em Outro.
Crie um Aplicativo OAuth para Autenticação de Conta de Serviço

Siga as etapas abaixo para criar um aplicativo OAuth e gerar uma chave privada. Em seguida, você autorizará a conta de serviço.

  1. Faça login no Google API Console e abra um projeto. Selecione o API Manager no menu principal.
  2. Clique em Criar credenciais -> Chave da conta de serviço.
  3. No menu Conta de serviço, selecione Nova conta de serviço ou selecione uma conta de serviço existente.
  4. Se estiver criando uma nova conta de serviço, selecione adicionalmente uma ou mais funções. Você pode atribuir funções primitivas no nível do projeto na seção IAM e Admin; outras funções permitem que você personalize ainda mais o acesso às APIs do Google.
  5. Na seção Tipo de chave, selecione o tipo de chave P12.
  6. Crie o aplicativo para baixar o par de chaves. A senha da chave privada é exibida: Defina isso em OAuthJWTCertPassword.
  7. Na seção de contas de serviço, clique em Gerenciar contas de serviço e defina OAuthJWTIssuer para o endereço e-mail exibido no campo ID da conta de serviço.

Recuperando Dados do Google AdWords

Os dados do Google AdWords são organizados em várias métricas (por exemplo, Conversões, Impressões e Cliques Inválidos), que podem ser agrupados por vários segmentos (por exemplo, Data e Dispositivo). Além disso, existem atributos que representam dados fixos ou configurações de conta (por exemplo, CampaignName, AdType e AdGroupStatus). Estes são chamados de Comportamento para o campo. Existem muitas combinações válidas de métricas, segmentos e atributos. O conector exibe cada tipo de relatório separado no Google AdWords como uma tabela.

Selecionando Dados

Ao contrário da maioria das tabelas de banco de dados, não é muito útil selecionar todas as métricas, segmentos e atributos em uma determinada tabela. Em alguns casos, nem é possível fazer isso, pois alguns dados entram em conflito entre si quando selecionados. Como resultado, o conector interpreta a consultar SELECT * para significar que um conjunto padrão de métricas, segmentos e atributos são solicitados. Isso inclui consultas que selecionam explicitamente todas as colunas para contabilizar ferramentas que usam projeção ao retornar resultados. Esses campos padrão representam as colunas padrão expostas por meio do console do Google AdWords. Para selecionar colunas não padrão, simplesmente selecione explicitamente essas colunas na consultar em vez de emitir uma consultar SELECT *. Por fim, é importante observar que pelo menos uma métrica deve ser incluída na solicitação para que qualquer dado seja retornado.

Por padrão, os nomes das colunas são os valores usados pela API.

Outras Considerações

Certos campos de porcentagem podem retornar os valores '< 10%' ou '> 90%'. Para permitir que você use esta coluna como um campo numérico, esses valores são relatados exatamente como '10' e '90', respectivamente.

Acesso a Dados de Ajuste Fino

Selecionando a Versão da API

A Google Ads API adere a um cronograma de descontinuação de aproximadamente a cada 10 meses.
Para compatibilidade com versões anteriores, o conector mantém APIs que foram obsoletas, mas não obsoletas; se seu aplicativo requer uma API obsoleta, você pode configurá-la no Schema propriedade.

Acesso a Dados de Ajuste Fino

Você pode usar as seguintes propriedades para obter maior controle sobre os recursos da Google Ads API e as estratégias que o conector usa para exibi-los:

  • IncludeZeroImpressions: Esta propriedade controla se os registros com zero impressões são incluídos nos relatórios.

Anotações Importantes

Procedimentos Armazenados

  • Os recursos de procedimentos armazenados descritos nesta documentação não são suportados no momento.
  • Como os procedimentos armazenados não são suportados atualmente, qualquer recurso dependente de procedimentos armazenados também não é suportado atualmente.

Arquivos de Configuração e Seus Caminhos

  • Todas as referências para adicionar arquivos de configuração e seus caminhos referem-se a arquivos e locais no Harmony Agente onde o conector está instalado. Esses caminhos devem ser ajustados conforme apropriado, dependendo do agente e do sistema operacional. Se vários agentes forem usados em um grupo de agentes, arquivos idênticos serão necessários em cada agente.

Características Avançadas

Esta seção detalha uma seleção de recursos avançados do conector do Google Ads.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visões definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Configuração SSL

Use Configuração SSL para ajustar como o conector lida com as negociações de certificado TLS/SSL. Você pode escolher entre vários formatos de certificado; Veja o SSLServerCert propriedade em "Opções de cadeia de conexão" para obter mais informações.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Visualizações Definidas pelo Usuário

O Jitterbit Connector for Google Ads permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

  • Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
  • declarações DDL.

Definindo Visualizações Usando um Arquivo de Configuração

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

  • Cada elemento raiz define o nome de uma exibição.
  • Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a visualização.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM CampaignPerformance WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Exibições Definidas pelo Usuário

As visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com Exibições Definidas pelo Usuário

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Resultando na consultar efetiva à fonte:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões muito mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Configuração SSL

Personalizando a Configuração SSL

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema.

Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis para fazê-lo.

Modelo de Dados

O Jitterbit Connector for Google Ads oferece suporte a dois esquemas distintos.

Modelo de dados do AdWords

Consulte Modelo de dados do Google AdWords.

Google Ads

Consulte Modelo de dados do Google Ads.

Modelo de Dados do AdWords

O Jitterbit Connector for Google Ads modela entidades do Google Ads em exibições relacionais e procedimentos armazenados. As visualizações fornecidas darão a você acesso aos dados do relatório do Google AdWords usando v201809 da API de relatórios do Google AdWords.

Visualizações

Visualizações são tabelas que não podem ser modificadas. Normalmente, os dados que são somente leitura e não podem ser atualizados são mostrados como exibições. Além disso, as limitações e os requisitos da API estão documentados nesta seção.

Procedimentos Armazenados

NOTE: Procedimentos armazenados não são suportados atualmente. Veja a nota para detalhes.

Procedimentos armazenados são interfaces semelhantes a funções para a fonte de dados. Eles podem ser usados para pesquisar, atualizar e modificar informações na fonte de dados.

Visualizações

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto. Para saber mais sobre tabelas e procedimentos armazenados, navegue até as entradas correspondentes neste documento de ajuda.

Conector Jitterbit para Visualizações de Google Ads
Nome Descrição
AccountPerformance O relatório Desempenho da conta inclui todas as estatísticas agregadas por padrão no nível da conta, uma linha por conta.
AdCustomizersFeedItem O relatório Item de feed de personalizadores de anúncios fornece estatísticas para itens de feed usados em Personalizadores de anúncios. As estatísticas são agregadas no nível do item de feed, uma linha por item de feed.
AdGroupBidLandscape Representa dados sobre um bidlandscape para um grupo de anúncios.
AdgroupPerformance O Relatório de desempenho do grupo de anúncios inclui todas as estatísticas agregadas por padrão no nível do grupo de anúncios, uma linha por grupo de anúncios.
AdGroups Serviço para acessar detalhes sobre quaisquer grupos de anúncios.
AdPerformance O relatório de desempenho do anúncio inclui todas as estatísticas agregadas no nível do anúncio, uma linha por anúncio.
AgeRangePerformance O relatório de desempenho por faixa etária inclui todas as estatísticas da rede de exibição agregadas por faixa etária. Ele também inclui desempenho de público automático.
AudiencePerformance O relatório de desempenho do público inclui dados de desempenho de interesses e listas de remarketing para anúncios gráficos e listas de remarketing para anúncios de pesquisa (RLSA), agregados no nível do público - uma linha por público.
AutomaticPlacementsPerformance O relatório Desempenho de canais automáticos inclui todas as estatísticas agregadas no nível do canal, uma linha por canal.
BidGoalPerformance O Relatório de desempenho da meta de lances inclui estatísticas para suas estratégias de lances.
BudgetPerformance O relatório de desempenho do orçamento inclui todas as estatísticas agregadas por padrão no nível do orçamento, uma linha por orçamento.
CallMetricsCallDetails O relatório Call Metrics Call Details inclui detalhes da chamada para sua extensão de chamada, incluindo a duração da chamada e o código de área do chamador.
CampaignAdScheduleTarget O relatório Alvo de programação de anúncios da campanha resume o desempenho de campanhas por critérios AdSchedule.
CampaignCriteria O relatório Critérios de campanha é um relatório de estrutura que permite recuperar critérios em nível de campanha com eficiência.
CampaignCriterionBidLandscape O cenário de lances para um critério. Um cenário de lances estima o desempenho de um critério com base em diferentes valores de lances.
CampaignGroupPerformance O relatório Desempenho do Grupo de Campanhas inclui as estatísticas de desempenho geral das campanhas que você incluiu nos grupos de campanhas. As estatísticas são agregadas por padrão no nível do grupo de campanha.
CampaignLocationTarget O relatório de segmentação por local da campanha resume o desempenho de campanhas por critério de campanha baseado em local.
CampaignNegativeKeywordsPerformance Embora as palavras-chave negativas não contenham estatísticas, você pode usar este relatório estruturado para recuperar com eficiência atributos de objetos NegativeCampaignCriterion baseados em palavras-chave.
CampaignNegativeLocations Embora os locais negativos não contenham estatísticas, você pode usar este relatório estruturado para recuperar com eficiência atributos de objetos NegativeCampaignCriterion baseados em local.
CampaignNegativePlacementsPerformance Embora as veiculações negativas não contenham estatísticas, você pode usar este relatório estruturado para recuperar com eficiência atributos de objetos NegativeCampaignCriterion baseados em veiculações.
CampaignPerformance O relatório Desempenho das campanhas inclui todas as estatísticas agregadas por padrão no nível da campanha, uma linha por campanha.
Campaigns Serviço para acessar detalhes sobre qualquer campanha.
CampaignSharedSet O relatório Conjunto compartilhado de campanha inclui todos os relacionamentos entre SharedSets e campanhas.
ClickPerformance O relatório de desempenho do clique inclui estatísticas agregadas em cada nível de clique e inclui cliques válidos e inválidos. O campo KeywordId retornará todos os critérios que acionaram o clique, não apenas palavras-chave.
ConversionTrackers Serviço para acessar detalhes sobre qualquer rastreador de conversão.
CreativeConversion Cliques gratuitos são interações que ocorrem antes de um clique para anúncios em vídeo, anúncios gráficos, extensões de produto e extensões de local, interações como uma reprodução de vídeo ou obter direções.
CriteriaPerformance O Relatório de desempenho de critérios inclui estatísticas agregadas no nível dos critérios do grupo de anúncios, uma linha por grupo de anúncios e combinação de critérios.
CriterionBidLandscape O cenário de lances para um critério. Um cenário de lances estima o desempenho de um critério com base em diferentes valores de lances.
Customers Serviço para acessar detalhes básicos sobre qualquer cliente.
DisplayKeywordPerformance O relatório de desempenho da palavra-chave da Rede de Display inclui todas as estatísticas da rede de exibição agregadas no nível da palavra-chave, uma linha por palavra-chave.
DisplayTopicsPerformance O relatório de desempenho de tópicos de exibição inclui todas as estatísticas da rede de exibição agregadas no nível do tópico, uma linha por tópico.
FinalUrl O relatório de URL final inclui todas as estatísticas agregadas no nível do URL final, uma linha por URL final. Se outros campos de segmento forem usados, você poderá obter mais de uma linha por URL final.
GenderPerformance O relatório de desempenho de gênero inclui todas as estatísticas agregadas por gênero. Ele também inclui desempenho de público automático.
GeoPerformance O relatório de desempenho geográfico inclui todas as estatísticas agregadas no nível do país/território, uma linha por país/território.
KeywordlessCategory O Relatório de desempenho de categoria sem palavra-chave inclui estatísticas de anúncios sem palavra-chave (anúncios dinâmicos de pesquisa) agregadas por categoria.
KeywordlessQuery O relatório Consulta sem palavras-chave inclui estatísticas de anúncios sem palavras-chave (anúncios de pesquisa dinâmicos) com base em termos de pesquisa.
KeywordsPerformance O Relatório de desempenho das palavras-chave inclui todas as estatísticas agregadas no nível da palavra-chave, uma linha por palavra-chave.
Label O relatório Rótulo é um relatório de estrutura que lista todos os rótulos da sua conta.
LandingPage O relatório da página de destino inclui todas as estatísticas agregadas por padrão pelo UnexpandedFinalUrlString, uma linha por string de URL.
LocationCriterion Representa dados que encapsulam um critério de localização.
ManagedCustomers Serviço para acessar detalhes básicos sobre qualquer cliente.
ManagedCustomersLinks Serviço para acessar detalhes básicos sobre quaisquer links de clientes.
MarketplacePerformance O relatório de Desempenho do Marketplace inclui todas as estatísticas de anúncios exibidos no Marketplace, agregadas por padrão no nível da conta.
PaidOrganicQuery O relatório Consulta paga e orgânica fornece uma visão holística de suas estatísticas de pesquisa em anúncios e listagens orgânicas no nível da consultar. Isso permite que você analise os pontos fortes e as lacunas em sua presença geral na pesquisa e fornece informações sobre como suas listagens de pesquisa paga e orgânica funcionam juntas para conectar sua empresa às pessoas que pesquisam no Google.
ParentalStatusPerformance O relatório Desempenho do status parental inclui estatísticas agregadas no nível do status parental, uma linha por status parental
Placeholder O relatório de espaço reservado fornece estatísticas para extensões de anúncio baseadas em feed, uma linha por tipo de espaço reservado.
PlaceholderFeedItem O relatório de item de feed de espaço reservado inclui todas as estatísticas no nível do item de feed (por exemplo, um único sitelink).
PlacementPerformance O Relatório de desempenho de veiculações inclui todas as estatísticas agregadas no nível da veiculação, uma linha por veiculação.
ProductPartition O relatório Partição de produto fornece estatísticas de campanha de compras agregadas no nível de partição de produto (campo Id).
SearchQueryPerformance O relatório de termos de pesquisa inclui todas as estatísticas agregadas no nível dos termos de pesquisa, uma linha por combinação de termos de pesquisa.
SharedSet O relatório Conjunto compartilhado inclui todos os Conjuntos compartilhados que podem ser compartilhados entre campanhas.
SharedSetCriteria O relatório Shared Set Criteria inclui critérios para cada SharedSet.
ShoppingPerformance O relatório Desempenho de compras fornece estatísticas de campanha de compras agregadas no nível do produto (campo OfferId).
TopContentPerformance Recupera os dados do relatório TopContentPerformance.
UrlPerformance O relatório de desempenho da URL inclui todas as estatísticas agregadas na URL e no nível do critério.
UserAdDistance O Relatório de distância do anúncio do usuário fornece estatísticas agregadas pela distância do usuário de suas extensões de local.
VideoPerformance O Relatório de desempenho de vídeo inclui estatísticas das campanhas atualizadas do AdWords para vídeo de sua conta.
Desempenho da Conta

O relatório Desempenho da conta inclui todas as estatísticas agregadas por padrão no nível da conta, uma linha por conta.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório AccountPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório AccountPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório AccountPerformance.
CanManageClients Boolean Atributo Pode Gerenciar Clientes Pode gerenciar clientes para o relatório AccountPerformance.
ConversionAdjustment Boolean Atributo Ajuste de conversão Ajuste de conversão para o relatório AccountPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório AccountPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório AccountPerformance.
IsAutoTaggingEnabled Boolean Atributo Marcação automática habilitada Marcação automática habilitada para o relatório AccountPerformance.
IsTestAccount Boolean Atributo Conta de teste Conta de teste para o relatório AccountPerformance.
AdNetworkType1 String Segmento Rede Rede para o relatório AccountPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório AccountPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório AccountPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionAdjustmentLagBucket String Segmento Dias Para Conversão Ou Ajuste Dias para conversão ou ajuste para o relatório AccountPerformance. Os valores permitidos são UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_ 9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAY S, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CON VERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório AccountPerformance.
ConversionLagBucket String Segmento Dias Para Conversão Dias até a conversão para o relatório AccountPerformance. Os valores permitidos são UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_ 9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório AccountPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório AccountPerformance.
Date Date Segmento Dia Dia para o relatório AccountPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório AccountPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório AccountPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório AccountPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
HourOfDay Integer Segmento Hora do dia Hora do dia para o relatório AccountPerformance.
Month String Segmento Mês Mês para o relatório AccountPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório AccountPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório AccountPerformance.
Slot String Segmento Top Vs Outro Top Vs Other para o relatório AccountPerformance. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segmento Semana Semana para o relatório AccountPerformance.
Year Integer Segmento Ano Ano para o relatório AccountPerformance.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório AccountPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório AccountPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório AccountPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impressões por impr mensuráveis do Active View para o relatório AccountPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório AccountPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressão mensurável do Active View para o relatório AccountPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório AccountPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório AccountPerformance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório AccountPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todo o valor de conv para o relatório AccountPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório AccountPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório AccountPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório AccountPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório AccountPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório AccountPerformance.
AveragePosition Double Métrica Posição Média Posição média para o relatório AccountPerformance.
Clicks Long Métrica Cliques Cliques para o relatório AccountPerformance.
ContentBudgetLostImpressionShare Double Métrica IS de conteúdo perdido (orçamento) Conteúdo Perdido IS (orçamento) para o relatório AccountPerformance.
ContentImpressionShare Double Métrica Conteúdo Impr Compartilhar Compartilhamento de impressões de conteúdo para o relatório AccountPerformance.
ContentRankLostImpressionShare Double Métrica IS de conteúdo perdido (classificação) Conteúdo Perdido IS (classificação) para o relatório AccountPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório AccountPerformance.
Conversions Double Métrica Conversões Conversões para o relatório AccountPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório AccountPerformance.
Cost Decimal Métrica Custo Custo do relatório AccountPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório AccountPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório AccountPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório AccountPerformance.
Ctr Double Métrica CTR CTR para o relatório AccountPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório AccountPerformance.
Engagements Long Métrica Noivados Envolvimentos para o relatório AccountPerformance.
Impressions Long Métrica Impressões Impressões para o relatório AccountPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório AccountPerformance.
Interactions Long Métrica Interações Interações para o relatório AccountPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório AccountPerformance.
InvalidClickRate Double Métrica Taxa de cliques inválida Taxa de cliques inválida para o relatório AccountPerformance.
InvalidClicks Long Métrica Cliques inválidos Cliques inválidos para o relatório AccountPerformance.
SearchBudgetLostImpressionShare Double Métrica Pesquisar IS perdido (orçamento) Pesquise o IS perdido (orçamento) para o relatório AccountPerformance.
SearchExactMatchImpressionShare Double Métrica Pesquisar correspondência exata é Pesquise IS de correspondência exata para o relatório AccountPerformance.
SearchImpressionShare Double Métrica Pesquisar Impr Compartilhar Pesquise Impr Share para o relatório AccountPerformance.
SearchRankLostImpressionShare Double Métrica Pesquisar IS perdido (classificação) Pesquise o número de impressões perdidas (classificação) do relatório AccountPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório AccountPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório AccountPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório AccountPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório AccountPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório AccountPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
AdCustomizersFeedItem

O relatório Item de feed de personalizadores de anúncios fornece estatísticas para itens de feed usados em Personalizadores de anúncios. As estatísticas são agregadas no nível do item de feed, uma linha por item de feed.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountDescriptiveName String Atributo Conta Conta para o relatório AdCustomizersFeedItem.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório AdCustomizersFeedItem.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório AdCustomizersFeedItem.
AdId Long Atributo ID do anúncio ID do anúncio para o relatório AdCustomizersFeedItem.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório AdCustomizersFeedItem.
CampaignName String Atributo Campanha Campanha para o relatório AdCustomizersFeedItem.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório AdCustomizersFeedItem.
FeedId Long Atributo ID do feed ID do feed para o relatório AdCustomizersFeedItem.
FeedItemAttributes String Atributo Valores de atributos Valores de atributo para o relatório AdCustomizersFeedItem.
FeedItemEndTime Long Atributo Data final Data de término do relatório AdCustomizersFeedItem.
FeedItemId Long Atributo Identificação do item ID do item para o relatório AdCustomizersFeedItem.
FeedItemStartTime Long Atributo Data de início Data de início do relatório AdCustomizersFeedItem.
FeedItemStatus String Atributo Estado do artigo Estado do item para o relatório AdCustomizersFeedItem. Os valores permitidos são ENABLED, REMOVED, UNKNOWN.
GeoTargetingCriterionId Long Atributo Localização alvo Local de destino para o relatório AdCustomizersFeedItem.
KeywordTargetingId Long Atributo ID da palavra-chave ID da palavra-chave para o relatório AdCustomizersFeedItem.
KeywordTargetingMatchType String Atributo Tipo de correspondência de palavra-chave de destino Tipo de correspondência de palavras-chave de destino para o relatório AdCustomizersFeedItem.
KeywordTargetingText String Atributo Texto de palavra-chave de destino Texto de palavra-chave de destino para o relatório AdCustomizersFeedItem.
TargetingAdGroupId Long Atributo ID do grupo de anúncios de destino ID do grupo de anúncios de destino para o relatório AdCustomizersFeedItem.
TargetingCampaignId Long Atributo ID da campanha alvo ID da campanha de destino para o relatório AdCustomizersFeedItem.
AdNetworkType1 String Segmento Rede Rede para o relatório AdCustomizersFeedItem. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório AdCustomizersFeedItem. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório AdCustomizersFeedItem.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório AdCustomizersFeedItem.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório AdCustomizersFeedItem.
Date Date Segmento Dia Dia para o relatório AdCustomizersFeedItem.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório AdCustomizersFeedItem. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório AdCustomizersFeedItem. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório AdCustomizersFeedItem. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório AdCustomizersFeedItem.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório AdCustomizersFeedItem. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório AdCustomizersFeedItem.
Slot String Segmento Top Vs Outro Top Vs Other para o relatório AdCustomizersFeedItem. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segmento Semana Semana para o relatório AdCustomizersFeedItem.
Year Integer Segmento Ano Ano para o relatório AdCustomizersFeedItem.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório AdCustomizersFeedItem.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório AdCustomizersFeedItem.
AllConversionValue Double Métrica Valor de todas as conversões Todo o valor de conversão para o relatório AdCustomizersFeedItem.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório AdCustomizersFeedItem.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório AdCustomizersFeedItem.
AverageCpe Double Métrica CPE médio CPE médio para o relatório AdCustomizersFeedItem.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório AdCustomizersFeedItem.
AverageCpv Double Métrica CPV médio CPV médio para o relatório AdCustomizersFeedItem.
AveragePosition Double Métrica Posição Média Posição média do relatório AdCustomizersFeedItem.
Clicks Long Métrica Cliques Cliques para o relatório AdCustomizersFeedItem.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório AdCustomizersFeedItem.
Conversions Double Métrica Conversões Conversões para o relatório AdCustomizersFeedItem.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório AdCustomizersFeedItem.
Cost Decimal Métrica Custo Custo do relatório AdCustomizersFeedItem.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório AdCustomizersFeedItem.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório AdCustomizersFeedItem.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório AdCustomizersFeedItem.
Ctr Double Métrica CTR CTR para o relatório AdCustomizersFeedItem.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório AdCustomizersFeedItem.
Engagements Long Métrica Noivados Engajamentos para o relatório AdCustomizersFeedItem.
Impressions Long Métrica Impressões Impressões para o relatório AdCustomizersFeedItem.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório AdCustomizersFeedItem.
Interactions Long Métrica Interações Interações para o relatório AdCustomizersFeedItem.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório AdCustomizersFeedItem.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório AdCustomizersFeedItem.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório AdCustomizersFeedItem.
VideoViewRate Double Métrica Ver Taxa Taxa de visualização do relatório AdCustomizersFeedItem.
VideoViews Long Métrica Visualizações Visualizações do relatório AdCustomizersFeedItem.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
AdGroupBidLandscape

Representa dados sobre um bidlandscape para um grupo de anúncios.

Colunas
Nome Tipo Comportamento DisplayName Descrição
CampaignId Long ID da campanha que contém o critério ao qual este cenário de lances está associado.
AdGroupId Long ID do grupo de anúncios que contém o critério ao qual esse cenário de lance está associado.
StartDate String Primeiro dia em que se baseia esta paisagem. Normalmente, pode ser até uma semana atrás.
EndDate String Último dia em que se baseia esta paisagem.
LandscapeType String O tipo deste lance de paisagem.
LandscapeCurrent Boolean Se verdadeiro, esse cenário de lance contém o conjunto de critérios do grupo de anúncios que atualmente não tem substituições de lance em nível de critério. Se falso, esse cenário de lances foi derivado de um instantâneo anterior dos critérios do grupo de anúncios, portanto, pode conter critérios aos quais as substituições de lances foram adicionadas recentemente e não conter critérios dos quais as substituições de lances foram removidas recentemente.
Bid Long O valor do lance usado para estimar os dados desse ponto de paisagem.
Clicks Long Número estimado de cliques neste lance.
Cost Long Custo estimado neste lance.
Impressions Long Número estimado de impressões neste lance.
PromotedImpressions Long Número estimado de impressões promovidas.
BiddableConversions Double Número estimado de conversões que recebem lances.
BiddableConversionsValue Double Valor estimado das conversões que recebem lances.
Desempenho do Grupo de Anúncios

O Relatório de desempenho do grupo de anúncios inclui todas as estatísticas agregadas por padrão no nível do grupo de anúncios, uma linha por grupo de anúncios.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar. Por exemplo, a consultar a seguir usa o dispositivo em vez do segmento de data padrão para consultar os dados de desempenho do grupo de anúncios:

SELECT AdGroupId, AdGroupName, CampaignName, Device, Clicks, ConversionRate, Impressions FROM AdGroupPerformance

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords. Por exemplo, a consultar a seguir retornará apenas grupos de anúncios em campanhas habilitadas com uma taxa de conversão maior que 0:

SELECT AdGroupId, AdGroupName, CampaignName, Device, Clicks, ConversionRate, Impressions FROM AdGroupPerformance WHERE CampaignStatus='ENABLED' AND ConversionRate > 0
Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório AdgroupPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório AdgroupPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório AdgroupPerformance.
AdGroupDesktopBidModifier Double Atributo Ajuste de lance para computador Desktop Bid Adj para o relatório AdgroupPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório AdgroupPerformance.
AdGroupMobileBidModifier Double Atributo Ajuste de lance para celular Mobile Bid Adj para o relatório AdgroupPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório AdgroupPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório AdgroupPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
AdGroupTabletBidModifier Double Atributo Ajuste de lance para tablet Tablet Bid Adj para o relatório AdgroupPerformance.
AdGroupType String Atributo Tipo de grupo de anúncios Tipo de grupo de anúncios para o relatório AdgroupPerformance. Os valores permitidos são UNKNOWN, SEARCH_STANDARD, SEARCH_DYNAMIC_ADS, DISPLAY_STANDARD, DISPLAY_ENGAGEMENT, SHOPPING_PRODUCT_ADS, SHOPPING_SHOWCASE_ADS, SHOPPING_GOAL_OPTIMIZED_ADS, VIDEO_TRUE_VIEW_IN_STREAM, VIDEO_TRUE_VIEW_IN_DISPLAY, VIDEO_BUMPER, VIDEO_ NON_SKIPPABLE_IN_STREAM, HOTEL_ADS.
AdRotationMode String Atributo Modo de rotação de anúncios Modo de rotação de anúncios para o relatório AdgroupPerformance. Os valores permitidos são UNKNOWN, OPTIMIZE, ROTATE_FOREVER.
BaseAdGroupId Long Atributo ID do grupo de anúncios base ID do grupo de anúncios base para o relatório AdgroupPerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório AdgroupPerformance.
BiddingStrategyId Long Atributo ID da estratégia de lances ID da estratégia de lances para o relatório AdgroupPerformance.
BiddingStrategyName String Atributo Nome da estratégia de lances Nome da estratégia de lances para o relatório AdgroupPerformance.
BiddingStrategySource String Atributo Origem da estratégia de lances Origem da estratégia de lances para o relatório AdgroupPerformance. Os valores permitidos são CAMPAIGN, ADGROUP, CRITERION.
BiddingStrategyType String Atributo Tipo de estratégia de lance Tipo de estratégia de lance para o relatório AdgroupPerformance. Os valores permitidos são MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório AdgroupPerformance.
CampaignName String Atributo Campanha Campanha para o relatório AdgroupPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório AdgroupPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
ContentBidCriterionTypeGroup String Atributo Dimensão de lance da rede de conteúdo Dimensão de lance da rede de conteúdo para o relatório AdgroupPerformance. Os valores permitidos são KEYWORD, USER_INTEREST_AND_LIST, VERTICAL, GENDER, AGE_RANGE, PLACEMENT, PARENT, INCOME_RANGE, NONE, UNKNOWN.
ConversionAdjustment Boolean Atributo Ajuste de conversão Ajuste de conversão para o relatório AdgroupPerformance.
CpcBid Decimal Atributo CPC máximo padrão CPC máximo padrão para o relatório AdgroupPerformance.
CpmBid Decimal Atributo CPM máximo CPM máximo para o relatório AdgroupPerformance.
CpvBid Decimal Atributo CPV máximo CPV máximo para o relatório AdgroupPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório AdgroupPerformance.
EffectiveTargetRoas Double Atributo ROAS alvo ROAS desejado para o relatório AdgroupPerformance.
EffectiveTargetRoasSource String Atributo Origem do ROAS desejado Origem do ROAS desejado para o relatório AdgroupPerformance. Os valores permitidos são UNKNOWN, ADGROUP, ADGROUP_CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
EnhancedCpcEnabled Boolean Atributo CPC otimizado ativado CPC aprimorado ativado para o relatório AdgroupPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório AdgroupPerformance.
FinalUrlSuffix String Atributo Sufixo do URL final Sufixo de URL final para o relatório AdgroupPerformance.
LabelIds String Atributo IDs de etiquetas IDs de rótulo para o relatório AdgroupPerformance.
Labels String Atributo Etiquetas Rótulos para o relatório AdgroupPerformance.
TargetCpa Decimal Atributo CPA alvo CPA desejado para o relatório AdgroupPerformance.
TargetCpaBidSource String Atributo Origem de CPA alvo Origem de CPA de destino para o relatório AdgroupPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de rastreamento para o relatório AdgroupPerformance.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro personalizado para o relatório AdgroupPerformance.
AdNetworkType1 String Segmento Rede Rede para o relatório AdgroupPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório AdgroupPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório AdgroupPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionAdjustmentLagBucket String Segmento Dias Para Conversão Ou Ajuste Dias para conversão ou ajuste para o relatório AdgroupPerformance. Os valores permitidos são UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_ 9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAY S, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CON VERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório AdgroupPerformance.
ConversionLagBucket String Segmento Dias Para Conversão Dias até a conversão para o relatório AdgroupPerformance. Os valores permitidos são UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_ 9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório AdgroupPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório AdgroupPerformance.
Date Date Segmento Dia Dia para o relatório AdgroupPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório AdgroupPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório AdgroupPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório AdgroupPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
HourOfDay Integer Segmento Hora do dia Hora do dia para o relatório AdgroupPerformance.
Month String Segmento Mês Mês do relatório AdgroupPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório AdgroupPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório AdgroupPerformance.
Slot String Segmento Top Vs Outro Top Vs Other para o relatório AdgroupPerformance. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segmento Semana Semana para o relatório AdgroupPerformance.
Year Integer Segmento Ano Ano para o relatório AdgroupPerformance.
AbsoluteTopImpressionPercentage Double Métrica Impr Abs Top A porcentagem de impressões adicionadas mostradas como o primeiro anúncio.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório AdgroupPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório AdgroupPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório AdgroupPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impr mensuráveis do Active View por impr para o relatório AdgroupPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório AdgroupPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressão mensurável do Active View para o relatório AdgroupPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório AdgroupPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório AdgroupPerformance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório AdgroupPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conversão para o relatório AdgroupPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório AdgroupPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório AdgroupPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório AdgroupPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório AdgroupPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório AdgroupPerformance.
AveragePageviews Double Métrica Páginas por sessão Páginas por sessão para o relatório AdgroupPerformance.
AveragePosition Double Métrica Posição Média Posição média para o relatório AdgroupPerformance.
AverageTimeOnSite Double Métrica Duração Média da Sessão (segundos) Duração média da sessão (segundos) para o relatório AdgroupPerformance.
BounceRate Double Métrica Taxa de rejeição Taxa de rejeição para o relatório AdgroupPerformance.
ClickAssistedConversions Long Métrica Clique em Conv Assistida Clique em Assisted Conv para o relatório AdgroupPerformance.
ClickAssistedConversionsOverLastClickConversions Double Métrica Conv de clique assistido por último clique de conversão Clique em Conv assistida por último clique em Conv para o relatório AdgroupPerformance.
ClickAssistedConversionValue Double Métrica Clique em Valor de conversão assistida Clique em Valor de conversão assistida para o relatório AdgroupPerformance.
Clicks Long Métrica Cliques Cliques para o relatório AdgroupPerformance.
ContentImpressionShare Double Métrica Conteúdo Impr Compartilhar Compartilhamento de impressões de conteúdo para o relatório AdgroupPerformance.
ContentRankLostImpressionShare Double Métrica IS de conteúdo perdido (classificação) É de conteúdo perdido (classificação) para o relatório AdgroupPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório AdgroupPerformance.
Conversions Double Métrica Conversões Conversões para o relatório AdgroupPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório AdgroupPerformance.
Cost Decimal Métrica Custo Custo do relatório AdgroupPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório AdgroupPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório AdgroupPerformance.
CostPerCurrentModelAttributedConversion Double Métrica Custo por conversão (modelo atual) Custo por conversão (modelo atual) para o relatório AdgroupPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório AdgroupPerformance.
Ctr Double Métrica CTR CTR para o relatório AdgroupPerformance.
CurrentModelAttributedConversions Double Métrica Conversões (Modelo atual) Conversões (modelo atual) para o relatório AdgroupPerformance.
CurrentModelAttributedConversionValue Double Métrica Valor conv (modelo atual) Valor conv (modelo atual) para o relatório AdgroupPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório AdgroupPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório AdgroupPerformance.
GmailForwards Long Métrica Encaminhamentos do Gmail Encaminhamentos do Gmail para o relatório AdgroupPerformance.
GmailSaves Long Métrica Gmail salva Gmail salva para o relatório AdgroupPerformance.
GmailSecondaryClicks Long Métrica Cliques do Gmail para o site Gmail Clicks To Website para o relatório AdgroupPerformance.
ImpressionAssistedConversions Long Métrica Conv assistida por impressão Impr Assisted Conv para o relatório AdgroupPerformance.
ImpressionAssistedConversionsOverLastClickConversions Double Métrica Conv de impressão assistida por último clique Conv Conv de impressão assistida por último clique Conv para o relatório AdgroupPerformance.
ImpressionAssistedConversionValue Double Métrica Valor de conversão assistida por impressão Valor de conversão assistida por impressão para o relatório AdgroupPerformance.
Impressions Long Métrica Impressões Impressões para o relatório AdgroupPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório AdgroupPerformance.
Interactions Long Métrica Interações Interações para o relatório AdgroupPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório AdgroupPerformance.
NumOfflineImpressions Long Métrica Impressões de telefone Impressões de telefone para o relatório AdgroupPerformance.
NumOfflineInteractions Long Métrica Chamadas telefônicas Chamadas telefônicas para o relatório AdgroupPerformance.
OfflineInteractionRate Double Métrica PTR PTR para o relatório AdgroupPerformance.
PercentNewVisitors Double Métrica Porcentagem de Novas Sessões Porcentagem de novas sessões para o relatório AdgroupPerformance.
RelativeCtr Double Métrica CTR relativa CTR relativa para o relatório AdgroupPerformance.
SearchAbsoluteTopImpressionShare Double Métrica Pesquisar Abs Top IS Pesquisar Abs Top IS para o relatório AdgroupPerformance.
SearchExactMatchImpressionShare Double Métrica Pesquisar correspondência exata é Pesquisar É de correspondência exata para o relatório AdgroupPerformance.
SearchImpressionShare Double Métrica Pesquisar Impr Compartilhar Pesquise Compartilhamento de impressões para o relatório AdgroupPerformance.
SearchRankLostImpressionShare Double Métrica Pesquisar IS perdido (classificação) Pesquise a parcela de impressões perdidas (classificação) do relatório AdgroupPerformance.
TopImpressionPercentage Double Métrica Impr Início A porcentagem de impressões adicionadas que são exibidas em qualquer lugar acima dos resultados da pesquisa orgânica.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório AdgroupPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório AdgroupPerformance.
ValuePerCurrentModelAttributedConversion Double Métrica Valor por conversão (modelo atual) Valor por conversão (modelo atual) para o relatório AdgroupPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido a 100% para o relatório AdgroupPerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido em 25% para o relatório AdgroupPerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido em 50% para o relatório AdgroupPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido em 75% para o relatório AdgroupPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório AdgroupPerformance.
VideoViews Long Métrica Visualizações Exibições do relatório AdgroupPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório AdgroupPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Grupos de Anúncios

Serviço para acessar detalhes sobre quaisquer grupos de anúncios.

Informações Específicas da Tabela

Selecione

Há duas maneiras de consultar AdGroups.

  • A consultar a seguir retorna o grupo de anúncios especificado.

    SELECT * FROM [Grupos de anúncios] WHERE Id=123456789
    
  • A consultar a seguir retorna todos os grupos de anúncios.

    SELECT * FROM [AdGroups]
    
Colunas
Nome Tipo Comportamento DisplayName Descrição
Id [KEY] Long ID deste grupo de anúncios.
CampaignId Long ID da campanha à qual este grupo de anúncios está associado.
CampaignName String Nome da campanha à qual este grupo de anúncios está associado.
Name String Nome deste grupo de anúncios (no máximo 255 caracteres UTF-8 de largura total).
Status String Status deste grupo de anúncios.
ContentBidCriterionTypeGroup String Permite que os anunciantes especifiquem uma dimensão de critérios na qual colocar lances absolutos.
BaseCampaignId Long ID da campanha base a partir da qual este grupo de anúncios de rascunho/teste foi criado.
BaseAdGroupId Long ID do grupo de anúncios base a partir do qual este grupo de anúncios de rascunho/teste foi criado.
TrackingUrlTemplate String Modelo de URL para construir um URL de rastreamento.
FinalUrlSuffix String Modelo de URL para anexar parâmetros ao URL final.
UrlCustomParameters String Uma lista de mapeamentos a serem usados para substituir tags de parâmetro personalizado de URL em trackingUrlTemplate, finalUrls e/ou finalMobileUrls.
AdGroupType String O tipo do grupo de anúncios.
BiddingStrategyId Long ID da estratégia de lances a ser associada à campanha, ao grupo de anúncios ou aos critérios do grupo de anúncios.
BiddingStrategyName String Nome da estratégia de lances.
BiddingStrategyType String O tipo de estratégia de lance a ser anexado.
BiddingStrategySource String Indica onde a estratégia de lances está associada, ou seja, campanha, grupo de anúncios ou critério do grupo de anúncios.
AdRotationMode String O modo de rotação de anúncios para especificar com que frequência os anúncios no grupo de anúncios serão exibidos entre si.
Desempenho do Anúncio

O relatório de desempenho do anúncio inclui todas as estatísticas agregadas no nível do anúncio, uma linha por anúncio.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar. Por exemplo, a consultar a seguir usa ClickType em vez do segmento de data padrão para consultar os dados de desempenho do anúncio:

SELECT AdType, Headline, CampaignName, ClickType, Clicks, ConversionRate, Impressions FROM AdPerformance

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords. Por exemplo, esta consultar retornará apenas anúncios ativados com uma taxa de conversão maior que 0:

SELECT AdType, Headline, CampaignName, Device, Clicks, ConversionRate, Impressions FROM AdPerformance WHERE Status='ENABLED' AND ConversionRate > 0
Colunas
Nome Tipo Comportamento DisplayName Descrição
AccentColor String Atributo Cor de destaque (responsivo) Accent Color (responsivo) para o relatório AdPerformance.
AccountCurrencyCode String Atributo Moeda Moeda para o relatório AdPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório AdPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório AdPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório AdPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório AdPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório AdPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
AdStrengthInfo String Atributo Força do anúncio Qualidade do anúncio para o relatório AdPerformance.
AdType String Atributo Tipo de anúncio Tipo de anúncio para o relatório AdPerformance. Os valores permitidos são DEPRECATED_AD, IMAGE_AD, PRODUCT_AD, TEMPLATE_AD, TEXT_AD, THIRD_PARTY_REDIRECT_AD, DYNAMIC_SEARCH_AD, CALL_ONLY_AD, EXPANDED_TEXT_AD, RESPONSIVE_DISPLAY_AD, SHOWCASE_AD, GOAL_OPTIMIZED_SHOPPING_AD, EXPANDED_DYNAMIC_SEARCH_AD, GMAIL_AD, RESPONSIVE_SEARCH_AD, MULTI_ASSET_RESPONSIVE_DISPLAY_AD, DESCONHECIDO.
AllowFlexibleColor Boolean Atributo Permitir cor flexível (responsivo) Permitir cores flexíveis (responsivas) para o relatório AdPerformance.
Automated Boolean Atributo Sugestão de anúncio autoaplicada Sugestão de anúncio aplicada automaticamente para o relatório AdPerformance.
BaseAdGroupId Long Atributo ID do grupo de anúncios base ID do grupo de anúncios base para o relatório AdPerformance.
BaseCampaignId Long Atributo ID base da campanha ID da campanha base para o relatório AdPerformance.
BusinessName String Atributo Nome comercial Nome da empresa para o relatório AdPerformance.
CallOnlyPhoneNumber String Atributo Número de telefone do anúncio somente para chamadas Número de telefone do anúncio somente para chamadas para o relatório AdPerformance.
CallToActionText String Atributo Texto de Chamada à Ação (responsivo) Texto de chamada para ação (responsivo) para o relatório AdPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório AdPerformance.
CampaignName String Atributo Campanha Campanha para o relatório AdPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório AdPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CombinedApprovalStatus String Atributo Status de aprovação Status de aprovação para o relatório AdPerformance. Os valores permitidos são UNKNOWN, APPROVED, APPROVED_LIMITED, ELIGIBLE, UNDER_REVIEW, DISAPPROVED, SITE_SUSPENDED.
ConversionAdjustment Boolean Atributo Ajuste de conversão Ajuste de conversão para o relatório AdPerformance.
CreativeDestinationUrl String Atributo URL de destino URL de destino para o relatório AdPerformance.
CreativeFinalAppUrls String Atributo URL final do aplicativo URL final do aplicativo para o relatório AdPerformance.
CreativeFinalMobileUrls String Atributo URL final móvel URL final para celular do relatório AdPerformance.
CreativeFinalUrls String Atributo URL final URL final do relatório AdPerformance.
CreativeFinalUrlSuffix String Atributo Sufixo do URL final Sufixo de URL final para o relatório AdPerformance.
CreativeTrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de rastreamento para o relatório AdPerformance.
CreativeUrlCustomParameters String Atributo Parâmetro personalizado Parâmetro personalizado para o relatório AdPerformance.
CriterionType String Atributo Tipo de critério Tipo de critério para o relatório AdPerformance. Os valores permitidos são UNKNOWN, AD_SCHEDULE, AGE_RANGE, APP_PAYMENT_MODEL, CARRIER, CONTENT_LABEL, CUSTOM_AFFINITY, GENDER, LOCATION_GROUPS, IP_BLOCK, KEYWORD, LANGUAGE, LOCATION, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, MOBILE_DEVICE, OPERATING_SYSTEM_VERSION, PARENT, PLACEMENT, PLATFORM, PREFERRED_CONTENT, PRODUCT_PARTITION, PRODUCT_SCOPE, PROXIMIDADE, USER_INTEREST, USER_LIST, VERTICAL, WEBPAGE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO, CUSTOM_IN_MARKET.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório AdPerformance.
Description String Atributo Descrição Descrição do relatório AdPerformance.
Description1 String Atributo Descrição Linha 1 Linha de descrição 1 para o relatório AdPerformance.
Description2 String Atributo Descrição Linha 2 Linha de descrição 2 para o relatório AdPerformance.
DevicePreference Long Atributo Preferência do dispositivo Preferência de dispositivo para o relatório AdPerformance.
DisplayUrl String Atributo URL de visualização URL de exibição do relatório AdPerformance.
EnhancedDisplayCreativeLandscapeLogoImageMediaId Long Atributo ID do logotipo em paisagem (responsivo) ID do logotipo em paisagem (responsivo) para o relatório AdPerformance.
EnhancedDisplayCreativeLogoImageMediaId Long Atributo ID do logotipo (responsivo) ID do logotipo (responsivo) para o relatório AdPerformance.
EnhancedDisplayCreativeMarketingImageMediaId Long Atributo ID da imagem (responsivo) ID da imagem (responsiva) para o relatório AdPerformance.
EnhancedDisplayCreativeMarketingImageSquareMediaId Long Atributo ID da imagem Square (responsivo) ID da imagem Square (responsiva) para o relatório AdPerformance.
ExpandedDynamicSearchCreativeDescription2 String Atributo Descrição do anúncio de pesquisa dinâmico expandido 2 Descrição expandida do anúncio dinâmico de pesquisa 2 para o relatório AdPerformance.
ExpandedTextAdDescription2 String Atributo Descrição do anúncio de texto expandido 2 Descrição do anúncio de texto expandido 2 para o relatório AdPerformance.
ExpandedTextAdHeadlinePart3 String Atributo Título do anúncio de texto expandido 3 Título do anúncio de texto expandido 3 para o relatório AdPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório AdPerformance.
FormatSetting String Atributo Preferência de formato de anúncio (responsivo) Preferência de formato de anúncio (responsivo) para o relatório AdPerformance. Os valores permitidos são UNKNOWN, ALL_FORMATS, NON_NATIVE, NATIVE.
GmailCreativeHeaderImageMediaId Long Atributo ID da mídia da imagem do cabeçalho do anúncio do Gmail ID da mídia da imagem do cabeçalho do anúncio do Gmail para o relatório AdPerformance.
GmailCreativeLogoImageMediaId Long Atributo ID da mídia da imagem do logotipo do anúncio do Gmail ID de mídia da imagem do logotipo do anúncio do Gmail para o relatório AdPerformance.
GmailCreativeMarketingImageMediaId Long Atributo ID de mídia de imagem de marketing de anúncio do Gmail ID de mídia de imagem de marketing de anúncio do Gmail para o relatório AdPerformance.
GmailTeaserBusinessName String Atributo Nome comercial do anúncio do Gmail Nome comercial do anúncio do Gmail para o relatório AdPerformance.
GmailTeaserDescription String Atributo Descrição do anúncio do Gmail Descrição do anúncio do Gmail para o relatório AdPerformance.
GmailTeaserHeadline String Atributo Título do anúncio do Gmail Título do anúncio do Gmail para o relatório AdPerformance.
Headline String Atributo Anúncio Anúncio para o relatório AdPerformance.
HeadlinePart1 String Atributo Título 1 Título 1 para o relatório AdPerformance.
HeadlinePart2 String Atributo Título 2 Título 2 para o relatório AdPerformance.
Id Long Atributo ID do anúncio ID do anúncio para o relatório AdPerformance.
ImageAdUrl String Atributo URL do anúncio gráfico URL do anúncio gráfico para o relatório AdPerformance.
ImageCreativeImageHeight Integer Atributo Altura da imagem Altura da imagem para o relatório AdPerformance.
ImageCreativeImageWidth Integer Atributo Largura da imagem Largura da imagem para o relatório AdPerformance.
ImageCreativeMimeType String Atributo Tipo de imagem Mime Tipo de MIME de imagem para o relatório AdPerformance.
ImageCreativeName String Atributo Nome do anúncio gráfico Nome do anúncio gráfico para o relatório AdPerformance.
IsNegative Boolean Atributo é negativo É negativo para o relatório AdPerformance.
LabelIds String Atributo IDs de etiquetas IDs de rótulo para o relatório AdPerformance.
Labels String Atributo Etiquetas Rótulos para o relatório AdPerformance.
LongHeadline String Atributo Título longo Título longo para o relatório AdPerformance.
MainColor String Atributo Cor Principal (responsiva) Cor principal (responsiva) para o relatório AdPerformance.
MarketingImageCallToActionText String Atributo Texto de chamada para ação de imagem de marketing de anúncio do Gmail Texto de call-to-action da imagem de marketing de anúncios do Gmail para o relatório AdPerformance.
MarketingImageCallToActionTextColor String Atributo Cor do texto de chamada para ação de imagem de marketing de anúncio do Gmail Imagem de marketing de anúncio do Gmail Cor do texto de chamada para ação para o relatório AdPerformance.
MarketingImageDescription String Atributo Descrição da imagem de marketing de anúncio do Gmail Descrição da imagem de marketing de anúncios do Gmail para o relatório AdPerformance.
MarketingImageHeadline String Atributo Título da imagem de marketing de anúncio do Gmail Título da imagem de marketing de anúncio do Gmail para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdAccentColor String Atributo Cor de destaque (tela responsiva com vários recursos) Cor de destaque (exibição responsiva de vários recursos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdAllowFlexibleColor Boolean Atributo Permitir cores flexíveis (exibição responsiva de vários ativos) Permitir cores flexíveis (exibição responsiva de vários ativos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdBusinessName String Atributo Nome comercial (exibição responsiva de vários ativos) Nome comercial (exibição responsiva de vários ativos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdCallToActionText String Atributo Texto de chamada para ação (exibição responsiva de vários recursos) Texto de chamada para ação (exibição responsiva de vários recursos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdDescriptions String Atributo Descrições (exibição responsiva de vários recursos) Descrições (exibição responsiva de vários recursos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdDynamicSettingsPricePrefix String Atributo Prefixo de preço (exibição responsiva de vários ativos) Prefixo de preço (exibição responsiva de vários ativos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdDynamicSettingsPromoText String Atributo Texto da promoção (exibição responsiva de vários recursos) Texto de promoção (exibição responsiva de vários recursos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdFormatSetting String Atributo Preferência de formato de anúncio (exibição responsiva com vários ativos) Preferência de formato de anúncio (exibição responsiva de vários recursos) para o relatório AdPerformance. Os valores permitidos são UNKNOWN, ALL_FORMATS, NON_NATIVE, NATIVE.
MultiAssetResponsiveDisplayAdHeadlines String Atributo Manchetes (exibição responsiva de vários ativos) Títulos (exibição responsiva de vários recursos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdLandscapeLogoImages String Atributo Logotipos em paisagem (exibição responsiva com vários recursos) Logotipos em paisagem (exibição responsiva de vários ativos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdLogoImages String Atributo Logos (exibição responsiva de vários recursos) Logotipos (exibição responsiva de vários recursos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdLongHeadline String Atributo Título longo (exibição responsiva de vários recursos) Título longo (exibição responsiva de vários recursos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdMainColor String Atributo Cor principal (exibição responsiva de vários recursos) Cor principal (exibição responsiva de vários recursos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdMarketingImages String Atributo Imagens (exibição responsiva de vários ativos) Imagens (exibição responsiva de vários recursos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdSquareMarketingImages String Atributo Imagens Square (exibição responsiva de vários recursos) Imagens Square (exibição responsiva de vários ativos) para o relatório AdPerformance.
MultiAssetResponsiveDisplayAdYouTubeVideos String Atributo Vídeos do YouTube (exibição responsiva com vários ativos) Vídeos do YouTube (exibição responsiva com vários recursos) para o relatório AdPerformance.
Path1 String Atributo Caminho 1 Caminho 1 para o relatório AdPerformance.
Path2 String Atributo Caminho 2 Caminho 2 para o relatório AdPerformance.
PolicySummary String Atributo Política Política para o relatório AdPerformance.
PricePrefix String Atributo Prefixo de preço (responsivo) Prefixo de preço (responsivo) para o relatório AdPerformance.
PromoText String Atributo Texto promocional (responsivo) Texto de promoção (responsivo) para o relatório AdPerformance.
ResponsiveSearchAdDescriptions String Atributo Descrições de anúncios responsivos de pesquisa Descrições de anúncios responsivos de pesquisa para o relatório AdPerformance.
ResponsiveSearchAdHeadlines String Atributo Títulos de anúncios de pesquisa responsivos Títulos de anúncios de pesquisa responsivos para o relatório AdPerformance.
ResponsiveSearchAdPath1 String Atributo Caminho 1 do anúncio de pesquisa responsivo Caminho 1 do anúncio de pesquisa responsivo para o relatório AdPerformance.
ResponsiveSearchAdPath2 String Atributo Caminho 2 do anúncio de pesquisa responsivo Caminho 2 do anúncio de pesquisa responsivo para o relatório AdPerformance.
ShortHeadline String Atributo Título Curto Título curto para o relatório AdPerformance.
Status String Atributo Estado do anúncio Estado do anúncio para o relatório AdPerformance. Os valores permitidos são ENABLED, PAUSED, DISABLED.
SystemManagedEntitySource String Atributo Origem da Entidade Gerenciada pelo Sistema Origem da entidade gerenciada pelo sistema para o relatório AdPerformance. Os valores permitidos são UNKNOWN, AD_VARIATIONS.
AdNetworkType1 String Segmento Rede Rede para o relatório AdPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório AdPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório AdPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionAdjustmentLagBucket String Segmento Dias Para Conversão Ou Ajuste Dias para conversão ou ajuste para o relatório AdPerformance. Os valores permitidos são UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_ 9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAY S, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CON VERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório AdPerformance.
ConversionLagBucket String Segmento Dias Para Conversão Dias até a conversão para o relatório AdPerformance. Os valores permitidos são UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_ 9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório AdPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório AdPerformance.
CriterionId Long Segmento ID da palavra-chave ID da palavra-chave para o relatório AdPerformance.
Date Date Segmento Dia Dia para o relatório AdPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório AdPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório AdPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório AdPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório AdPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório AdPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório AdPerformance.
Slot String Segmento Top Vs Outro Top Vs Other para o relatório AdPerformance. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segmento Semana Semana para o relatório AdPerformance.
Year Integer Segmento Ano Ano do relatório AdPerformance.
AbsoluteTopImpressionPercentage Double Métrica Impr Abs Top A porcentagem de impressões adicionadas mostradas como o primeiro anúncio.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório AdPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível CTR visível do Active View para o relatório AdPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório AdPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impressão mensurável do Active View por impressão para o relatório AdPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório AdPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressões mensuráveis do Active View para o relatório AdPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório AdPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório AdPerformance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório AdPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório AdPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório AdPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório AdPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório AdPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório AdPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório AdPerformance.
AveragePageviews Double Métrica Páginas por sessão Páginas por sessão para o relatório AdPerformance.
AveragePosition Double Métrica Posição Média Posição média para o relatório AdPerformance.
AverageTimeOnSite Double Métrica Duração Média da Sessão (segundos) Duração média da sessão (segundos) para o relatório AdPerformance.
BounceRate Double Métrica Taxa de rejeição Taxa de rejeição para o relatório AdPerformance.
ClickAssistedConversions Long Métrica Clique em Conv Assistida Clique em Conv assistida para o relatório AdPerformance.
ClickAssistedConversionsOverLastClickConversions Double Métrica Conv de clique assistido por último clique de conversão Clique em Conv assistida por último clique em Conv para o relatório AdPerformance.
ClickAssistedConversionValue Double Métrica Clique em Valor de conversão assistida Clique em Valor de conversão assistida para o relatório AdPerformance.
Clicks Long Métrica Cliques Cliques para o relatório AdPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório AdPerformance.
Conversions Double Métrica Conversões Conversões para o relatório AdPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório AdPerformance.
Cost Decimal Métrica Custo Custo do relatório AdPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório AdPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório AdPerformance.
CostPerCurrentModelAttributedConversion Double Métrica Custo por conversão (modelo atual) Custo por conversão (modelo atual) para o relatório AdPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório AdPerformance.
Ctr Double Métrica CTR CTR para o relatório AdPerformance.
CurrentModelAttributedConversions Double Métrica Conversões (Modelo atual) Conversões (modelo atual) para o relatório AdPerformance.
CurrentModelAttributedConversionValue Double Métrica Valor conv (modelo atual) Valor conv (modelo atual) para o relatório AdPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório AdPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório AdPerformance.
GmailForwards Long Métrica Encaminhamentos do Gmail Encaminhamentos do Gmail para o relatório AdPerformance.
GmailSaves Long Métrica Gmail salva Economias do Gmail para o relatório AdPerformance.
GmailSecondaryClicks Long Métrica Cliques do Gmail para o site Gmail Clicks To Website para o relatório AdPerformance.
ImpressionAssistedConversions Long Métrica Conv assistida por impressão Impr Assisted Conv para o relatório AdPerformance.
ImpressionAssistedConversionsOverLastClickConversions Double Métrica Conv de impressão assistida por último clique Conv Conv de impressão assistida por último clique Conv para o relatório AdPerformance.
ImpressionAssistedConversionValue Double Métrica Valor de conversão assistida por impressão Valor de conversão assistida por impressão para o relatório AdPerformance.
Impressions Long Métrica Impressões Impressões para o relatório AdPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório AdPerformance.
Interactions Long Métrica Interações Interações para o relatório AdPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório AdPerformance.
PercentNewVisitors Double Métrica Porcentagem de Novas Sessões Porcentagem de novas sessões para o relatório AdPerformance.
TopImpressionPercentage Double Métrica Impr Início A porcentagem de impressões adicionadas que são exibidas em qualquer lugar acima dos resultados da pesquisa orgânica.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório AdPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório AdPerformance.
ValuePerCurrentModelAttributedConversion Double Métrica Valor por conversão (modelo atual) Valor por conversão (modelo atual) para o relatório AdPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido a 100% para o relatório AdPerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido até 25% para o relatório AdPerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido até 50% para o relatório AdPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido até 75% para o relatório AdPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de visualização do relatório AdPerformance.
VideoViews Long Métrica Visualizações Exibições do relatório AdPerformance.
ViewThroughConversions Long Métrica Conv de visualização Conv de exibição para o relatório AdPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Faixa Etáriadesempenho

O relatório de desempenho por faixa etária inclui todas as estatísticas da rede de exibição agregadas por faixa etária. Ele também inclui desempenho de público automático.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório AgeRangePerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório AgeRangePerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório AgeRangePerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório AgeRangePerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório AgeRangePerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório AgeRangePerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
BaseAdGroupId Long Atributo ID do grupo de anúncios base ID do grupo de anúncios base para o relatório AgeRangePerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório AgeRangePerformance.
BiddingStrategyId Long Atributo ID da estratégia de lances ID da estratégia de lances para o relatório AgeRangePerformance.
BiddingStrategyName String Atributo Nome da estratégia de lance Nome da estratégia de lances para o relatório AgeRangePerformance.
BiddingStrategyType String Atributo Tipo de estratégia de lance Tipo de estratégia de lance para o relatório AgeRangePerformance. Os valores permitidos são MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BidModifier Double Atributo Ajuste de lance Ajuste de lance para o relatório AgeRangePerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório AgeRangePerformance.
CampaignName String Atributo Campanha Campanha para o relatório AgeRangePerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório AgeRangePerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Atributo CPC máximo CPC máximo para o relatório AgeRangePerformance.
CpcBidSource String Atributo Origem do CPC máx. Origem do CPC máximo para o relatório AgeRangePerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Atributo CPM máximo CPM máximo para o relatório AgeRangePerformance.
CpmBidSource String Atributo Origem do CPM máx. Origem do CPM máximo para o relatório AgeRangePerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Atributo Faixa etária Faixa etária para o relatório AgeRangePerformance.
CriteriaDestinationUrl String Atributo URL de destino URL de destino para o relatório AgeRangePerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório AgeRangePerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório AgeRangePerformance.
FinalAppUrls String Atributo URL final do aplicativo URL final do aplicativo para o relatório AgeRangePerformance.
FinalMobileUrls String Atributo URL final móvel URL final móvel para o relatório AgeRangePerformance.
FinalUrls String Atributo URL final URL final para o relatório AgeRangePerformance.
Id Long Atributo ID do critério ID do critério para o relatório AgeRangePerformance.
IsNegative Boolean Atributo é negativo É negativo para o relatório AgeRangePerformance.
IsRestrict Boolean Atributo está restringindo É uma restrição para o relatório AgeRangePerformance.
Status String Atributo Faixa etária Estado Estado da faixa etária para o relatório AgeRangePerformance. Os valores permitidos são ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de rastreamento para o relatório AgeRangePerformance.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro customizado para o relatório AgeRangePerformance.
AdNetworkType1 String Segmento Rede Rede para o relatório AgeRangePerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório AgeRangePerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório AgeRangePerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório AgeRangePerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório AgeRangePerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório AgeRangePerformance.
Date Date Segmento Dia Dia para o relatório AgeRangePerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório AgeRangePerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório AgeRangePerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório AgeRangePerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês para o relatório AgeRangePerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório AgeRangePerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório AgeRangePerformance.
Week String Segmento Semana Semana para o relatório AgeRangePerformance.
Year Integer Segmento Ano Ano para o relatório AgeRangePerformance.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório AgeRangePerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório AgeRangePerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório AgeRangePerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Active View Mensurável Impr por Impr para o relatório AgeRangePerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório AgeRangePerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressão mensurável do Active View para o relatório AgeRangePerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório AgeRangePerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório AgeRangePerformance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório AgeRangePerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório AgeRangePerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório AgeRangePerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório AgeRangePerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório AgeRangePerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório AgeRangePerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório AgeRangePerformance.
Clicks Long Métrica Cliques Cliques para o relatório AgeRangePerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório AgeRangePerformance.
Conversions Double Métrica Conversões Conversões para o relatório AgeRangePerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório AgeRangePerformance.
Cost Decimal Métrica Custo Custo do relatório AgeRangePerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório AgeRangePerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório AgeRangePerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório AgeRangePerformance.
Ctr Double Métrica CTR CTR para o relatório AgeRangePerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório AgeRangePerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório AgeRangePerformance.
GmailForwards Long Métrica Encaminhamentos do Gmail Encaminhamentos do Gmail para o relatório AgeRangePerformance.
GmailSaves Long Métrica Gmail salva Gmail salva para o relatório AgeRangePerformance.
GmailSecondaryClicks Long Métrica Cliques do Gmail para o site Gmail Clicks To Website para o relatório AgeRangePerformance.
Impressions Long Métrica Impressões Impressões para o relatório AgeRangePerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório AgeRangePerformance.
Interactions Long Métrica Interações Interações para o relatório AgeRangePerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório AgeRangePerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório AgeRangePerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório AgeRangePerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido em 100% para o relatório AgeRangePerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido até 25% para o relatório AgeRangePerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido até 50% para o relatório AgeRangePerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido em 75% para o relatório AgeRangePerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório AgeRangePerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório AgeRangePerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório AgeRangePerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
AudiênciaDesempenho

O relatório de desempenho do público inclui dados de desempenho de interesses e listas de remarketing para anúncios gráficos e listas de remarketing para anúncios de pesquisa (RLSA), agregados no nível do público - uma linha por público.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório AudiencePerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório AudiencePerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório AudiencePerformance.
BaseAdGroupId Long Atributo ID do grupo de anúncios base ID do grupo de anúncios base para o relatório AudiencePerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório AudiencePerformance.
BiddingStrategyId Long Atributo ID da estratégia de lances ID da estratégia de lances para o relatório AudiencePerformance.
BiddingStrategyName String Atributo Nome da estratégia de lance Nome da estratégia de lances para o relatório AudiencePerformance.
BiddingStrategyType String Atributo Tipo de estratégia de lance Tipo de estratégia de lance para o relatório AudiencePerformance. Os valores permitidos são MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BidModifier Double Atributo Ajuste de lance Ajuste de lance para o relatório AudiencePerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório AudiencePerformance.
CampaignName String Atributo Campanha Campanha para o relatório AudiencePerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório AudiencePerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Atributo CPC máximo CPC máximo para o relatório AudiencePerformance.
CpcBidSource String Atributo Origem do CPC máx. Origem do CPC máximo para o relatório AudiencePerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Atributo CPM máximo CPM máximo para o relatório AudiencePerformance.
CpmBidSource String Atributo Origem do CPM máx. Origem do CPM máximo para o relatório AudiencePerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Atributo Audiência Público para o relatório AudiencePerformance.
CriteriaDestinationUrl String Atributo URL de destino URL de destino para o relatório AudiencePerformance.
CriterionAttachmentLevel String Atributo Nível Nível para o relatório AudiencePerformance. Os valores permitidos são UNKNOWN, ADGROUP, CAMPAIGN, CUSTOMER.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório AudiencePerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório AudiencePerformance.
FinalAppUrls String Atributo URL final do aplicativo URL final do aplicativo para o relatório AudiencePerformance.
FinalMobileUrls String Atributo URL final móvel URL final móvel para o relatório AudiencePerformance.
FinalUrls String Atributo URL final URL final para o relatório AudiencePerformance.
Id Long Atributo ID do critério ID do critério para o relatório AudiencePerformance.
IsRestrict Boolean Atributo está restringindo É restritivo para o relatório AudiencePerformance.
Status String Atributo Estado da audiência Estado do público para o relatório AudiencePerformance. Os valores permitidos são ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de rastreamento para o relatório AudiencePerformance.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro personalizado para o relatório AudiencePerformance.
UserListName String Atributo Nome da lista de usuários Nome da lista de usuários para o relatório AudiencePerformance.
AdGroupId Long Segmento ID do grupo de anúncios ID do grupo de anúncios para o relatório AudiencePerformance.
AdGroupName String Segmento Grupo de anúncios Grupo de anúncios para o relatório AudiencePerformance.
AdGroupStatus String Segmento Estado do grupo de anúncios Estado do grupo de anúncios para o relatório AudiencePerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
AdNetworkType1 String Segmento Rede Rede para o relatório AudiencePerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório AudiencePerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório AudiencePerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório AudiencePerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório AudiencePerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório AudiencePerformance.
Date Date Segmento Dia Dia para o relatório AudiencePerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório AudiencePerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório AudiencePerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório AudiencePerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês para o relatório AudiencePerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório AudiencePerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório AudiencePerformance.
Slot String Segmento Top Vs Outro Top Vs Other para o relatório AudiencePerformance. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segmento Semana Semana para o relatório AudiencePerformance.
Year Integer Segmento Ano Ano para o relatório AudiencePerformance.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório AudiencePerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório AudiencePerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório AudiencePerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impr mensuráveis do Active View por impr para o relatório AudiencePerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório AudiencePerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressão mensurável do Active View para o relatório AudiencePerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório AudiencePerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório AudiencePerformance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório AudiencePerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todo o valor de conv para o relatório AudiencePerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório AudiencePerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório AudiencePerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório AudiencePerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório AudiencePerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório AudiencePerformance.
AveragePosition Double Métrica Posição Média Posição média para o relatório AudiencePerformance.
Clicks Long Métrica Cliques Cliques para o relatório AudiencePerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório AudiencePerformance.
Conversions Double Métrica Conversões Conversões para o relatório AudiencePerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório AudiencePerformance.
Cost Decimal Métrica Custo Custo do relatório AudiencePerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório AudiencePerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório AudiencePerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório AudiencePerformance.
Ctr Double Métrica CTR CTR para o relatório AudiencePerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório AudiencePerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório AudiencePerformance.
GmailForwards Long Métrica Encaminhamentos do Gmail Encaminhamentos do Gmail para o relatório AudiencePerformance.
GmailSaves Long Métrica Gmail salva Gmail salva para o relatório AudiencePerformance.
GmailSecondaryClicks Long Métrica Cliques do Gmail para o site Gmail Clicks To Website para o relatório AudiencePerformance.
Impressions Long Métrica Impressões Impressões para o relatório AudiencePerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório AudiencePerformance.
Interactions Long Métrica Interações Interações para o relatório AudiencePerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório AudiencePerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório AudiencePerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conv para o relatório AudiencePerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido até 100% para o relatório AudiencePerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido até 25% para o relatório AudiencePerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido até 50% para o relatório AudiencePerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido até 75% para o relatório AudiencePerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório AudiencePerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório AudiencePerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório AudiencePerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Desempenho de Posicionamentos Automáticos

O relatório Desempenho de canais automáticos inclui todas as estatísticas agregadas no nível do canal, uma linha por canal.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório AutomaticPlacementsPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório AutomaticPlacementsPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório AutomaticPlacementsPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório AutomaticPlacementsPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório AutomaticPlacementsPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório AutomaticPlacementsPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório AutomaticPlacementsPerformance.
CampaignName String Atributo Campanha Campanha para o relatório AutomaticPlacementsPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório AutomaticPlacementsPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CriteriaParameters String Atributo URL URL para o relatório AutomaticPlacementsPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório AutomaticPlacementsPerformance.
DisplayName String Atributo Nome de exibição dos critérios Nome de exibição de critérios para o relatório AutomaticPlacementsPerformance.
Domain String Atributo Domínio Domínio para o relatório AutomaticPlacementsPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório AutomaticPlacementsPerformance.
IsBidOnPath String Atributo Adicionado Adicionado para o relatório AutomaticPlacementsPerformance.
IsPathExcluded String Atributo Excluído Excluído para o relatório AutomaticPlacementsPerformance.
AdFormat String Segmento Tipo de anúncio Tipo de anúncio para o relatório AutomaticPlacementsPerformance. Os valores permitidos são UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.
AdNetworkType1 String Segmento Rede Network para o relatório AutomaticPlacementsPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório AutomaticPlacementsPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório AutomaticPlacementsPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório AutomaticPlacementsPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório AutomaticPlacementsPerformance.
Date Date Segmento Dia Dia para o relatório AutomaticPlacementsPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório AutomaticPlacementsPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório AutomaticPlacementsPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
IsAutoOptimized Boolean Segmento Modo de segmentação Modo de segmentação para o relatório AutomaticPlacementsPerformance.
Month String Segmento Mês Mês do relatório AutomaticPlacementsPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório AutomaticPlacementsPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório AutomaticPlacementsPerformance.
Week String Segmento Semana Semana para o relatório AutomaticPlacementsPerformance.
Year Integer Segmento Ano Ano para o relatório AutomaticPlacementsPerformance.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório AutomaticPlacementsPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório AutomaticPlacementsPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório AutomaticPlacementsPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impressões por impr mensuráveis do Active View para o relatório AutomaticPlacementsPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório AutomaticPlacementsPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressão mensurável do Active View para o relatório AutomaticPlacementsPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório AutomaticPlacementsPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório AutomaticPlacementsPerformance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório AutomaticPlacementsPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório AutomaticPlacementsPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório AutomaticPlacementsPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório AutomaticPlacementsPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório AutomaticPlacementsPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório AutomaticPlacementsPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório AutomaticPlacementsPerformance.
Clicks Long Métrica Cliques Cliques para o relatório AutomaticPlacementsPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório AutomaticPlacementsPerformance.
Conversions Double Métrica Conversões Conversões para o relatório AutomaticPlacementsPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório AutomaticPlacementsPerformance.
Cost Decimal Métrica Custo Custo do relatório AutomaticPlacementsPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório AutomaticPlacementsPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório AutomaticPlacementsPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório AutomaticPlacementsPerformance.
Ctr Double Métrica CTR CTR para o relatório AutomaticPlacementsPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório AutomaticPlacementsPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório AutomaticPlacementsPerformance.
Impressions Long Métrica Impressões Impressões para o relatório AutomaticPlacementsPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório AutomaticPlacementsPerformance.
Interactions Long Métrica Interações Interações para o relatório AutomaticPlacementsPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório AutomaticPlacementsPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório AutomaticPlacementsPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório AutomaticPlacementsPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório AutomaticPlacementsPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório AutomaticPlacementsPerformance.
ViewThroughConversions Long Métrica Conv de visualização Conv de exibição para o relatório AutomaticPlacementsPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
LanceMetaDesempenho

O Relatório de desempenho da meta de lances inclui estatísticas para suas estratégias de lances.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountDescriptiveName String Atributo Conta Conta para o relatório BidGoalPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório BidGoalPerformance.
Id Long Atributo ID da estratégia de lances ID da estratégia de lances para o relatório BidGoalPerformance.
Name String Atributo Nome da estratégia de lance Nome da estratégia de lances para o relatório BidGoalPerformance.
PageOnePromotedBidCeiling Decimal Atributo Limite de lance (local de destino da página de pesquisa) Limite de lance (local da página de pesquisa de destino) para o relatório BidGoalPerformance.
PageOnePromotedBidChangesForRaisesOnly Boolean Atributo Automação de lances (localização da página de pesquisa de destino) Automação de lances (localização da página de pesquisa de destino) para o relatório BidGoalPerformance.
PageOnePromotedBidModifier Double Atributo Ajuste de lance (local da página de pesquisa de destino) Ajuste de lance (local da página de pesquisa de destino) para o relatório BidGoalPerformance.
PageOnePromotedRaiseBidWhenBudgetConstrained Boolean Atributo Orçamentos limitados (local de destino da página de pesquisa) Orçamentos limitados (local da página de pesquisa de destino) para o relatório BidGoalPerformance.
PageOnePromotedRaiseBidWhenLowQualityScore Boolean Atributo Palavras-chave de baixa qualidade (localização da página de pesquisa de destino) Palavras-chave de baixa qualidade (localização da página de pesquisa de destino) para o relatório BidGoalPerformance.
PageOnePromotedStrategyGoal String Atributo Localização (localização da página de pesquisa de destino) Local (local da página de pesquisa de destino) para o relatório BidGoalPerformance.
Status String Atributo Estado Estado para o relatório BidGoalPerformance. Os valores permitidos são ENABLED, REMOVED, UNKNOWN.
TargetCpa Decimal Atributo CPA alvo CPA desejado para o relatório BidGoalPerformance.
TargetCpaMaxCpcBidCeiling Decimal Atributo Limite de lance superior (CPA desejado) Limite de lance superior (CPA desejado) para o relatório BidGoalPerformance.
TargetCpaMaxCpcBidFloor Decimal Atributo Limite de lance inferior (CPA desejado) Limite de lance inferior (CPA desejado) para o relatório BidGoalPerformance.
TargetOutrankShare Double Atributo Meta de Superação de Classificação Parcela de superação desejada para o relatório BidGoalPerformance.
TargetOutrankShareBidChangesForRaisesOnly Boolean Atributo Automação de lances (parcela de superação desejada) Automação de lances (parcela de superação desejada) para o relatório BidGoalPerformance.
TargetOutrankShareCompetitorDomain String Atributo Domínio do Concorrente (Parcela de Superação Alvo) Domínio do concorrente (parcela de superação de destino) para o relatório BidGoalPerformance.
TargetOutrankShareMaxCpcBidCeiling Decimal Atributo Limite máximo superior de lance de Cpc (parcela de superação desejada) Limite máximo de lance de Cpc máximo (parcela de superação desejada) para o relatório BidGoalPerformance.
TargetOutrankShareRaiseBidWhenLowQualityScore Boolean Atributo Palavras-chave de baixa qualidade (parcela de superação desejada) Palavras-chave de baixa qualidade (parcela de superação desejada) para o relatório BidGoalPerformance.
TargetRoas Double Atributo ROAS alvo ROAS desejado para o relatório BidGoalPerformance.
TargetRoasBidCeiling Decimal Atributo Limite de lance superior (ROAS desejado) Limite de lance superior (ROAS desejado) para o relatório BidGoalPerformance.
TargetRoasBidFloor Decimal Atributo Limite de lance inferior (ROAS desejado) Limite de lance inferior (ROAS desejado) para o relatório BidGoalPerformance.
TargetSpendBidCeiling Decimal Atributo Limite de lance (maximizar cliques) Limite de lance (maximizar cliques) para o relatório BidGoalPerformance.
TargetSpendSpendTarget Decimal Atributo Meta de gastos (maximizar cliques) Gasto desejado (maximizar cliques) para o relatório BidGoalPerformance.
Type String Atributo Tipo de estratégia de lance Tipo de estratégia de lance para o relatório BidGoalPerformance. Os valores permitidos são MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório BidGoalPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório BidGoalPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório BidGoalPerformance.
Date Date Segmento Dia Dia para o relatório BidGoalPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório BidGoalPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório BidGoalPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Fonte de conversão para o relatório BidGoalPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
HourOfDay Integer Segmento Hora do dia Hora do dia para o relatório BidGoalPerformance.
Month String Segmento Mês Mês do relatório BidGoalPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório BidGoalPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório BidGoalPerformance.
Week String Segmento Semana Semana para o relatório BidGoalPerformance.
Year Integer Segmento Ano Ano para o relatório BidGoalPerformance.
AdGroupCount Integer Métrica Grupos de anúncios Grupos de anúncios para o relatório BidGoalPerformance.
AdGroupCriteriaCount Integer Métrica Palavras-chave Palavras-chave para o relatório BidGoalPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório BidGoalPerformance.
AllConversions Double Métrica Todas as conversões Todas as conversões para o relatório BidGoalPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conversão para o relatório BidGoalPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório BidGoalPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório BidGoalPerformance.
AveragePosition Double Métrica Posição Média Posição média para o relatório BidGoalPerformance.
CampaignCount Integer Métrica Campanhas Campanhas para o relatório BidGoalPerformance.
Clicks Long Métrica Cliques Cliques para o relatório BidGoalPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório BidGoalPerformance.
Conversions Double Métrica Conversões Conversões para o relatório BidGoalPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório BidGoalPerformance.
Cost Decimal Métrica Custo Custo do relatório BidGoalPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório BidGoalPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório BidGoalPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório BidGoalPerformance.
Ctr Double Métrica CTR CTR para o relatório BidGoalPerformance.
Impressions Long Métrica Impressões Impressões para o relatório BidGoalPerformance.
NonRemovedAdGroupCount Long Métrica Grupos de anúncios não removidos Grupos de anúncios não removidos para o relatório BidGoalPerformance.
NonRemovedAdGroupCriteriaCount Long Métrica Palavras-chave não removidas Palavras-chave não removidas para o relatório BidGoalPerformance.
NonRemovedCampaignCount Long Métrica Campanhas Não Removidas Campanhas não removidas para o relatório BidGoalPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório BidGoalPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório BidGoalPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório BidGoalPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
OrçamentoDesempenho

O relatório de desempenho do orçamento inclui todas as estatísticas agregadas por padrão no nível do orçamento, uma linha por orçamento.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountDescriptiveName String Atributo Conta Conta para o relatório BudgetPerformance.
Amount Decimal Atributo Orçamento Orçamento para o relatório BudgetPerformance.
BudgetId Long Atributo ID do orçamento ID do orçamento para o relatório BudgetPerformance.
BudgetName String Atributo Nome do Orçamento Nome do orçamento para o relatório BudgetPerformance.
BudgetReferenceCount Integer Atributo # Campanhas # Campanhas para o relatório BudgetPerformance.
BudgetStatus String Atributo Orçamento Estado Estado do orçamento para o relatório BudgetPerformance. Os valores permitidos são ENABLED, REMOVED, UNKNOWN.
DeliveryMethod String Atributo Método de entrega Método de entrega para o relatório BudgetPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório BudgetPerformance.
HasRecommendedBudget Boolean Atributo Tem Orçamento Recomendado Tem orçamento recomendado para o relatório BudgetPerformance.
IsBudgetExplicitlyShared Boolean Atributo Explicitamente compartilhado Explicitamente compartilhado para o relatório BudgetPerformance.
Period String Atributo Período Orçamentário Período de orçamento para o relatório BudgetPerformance.
RecommendedBudgetAmount Decimal Atributo Valor do orçamento recomendado Valor de orçamento recomendado para o relatório BudgetPerformance.
TotalAmount Decimal Atributo Valor total do orçamento Total Budget Amount para o relatório BudgetPerformance.
AssociatedCampaignId Long Segmento ID da campanha ID da campanha para o relatório BudgetPerformance.
AssociatedCampaignName String Segmento Campanha Campanha para o relatório BudgetPerformance.
AssociatedCampaignStatus String Segmento Estado da campanha Estado da campanha para o relatório BudgetPerformance. Os valores permitidos são ENABLED, PAUSED, REMOVED, UNKNOWN.
BudgetCampaignAssociationStatus String Segmento Uso do Orçamento Uso do orçamento para o relatório BudgetPerformance. Os valores permitidos são ENABLED, REMOVED, UNKNOWN.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório BudgetPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório BudgetPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório BudgetPerformance.
ExternalConversionSource String Segmento Origem da conversão Fonte de conversão para o relatório BudgetPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório BudgetPerformance.
AllConversions Double Métrica Todas as conversões Todas as conversões para o relatório BudgetPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conversão para o relatório BudgetPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório BudgetPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório BudgetPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório BudgetPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório BudgetPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório BudgetPerformance.
AveragePosition Double Métrica Posição Média Posição média para o relatório BudgetPerformance.
Clicks Long Métrica Cliques Cliques para o relatório BudgetPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório BudgetPerformance.
Conversions Double Métrica Conversões Conversões para o relatório BudgetPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório BudgetPerformance.
Cost Decimal Métrica Custo Custo do relatório BudgetPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório BudgetPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório BudgetPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório BudgetPerformance.
Ctr Double Métrica CTR CTR para o relatório BudgetPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório BudgetPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório BudgetPerformance.
Impressions Long Métrica Impressões Impressões para o relatório BudgetPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório BudgetPerformance.
Interactions Long Métrica Interações Interações para o relatório BudgetPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório BudgetPerformance.
RecommendedBudgetEstimatedChangeInWeeklyClicks Long Métrica Alteração estimada em cliques semanais no orçamento recomendado Alteração estimada em cliques semanais no orçamento recomendado para o relatório BudgetPerformance.
RecommendedBudgetEstimatedChangeInWeeklyCost Decimal Métrica Mudança estimada no custo semanal no orçamento recomendado Alteração estimada no custo semanal no orçamento recomendado para o relatório BudgetPerformance.
RecommendedBudgetEstimatedChangeInWeeklyInteractions Long Métrica Mudança estimada nas interações semanais no orçamento recomendado Alteração estimada nas interações semanais no orçamento recomendado para o relatório BudgetPerformance.
RecommendedBudgetEstimatedChangeInWeeklyViews Long Métrica Mudança estimada nas exibições semanais no orçamento recomendado Alteração estimada nas exibições semanais no orçamento recomendado para o relatório BudgetPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório BudgetPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório BudgetPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório BudgetPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório BudgetPerformance.
ViewThroughConversions Long Métrica Conv de visualização Conv de visualização para o relatório BudgetPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
CallMetricsCallDetails

O relatório Call Metrics Call Details inclui detalhes da chamada para sua extensão de chamada, incluindo a duração da chamada e o código de área do chamador.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório CallMetricsCallDetails.
AccountDescriptiveName String Atributo Conta Conta para o relatório CallMetricsCallDetails.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório CallMetricsCallDetails.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório CallMetricsCallDetails.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório CallMetricsCallDetails.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório CallMetricsCallDetails. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CallDuration Long Atributo Duração (segundos) Duração (segundos) para o relatório CallMetricsCallDetails.
CallEndTime Long Atributo Horário final Horário de término do relatório CallMetricsCallDetails.
CallerCountryCallingCode String Atributo Código do país do chamador Código do país do chamador para o relatório CallMetricsCallDetails.
CallerNationalDesignatedCode String Atributo Código de área do chamador Código de área do chamador para o relatório CallMetricsCallDetails.
CallStartTime Long Atributo Hora de início Horário de início do relatório CallMetricsCallDetails.
CallStatus String Atributo Estado Status do relatório CallMetricsCallDetails. Os valores permitidos são RECEIVED, MISSED, UNKNOWN.
CallTrackingDisplayLocation String Atributo Origem da chamada Origem da chamada para o relatório CallMetricsCallDetails. Os valores permitidos são UNKNOWN, AD, LANDING_PAGE.
CallType String Atributo Tipo de Chamada Tipo de chamada para o relatório CallMetricsCallDetails. Os valores permitidos são GOOGLE_SEARCH, HIGH_END_MOBILE_SEARCH, UNKNOWN.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório CallMetricsCallDetails.
CampaignName String Atributo Campanha Campanha para o relatório CallMetricsCallDetails.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório CallMetricsCallDetails. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório CallMetricsCallDetails.
Date Date Atributo Dia Dia para o relatório CallMetricsCallDetails.
DayOfWeek String Atributo Dia da semana Dia da semana para o relatório CallMetricsCallDetails. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório CallMetricsCallDetails.
HourOfDay Integer Atributo Hora do dia Hora do dia para o relatório CallMetricsCallDetails.
Month String Atributo Mês Mês para o relatório CallMetricsCallDetails.
MonthOfYear String Atributo mês do ano Mês do ano para o relatório CallMetricsCallDetails. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Atributo Trimestre Trimestre para o relatório CallMetricsCallDetails.
Week String Atributo Semana Semana para o relatório CallMetricsCallDetails.
Year Integer Atributo Ano Ano para o relatório CallMetricsCallDetails.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
CampaignAdScheduleTarget

O relatório Alvo de programação de anúncios da campanha resume o desempenho de campanhas por critérios AdSchedule.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório CampaignAdScheduleTarget.
AccountDescriptiveName String Atributo Conta Conta para o relatório CampaignAdScheduleTarget.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório CampaignAdScheduleTarget.
BidModifier Double Atributo Ajuste de lance Ajuste de lance para o relatório CampaignAdScheduleTarget.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório CampaignAdScheduleTarget.
CampaignName String Atributo Campanha Campanha para o relatório CampaignAdScheduleTarget.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório CampaignAdScheduleTarget. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório CampaignAdScheduleTarget.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório CampaignAdScheduleTarget.
Id Long Atributo Programação de anúncios Programação de anúncios para o relatório CampaignAdScheduleTarget.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório CampaignAdScheduleTarget.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório CampaignAdScheduleTarget.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório CampaignAdScheduleTarget.
Date Date Segmento Dia Dia para o relatório CampaignAdScheduleTarget.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório CampaignAdScheduleTarget. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório CampaignAdScheduleTarget.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório CampaignAdScheduleTarget. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório CampaignAdScheduleTarget.
Week String Segmento Semana Semana para o relatório CampaignAdScheduleTarget.
Year Integer Segmento Ano Ano para o relatório CampaignAdScheduleTarget.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório CampaignAdScheduleTarget.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório CampaignAdScheduleTarget.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conversão para o relatório CampaignAdScheduleTarget.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório CampaignAdScheduleTarget.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório CampaignAdScheduleTarget.
AverageCpe Double Métrica CPE médio CPE médio para o relatório CampaignAdScheduleTarget.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório CampaignAdScheduleTarget.
AverageCpv Double Métrica CPV médio CPV médio para o relatório CampaignAdScheduleTarget.
AveragePosition Double Métrica Posição Média Posição média para o relatório CampaignAdScheduleTarget.
Clicks Long Métrica Cliques Cliques para o relatório CampaignAdScheduleTarget.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório CampaignAdScheduleTarget.
Conversions Double Métrica Conversões Conversões para o relatório CampaignAdScheduleTarget.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório CampaignAdScheduleTarget.
Cost Decimal Métrica Custo Custo do relatório CampaignAdScheduleTarget.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório CampaignAdScheduleTarget.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório CampaignAdScheduleTarget.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório CampaignAdScheduleTarget.
Ctr Double Métrica CTR CTR para o relatório CampaignAdScheduleTarget.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório CampaignAdScheduleTarget.
Engagements Long Métrica Noivados Envolvimentos para o relatório CampaignAdScheduleTarget.
Impressions Long Métrica Impressões Impressões para o relatório CampaignAdScheduleTarget.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório CampaignAdScheduleTarget.
Interactions Long Métrica Interações Interações para o relatório CampaignAdScheduleTarget.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório CampaignAdScheduleTarget.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório CampaignAdScheduleTarget.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório CampaignAdScheduleTarget.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido até 100% para o relatório CampaignAdScheduleTarget.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido até 25% para o relatório CampaignAdScheduleTarget.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido até 50% para o relatório CampaignAdScheduleTarget.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido até 75% para o relatório CampaignAdScheduleTarget.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório CampaignAdScheduleTarget.
VideoViews Long Métrica Visualizações Exibições do relatório CampaignAdScheduleTarget.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório CampaignAdScheduleTarget.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Critérios de Campanha

O relatório Critérios de campanha é um relatório de estrutura que permite recuperar critérios em nível de campanha com eficiência.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório CampaignCriteria.
AccountDescriptiveName String Atributo Conta Conta para o relatório CampaignCriteria.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório CampaignCriteria.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório CampaignCriteria.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório CampaignCriteria.
CampaignName String Atributo Campanha Campanha para o relatório CampaignCriteria.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório CampaignCriteria. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
Criteria String Atributo Critério Critério para o relatório CampaignCriteria.
CriteriaType String Atributo Tipo de critério Tipo de critério para o relatório CampaignCriteria. Os valores permitidos são CONTENT_LABEL, KEYWORD, PLACEMENT, VERTICAL, USER_LIST, USER_INTEREST, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, PRODUCT_PARTITION, IP_BLOCK, WEBPAGE, LANGUAGE, LOCATION, AGE_RANGE, CARRIER, OPERATING_SYSTEM_VERSION, MOBILE_DEVICE, GENDER, PARENT, PROXIMITY, PLATAFORMA, PREFERRED_CONTENT, AD_SCHEDULE, LOCATION_GROUPS, PRODUCT_SCOPE, RUN_OF_NETWORK, CUSTOM_AFFINITY, CUSTOM_INTENT, YOUTUBE_VIDEO, YOUTUBE_CHANNEL, APP_PAYMENT_MODEL, INCOME_RANGE, INTERACTION_TYPE, UNKNOWN.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório CampaignCriteria.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório CampaignCriteria.
Id Long Atributo ID do critério ID do critério para o relatório CampaignCriteria.
IsNegative Boolean Atributo é negativo É negativo para o relatório CampaignCriteria.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
CampaignCriterionBidLandscape

O cenário de lances para um critério. Um cenário de lances estima o desempenho de um critério com base em diferentes valores de lances.

Colunas
Nome Tipo Comportamento DisplayName Descrição
CampaignId Long ID da campanha que contém o critério ao qual este cenário de lances está associado.
StartDate String Primeiro dia em que se baseia esta paisagem. Normalmente, pode ser até uma semana atrás.
EndDate String Último dia em que se baseia esta paisagem.
CriterionId Long ID do critério associado a esta paisagem.
Clicks Long Número estimado de cliques neste lance.
Cost Long Custo estimado neste lance.
Impressions Long Número estimado de impressões neste lance.
PromotedImpressions Long Número estimado de impressões promovidas.
RequiredBudget Long Orçamento diário necessário para alcançar as estatísticas previstas neste lance.
BidModifier Double O valor do modificador de lance desse ponto.
TotalLocalImpressions Long Total estimado de impressões para todos os dispositivos no cenário do modificador de lance para celular.
TotalLocalClicks Long Total estimado de cliques para todos os dispositivos no cenário do modificador de lance para celular.
TotalLocalCost Long Custo total estimado para todos os dispositivos no cenário do modificador de lance para celular.
TotalLocalPromotedImpressions Long Total estimado de impressões promovidas para todos os dispositivos no cenário do modificador de lance para celular.
Desempenho do Grupo de Campanhas

O relatório Desempenho do Grupo de Campanhas inclui as estatísticas de desempenho geral das campanhas que você incluiu nos grupos de campanhas. As estatísticas são agregadas por padrão no nível do grupo de campanha.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
Id Long Atributo ID do grupo de campanha ID do grupo de campanha para o relatório CampaignGroupPerformance.
Name String Atributo Nome do grupo de campanha Nome do grupo de campanha para o relatório CampaignGroupPerformance.
Status String Atributo Status do grupo de campanha Status do grupo de campanha para o relatório CampaignGroupPerformance. Os valores permitidos são UNKNOWN, ENABLED, REMOVED.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório CampaignGroupPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório CampaignGroupPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório CampaignGroupPerformance.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório CampaignGroupPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório CampaignGroupPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório CampaignGroupPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório CampaignGroupPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impr mensuráveis do Active View por impr para o relatório CampaignGroupPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório CampaignGroupPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressões mensuráveis do Active View para o relatório CampaignGroupPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório CampaignGroupPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório CampaignGroupPerformance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório CampaignGroupPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todo o valor de conversão para o relatório CampaignGroupPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório CampaignGroupPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório CampaignGroupPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório CampaignGroupPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório CampaignGroupPerformance.
Conversions Double Métrica Conversões Conversões para o relatório CampaignGroupPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório CampaignGroupPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório CampaignGroupPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório CampaignGroupPerformance.
CostPerCurrentModelAttributedConversion Double Métrica Custo por conversão (modelo atual) Custo por conversão (modelo atual) para o relatório CampaignGroupPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório CampaignGroupPerformance.
CurrentModelAttributedConversions Double Métrica Conversões (Modelo atual) Conversões (modelo atual) para o relatório CampaignGroupPerformance.
CurrentModelAttributedConversionValue Double Métrica Valor conv (modelo atual) Valor conv (modelo atual) para o relatório CampaignGroupPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório CampaignGroupPerformance.
Engagements Long Métrica Noivados Envolvimentos para o relatório CampaignGroupPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório CampaignGroupPerformance.
Interactions Long Métrica Interações Interações para o relatório CampaignGroupPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório CampaignGroupPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório CampaignGroupPerformance.
ValuePerCurrentModelAttributedConversion Double Métrica Valor por conversão (modelo atual) Valor por conversão (modelo atual) para o relatório CampaignGroupPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório CampaignGroupPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório CampaignGroupPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório CampaignGroupPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Local da Campanhaalvo

O relatório de segmentação por local da campanha resume o desempenho de campanhas por critério de campanha baseado em local.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório CampaignLocationTarget.
AccountDescriptiveName String Atributo Conta Conta para o relatório CampaignLocationTarget.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório CampaignLocationTarget.
BidModifier Double Atributo Ajuste de lance Ajuste de lance para o relatório CampaignLocationTarget.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório CampaignLocationTarget.
CampaignName String Atributo Campanha Campanha para o relatório CampaignLocationTarget.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório CampaignLocationTarget. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório CampaignLocationTarget.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório CampaignLocationTarget.
Id Long Atributo Localização Local para o relatório CampaignLocationTarget.
IsNegative Boolean Atributo é negativo É negativo para o relatório CampaignLocationTarget.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório CampaignLocationTarget.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório CampaignLocationTarget.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório CampaignLocationTarget.
Date Date Segmento Dia Dia para o relatório CampaignLocationTarget.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório CampaignLocationTarget. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório CampaignLocationTarget.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório CampaignLocationTarget. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório CampaignLocationTarget.
Week String Segmento Semana Semana para o relatório CampaignLocationTarget.
Year Integer Segmento Ano Ano para o relatório CampaignLocationTarget.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório CampaignLocationTarget.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório CampaignLocationTarget.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório CampaignLocationTarget.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório CampaignLocationTarget.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório CampaignLocationTarget.
AverageCpe Double Métrica CPE médio CPE médio para o relatório CampaignLocationTarget.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório CampaignLocationTarget.
AverageCpv Double Métrica CPV médio CPV médio para o relatório CampaignLocationTarget.
AveragePosition Double Métrica Posição Média Posição média para o relatório CampaignLocationTarget.
Clicks Long Métrica Cliques Cliques para o relatório CampaignLocationTarget.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório CampaignLocationTarget.
Conversions Double Métrica Conversões Conversões para o relatório CampaignLocationTarget.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório CampaignLocationTarget.
Cost Decimal Métrica Custo Custo do relatório CampaignLocationTarget.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório CampaignLocationTarget.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório CampaignLocationTarget.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório CampaignLocationTarget.
Ctr Double Métrica CTR CTR para o relatório CampaignLocationTarget.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório CampaignLocationTarget.
Engagements Long Métrica Noivados Envolvimentos para o relatório CampaignLocationTarget.
Impressions Long Métrica Impressões Impressões para o relatório CampaignLocationTarget.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório CampaignLocationTarget.
Interactions Long Métrica Interações Interações para o relatório CampaignLocationTarget.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório CampaignLocationTarget.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório CampaignLocationTarget.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório CampaignLocationTarget.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório CampaignLocationTarget.
VideoViews Long Métrica Visualizações Exibições para o relatório CampaignLocationTarget.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório CampaignLocationTarget.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
CampanhaNegativoPalavras-chaveDesempenho

Embora as palavras-chave negativas não contenham estatísticas, você pode usar este relatório estruturado para recuperar com eficiência atributos de objetos NegativeCampaignCriterion baseados em palavras-chave.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório CampaignNegativeKeywordsPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório CampaignNegativeKeywordsPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório CampaignNegativeKeywordsPerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório CampaignNegativeKeywordsPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório CampaignNegativeKeywordsPerformance.
CampaignName String Atributo Campanha Campanha para o relatório CampaignNegativeKeywordsPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório CampaignNegativeKeywordsPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
Criteria String Atributo Palavra-chave negativa Palavra-chave negativa para o relatório CampaignNegativeKeywordsPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório CampaignNegativeKeywordsPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório CampaignNegativeKeywordsPerformance.
Id Long Atributo ID da palavra-chave ID da palavra-chave para o relatório CampaignNegativeKeywordsPerformance.
IsNegative Boolean Atributo é negativo É negativo para o relatório CampaignNegativeKeywordsPerformance.
KeywordMatchType String Atributo Tipo de correspondência Tipo de correspondência para o relatório CampaignNegativeKeywordsPerformance. Os valores permitidos são EXACT, PHRASE, BROAD.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Locais Negativos da Campanha

Embora os locais negativos não contenham estatísticas, você pode usar este relatório estruturado para recuperar com eficiência atributos de objetos NegativeCampaignCriterion baseados em local.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório CampaignNegativeLocations.
AccountDescriptiveName String Atributo Conta Conta para o relatório CampaignNegativeLocations.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório CampaignNegativeLocations.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório CampaignNegativeLocations.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório CampaignNegativeLocations.
CampaignName String Atributo Campanha Campanha para o relatório CampaignNegativeLocations.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório CampaignNegativeLocations. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório CampaignNegativeLocations.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório CampaignNegativeLocations.
Id Long Atributo Localização Localização do relatório CampaignNegativeLocations.
IsNegative Boolean Atributo é negativo É negativo para o relatório CampaignNegativeLocations.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
CampanhaNegativoCanaisDesempenho

Embora as veiculações negativas não contenham estatísticas, você pode usar este relatório estruturado para recuperar com eficiência atributos de objetos NegativeCampaignCriterion baseados em veiculações.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório CampaignNegativePlacementsPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório CampaignNegativePlacementsPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório CampaignNegativePlacementsPerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório CampaignNegativePlacementsPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório CampaignNegativePlacementsPerformance.
CampaignName String Atributo Campanha Campanha para o relatório CampaignNegativePlacementsPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório CampaignNegativePlacementsPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
Criteria String Atributo Exclusão Exclusão do relatório CampaignNegativePlacementsPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório CampaignNegativePlacementsPerformance.
DisplayName String Atributo Nome de exibição dos critérios Nome de exibição de critérios para o relatório CampaignNegativePlacementsPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório CampaignNegativePlacementsPerformance.
Id Long Atributo ID da palavra-chave ID da palavra-chave para o relatório CampaignNegativePlacementsPerformance.
IsNegative Boolean Atributo é negativo É negativo para o relatório CampaignNegativePlacementsPerformance.
KeywordMatchType String Atributo Tipo de correspondência Tipo de correspondência para o relatório CampaignNegativePlacementsPerformance. Os valores permitidos são EXACT, PHRASE, BROAD.
VerticalId Long Atributo Identificação vertical ID vertical para o relatório CampaignNegativePlacementsPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Desempenho da Campanha

O relatório Desempenho das campanhas inclui todas as estatísticas agregadas por padrão no nível da campanha, uma linha por campanha.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar. Por exemplo, a consultar a seguir usa Dispositivo em vez do segmento Data padrão para consultar os dados de Desempenho da campanha:

SELECT CampaignId, CampaignName, Device, Clicks, ConversionRate, Impressions FROM CampaignPerformance

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords. Por exemplo, esta consultar retornará apenas as campanhas ativadas (que é o comportamento padrão no console do AdWords) com mais de 100 impressões:

SELECT CampaignName, CampaignStatus, Impressions FROM CampaignPerformance WHERE CampaignStatus='ENABLED' AND Impressions > 100
Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório CampaignPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório CampaignPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório CampaignPerformance.
AdvertisingChannelSubType String Atributo Subcanal Publicitário Subcanal de publicidade para o relatório CampaignPerformance. Os valores permitidos são UNKNOWN, SEARCH_MOBILE_APP, DISPLAY_MOBILE_APP, SEARCH_EXPRESS, DISPLAY_EXPRESS, UNIVERSAL_APP_CAMPAIGN, DISPLAY_SMART_CAMPAIGN, SHOPPING_GOAL_OPTIMIZED_ADS, DISPLAY_GMAIL_AD.
AdvertisingChannelType String Atributo Canal de Publicidade Canal de publicidade para o relatório CampaignPerformance. Os valores permitidos são UNKNOWN, SEARCH, DISPLAY, SHOPPING, VIDEO, MULTI_CHANNEL, EXPRESS.
Amount Decimal Atributo Orçamento Orçamento para o relatório CampaignPerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório CampaignPerformance.
BiddingStrategyId Long Atributo ID da estratégia de lances ID da estratégia de lances para o relatório CampaignPerformance.
BiddingStrategyName String Atributo Nome da estratégia de lance Nome da estratégia de lances para o relatório CampaignPerformance.
BiddingStrategyType String Atributo Tipo de estratégia de lance Tipo de estratégia de lance para o relatório CampaignPerformance. Os valores permitidos são MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BudgetId Long Atributo ID do orçamento ID do orçamento para o relatório CampaignPerformance.
CampaignDesktopBidModifier Double Atributo Ajuste de lance para computador Desktop Bid Adj para o relatório CampaignPerformance.
CampaignGroupId Long Atributo ID do grupo de campanha ID do grupo de campanha para o relatório CampaignPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório CampaignPerformance.
CampaignMobileBidModifier Double Atributo Ajuste de lance para celular Mobile Bid Adj para o relatório CampaignPerformance.
CampaignName String Atributo Campanha Campanha para o relatório CampaignPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório CampaignPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignTabletBidModifier Double Atributo Ajuste de lance para tablet Tablet Bid Adj para o relatório CampaignPerformance.
CampaignTrialType String Atributo Tipo de teste de campanha Tipo de teste de campanha para o relatório CampaignPerformance. Os valores permitidos são UNKNOWN, BASE, DRAFT, TRIAL.
ConversionAdjustment Boolean Atributo Ajuste de conversão Ajuste de conversão para o relatório CampaignPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório CampaignPerformance.
EndDate Date Atributo Data final Data de término do relatório CampaignPerformance.
EnhancedCpcEnabled Boolean Atributo CPC otimizado ativado CPC aprimorado ativado para o relatório CampaignPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório CampaignPerformance.
FinalUrlSuffix String Atributo Sufixo do URL final Sufixo de URL final para o relatório CampaignPerformance.
HasRecommendedBudget Boolean Atributo Tem Orçamento Recomendado Tem orçamento recomendado para o relatório CampaignPerformance.
IsBudgetExplicitlyShared Boolean Atributo Orçamento compartilhado explicitamente Orçamento explicitamente compartilhado para o relatório CampaignPerformance.
LabelIds String Atributo IDs de etiquetas IDs de rótulo para o relatório CampaignPerformance.
Labels String Atributo Etiquetas Rótulos para o relatório CampaignPerformance.
MaximizeConversionValueTargetRoas Double Atributo ROAS desejado (maximizar o valor da conversão) ROAS desejado (maximizar o valor da conversão) para o relatório CampaignPerformance.
Period String Atributo Período Orçamentário Período de orçamento para o relatório CampaignPerformance.
RecommendedBudgetAmount Decimal Atributo Valor do orçamento recomendado Valor do orçamento recomendado para o relatório CampaignPerformance.
ServingStatus String Atributo Status de veiculação da campanha Status de veiculação da campanha para o relatório CampaignPerformance. Os valores permitidos são SERVING, NONE, ENDED, PENDING, SUSPENDED.
StartDate Date Atributo Data de início Data de início do relatório CampaignPerformance.
TotalAmount Decimal Atributo Valor total do orçamento Valor total do orçamento para o relatório CampaignPerformance.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de rastreamento para o relatório CampaignPerformance.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro customizado para o relatório CampaignPerformance.
AdNetworkType1 String Segmento Rede Rede para o relatório CampaignPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório CampaignPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório CampaignPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionAdjustmentLagBucket String Segmento Dias Para Conversão Ou Ajuste Dias para conversão ou ajuste para o relatório CampaignPerformance. Os valores permitidos são UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_ 9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAY S, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CON VERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.
ConversionAttributionEventType String Segmento Tipo de evento de anúncio Tipo de evento de anúncio para o relatório CampaignPerformance. Os valores permitidos são UNKNOWN, IMPRESSION, INTERACTION.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório CampaignPerformance.
ConversionLagBucket String Segmento Dias Para Conversão Dias até a conversão para o relatório CampaignPerformance. Os valores permitidos são UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_ 9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório CampaignPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório CampaignPerformance.
Date Date Segmento Dia Dia para o relatório CampaignPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório CampaignPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório CampaignPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório CampaignPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
HourOfDay Integer Segmento Hora do dia Hora do dia para o relatório CampaignPerformance.
Month String Segmento Mês Mês para o relatório CampaignPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório CampaignPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório CampaignPerformance.
Slot String Segmento Top Vs Outro Top Vs Other para o relatório CampaignPerformance. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segmento Semana Semana para o relatório CampaignPerformance.
Year Integer Segmento Ano Ano para o relatório CampaignPerformance.
AbsoluteTopImpressionPercentage Double Métrica Impr Abs Top A porcentagem de impressões adicionadas mostradas como o primeiro anúncio.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório CampaignPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível CTR visível do Active View para o relatório CampaignPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório CampaignPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Active View mensurável impr por impr para o relatório CampaignPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório CampaignPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressões mensuráveis do Active View para o relatório CampaignPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório CampaignPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório CampaignPerformance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório CampaignPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório CampaignPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório CampaignPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório CampaignPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório CampaignPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório CampaignPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório CampaignPerformance.
AverageFrequency Double Métrica Freq média de impr. por cookie Freq média de impr. por cookie para o relatório CampaignPerformance.
AveragePageviews Double Métrica Páginas por sessão Páginas por sessão para o relatório CampaignPerformance.
AveragePosition Double Métrica Posição Média Posição média para o relatório CampaignPerformance.
AverageTimeOnSite Double Métrica Duração Média da Sessão (segundos) Duração média da sessão (segundos) para o relatório CampaignPerformance.
BounceRate Double Métrica Taxa de rejeição Taxa de rejeição para o relatório CampaignPerformance.
ClickAssistedConversions Long Métrica Clique em Conv Assistida Clique em Assisted Conv para o relatório CampaignPerformance.
ClickAssistedConversionsOverLastClickConversions Double Métrica Conv de clique assistido por último clique de conversão Clique em Conv assistida por último clique em Conv para o relatório CampaignPerformance.
ClickAssistedConversionValue Double Métrica Clique em Valor de conversão assistida Clique em Valor de conversão assistida para o relatório CampaignPerformance.
Clicks Long Métrica Cliques Cliques para o relatório CampaignPerformance.
ContentBudgetLostImpressionShare Double Métrica IS de conteúdo perdido (orçamento) Conteúdo Perdido IS (orçamento) para o relatório CampaignPerformance.
ContentImpressionShare Double Métrica Conteúdo Impr Compartilhar Compartilhamento de impressões de conteúdo para o relatório CampaignPerformance.
ContentRankLostImpressionShare Double Métrica IS de conteúdo perdido (classificação) É de conteúdo perdido (classificação) para o relatório CampaignPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório CampaignPerformance.
Conversions Double Métrica Conversões Conversões para o relatório CampaignPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório CampaignPerformance.
Cost Decimal Métrica Custo Custo do relatório CampaignPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conv para o relatório CampaignPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório CampaignPerformance.
CostPerCurrentModelAttributedConversion Double Métrica Custo por conversão (modelo atual) Custo por conversão (modelo atual) para o relatório CampaignPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Cross-device Conv para o relatório CampaignPerformance.
Ctr Double Métrica CTR CTR para o relatório CampaignPerformance.
CurrentModelAttributedConversions Double Métrica Conversões (Modelo atual) Conversões (modelo atual) para o relatório CampaignPerformance.
CurrentModelAttributedConversionValue Double Métrica Valor conv (modelo atual) Valor conv (modelo atual) para o relatório CampaignPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório CampaignPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório CampaignPerformance.
GmailForwards Long Métrica Encaminhamentos do Gmail Encaminhamentos do Gmail para o relatório CampaignPerformance.
GmailSaves Long Métrica Gmail salva Gmail salva para o relatório CampaignPerformance.
GmailSecondaryClicks Long Métrica Cliques do Gmail para o site Gmail Clicks To Website for the CampaignPerformance report.
ImpressionAssistedConversions Long Métrica Conv assistida por impressão Impr Assisted Conv para o relatório CampaignPerformance.
ImpressionAssistedConversionsOverLastClickConversions Double Métrica Conv de impressão assistida por último clique Conv Conv de impressão assistida por último clique Conv para o relatório CampaignPerformance.
ImpressionAssistedConversionValue Double Métrica Valor de conversão assistida por impressão Valor de conversão assistida por impressão para o relatório CampaignPerformance.
ImpressionReach Long Métrica Cookies Exclusivos Cookies exclusivos para o relatório CampaignPerformance.
Impressions Long Métrica Impressões Impressões para o relatório CampaignPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório CampaignPerformance.
Interactions Long Métrica Interações Interações para o relatório CampaignPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório CampaignPerformance.
InvalidClickRate Double Métrica Taxa de cliques inválida Taxa de cliques inválida para o relatório CampaignPerformance.
InvalidClicks Long Métrica Cliques inválidos Cliques inválidos para o relatório CampaignPerformance.
NumOfflineImpressions Long Métrica Impressões de telefone Impressões telefônicas para o relatório CampaignPerformance.
NumOfflineInteractions Long Métrica Chamadas telefônicas Chamadas telefônicas para o relatório CampaignPerformance.
OfflineInteractionRate Double Métrica PTR PTR para o relatório CampaignPerformance.
PercentNewVisitors Double Métrica Porcentagem de Novas Sessões Porcentagem de novas sessões para o relatório CampaignPerformance.
RelativeCtr Double Métrica CTR relativa CTR relativa para o relatório CampaignPerformance.
SearchAbsoluteTopImpressionShare Double Métrica Pesquisar Abs Top IS Pesquise Abs Top IS para obter o relatório CampaignPerformance.
SearchBudgetLostImpressionShare Double Métrica Pesquisar IS perdido (orçamento) Pesquise a parcela de impressões perdidas (orçamento) do relatório CampaignPerformance.
SearchClickShare Double Métrica Clique em Compartilhar Clique em Compartilhar para obter o relatório CampaignPerformance.
SearchExactMatchImpressionShare Double Métrica Pesquisar correspondência exata é Pesquisar É de correspondência exata para o relatório CampaignPerformance.
SearchImpressionShare Double Métrica Pesquisar Impr Compartilhar Pesquise Parcela de impressões para o relatório Desempenho da campanha.
SearchRankLostImpressionShare Double Métrica Pesquisar IS perdido (classificação) Pesquise a parcela de impressões perdidas (classificação) do relatório CampaignPerformance.
SearchTopImpressionShare Double Métrica Pesquisar top IS Pesquise os principais IS para obter o relatório CampaignPerformance.
TopImpressionPercentage Double Métrica Impr Início A porcentagem de impressões adicionadas que são exibidas em qualquer lugar acima dos resultados da pesquisa orgânica.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório CampaignPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório CampaignPerformance.
ValuePerCurrentModelAttributedConversion Double Métrica Valor por conversão (modelo atual) Valor por conversão (modelo atual) para o relatório CampaignPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido até 100% para o relatório de desempenho da campanha.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido em 25% para o relatório de desempenho da campanha.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido até 50% para o relatório CampaignPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido em 75% para o relatório de desempenho da campanha.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório CampaignPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório CampaignPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório CampaignPerformance.
Campanhas

Serviço para acessar detalhes sobre qualquer campanha.

Informações Específicas da Tabela

Selecione

Há duas maneiras de consultar Campanhas.

  • A consultar a seguir retorna a campanha especificada.

    SELECT * FROM [Campanhas] WHERE Id=123456789
    
  • A consultar a seguir retorna todas as campanhas.

    SELECT * FROM [Campaigns]
    
Colunas
Nome Tipo Comportamento DisplayName Descrição
Id [KEY] Long ID desta campanha.
CampaignGroupId Long ID do grupo de campanhas ao qual esta campanha pertence.
Name String Nome desta campanha.
Status String Status desta campanha.
ServingStatus String Estado de atendimento.
StartDate String Data de início da campanha.
EndDate String Data em que a campanha termina.
AdServingOptimizationStatus String Status de otimização da veiculação de anúncios.
AdvertisingChannelType String O destino de veiculação principal para anúncios nesta campanha.
AdvertisingChannelSubType String Refinamento opcional de AdvertisingChannelType.
CampaignTrialType String Indica se esta campanha é uma campanha normal, uma campanha de rascunho ou uma campanha de teste.
BaseCampaignId Long ID da campanha base do rascunho ou da campanha de teste.
TrackingUrlTemplate String Modelo de URL para construir um URL de rastreamento.
FinalUrlSuffix String Modelo de URL para anexar parâmetros ao URL final.
UrlCustomParameters String Uma lista de mapeamentos a serem usados para substituir tags de parâmetro personalizado de URL em trackingUrlTemplate, finalUrls e/ou finalMobileUrls.
SelectiveOptimization String Configuração de otimização seletiva para esta campanha, que inclui um conjunto de tipos de conversão para otimizar esta campanha.
BudgetId Long Um Budget é criado usando a operação BudgetService ADD e recebe um BudgetId.
BudgetName String Nome do Orçamento.
Amount Long Valor do orçamento na moeda local para a conta.
DeliveryMethod String Método de entrega para o orçamento que determina a taxa na qual o orçamento é gasto.
BudgetReferenceCount Int Número de campanhas que usam ativamente este orçamento.
IsBudgetExplicitlyShared Boolean Se verdadeiro, esse orçamento foi criado com o objetivo de compartilhar esse orçamento em uma ou mais campanhas.
BudgetStatus String Situação do orçamento.
Eligible Boolean Se a campanha for qualificada para entrar no otimizador de conversões.
FrequencyCapMaxImpressions Long Número máximo de impressões permitidas durante o intervalo de tempo por esse limite.
TimeUnit String Unidade de tempo em que o limite é definido.
Level String O nível no qual o limite deve ser aplicado (criativo/grupo de anúncios).
TargetGoogleSearch Boolean Os anúncios serão veiculados com os resultados de pesquisa do Google.com.
TargetSearchNetwork Boolean Os anúncios serão veiculados em sites parceiros na Rede de Pesquisa do Google
TargetContentNetwork Boolean Os anúncios serão exibidos em canais especificados na Rede de Display do Google.
TargetPartnerSearchNetwork Boolean Os anúncios serão veiculados na rede de parceiros do Google.
BiddingStrategyId Long ID da estratégia de lances a ser associada à campanha, ao grupo de anúncios ou aos critérios do grupo de anúncios.
BiddingStrategyName String Nome da estratégia de lances.
BiddingStrategyType String O tipo da estratégia de lance a ser anexada.
BiddingStrategySource String Indica onde a estratégia de lances está associada, ou seja, campanha, grupo de anúncios ou critério do grupo de anúncios.
TargetRoasOverride Double O retorno desejado sobre o gasto médio (ROAS).
VanityPharmaDisplayUrlMode String O modo de exibição para URLs de produtos farmacêuticos personalizados.
VanityPharmaText String O texto que será exibido no URL de visualização do anúncio de texto quando a descrição do site for o modo de exibição selecionado para URLs de produtos farmacêuticos personalizados.
BiddingStrategyGoalType String Representa a meta para a qual a estratégia de lances dessa campanha para apps deve ser otimizada.
AppId String Uma cadeia de caracteres que identifica exclusivamente um aplicativo móvel.
AppVendor String O fornecedor, ou seja, a loja de aplicativos que distribui esse aplicativo específico.
CampaignSharedSet

O relatório Conjunto compartilhado de campanha inclui todos os relacionamentos entre SharedSets e campanhas.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountDescriptiveName String Atributo Conta Conta para o relatório CampaignSharedSet.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório CampaignSharedSet.
CampaignName String Atributo Campanha Campanha para o relatório CampaignSharedSet.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório CampaignSharedSet. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório CampaignSharedSet.
SharedSetId Long Atributo ID do Conjunto Compartilhado ID do conjunto compartilhado para o relatório CampaignSharedSet.
SharedSetName String Atributo Nome do Conjunto Compartilhado Nome do conjunto compartilhado para o relatório CampaignSharedSet.
SharedSetType String Atributo Tipo de conjunto compartilhado Tipo de conjunto compartilhado para o relatório CampaignSharedSet. Os valores permitidos são NEGATIVE_KEYWORDS, NEGATIVE_PLACEMENTS, UNKNOWN.
Status String Atributo Estado Estado para o relatório CampaignSharedSet. Os valores permitidos são ENABLED, REMOVED, UNKNOWN.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
CliqueDesempenho

O relatório de desempenho do clique inclui estatísticas agregadas em cada nível de clique e inclui cliques válidos e inválidos. O campo KeywordId retornará todos os critérios que acionaram o clique, não apenas palavras-chave.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Observe que esta tabela oferece suporte apenas a consultas de um dia específico nos últimos 90 dias. Você precisará definir StartDate e EndDate com o mesmo valor na cláusula WHERE.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountDescriptiveName String Atributo Conta Conta para o relatório ClickPerformance.
AdFormat String Atributo Tipo de anúncio Tipo de anúncio para o relatório ClickPerformance. Os valores permitidos são UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório ClickPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório ClickPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório ClickPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
AdNetworkType1 String Atributo Rede Rede para o relatório ClickPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Atributo Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório ClickPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdVariationControlTrialArmId Long Atributo ID do braço de teste de controle de variação de anúncio ID do grupo de teste de controle de variação de anúncios para o relatório ClickPerformance.
AdVariationTreatmentTrialArmId Long Atributo ID do braço de teste de tratamento de variação de anúncio ID do grupo de teste de tratamento de variação de anúncio para o relatório ClickPerformance.
AdVariationTrialId Long Atributo ID de teste de variação de anúncio ID de teste de variação de anúncio para o relatório ClickPerformance.
AoiCityCriteriaId Integer Atributo Cidade (Local de Interesse) Cidade (local de interesse) para o relatório ClickPerformance.
AoiCountryCriteriaId Integer Atributo País por território (local de interesse) País por território (local de interesse) para o relatório ClickPerformance.
AoiMetroCriteriaId Integer Atributo Área Metropolitana (Local de Interesse) Área metropolitana (local de interesse) para o relatório ClickPerformance.
AoiMostSpecificTargetId Long Atributo Local de destino mais específico (local de interesse) Alvo de local mais específico (local de interesse) para o relatório ClickPerformance.
AoiRegionCriteriaId Integer Atributo Região (local de interesse) Região (local de interesse) para o relatório ClickPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório ClickPerformance.
CampaignLocationTargetId Long Atributo Alvo de localização da campanha Segmentação por local da campanha para o relatório ClickPerformance.
CampaignName String Atributo Campanha Campanha para o relatório ClickPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório ClickPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
Clicks Long Atributo Cliques Cliques para o relatório ClickPerformance.
ClickType String Atributo Clique em Tipo Clique em Tipo para o relatório ClickPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
CreativeId Long Atributo ID do anúncio ID do anúncio para o relatório ClickPerformance.
CriteriaId Long Atributo ID da palavra-chave ID da palavra-chave para o relatório ClickPerformance.
CriteriaParameters String Atributo Palavra-chave por canal Palavra-chave por canal para o relatório ClickPerformance.
Date Date Atributo Dia Dia para o relatório ClickPerformance.
Device String Atributo Dispositivo Dispositivo para o relatório ClickPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório ClickPerformance.
GclId String Atributo ID de clique do Google ID de clique do Google para o relatório ClickPerformance.
KeywordMatchType String Atributo Tipo de correspondência Tipo de correspondência para o relatório ClickPerformance. Os valores permitidos são UNKNOWN, EXACT, PHRASE, BROAD.
LopCityCriteriaId Integer Atributo Cidade (localização física) Cidade (localização física) para o relatório ClickPerformance.
LopCountryCriteriaId Integer Atributo País por território (localização física) País por território (localização física) para o relatório ClickPerformance.
LopMetroCriteriaId Integer Atributo Área metropolitana (localização física) Área metropolitana (localização física) para o relatório ClickPerformance.
LopMostSpecificTargetId Long Atributo Alvo de localização mais específica (localização física) Alvo de local mais específico (local físico) para o relatório ClickPerformance.
LopRegionCriteriaId Integer Atributo Região (localização física) Região (localização física) para o relatório ClickPerformance.
MonthOfYear String Atributo mês do ano Mês do ano para o relatório ClickPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Page Integer Atributo Página Página do relatório ClickPerformance.
Slot String Atributo Top Vs Outro Top Vs Other para o relatório ClickPerformance. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
UserListId Long Atributo ID da lista de usuários ID da lista de usuários para o relatório ClickPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Rastreadores de Conversão

Serviço para acessar detalhes sobre qualquer rastreador de conversão.

Informações Específicas da Tabela

Selecione

Há duas maneiras de consultar ConversionTrackers.

  • A consultar a seguir retorna o rastreador de conversão especificado.

    SELECT * FROM [Rastreadores de Conversão] WHERE Id=123456789
    
  • A consultar a seguir retorna todos os rastreadores de conversão.

    SELECT * FROM [ConversionTrackers]
    
Colunas
Nome Tipo Comportamento DisplayName Descrição
Id [KEY] Long ID deste rastreador de conversão, nulo ao criar um novo.
OriginalConversionTypeId Long O ID do tipo de conversão original no qual este ConversionType se baseia.
Name String Nome desse rastreador de conversão.
Status String Status deste rastreador de conversão.
Category String A categoria de conversão que está sendo rastreada.
GoogleEventSnippet String O snippet de evento que funciona com a tag global do site para rastrear ações que devem ser contabilizadas como conversões.
GoogleGlobalSiteTag String A tag global do site que adiciona visitantes às suas listas básicas de remarketing e define novos cookies em seu domínio, que armazenam informações sobre o clique no anúncio que levou o usuário ao seu site.
DataDrivenModelStatus String O status do modelo de atribuição baseada em dados para o tipo de conversão.
ConversionTypeOwnerCustomerId Long O ID do cliente externo do proprietário do tipo de conversão ou 0 se este for um tipo de conversão definido pelo sistema.
ViewthroughLookbackWindow Int Janela de lookback para conversões de visualização em dias.
CtcLookbackWindow Int A janela de lookback da conversão por clique (ctc) é o número máximo de dias entre o momento em que um evento de conversão ocorre e o clique anterior correspondente no anúncio.
CountingType String Como contar eventos para este rastreador de conversão.
DefaultRevenueValue Double O valor a ser usado quando a tag desse rastreador de conversão envia eventos de conversão sem valores.
DefaultRevenueCurrencyCode String O código de moeda a ser usado quando a tag desse rastreador de conversão envia eventos de conversão sem códigos de moeda.
AlwaysUseDefaultRevenueValue Boolean Controla se os valores do evento de conversão e os códigos de moeda são obtidos do snippet de tag ou de ConversionTracker.defaultRevenueValue e ConversionTracker.defaultRevenueCurrencyCode.
ExcludeFromBidding Boolean Se esse rastreador de conversão deve ser excluído do
AttributionModelType String Modelos de atribuição que descrevem como distribuir crédito para uma conversão específica em muitas interações anteriores.
MostRecentConversionDate String A data do clique mais recente no anúncio que levou a uma conversão desse tipo de conversão.
LastReceivedRequestTime String A última vez que uma tag de conversão para esse tipo de conversão foi disparada com êxito e vista pelo Google AdWords.
ConversionTrackerType String Indica que esta instância é um subtipo de ConversionTracker.
PhoneCallDuration Long A duração da chamada telefônica (em segundos) após a qual uma conversão deve ser relatada
TrackingCodeType String Código de rastreamento a ser usado para o tipo de conversão.
AppId String ID do aplicativo do rastreador de conversão do aplicativo.
AppPlatform String Plataforma de aplicativo do rastreador de conversão de aplicativo.
AppConversionType String O tipo de AppConversion, que identifica uma conversão como sendo download ou compra no aplicativo.
AppPostbackUrl String A URL de postback.
Snippet String O snippet gerado para este rastreador de conversão.
IsExternallyAttributed Boolean Se esta conversão está usando um modelo de atribuição externo.
CreativeConversion

Cliques gratuitos são interações que ocorrem antes de um clique para anúncios em vídeo, anúncios gráficos, extensões de produto e extensões de local, interações como uma reprodução de vídeo ou obter direções.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório CreativeConversion.
AccountDescriptiveName String Atributo Conta Conta para o relatório CreativeConversion.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório CreativeConversion.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório CreativeConversion.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório CreativeConversion.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório CreativeConversion. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório CreativeConversion.
CampaignName String Atributo Campanha Campanha para o relatório CreativeConversion.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório CreativeConversion. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CreativeId Long Atributo ID do anúncio ID do anúncio para o relatório CreativeConversion.
CriteriaParameters String Atributo Palavra-chave por canal Palavra-chave por canal para o relatório CreativeConversion.
CriteriaTypeName String Atributo Tipo de correspondência Tipo de correspondência para o relatório CreativeConversion.
CriterionId Long Atributo ID da palavra-chave ID da palavra-chave para o relatório CreativeConversion.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório CreativeConversion.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório CreativeConversion.
AdNetworkType1 String Segmento Rede Rede para o relatório CreativeConversion. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório CreativeConversion. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionTrackerId Long Segmento Tipo de clique grátis Tipo de clique gratuito para o relatório CreativeConversion.
Date Date Segmento Dia Dia para o relatório CreativeConversion.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório CreativeConversion. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Month String Segmento Mês Mês para o relatório CreativeConversion.
Quarter String Segmento Trimestre Trimestre para o relatório CreativeConversion.
Week String Segmento Semana Semana para o relatório CreativeConversion.
Year Integer Segmento Ano Ano para o relatório CreativeConversion.
CreativeConversionRate Double Métrica Taxa de cliques grátis Taxa de cliques grátis para o relatório CreativeConversion.
CreativeConversions Long Métrica Cliques Grátis Cliques gratuitos para o relatório CreativeConversion.
Impressions Long Métrica Impressões Impressões para o relatório CreativeConversion.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
CritériosDesempenho

O Relatório de desempenho de critérios inclui estatísticas agregadas no nível dos critérios do grupo de anúncios, uma linha por grupo de anúncios e combinação de critérios.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório CriteriaPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório CriteriaPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório CriteriaPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório CriteriaPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório CriteriaPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório CriteriaPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
ApprovalStatus String Atributo Status de aprovação Status de aprovação para o relatório CriteriaPerformance. Os valores permitidos são APPROVED, PENDING_REVIEW, UNDER_REVIEW, DISAPPROVED.
BaseAdGroupId Long Atributo ID do grupo de anúncios base ID do grupo de anúncios base para o relatório CriteriaPerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório CriteriaPerformance.
BidModifier Double Atributo Ajuste de lance Ajuste de lance para o relatório CriteriaPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório CriteriaPerformance.
CampaignName String Atributo Campanha Campanha para o relatório CriteriaPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório CriteriaPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
ConversionAdjustment Boolean Atributo Ajuste de conversão Ajuste de conversão para o relatório CriteriaPerformance.
CpcBid Decimal Atributo CPC máximo CPC máximo para o relatório CriteriaPerformance.
CpcBidSource String Atributo Origem do CPC máx. Origem do CPC máximo para o relatório CriteriaPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Atributo CPM máximo CPM máximo para o relatório CriteriaPerformance.
CpvBid Decimal Atributo CPV máximo CPV máximo para o relatório CriteriaPerformance.
CpvBidSource String Atributo Fonte de CPV máx. Origem do CPV máximo para o relatório CriteriaPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CreativeQualityScore String Atributo Relevância do anúncio Relevância do anúncio para o relatório CriteriaPerformance. Os valores permitidos são UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
Criteria String Atributo Palavra-chave por canal Palavra-chave por canal para o relatório CriteriaPerformance.
CriteriaDestinationUrl String Atributo URL de destino de palavra-chave por canal URL de destino de palavra-chave por canal para o relatório CriteriaPerformance.
CriteriaType String Atributo Tipo de critério Tipo de critério para o relatório CriteriaPerformance. Os valores permitidos são CONTENT_LABEL, KEYWORD, PLACEMENT, VERTICAL, USER_LIST, USER_INTEREST, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, PRODUCT_PARTITION, IP_BLOCK, WEBPAGE, LANGUAGE, LOCATION, AGE_RANGE, CARRIER, OPERATING_SYSTEM_VERSION, MOBILE_DEVICE, GENDER, PARENT, PROXIMITY, PLATAFORMA, PREFERRED_CONTENT, AD_SCHEDULE, LOCATION_GROUPS, PRODUCT_SCOPE, RUN_OF_NETWORK, CUSTOM_AFFINITY, CUSTOM_INTENT, YOUTUBE_VIDEO, YOUTUBE_CHANNEL, APP_PAYMENT_MODEL, INCOME_RANGE, INTERACTION_TYPE, UNKNOWN.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório CriteriaPerformance.
DisplayName String Atributo Nome de exibição dos critérios Nome de exibição de critérios para o relatório CriteriaPerformance.
EnhancedCpcEnabled Boolean Atributo CPC otimizado ativado CPC aprimorado ativado para o relatório CriteriaPerformance.
EstimatedAddClicksAtFirstPositionCpc Long Atributo Est Adicionar cliques por semana (primeiro lance de posição) Est Adicionar cliques por semana (primeiro lance de posição) para o relatório CriteriaPerformance.
EstimatedAddCostAtFirstPositionCpc Decimal Atributo Est Adicionar custo por semana (primeiro lance de posição) Est Adicionar custo por semana (primeiro lance de posição) para o relatório CriteriaPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório CriteriaPerformance.
FinalAppUrls String Atributo URL final do aplicativo URL final do aplicativo para o relatório CriteriaPerformance.
FinalMobileUrls String Atributo URL final móvel URL final móvel para o relatório CriteriaPerformance.
FinalUrls String Atributo URL final URL final para o relatório CriteriaPerformance.
FinalUrlSuffix String Atributo Sufixo do URL final Sufixo de URL final para o relatório CriteriaPerformance.
FirstPageCpc String Atributo Primeira Página CPC CPC de primeira página para o relatório CriteriaPerformance.
FirstPositionCpc String Atributo Primeira Posição CPC Primeira posição CPC para o relatório CriteriaPerformance.
HasQualityScore Boolean Atributo Possui Índice de Qualidade Possui Índice de qualidade para o relatório CriteriaPerformance.
Id Long Atributo ID da palavra-chave ID da palavra-chave para o relatório CriteriaPerformance.
IsNegative Boolean Atributo é negativo É negativo para o relatório CriteriaPerformance.
LabelIds String Atributo IDs de etiquetas IDs de rótulo para o relatório CriteriaPerformance.
Labels String Atributo Etiquetas Rótulos para o relatório CriteriaPerformance.
Parameter String Atributo Alvo de anúncio dinâmico Alvo de anúncio dinâmico para o relatório CriteriaPerformance.
PostClickQualityScore String Atributo Experiência da página de destino Experiência da página de destino para o relatório CriteriaPerformance. Os valores permitidos são UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
QualityScore Integer Atributo Índice de qualidade Índice de qualidade para o relatório CriteriaPerformance.
SearchPredictedCtr String Atributo Taxa de cliques esperada Taxa de cliques esperada para o relatório CriteriaPerformance. Os valores permitidos são UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
Status String Atributo Palavra-chave por estado do canal Palavra-chave por estado de veiculação para o relatório CriteriaPerformance. Os valores permitidos são ENABLED, REMOVED, PAUSED.
SystemServingStatus String Atributo Status de veiculação do critério Status de exibição do critério para o relatório CriteriaPerformance. Os valores permitidos são ELIGIBLE, RARELY_SERVED.
TopOfPageCpc String Atributo Topo da página CPC Top Of Page CPC para o relatório CriteriaPerformance.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de acompanhamento para o relatório CriteriaPerformance.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro personalizado para o relatório CriteriaPerformance.
VerticalId Long Atributo Identificação Vertical ID vertical para o relatório CriteriaPerformance.
AdNetworkType1 String Segmento Rede Rede para o relatório CriteriaPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório CriteriaPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório CriteriaPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionAdjustmentLagBucket String Segmento Dias Para Conversão Ou Ajuste Dias para conversão ou ajuste para o relatório CriteriaPerformance. Os valores permitidos são UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_ 9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAY S, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CON VERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório CriteriaPerformance.
ConversionLagBucket String Segmento Dias Para Conversão Dias até a conversão para o relatório CriteriaPerformance. Os valores permitidos são UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_ 9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório CriteriaPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório CriteriaPerformance.
Date Date Segmento Dia Dia para o relatório CriteriaPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório CriteriaPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório CriteriaPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório CriteriaPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês para o relatório CriteriaPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório CriteriaPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório CriteriaPerformance.
Slot String Segmento Top Vs Outro Top Vs Other para o relatório CriteriaPerformance. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segmento Semana Semana para o relatório CriteriaPerformance.
Year Integer Segmento Ano Ano para o relatório CriteriaPerformance.
AbsoluteTopImpressionPercentage Double Métrica Impr Abs Top A porcentagem de impressões adicionadas mostradas como o primeiro anúncio.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório CriteriaPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório CriteriaPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório CriteriaPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impr mensuráveis do Active View por impr para o relatório CriteriaPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório CriteriaPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressão mensurável do Active View para o relatório CriteriaPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório CriteriaPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório CriteriaPerformance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório CriteriaPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conversão para o relatório CriteriaPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório CriteriaPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório CriteriaPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório CriteriaPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório CriteriaPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório CriteriaPerformance.
AveragePosition Double Métrica Posição Média Posição média para o relatório CriteriaPerformance.
Clicks Long Métrica Cliques Cliques para o relatório CriteriaPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório CriteriaPerformance.
Conversions Double Métrica Conversões Conversões para o relatório CriteriaPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório CriteriaPerformance.
Cost Decimal Métrica Custo Custo do relatório CriteriaPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório CriteriaPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório CriteriaPerformance.
CostPerCurrentModelAttributedConversion Double Métrica Custo por conversão (modelo atual) Custo por conversão (modelo atual) para o relatório CriteriaPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório CriteriaPerformance.
Ctr Double Métrica CTR CTR para o relatório CriteriaPerformance.
CurrentModelAttributedConversions Double Métrica Conversões (Modelo atual) Conversões (Modelo atual) para o relatório CriteriaPerformance.
CurrentModelAttributedConversionValue Double Métrica Valor conv (modelo atual) Valor Conv (modelo atual) para o relatório CriteriaPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório CriteriaPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório CriteriaPerformance.
GmailForwards Long Métrica Encaminhamentos do Gmail Encaminhamentos do Gmail para o relatório CriteriaPerformance.
GmailSaves Long Métrica Gmail salva Gmail salva para o relatório CriteriaPerformance.
GmailSecondaryClicks Long Métrica Cliques do Gmail para o site Gmail Clicks To Website para o relatório CriteriaPerformance.
Impressions Long Métrica Impressões Impressões para o relatório CriteriaPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório CriteriaPerformance.
Interactions Long Métrica Interações Interações para o relatório CriteriaPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório CriteriaPerformance.
TopImpressionPercentage Double Métrica Impr Início A porcentagem de impressões adicionadas que são exibidas em qualquer lugar acima dos resultados da pesquisa orgânica.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório CriteriaPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório CriteriaPerformance.
ValuePerCurrentModelAttributedConversion Double Métrica Valor por conversão (modelo atual) Valor por conversão (modelo atual) para o relatório CriteriaPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido até 100% para o relatório CriteriaPerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido em 25% para o relatório CriteriaPerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido até 50% para o relatório CriteriaPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido em 75% para o relatório CriteriaPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório CriteriaPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório CriteriaPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório CriteriaPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
CriterionBidLandscape

O cenário de lances para um critério. Um cenário de lances estima o desempenho de um critério com base em diferentes valores de lances.

Colunas
Nome Tipo Comportamento DisplayName Descrição
CampaignId Long ID da campanha que contém o critério ao qual este cenário de lances está associado.
AdGroupId Long ID do grupo de anúncios que contém o critério ao qual esse cenário de lance está associado.
StartDate String Primeiro dia em que se baseia esta paisagem. Normalmente, pode ser até uma semana atrás.
EndDate String Último dia em que se baseia esta paisagem.
CriterionId Long ID do critério associado a esta paisagem.
Bid Long O valor do lance usado para estimar os dados desse ponto de paisagem.
Clicks Long Número estimado de cliques neste lance.
Cost Long Custo estimado neste lance.
Impressions Long Número estimado de impressões neste lance.
PromotedImpressions Long Número estimado de impressões promovidas.
BiddableConversions Double Número estimado de conversões que recebem lances.
BiddableConversionsValue Double Valor estimado das conversões que recebem lances.
Clientes

Serviço para acessar detalhes básicos sobre qualquer cliente.

Informações Específicas da Tabela

Selecione

Existem duas maneiras de consultar Clientes.

  • A consultar a seguir retorna o cliente especificado.

    SELECT * FROM [Clientes] WHERE CustomerID=6101846543
    
  • A consultar a seguir retorna todos os clientes.

    SELECT * FROM [Customers]
    
Colunas
Nome Tipo Comportamento DisplayName Descrição
CustomerId [KEY] String ID do cliente do cliente.
CurrencyCode String CurrencyCode do cliente.
DateTimeZone String DateTimeZone do cliente.
DescriptiveName String Nome do Cliente.
CanManageClients Boolean Booleano mostrando se o Cliente pode gerenciar clientes.
TestAccount Boolean Booleano mostrando se a conta é uma conta de teste.
AutoTaggingEnabled Boolean Shofing booleano se o AutoTagging estiver habilitado.
ParallelTrackingEnabled Boolean Shofing booleano se o ParallellTracking estiver ativado.
EffectiveConversionTrackingId Long ID de EffectiveConversionTracking.
UsesCrossAccountConversionTracking String Shofing booleano se UsesCrossAccountConversionTracking estiver habilitado.
Snippet String Trecho.
GoogleGlobalSiteTag String GoogleGlobalSiteTag.
ExibiçãoPalavra-chaveDesempenho

O relatório de desempenho da palavra-chave da Rede de Display inclui todas as estatísticas da rede de exibição agregadas no nível da palavra-chave, uma linha por palavra-chave.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório DisplayKeywordPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório DisplayKeywordPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório DisplayKeywordPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório DisplayKeywordPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório DisplayKeywordPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório DisplayKeywordPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
BaseAdGroupId Long Atributo ID do grupo de anúncios base ID do grupo de anúncios base para o relatório DisplayKeywordPerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório DisplayKeywordPerformance.
BiddingStrategyId Long Atributo ID da estratégia de lances ID da estratégia de lances para o relatório DisplayKeywordPerformance.
BiddingStrategyName String Atributo Nome da estratégia de lance Nome da estratégia de lances para o relatório DisplayKeywordPerformance.
BiddingStrategyType String Atributo Tipo de estratégia de lance Tipo de estratégia de lance para o relatório DisplayKeywordPerformance. Os valores permitidos são MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório DisplayKeywordPerformance.
CampaignName String Atributo Campanha Campanha para o relatório DisplayKeywordPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório DisplayKeywordPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Atributo CPC máximo CPC máximo para o relatório DisplayKeywordPerformance.
CpcBidSource String Atributo Origem do CPC máx. Origem de CPC máximo para o relatório DisplayKeywordPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Atributo CPM máximo CPM máximo para o relatório DisplayKeywordPerformance.
CpmBidSource String Atributo Origem do CPM máx. Origem do CPM máximo para o relatório DisplayKeywordPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpvBid Decimal Atributo CPV máximo CPV máximo para o relatório DisplayKeywordPerformance.
CpvBidSource String Atributo Fonte de CPV máx. Origem do CPV máximo para o relatório DisplayKeywordPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Atributo Palavra-chave Palavra-chave para o relatório DisplayKeywordPerformance.
CriteriaDestinationUrl String Atributo URL de destino URL de destino para o relatório DisplayKeywordPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório DisplayKeywordPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório DisplayKeywordPerformance.
FinalAppUrls String Atributo URL final do aplicativo URL final do aplicativo para o relatório DisplayKeywordPerformance.
FinalMobileUrls String Atributo URL final móvel URL final móvel para o relatório DisplayKeywordPerformance.
FinalUrls String Atributo URL final URL final para o relatório DisplayKeywordPerformance.
Id Long Atributo ID da palavra-chave ID da palavra-chave para o relatório DisplayKeywordPerformance.
IsNegative Boolean Atributo é negativo É negativo para o relatório DisplayKeywordPerformance.
IsRestrict Boolean Atributo está restringindo É uma restrição para o relatório DisplayKeywordPerformance.
Status String Atributo Palavra-chave Estado Estado da palavra-chave para o relatório DisplayKeywordPerformance. Os valores permitidos são ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de rastreamento para o relatório DisplayKeywordPerformance.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro personalizado para o relatório DisplayKeywordPerformance.
AdNetworkType1 String Segmento Rede Rede para o relatório DisplayKeywordPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório DisplayKeywordPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório DisplayKeywordPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório DisplayKeywordPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório DisplayKeywordPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório DisplayKeywordPerformance.
Date Date Segmento Dia Dia para o relatório DisplayKeywordPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório DisplayKeywordPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório DisplayKeywordPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório DisplayKeywordPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório DisplayKeywordPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório DisplayKeywordPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório DisplayKeywordPerformance.
Week String Segmento Semana Semana para o relatório DisplayKeywordPerformance.
Year Integer Segmento Ano Ano do relatório DisplayKeywordPerformance.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório DisplayKeywordPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório DisplayKeywordPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório DisplayKeywordPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impressão mensurável do Active View por impressão para o relatório DisplayKeywordPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório DisplayKeywordPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressões mensuráveis do Active View para o relatório DisplayKeywordPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório DisplayKeywordPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório DisplayKeywordPerformance.
AllConversions Double Métrica Todas as conversões Todas as conversões para o relatório DisplayKeywordPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório DisplayKeywordPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório DisplayKeywordPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório DisplayKeywordPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório DisplayKeywordPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório DisplayKeywordPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório DisplayKeywordPerformance.
Clicks Long Métrica Cliques Cliques para o relatório DisplayKeywordPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório DisplayKeywordPerformance.
Conversions Double Métrica Conversões Conversões para o relatório DisplayKeywordPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório DisplayKeywordPerformance.
Cost Decimal Métrica Custo Custo do relatório DisplayKeywordPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório DisplayKeywordPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório DisplayKeywordPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório DisplayKeywordPerformance.
Ctr Double Métrica CTR CTR para o relatório DisplayKeywordPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório DisplayKeywordPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório DisplayKeywordPerformance.
GmailForwards Long Métrica Encaminhamentos do Gmail Encaminhamentos do Gmail para o relatório DisplayKeywordPerformance.
GmailSaves Long Métrica Gmail salva Gmail salva para o relatório DisplayKeywordPerformance.
GmailSecondaryClicks Long Métrica Cliques do Gmail para o site Gmail Clicks To Website para o relatório DisplayKeywordPerformance.
Impressions Long Métrica Impressões Impressões para o relatório DisplayKeywordPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório DisplayKeywordPerformance.
Interactions Long Métrica Interações Interações para o relatório DisplayKeywordPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório DisplayKeywordPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório DisplayKeywordPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório DisplayKeywordPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido até 100% para o relatório DisplayKeywordPerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido até 25% para o relatório DisplayKeywordPerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido até 50% para o relatório DisplayKeywordPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido até 75% para o relatório DisplayKeywordPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório DisplayKeywordPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório DisplayKeywordPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório DisplayKeywordPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
DisplayTopicsDesempenho

O relatório de desempenho de tópicos de exibição inclui todas as estatísticas da rede de exibição agregadas no nível do tópico, uma linha por tópico.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório DisplayTopicsPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório DisplayTopicsPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório DisplayTopicsPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório DisplayTopicsPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório DisplayTopicsPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório DisplayTopicsPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
BaseAdGroupId Long Atributo ID do grupo de anúncios base ID do grupo de anúncios base para o relatório DisplayTopicsPerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório DisplayTopicsPerformance.
BiddingStrategyId Long Atributo ID da estratégia de lances ID da estratégia de lances para o relatório DisplayTopicsPerformance.
BiddingStrategyName String Atributo Nome da estratégia de lance Nome da estratégia de lances para o relatório DisplayTopicsPerformance.
BiddingStrategyType String Atributo Tipo de estratégia de lance Tipo de estratégia de lance para o relatório DisplayTopicsPerformance. Os valores permitidos são MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BidModifier Double Atributo Ajuste de lance Ajuste de lance para o relatório DisplayTopicsPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório DisplayTopicsPerformance.
CampaignName String Atributo Campanha Campanha para o relatório DisplayTopicsPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório DisplayTopicsPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Atributo CPC máximo CPC máximo para o relatório DisplayTopicsPerformance.
CpcBidSource String Atributo Origem do CPC máx. Origem do CPC máximo para o relatório DisplayTopicsPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Atributo CPM máximo CPM máximo para o relatório DisplayTopicsPerformance.
CpmBidSource String Atributo Origem do CPM máx. Origem do CPM máximo para o relatório DisplayTopicsPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Atributo Tópico Tópico para o relatório DisplayTopicsPerformance.
CriteriaDestinationUrl String Atributo URL de destino URL de destino para o relatório DisplayTopicsPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório DisplayTopicsPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório DisplayTopicsPerformance.
FinalAppUrls String Atributo URL final do aplicativo URL final do aplicativo para o relatório DisplayTopicsPerformance.
FinalMobileUrls String Atributo URL final móvel URL final móvel para o relatório DisplayTopicsPerformance.
FinalUrls String Atributo URL final URL final do relatório DisplayTopicsPerformance.
Id Long Atributo ID do critério ID do critério para o relatório DisplayTopicsPerformance.
IsNegative Boolean Atributo é negativo É negativo para o relatório DisplayTopicsPerformance.
IsRestrict Boolean Atributo está restringindo É uma restrição para o relatório DisplayTopicsPerformance.
Status String Atributo Estado do Tópico Estado do tópico para o relatório DisplayTopicsPerformance. Os valores permitidos são ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de rastreamento para o relatório DisplayTopicsPerformance.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro personalizado para o relatório DisplayTopicsPerformance.
VerticalId Long Atributo Identificação vertical ID vertical para o relatório DisplayTopicsPerformance.
AdNetworkType1 String Segmento Rede Network para o relatório DisplayTopicsPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório DisplayTopicsPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório DisplayTopicsPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório DisplayTopicsPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório DisplayTopicsPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório DisplayTopicsPerformance.
Date Date Segmento Dia Dia para o relatório DisplayTopicsPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório DisplayTopicsPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório DisplayTopicsPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório DisplayTopicsPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório DisplayTopicsPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório DisplayTopicsPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório DisplayTopicsPerformance.
Week String Segmento Semana Semana para o relatório DisplayTopicsPerformance.
Year Integer Segmento Ano Ano para o relatório DisplayTopicsPerformance.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório DisplayTopicsPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível CTR visível do Active View para o relatório DisplayTopicsPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório DisplayTopicsPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impr mensuráveis do Active View por impr para o relatório DisplayTopicsPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório DisplayTopicsPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressão mensurável do Active View Impressão mensurável do Active View para o relatório DisplayTopicsPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório DisplayTopicsPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório DisplayTopicsPerformance.
AllConversions Double Métrica Todas as conversões Todas as conversões para o relatório DisplayTopicsPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório DisplayTopicsPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório DisplayTopicsPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório DisplayTopicsPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório DisplayTopicsPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório DisplayTopicsPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório DisplayTopicsPerformance.
Clicks Long Métrica Cliques Cliques para o relatório DisplayTopicsPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório DisplayTopicsPerformance.
Conversions Double Métrica Conversões Conversões para o relatório DisplayTopicsPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório DisplayTopicsPerformance.
Cost Decimal Métrica Custo Custo do relatório DisplayTopicsPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório DisplayTopicsPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório DisplayTopicsPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório DisplayTopicsPerformance.
Ctr Double Métrica CTR CTR para o relatório DisplayTopicsPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório DisplayTopicsPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório DisplayTopicsPerformance.
GmailForwards Long Métrica Encaminhamentos do Gmail Encaminhamentos do Gmail para o relatório DisplayTopicsPerformance.
GmailSaves Long Métrica Gmail salva Salvamentos do Gmail para o relatório DisplayTopicsPerformance.
GmailSecondaryClicks Long Métrica Cliques do Gmail para o site Gmail Clicks To Website para o relatório DisplayTopicsPerformance.
Impressions Long Métrica Impressões Impressões para o relatório DisplayTopicsPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório DisplayTopicsPerformance.
Interactions Long Métrica Interações Interações para o relatório DisplayTopicsPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório DisplayTopicsPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório DisplayTopicsPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório DisplayTopicsPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido em 100% para o relatório DisplayTopicsPerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido até 25% para o relatório DisplayTopicsPerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido em 50% para o relatório DisplayTopicsPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido em 75% para o relatório DisplayTopicsPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório DisplayTopicsPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório DisplayTopicsPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório DisplayTopicsPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
FinalUrl

O relatório de URL final inclui todas as estatísticas agregadas no nível do URL final, uma linha por URL final. Se outros campos de segmento forem usados, você poderá obter mais de uma linha por URL final.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório FinalUrl.
AccountDescriptiveName String Atributo Conta Conta para o relatório FinalUrl.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório FinalUrl.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório FinalUrl.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório FinalUrl.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório FinalUrl. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
AdvertisingChannelType String Atributo Canal de Publicidade Canal de publicidade para o relatório FinalUrl. Os valores permitidos são UNKNOWN, SEARCH, DISPLAY, SHOPPING, VIDEO, MULTI_CHANNEL, EXPRESS.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório FinalUrl.
CampaignName String Atributo Campanha Campanha para o relatório FinalUrl.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório FinalUrl. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CriteriaTypeName String Atributo Tipo de correspondência Tipo de correspondência para o relatório FinalUrl.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório FinalUrl.
EffectiveFinalUrl String Atributo URL final URL final para o relatório FinalUrl.
EffectiveTrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de rastreamento para o relatório FinalUrl.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório FinalUrl.
AdNetworkType1 String Segmento Rede Rede para o relatório FinalUrl. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório FinalUrl. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório FinalUrl. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório FinalUrl.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório FinalUrl.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório FinalUrl.
CriteriaParameters String Segmento Palavra-chave por canal Palavra-chave por canal para o relatório FinalUrl.
Date Date Segmento Dia Dia para o relatório FinalUrl.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório FinalUrl. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório FinalUrl. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório FinalUrl. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês para o relatório FinalUrl.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório FinalUrl. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório FinalUrl.
Slot String Segmento Top Vs Outro Top Vs Other para o relatório FinalUrl. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segmento Semana Semana para o relatório FinalUrl.
Year Integer Segmento Ano Ano para o relatório FinalUrl.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório FinalUrl.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório FinalUrl.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório FinalUrl.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impressão mensurável do Active View por impressão para o relatório FinalUrl.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório FinalUrl.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressão mensurável do Active View para o relatório FinalUrl.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório FinalUrl.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório FinalUrl.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório FinalUrl.
AllConversionValue Double Métrica Valor de todas as conversões Todo o valor de conv para o relatório FinalUrl.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório FinalUrl.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório FinalUrl.
AverageCpe Double Métrica CPE médio CPE médio para o relatório FinalUrl.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório FinalUrl.
AverageCpv Double Métrica CPV médio CPV médio para o relatório FinalUrl.
AveragePosition Double Métrica Posição Média Posição média para o relatório FinalUrl.
Clicks Long Métrica Cliques Cliques para o relatório FinalUrl.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório FinalUrl.
Conversions Double Métrica Conversões Conversões para o relatório FinalUrl.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório FinalUrl.
Cost Decimal Métrica Custo Custo do relatório FinalUrl.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório FinalUrl.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório FinalUrl.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório FinalUrl.
Ctr Double Métrica CTR CTR para o relatório FinalUrl.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório FinalUrl.
Engagements Long Métrica Noivados Engajamentos para o relatório FinalUrl.
Impressions Long Métrica Impressões Impressões para o relatório FinalUrl.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório FinalUrl.
Interactions Long Métrica Interações Interações para o relatório FinalUrl.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório FinalUrl.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório FinalUrl.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório FinalUrl.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório FinalUrl.
VideoViews Long Métrica Visualizações Exibições para o relatório FinalUrl.
ViewThroughConversions Long Métrica Conv de visualização Conv de visualização para o relatório FinalUrl.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
GêneroDesempenho

O relatório de desempenho de gênero inclui todas as estatísticas agregadas por gênero. Ele também inclui desempenho de público automático.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório GenderPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório GenderPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório GenderPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório GenderPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório GenderPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório GenderPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
BaseAdGroupId Long Atributo ID do grupo de anúncios base ID do grupo de anúncios base para o relatório GenderPerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório GenderPerformance.
BiddingStrategyId Long Atributo ID da estratégia de lances ID da estratégia de lances para o relatório GenderPerformance.
BiddingStrategyName String Atributo Nome da estratégia de lance Nome da estratégia de lances para o relatório GenderPerformance.
BiddingStrategyType String Atributo Tipo de estratégia de lance Tipo de estratégia de lance para o relatório GenderPerformance. Os valores permitidos são MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BidModifier Double Atributo Ajuste de lance Ajuste de lance para o relatório GenderPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório GenderPerformance.
CampaignName String Atributo Campanha Campanha para o relatório GenderPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório GenderPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Atributo CPC máximo CPC máx. para o relatório GenderPerformance.
CpcBidSource String Atributo Origem do CPC máx. Origem de CPC máximo para o relatório GenderPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Atributo CPM máximo CPM máximo para o relatório GenderPerformance.
CpmBidSource String Atributo Origem do CPM máx. Origem do CPM máximo para o relatório GenderPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Atributo Gênero Sexo para o relatório GenderPerformance.
CriteriaDestinationUrl String Atributo URL de destino URL de destino para o relatório GenderPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório GenderPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório GenderPerformance.
FinalAppUrls String Atributo URL final do aplicativo URL final do aplicativo para o relatório GenderPerformance.
FinalMobileUrls String Atributo URL final móvel URL final móvel para o relatório GenderPerformance.
FinalUrls String Atributo URL final URL final do relatório GenderPerformance.
Id Long Atributo ID do critério ID do critério para o relatório GenderPerformance.
IsNegative Boolean Atributo é negativo É negativo para o relatório GenderPerformance.
IsRestrict Boolean Atributo está restringindo É Restritivo para o relatório GenderPerformance.
Status String Atributo Estado de gênero Gender State para o relatório GenderPerformance. Os valores permitidos são ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de acompanhamento para o relatório GenderPerformance.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro personalizado para o relatório GenderPerformance.
AdNetworkType1 String Segmento Rede Rede para o relatório GenderPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório GenderPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório GenderPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório GenderPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório GenderPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório GenderPerformance.
Date Date Segmento Dia Dia do relatório GenderPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório GenderPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório GenderPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório GenderPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório GenderPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório GenderPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório GenderPerformance.
Week String Segmento Semana Semana do relatório GenderPerformance.
Year Integer Segmento Ano Ano para o relatório GenderPerformance.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório GenderPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório GenderPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório GenderPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Active View Mensurável Impr por Impr para o relatório GenderPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório GenderPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressão mensurável do Active View para o relatório GenderPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressão visível do Active View por impressão mensurável para o relatório GenderPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório GenderPerformance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório GenderPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório GenderPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório GenderPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório GenderPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório GenderPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório GenderPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório GenderPerformance.
Clicks Long Métrica Cliques Cliques para o relatório GenderPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório GenderPerformance.
Conversions Double Métrica Conversões Conversões para o relatório GenderPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório GenderPerformance.
Cost Decimal Métrica Custo Custo do relatório GenderPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório GenderPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório GenderPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório GenderPerformance.
Ctr Double Métrica CTR CTR para o relatório GenderPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório GenderPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório GenderPerformance.
GmailForwards Long Métrica Encaminhamentos do Gmail Encaminhamentos do Gmail para o relatório GenderPerformance.
GmailSaves Long Métrica Gmail salva Salvamentos do Gmail para o relatório GenderPerformance.
GmailSecondaryClicks Long Métrica Cliques do Gmail para o site Gmail Clicks To Website para o relatório GenderPerformance.
Impressions Long Métrica Impressões Impressões para o relatório GenderPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório GenderPerformance.
Interactions Long Métrica Interações Interações para o relatório GenderPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório GenderPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório GenderPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório GenderPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido em 100% para o relatório GenderPerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido em 25% para o relatório GenderPerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido em 50% para o relatório GenderPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido em 75% para o relatório GenderPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório GenderPerformance.
VideoViews Long Métrica Visualizações Exibições do relatório GenderPerformance.
ViewThroughConversions Long Métrica Conv de visualização Conv de exibição para o relatório GenderPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Desempenho Geográfico

O relatório de desempenho geográfico inclui todas as estatísticas agregadas no nível do país/território, uma linha por país/território.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Observe que o campo CountryCriteriaId é sempre obrigatório nas colunas SELECT (SELECT * deve considerar isso automaticamente).

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório GeoPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório GeoPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório GeoPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório GeoPerformance.
CampaignName String Atributo Campanha Campanha para o relatório de GeoDesempenho.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório GeoPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CityCriteriaId Integer Atributo Cidade Cidade para o relatório GeoPerformance.
CountryCriteriaId Integer Atributo País por território País por território para o relatório GeoPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório GeoPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório GeoPerformance.
IsTargetingLocation Boolean Atributo é segmentável É direcionável para o relatório GeoPerformance.
MetroCriteriaId Integer Atributo Área metropolitana Área metropolitana para o relatório GeoPerformance.
MostSpecificCriteriaId Long Atributo Localização mais específica Local mais específico para o relatório GeoPerformance.
RegionCriteriaId Integer Atributo Região Região para o relatório GeoPerformance.
AdFormat String Segmento Tipo de anúncio Tipo de anúncio para o relatório GeoPerformance. Os valores permitidos são UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.
AdGroupId Long Segmento ID do grupo de anúncios ID do grupo de anúncios para o relatório GeoPerformance.
AdGroupName String Segmento Grupo de anúncios Grupo de anúncios para o relatório GeoPerformance.
AdGroupStatus String Segmento Estado do grupo de anúncios Estado do grupo de anúncios para o relatório GeoPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
AdNetworkType1 String Segmento Rede Rede para o relatório GeoPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório GeoPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório GeoPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório GeoPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório GeoPerformance.
Date Date Segmento Dia Dia para o relatório GeoPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório GeoPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório GeoPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Fonte de conversão para o relatório GeoPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
LocationType String Segmento Tipo de localização Tipo de local para o relatório GeoPerformance. Os valores permitidos são AREA_OF_INTEREST, LOCATION_OF_PRESENCE, UNKNOWN.
Month String Segmento Mês Mês para o relatório GeoPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório GeoPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório GeoPerformance.
Week String Segmento Semana Semana do relatório GeoPerformance.
Year Integer Segmento Ano Ano para o relatório GeoPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório GeoPerformance.
AllConversions Double Métrica Todas as conversões Todas as conversões para o relatório GeoPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório GeoPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório GeoDesempenho.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório GeoDesempenho.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório GeoDesempenho.
AverageCpv Double Métrica CPV médio CPV médio para o relatório GeoDesempenho.
AveragePosition Double Métrica Posição Média Posição média para o relatório GeoPerformance.
Clicks Long Métrica Cliques Cliques para o relatório GeoPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório GeoPerformance.
Conversions Double Métrica Conversões Conversões para o relatório GeoPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório GeoPerformance.
Cost Decimal Métrica Custo Custo do relatório GeoPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório GeoDesempenho.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório GeoPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Cross-device Conv para o relatório GeoPerformance.
Ctr Double Métrica CTR CTR para o relatório GeoPerformance.
Impressions Long Métrica Impressões Impressões para o relatório GeoPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório GeoPerformance.
Interactions Long Métrica Interações Interações para o relatório GeoPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório GeoPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório GeoPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório GeoPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório GeoPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório GeoPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório GeoPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Categoria Sem Palavra-chave

O Relatório de desempenho de categoria sem palavra-chave inclui estatísticas de anúncios sem palavra-chave (anúncios dinâmicos de pesquisa) agregadas por categoria.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório KeywordlessCategory.
AccountDescriptiveName String Atributo Conta Conta para o relatório KeywordlessCategory.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório KeywordlessCategory.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório KeywordlessCategory.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório KeywordlessCategory.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório KeywordlessCategory. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório KeywordlessCategory.
CampaignName String Atributo Campanha Campanha para o relatório KeywordlessCategory.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório KeywordlessCategory. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
Category0 String Atributo Categorias de nível superior Categorias de nível superior para o relatório KeywordlessCategory.
Category1 String Atributo Subcategorias de primeiro nível Subcategorias de primeiro nível para o relatório KeywordlessCategory.
Category2 String Atributo Subcategorias de segundo nível Subcategorias de segundo nível para o relatório KeywordlessCategory.
CriterionId Long Atributo ID da palavra-chave ID da palavra-chave para o relatório KeywordlessCategory.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório KeywordlessCategory.
Domain String Atributo Domínio Domínio para o relatório KeywordlessCategory.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório KeywordlessCategory.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório KeywordlessCategory.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório KeywordlessCategory.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório KeywordlessCategory.
Date Date Segmento Dia Dia do relatório KeywordlessCategory.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório KeywordlessCategory. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório KeywordlessCategory. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório KeywordlessCategory.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório KeywordlessCategory. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório KeywordlessCategory.
Week String Segmento Semana Semana para o relatório KeywordlessCategory.
Year Integer Segmento Ano Ano para o relatório KeywordlessCategory.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório KeywordlessCategory.
AllConversions Double Métrica Todas as conversões Todas as conversões para o relatório KeywordlessCategory.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conversão para o relatório KeywordlessCategory.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório KeywordlessCategory.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório KeywordlessCategory.
Clicks Long Métrica Cliques Cliques para o relatório KeywordlessCategory.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório KeywordlessCategory.
Conversions Double Métrica Conversões Conversões para o relatório KeywordlessCategory.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório KeywordlessCategory.
Cost Decimal Métrica Custo Custo do relatório KeywordlessCategory.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório KeywordlessCategory.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório KeywordlessCategory.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório KeywordlessCategory.
Ctr Double Métrica CTR CTR para o relatório KeywordlessCategory.
Impressions Long Métrica Impressões Impressões para o relatório KeywordlessCategory.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório KeywordlessCategory.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório KeywordlessCategory.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Consulta Sem Palavra-chave

O relatório Consulta sem palavras-chave inclui estatísticas de anúncios sem palavras-chave (anúncios de pesquisa dinâmicos) com base em termos de pesquisa.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório KeywordlessQuery.
AccountDescriptiveName String Atributo Conta Conta para o relatório KeywordlessQuery.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório KeywordlessQuery.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório KeywordlessQuery.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório KeywordlessQuery.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório KeywordlessQuery. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório KeywordlessQuery.
CampaignName String Atributo Campanha Campanha para o relatório KeywordlessQuery.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório KeywordlessQuery. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CategoryPaths String Atributo Categorias Categorias para o relatório KeywordlessQuery.
CriterionId Long Atributo ID da palavra-chave ID da palavra-chave para o relatório KeywordlessQuery.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório KeywordlessQuery.
Domain String Atributo Domínio Domínio para o relatório KeywordlessQuery.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório KeywordlessQuery.
Line1 String Atributo Título gerado dinamicamente Título gerado dinamicamente para o relatório KeywordlessQuery.
Query String Atributo Termo de pesquisa Termo de pesquisa para o relatório KeywordlessQuery.
QueryTargetingStatus String Atributo Adicionado por excluído Adicionado por excluído para o relatório KeywordlessQuery. Os valores permitidos são ADDED, EXCLUDED, BOTH, NONE.
Title String Atributo Título da página de destino Título da página de destino para o relatório KeywordlessQuery.
Url String Atributo URL URL para o relatório KeywordlessQuery.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório KeywordlessQuery.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório KeywordlessQuery.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório KeywordlessQuery.
Date Date Segmento Dia Dia para o relatório KeywordlessQuery.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório KeywordlessQuery. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
ExternalConversionSource String Segmento Origem da conversão Fonte de conversão para o relatório KeywordlessQuery. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório KeywordlessQuery.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório KeywordlessQuery. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório KeywordlessQuery.
Week String Segmento Semana Semana para o relatório KeywordlessQuery.
Year Integer Segmento Ano Ano do relatório KeywordlessQuery.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório KeywordlessQuery.
AllConversions Double Métrica Todas as conversões Todas as conversões para o relatório KeywordlessQuery.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conversão para o relatório KeywordlessQuery.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório KeywordlessQuery.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório KeywordlessQuery.
Clicks Long Métrica Cliques Cliques para o relatório KeywordlessQuery.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório KeywordlessQuery.
Conversions Double Métrica Conversões Conversões para o relatório KeywordlessQuery.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório KeywordlessQuery.
Cost Decimal Métrica Custo Custo do relatório KeywordlessQuery.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório KeywordlessQuery.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório KeywordlessQuery.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório KeywordlessQuery.
Ctr Double Métrica CTR CTR para o relatório KeywordlessQuery.
Impressions Long Métrica Impressões Impressões para o relatório KeywordlessQuery.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório KeywordlessQuery.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório KeywordlessQuery.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Palavras-chaveDesempenho

O Relatório de desempenho das palavras-chave inclui todas as estatísticas agregadas no nível da palavra-chave, uma linha por palavra-chave.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório KeywordsPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório KeywordsPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório KeywordsPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório KeywordsPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório KeywordsPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
ApprovalStatus String Atributo Status de aprovação Status de aprovação para o relatório KeywordsPerformance. Os valores permitidos são APPROVED, PENDING_REVIEW, UNDER_REVIEW, DISAPPROVED.
BaseAdGroupId Long Atributo ID do grupo de anúncios base ID do grupo de anúncios base para o relatório KeywordsPerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório KeywordsPerformance.
BiddingStrategyId Long Atributo ID da estratégia de lances ID da estratégia de lances para o relatório KeywordsPerformance.
BiddingStrategyName String Atributo Nome da estratégia de lance Nome da estratégia de lances para o relatório KeywordsPerformance.
BiddingStrategySource String Atributo Origem da estratégia de lances Origem da estratégia de lances para o relatório KeywordsPerformance. Os valores permitidos são CAMPAIGN, ADGROUP, CRITERION.
BiddingStrategyType String Atributo Tipo de estratégia de lance Tipo de estratégia de lance para o relatório KeywordsPerformance. Os valores permitidos são MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório KeywordsPerformance.
CampaignName String Atributo Campanha Campanha para o relatório KeywordsPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
ConversionAdjustment Boolean Atributo Ajuste de conversão Ajuste de conversão para o relatório KeywordsPerformance.
CpcBid Decimal Atributo CPC máximo CPC máximo para o relatório KeywordsPerformance.
CpcBidSource String Atributo Origem do CPC máx. Origem do CPC máximo para o relatório KeywordsPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Atributo CPM máximo CPM máximo para o relatório KeywordsPerformance.
CreativeQualityScore String Atributo Relevância do anúncio Relevância do anúncio para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
Criteria String Atributo Palavra-chave Palavra-chave para o relatório KeywordsPerformance.
CriteriaDestinationUrl String Atributo URL de destino URL de destino para o relatório KeywordsPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório KeywordsPerformance.
EnhancedCpcEnabled Boolean Atributo CPC otimizado ativado CPC otimizado habilitado para o relatório KeywordsPerformance.
EstimatedAddClicksAtFirstPositionCpc Long Atributo Est Adicionar cliques por semana (primeiro lance de posição) Est Adicionar cliques por semana (primeiro lance de posição) para o relatório KeywordsPerformance.
EstimatedAddCostAtFirstPositionCpc Decimal Atributo Est Adicionar custo por semana (primeiro lance de posição) Est Adicionar custo por semana (primeiro lance de posição) para o relatório KeywordsPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório KeywordsPerformance.
FinalAppUrls String Atributo URL final do aplicativo URL final do aplicativo para o relatório KeywordsPerformance.
FinalMobileUrls String Atributo URL final móvel URL final móvel para o relatório KeywordsPerformance.
FinalUrls String Atributo URL final URL final para o relatório KeywordsPerformance.
FinalUrlSuffix String Atributo Sufixo do URL final Sufixo de URL final para o relatório KeywordsPerformance.
FirstPageCpc String Atributo Primeira Página CPC CPC da primeira página para o relatório KeywordsPerformance.
FirstPositionCpc String Atributo Primeira Posição CPC CPC da primeira posição para o relatório KeywordsPerformance.
HasQualityScore Boolean Atributo Possui Índice de Qualidade Possui Índice de qualidade para o relatório KeywordsPerformance.
Id Long Atributo ID da palavra-chave ID da palavra-chave para o relatório KeywordsPerformance.
IsNegative Boolean Atributo é negativo É negativo para o relatório KeywordsPerformance.
KeywordMatchType String Atributo Tipo de correspondência Tipo de correspondência para o relatório KeywordsPerformance. Os valores permitidos são EXACT, PHRASE, BROAD.
LabelIds String Atributo IDs de etiquetas IDs de rótulo para o relatório KeywordsPerformance.
Labels String Atributo Etiquetas Rótulos para o relatório KeywordsPerformance.
PostClickQualityScore String Atributo Experiência da página de destino Experiência da página de destino para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
QualityScore Integer Atributo Índice de qualidade Índice de qualidade para o relatório KeywordsPerformance.
SearchPredictedCtr String Atributo Taxa de cliques esperada Taxa de cliques esperada para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
Status String Atributo Palavra-chave Estado Estado da palavra-chave para o relatório KeywordsPerformance. Os valores permitidos são ENABLED, REMOVED, PAUSED.
SystemServingStatus String Atributo Status de veiculação do critério Status de exibição do critério para o relatório KeywordsPerformance. Os valores permitidos são ELIGIBLE, RARELY_SERVED.
TopOfPageCpc String Atributo Topo da página CPC CPC na parte superior da página para o relatório KeywordsPerformance.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de acompanhamento para o relatório KeywordsPerformance.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro personalizado para o relatório KeywordsPerformance.
VerticalId Long Atributo Identificação vertical ID vertical para o relatório KeywordsPerformance.
AdNetworkType1 String Segmento Rede Rede para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Network (with Search Partners) para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório KeywordsPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionAdjustmentLagBucket String Segmento Dias Para Conversão Ou Ajuste Dias para conversão ou ajuste para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_ 9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAY S, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CON VERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório KeywordsPerformance.
ConversionLagBucket String Segmento Dias Para Conversão Dias até a conversão para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_ 9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório KeywordsPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório KeywordsPerformance.
Date Date Segmento Dia Dia do relatório KeywordsPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório KeywordsPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Fonte de conversão para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório KeywordsPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório KeywordsPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório KeywordsPerformance.
Slot String Segmento Top Vs Outro Top Vs Other para o relatório KeywordsPerformance. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segmento Semana Semana para o relatório KeywordsPerformance.
Year Integer Segmento Ano Ano para o relatório KeywordsPerformance.
AbsoluteTopImpressionPercentage Double Métrica Impr Abs Top A porcentagem de impressões adicionadas mostradas como o primeiro anúncio.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório KeywordsPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível CTR visível do Active View para o relatório KeywordsPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório KeywordsPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impressões por impr mensuráveis do Active View para o relatório KeywordsPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório KeywordsPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressões mensuráveis do Active View para o relatório KeywordsPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório KeywordsPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório KeywordsPerformance.
AllConversions Double Métrica Todas as conversões Todas as conversões para o relatório KeywordsPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório KeywordsPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório KeywordsPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório KeywordsPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório KeywordsPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório KeywordsPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório KeywordsPerformance.
AveragePageviews Double Métrica Páginas por sessão Páginas por sessão para o relatório KeywordsPerformance.
AveragePosition Double Métrica Posição Média Posição média do relatório KeywordsPerformance.
AverageTimeOnSite Double Métrica Duração Média da Sessão (segundos) Duração média da sessão (segundos) para o relatório KeywordsPerformance.
BounceRate Double Métrica Taxa de rejeição Taxa de rejeição para o relatório KeywordsPerformance.
ClickAssistedConversions Long Métrica Clique em Conv Assistida Clique em Conv assistida para o relatório KeywordsPerformance.
ClickAssistedConversionsOverLastClickConversions Double Métrica Conv de clique assistido por último clique de conversão Clique em Conv assistida por último clique em Conv para o relatório KeywordsPerformance.
ClickAssistedConversionValue Double Métrica Clique em Valor de conversão assistida Clique em Valor de conversão assistida para o relatório KeywordsPerformance.
Clicks Long Métrica Cliques Cliques para o relatório KeywordsPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório KeywordsPerformance.
Conversions Double Métrica Conversões Conversões para o relatório KeywordsPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório KeywordsPerformance.
Cost Decimal Métrica Custo Custo do relatório KeywordsPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório KeywordsPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório KeywordsPerformance.
CostPerCurrentModelAttributedConversion Double Métrica Custo por conversão (modelo atual) Custo por conversão (modelo atual) para o relatório KeywordsPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório KeywordsPerformance.
Ctr Double Métrica CTR CTR para o relatório KeywordsPerformance.
CurrentModelAttributedConversions Double Métrica Conversões (Modelo atual) Conversões (modelo atual) para o relatório KeywordsPerformance.
CurrentModelAttributedConversionValue Double Métrica Valor conv (modelo atual) Valor conv (modelo atual) para o relatório KeywordsPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório KeywordsPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório KeywordsPerformance.
GmailForwards Long Métrica Encaminhamentos do Gmail Encaminhamentos do Gmail para o relatório KeywordsPerformance.
GmailSaves Long Métrica Gmail salva O Gmail salva para o relatório KeywordsPerformance.
GmailSecondaryClicks Long Métrica Cliques do Gmail para o site Gmail Clicks To Website para o relatório KeywordsPerformance.
HistoricalCreativeQualityScore String Métrica Relevância do anúncio (hist) Relevância do anúncio (hist) para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
HistoricalLandingPageQualityScore String Métrica Experiência da página de destino (hist) Experiência da página de destino (hist) para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
HistoricalQualityScore Integer Métrica Pontuação Qualificatória (hist) Qual Score (hist) para o relatório KeywordsPerformance.
HistoricalSearchPredictedCtr String Métrica Taxa de cliques esperada (hist) Taxa de cliques esperada (hist) para o relatório KeywordsPerformance. Os valores permitidos são UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
ImpressionAssistedConversions Long Métrica Conv assistida por impressão Impr Assisted Conv para o relatório KeywordsPerformance.
ImpressionAssistedConversionsOverLastClickConversions Double Métrica Conv de impressão assistida por último clique Conv Conv de impressão assistida por último clique Conv para o relatório KeywordsPerformance.
ImpressionAssistedConversionValue Double Métrica Valor de conversão assistida por impressão Valor de conversão assistida por impressão para o relatório KeywordsPerformance.
Impressions Long Métrica Impressões Impressões para o relatório KeywordsPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório KeywordsPerformance.
Interactions Long Métrica Interações Interações para o relatório KeywordsPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório KeywordsPerformance.
PercentNewVisitors Double Métrica Porcentagem de Novas Sessões Porcentagem de novas sessões para o relatório KeywordsPerformance.
SearchAbsoluteTopImpressionShare Double Métrica Pesquisar Abs Top IS Pesquisar Abs Top IS para o relatório KeywordsPerformance.
SearchExactMatchImpressionShare Double Métrica Pesquisar correspondência exata é Pesquisar É de correspondência exata para o relatório KeywordsPerformance.
SearchImpressionShare Double Métrica Pesquisar Impr Compartilhar Pesquise Compartilhamento de impressões para o relatório KeywordsPerformance.
SearchRankLostImpressionShare Double Métrica Pesquisar IS perdido (classificação) Pesquise o número de impressões perdidas (classificação) do relatório KeywordsPerformance.
SearchTopImpressionShare Double Métrica Pesquisar top IS Pesquise os principais IS para obter o relatório KeywordsPerformance.
TopImpressionPercentage Double Métrica Impr Início A porcentagem de impressões adicionadas que são exibidas em qualquer lugar acima dos resultados da pesquisa orgânica.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório KeywordsPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório KeywordsPerformance.
ValuePerCurrentModelAttributedConversion Double Métrica Valor por conversão (modelo atual) Valor por conversão (modelo atual) para o relatório KeywordsPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido a 100% para o relatório KeywordsPerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido até 25% para o relatório KeywordsPerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido até 50% para o relatório KeywordsPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido até 75% para o relatório KeywordsPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório KeywordsPerformance.
VideoViews Long Métrica Visualizações Exibições do relatório KeywordsPerformance.
ViewThroughConversions Long Métrica Conv de visualização Conv de exibição para o relatório KeywordsPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Rótulo

O relatório Rótulo é um relatório de estrutura que lista todos os rótulos da sua conta.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountDescriptiveName String Atributo Conta Conta para o relatório Label.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório Label.
LabelId Long Atributo ID da etiqueta ID do rótulo para o relatório de rótulo.
LabelName String Atributo Nome da etiqueta Rótulo Nome do relatório Rótulo.
AdGroupCreativesCount Long Métrica Contagem de creativos do grupo de anúncios Contagem de creativos do grupo de anúncios para o relatório de rótulo.
AdGroupCriteriaCount Long Métrica Contagem de critérios do grupo de anúncios Contagem de critérios do grupo de anúncios para o relatório de rótulo.
AdGroupsCount Long Métrica Contagem de grupos de anúncios Contagem de grupos de anúncios para o relatório de rótulos.
CampaignsCount Long Métrica Contagem de Campanhas Contagem de campanhas para o relatório de rótulo.
UserListsCount Long Métrica Contagem de listas de usuários Contagem de listas de usuários para o relatório Label.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Página de Destino

O relatório da página de destino inclui todas as estatísticas agregadas por padrão pelo UnexpandedFinalUrlString, uma linha por string de URL.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório LandingPage.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório LandingPage.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório LandingPage.
CampaignName String Atributo Campanha Campanha para o relatório LandingPage.
ExpandedFinalUrlString String Atributo Página inicial expandida Página inicial expandida para o relatório LandingPage.
UnexpandedFinalUrlString String Atributo Página inicial Landing Page para o relatório LandingPage.
AdNetworkType1 String Segmento Rede Rede para o relatório LandingPage. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório LandingPage. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
Date Date Segmento Dia Dia para o relatório LandingPage.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório LandingPage. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório LandingPage. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
Month String Segmento Mês Mês para o relatório LandingPage.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório LandingPage. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório LandingPage.
Slot String Segmento Top Vs Outro Top Vs Other para o relatório LandingPage. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segmento Semana Semana para o relatório LandingPage.
Year Integer Segmento Ano Ano para o relatório LandingPage.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório LandingPage.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório LandingPage.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório LandingPage.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impressão mensurável do Active View por impressão para o relatório LandingPage.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório LandingPage.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressões mensuráveis do Active View para o relatório LandingPage.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório LandingPage.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório LandingPage.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório LandingPage.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório LandingPage.
AveragePosition Double Métrica Posição Média Posição média do relatório LandingPage.
Clicks Long Métrica Cliques Cliques para o relatório LandingPage.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório LandingPage.
Conversions Double Métrica Conversões Conversões para o relatório LandingPage.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório LandingPage.
Cost Decimal Métrica Custo Custo do relatório LandingPage.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório LandingPage.
Ctr Double Métrica CTR CTR para o relatório LandingPage.
Impressions Long Métrica Impressões Impressões para o relatório LandingPage.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório LandingPage.
Interactions Long Métrica Interações Interações para o relatório LandingPage.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório LandingPage.
PercentageMobileFriendlyClicks Double Métrica Taxa de cliques otimizada para dispositivos móveis Taxa de cliques otimizada para celular para o relatório LandingPage.
PercentageValidAcceleratedMobilePagesClicks Double Métrica Taxa de cliques AMP válida Taxa de cliques AMP válida para o relatório LandingPage.
SpeedScore Long Métrica Pontuação de velocidade móvel Pontuação de velocidade móvel para o relatório LandingPage.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório LandingPage.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Critério de Localização

Representa dados que encapsulam um critério de localização.

Informações Específicas da Tabela

Selecione

Existe apenas uma maneira de consultar os critérios de localização. A coluna LocationName é obrigatória e deve ser sempre especificada!

  • A consultar a seguir retorna todos os critérios de localização que atendem à condição.

    SELECT * FROM [Critério de localização] WHERE LocationName='Ontario'
    
Colunas
Nome Tipo Comportamento DisplayName Descrição
CriterionId String ID deste critério.
CriterionType String Indica que esta instância é um subtipo de Critério.
DisplayType String Tipo de exibição do critério de localização.
TargetingStatus String O status de segmentação do critério de localização.
CanonicalName String Nome canônico do critério de localização.
Reach Long População de usuários aproximada que será segmentada, arredondada para o 100 mais próximo.
SearchTerm String Termo de pesquisa original, conforme especificado na solicitação de entrada para pesquisa por nome.
CountryCode String Isso é usado como uma dica e as sugestões são restritas a este país quando aplicável.
Locale String Localidade preferencial a ser usada como uma dica para determinar a lista de locais a serem retornados.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
LocationName String Nome do critério de localização.
Clientes Gerenciados

Serviço para acessar detalhes básicos sobre qualquer cliente.

Informações Específicas da Tabela

Selecione

Há duas maneiras de consultar ManagedCustomers.

  • A consultar a seguir retorna todos os clientes gerenciados pelo ParentCustomerID especificado.

    SELECT * FROM [Clientes Gerenciados] WHERE ParentCustomerID=6101846543
    
  • A consultar a seguir retorna todos os clientes que estão na conta do Google AdWords. O driver obterá todos os clientes consultando a visualização de clientes internamente e para cada cliente obterá os ManagedCustomers.

    SELECT * FROM [ManagedCustomers]
    
  • A consultar a seguir retorna todos os clientes que não estão ocultos na conta do GoogleAdwords.

    SELECT * FROM [Clientes Gerenciados] WHERE ExcludeHiddenAccounts = true
    
Colunas
Nome Tipo Comportamento DisplayName Descrição
ParentCustomerId [KEY] String ID do cliente de gerenciamento.
CustomerId String ID do cliente do cliente.
Name String Nome do Cliente.
CanManageClients String Booleano mostrando se o Cliente pode gerenciar clientes.
CurrencyCode String CurrencyCode do cliente.
DateTimeZone String DateTimeZone
TestAccount Boolean Booleano mostrando se a conta é uma conta de teste.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ExcludeHiddenAccounts Boolean Nome do local.

Serviço para acessar detalhes básicos sobre quaisquer links de clientes.

Informações Específicas da Tabela

Selecione

Há duas maneiras de consultar os Links ManagedCustomers.

  • A consultar a seguir retorna todos os links de clientes gerenciados pelo ParentCustomerID especificado.

    SELECT * FROM [Links de clientes gerenciados] WHERE ParentCustomerID=6101846543
    
  • A consultar a seguir retorna todos os clientes que estão na conta do GoogleAdwords. O driver obterá todos os clientes consultando a visualização de clientes internamente e para cada cliente obterá os links ManagedCustomers.

    SELECT * FROM [ManagedCustomersLinks]
    
Colunas
Nome Tipo Comportamento DisplayName Descrição
ParentCustomerId [KEY] String ID do cliente de gerenciamento.
ManagerCustomerId String ID de cliente do gerente vinculado.
ClientCustomerId String ID do cliente do cliente vinculado.
IsHidden Boolean Booleano mostrando se está oculto.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
CustomerId String ID do cliente do cliente. Usado como entrada para chamada de API
Name String Nome do Cliente. Usado como entrada para chamada de API
CanManageClients String Booleano mostrando se o Cliente pode gerenciar clientes. Usado como entrada para chamada de API
CurrencyCode String CurrencyCode do cliente. Usado como entrada para chamada de API
DateTimeZone String DateTimeZone Usado como entrada para chamada de API
TestAccount Boolean Booleano mostrando se a conta é uma conta de teste. Usado como entrada para chamada de API
ExcludeHiddenAccounts Boolean Nome do local. Usado como entrada para chamada de API
MercadoDesempenho

O relatório de Desempenho do Marketplace inclui todas as estatísticas de anúncios exibidos no Marketplace, agregadas por padrão no nível da conta.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório MarketplacePerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório MarketplacePerformance.
Date Date Segmento Dia Dia do relatório MarketplacePerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório MarketplacePerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Month String Segmento Mês Mês do relatório MarketplacePerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório MarketplacePerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório MarketplacePerformance.
Week String Segmento Semana Semana para o relatório MarketplacePerformance.
Year Integer Segmento Ano Ano para o relatório MarketplacePerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório MarketplacePerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório MarketplacePerformance.
Clicks Long Métrica Cliques Cliques para o relatório MarketplacePerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório MarketplacePerformance.
Conversions Double Métrica Conversões Conversões para o relatório MarketplacePerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório MarketplacePerformance.
Cost Decimal Métrica Custo Custo do relatório MarketplacePerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório MarketplacePerformance.
Ctr Double Métrica CTR CTR para o relatório MarketplacePerformance.
Impressions Long Métrica Impressões Impressões para o relatório MarketplacePerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório MarketplacePerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
PaidOrganicQuery

O relatório Consulta paga e orgânica fornece uma visão holística de suas estatísticas de pesquisa em anúncios e listagens orgânicas no nível da consultar. Isso permite que você analise os pontos fortes e as lacunas em sua presença geral na pesquisa e fornece informações sobre como suas listagens de pesquisa paga e orgânica funcionam juntas para conectar sua empresa às pessoas que pesquisam no Google.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório PaidOrganicQuery.
AccountDescriptiveName String Atributo Conta Conta para o relatório PaidOrganicQuery.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório PaidOrganicQuery.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório PaidOrganicQuery.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório PaidOrganicQuery.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório PaidOrganicQuery. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório PaidOrganicQuery.
CampaignName String Atributo Campanha Campanha para o relatório PaidOrganicQuery.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório PaidOrganicQuery. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório PaidOrganicQuery.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório PaidOrganicQuery.
KeywordId Long Atributo ID da palavra-chave ID da palavra-chave para o relatório PaidOrganicQuery.
KeywordTextMatchingQuery String Atributo Palavra-chave Palavra-chave para o relatório PaidOrganicQuery.
SearchQuery String Atributo Consulta Consulta para o relatório PaidOrganicQuery.
Date Date Segmento Dia Dia do relatório PaidOrganicQuery.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório PaidOrganicQuery. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Month String Segmento Mês Mês do relatório PaidOrganicQuery.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório PaidOrganicQuery. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório PaidOrganicQuery.
QueryMatchType String Segmento Tipo de correspondência Tipo de correspondência para o relatório PaidOrganicQuery. Os valores permitidos são AUTO, BROAD, EXACT, EXPANDED, PHRASE.
SerpType String Segmento Tipo de resultado da pesquisa Tipo de resultado da pesquisa para o relatório PaidOrganicQuery. Os valores permitidos são UNKNOWN, ADS_ONLY, ORGANIC_ONLY, ADS_AND_ORGANIC.
Week String Segmento Semana Semana para o relatório PaidOrganicQuery.
Year Integer Segmento Ano Ano do relatório PaidOrganicQuery.
AverageCpc Decimal Métrica CPC médio do anúncio CPC médio do anúncio para o relatório PaidOrganicQuery.
AveragePosition Double Métrica Posição média do anúncio Posição média do anúncio para o relatório PaidOrganicQuery.
Clicks Long Métrica Cliques em anúncios Cliques em anúncios para o relatório PaidOrganicQuery.
CombinedAdsOrganicClicks Long Métrica Cliques combinados Cliques combinados para o relatório PaidOrganicQuery.
CombinedAdsOrganicClicksPerQuery Double Métrica Cliques combinados por consulta Cliques combinados por consulta para o relatório PaidOrganicQuery.
CombinedAdsOrganicQueries Long Métrica Consultas combinadas Consultas combinadas para o relatório PaidOrganicQuery.
Ctr Double Métrica CTR do anúncio CTR do anúncio para o relatório PaidOrganicQuery.
Impressions Long Métrica Impressões de anúncios Impressões de anúncios para o relatório PaidOrganicQuery.
OrganicAveragePosition Double Métrica Posição Média Orgânica Posição média orgânica para o relatório PaidOrganicQuery.
OrganicClicks Long Métrica Cliques Orgânicos Cliques orgânicos para o relatório PaidOrganicQuery.
OrganicClicksPerQuery Double Métrica Cliques orgânicos por consulta Cliques orgânicos por consulta para o relatório PaidOrganicQuery.
OrganicImpressions Long Métrica Listagens Orgânicas Listagens orgânicas para o relatório PaidOrganicQuery.
OrganicImpressionsPerQuery Double Métrica Listagens orgânicas por consulta Listagens orgânicas por consulta para o relatório PaidOrganicQuery.
OrganicQueries Long Métrica Consultas Orgânicas Consultas orgânicas para o relatório PaidOrganicQuery.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
ParentalStatusDesempenho

O relatório de desempenho do status parental inclui estatísticas agregadas no nível do status parental, uma linha por status parental

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório ParentalStatusPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório ParentalStatusPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório ParentalStatusPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório ParentalStatusPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório ParentalStatusPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório ParentalStatusPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
BaseAdGroupId Long Atributo ID do grupo de anúncios base ID do grupo de anúncios base para o relatório ParentalStatusPerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório ParentalStatusPerformance.
BiddingStrategyId Long Atributo ID da estratégia de lances ID da estratégia de lances para o relatório ParentalStatusPerformance.
BiddingStrategyName String Atributo Nome da estratégia de lance Nome da estratégia de lances para o relatório ParentalStatusPerformance.
BiddingStrategyType String Atributo Tipo de estratégia de lance Tipo de estratégia de lance para o relatório ParentalStatusPerformance. Os valores permitidos são MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BidModifier Double Atributo Ajuste de lance Ajuste de lance para o relatório ParentalStatusPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório ParentalStatusPerformance.
CampaignName String Atributo Campanha Campanha para o relatório ParentalStatusPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório ParentalStatusPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Atributo CPC máximo CPC máximo para o relatório ParentalStatusPerformance.
CpcBidSource String Atributo Origem do CPC máx. Origem de CPC máximo para o relatório ParentalStatusPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Atributo CPM máximo CPM máximo para o relatório ParentalStatusPerformance.
CpmBidSource String Atributo Origem do CPM máx. Origem do CPM máximo para o relatório ParentalStatusPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Atributo Estatuto parental Status parental para o relatório ParentalStatusPerformance.
CriteriaDestinationUrl String Atributo URL de destino URL de destino para o relatório ParentalStatusPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório ParentalStatusPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório ParentalStatusPerformance.
FinalAppUrls String Atributo URL final do aplicativo URL final do aplicativo para o relatório ParentalStatusPerformance.
FinalMobileUrls String Atributo URL final móvel URL final móvel para o relatório ParentalStatusPerformance.
FinalUrls String Atributo URL final URL final do relatório ParentalStatusPerformance.
Id Long Atributo ID do critério ID do critério para o relatório ParentalStatusPerformance.
IsNegative Boolean Atributo é negativo É negativo para o relatório ParentalStatusPerformance.
IsRestrict Boolean Atributo está restringindo É uma restrição para o relatório ParentalStatusPerformance.
Status String Atributo Status Parental Estado Estado do status parental para o relatório ParentalStatusPerformance. Os valores permitidos são ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de rastreamento para o relatório ParentalStatusPerformance.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro personalizado para o relatório ParentalStatusPerformance.
AdNetworkType1 String Segmento Rede Rede para o relatório ParentalStatusPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório ParentalStatusPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório ParentalStatusPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório ParentalStatusPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório ParentalStatusPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório ParentalStatusPerformance.
Date Date Segmento Dia Dia para o relatório ParentalStatusPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório ParentalStatusPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório ParentalStatusPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Fonte de conversão para o relatório ParentalStatusPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório ParentalStatusPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório ParentalStatusPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório ParentalStatusPerformance.
Week String Segmento Semana Semana para o relatório ParentalStatusPerformance.
Year Integer Segmento Ano Ano para o relatório ParentalStatusPerformance.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório ParentalStatusPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório ParentalStatusPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório ParentalStatusPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Active View Mensurável Impr por Impr para o relatório ParentalStatusPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório ParentalStatusPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressão mensurável do Active View para o relatório ParentalStatusPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório ParentalStatusPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório ParentalStatusPerformance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório ParentalStatusPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório ParentalStatusPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório ParentalStatusPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório ParentalStatusPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório ParentalStatusPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório ParentalStatusPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório ParentalStatusPerformance.
Clicks Long Métrica Cliques Cliques para o relatório ParentalStatusPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório ParentalStatusPerformance.
Conversions Double Métrica Conversões Conversões para o relatório ParentalStatusPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório ParentalStatusPerformance.
Cost Decimal Métrica Custo Custo do relatório ParentalStatusPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório ParentalStatusPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório ParentalStatusPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório ParentalStatusPerformance.
Ctr Double Métrica CTR CTR para o relatório ParentalStatusPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório ParentalStatusPerformance.
Engagements Long Métrica Noivados Envolvimentos para o relatório ParentalStatusPerformance.
GmailForwards Long Métrica Encaminhamentos do Gmail Encaminhamentos do Gmail para o relatório ParentalStatusPerformance.
GmailSaves Long Métrica Gmail salva Gmail salva para o relatório ParentalStatusPerformance.
GmailSecondaryClicks Long Métrica Cliques do Gmail para o site Gmail Clicks To Website para o relatório ParentalStatusPerformance.
Impressions Long Métrica Impressões Impressões para o relatório ParentalStatusPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório ParentalStatusPerformance.
Interactions Long Métrica Interações Interações para o relatório ParentalStatusPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório ParentalStatusPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório ParentalStatusPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório ParentalStatusPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido a 100% para o relatório ParentalStatusPerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido até 25% para o relatório ParentalStatusPerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido em 50% para o relatório ParentalStatusPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido em 75% para o relatório ParentalStatusPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório ParentalStatusPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório ParentalStatusPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório ParentalStatusPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Espaço Reservado

O relatório de espaço reservado fornece estatísticas para extensões de anúncio baseadas em feed, uma linha por tipo de espaço reservado.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountDescriptiveName String Atributo Conta Conta para o relatório de espaço reservado.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório de espaço reservado.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório de espaço reservado.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório de espaço reservado. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório de espaço reservado.
CampaignName String Atributo Campanha Campanha para o relatório Placeholder.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório de espaço reservado. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
ExtensionPlaceholderCreativeId Long Atributo ID do anúncio ID do anúncio para o relatório de espaço reservado.
ExtensionPlaceholderType String Atributo Tipo de espaço reservado para alimentação Feed Placeholder Tipo para o relatório de Placeholder.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório de espaço reservado.
AdNetworkType1 String Segmento Rede Rede para o relatório de espaço reservado. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório de espaço reservado. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório de espaço reservado. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório de espaço reservado.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório de espaço reservado.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório de espaço reservado.
Date Date Segmento Dia Dia para o relatório Placeholder.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório de espaço reservado. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório Placeholder. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório de espaço reservado. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês para o relatório Placeholder.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório de espaço reservado. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório Placeholder.
Slot String Segmento Top Vs Outro Top Vs Other para o relatório Placeholder. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segmento Semana Semana para o relatório Placeholder.
Year Integer Segmento Ano Ano para o relatório de espaço reservado.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório de espaço reservado.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório de espaço reservado.
AllConversionValue Double Métrica Valor de todas as conversões Todo o valor de conv para o relatório de espaço reservado.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório de espaço reservado.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório de espaço reservado.
AverageCpe Double Métrica CPE médio CPE médio para o relatório de espaço reservado.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório de espaço reservado.
AverageCpv Double Métrica CPV médio CPV médio para o relatório de espaço reservado.
AveragePosition Double Métrica Posição Média Posição média para o relatório de espaço reservado.
Clicks Long Métrica Cliques Cliques para o relatório de espaço reservado.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório de espaço reservado.
Conversions Double Métrica Conversões Conversões para o relatório Placeholder.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório de espaço reservado.
Cost Decimal Métrica Custo Custo do relatório de espaço reservado.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório de espaço reservado.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório de espaço reservado.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório de espaço reservado.
Ctr Double Métrica CTR CTR para o relatório de espaço reservado.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório de espaço reservado.
Engagements Long Métrica Noivados Envolvimentos para o relatório Placeholder.
Impressions Long Métrica Impressões Impressões para o relatório Placeholder.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório Placeholder.
Interactions Long Métrica Interações Interações para o relatório Placeholder.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório de espaço reservado.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório de espaço reservado.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório de espaço reservado.
VideoViewRate Double Métrica Ver Taxa Exibir taxa para o relatório de espaço reservado.
VideoViews Long Métrica Visualizações Exibições para o relatório de espaço reservado.
ViewThroughConversions Long Métrica Conv de visualização Conv de exibição para o relatório de espaço reservado.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
PlaceholderFeedItem

O relatório de item de feed de espaço reservado inclui todas as estatísticas no nível do item de feed (por exemplo, um único sitelink).

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório PlaceholderFeedItem.
AccountDescriptiveName String Atributo Conta Conta para o relatório PlaceholderFeedItem.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório PlaceholderFeedItem.
AdId Long Atributo ID do anúncio ID do anúncio para o relatório PlaceholderFeedItem.
AttributeValues String Atributo Valores de atributos Valores de atributo para o relatório PlaceholderFeedItem.
Criteria String Atributo Texto de palavra-chave de destino Texto de palavra-chave de destino para o relatório PlaceholderFeedItem.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório PlaceholderFeedItem.
DevicePreference String Atributo Preferência do dispositivo Preferência de dispositivo para o relatório PlaceholderFeedItem.
DisapprovalShortNames String Atributo Motivos de reprovação Motivos de reprovação para o relatório PlaceholderFeedItem.
EndTime String Atributo Data final Data de término do relatório PlaceholderFeedItem.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório PlaceholderFeedItem.
FeedId Long Atributo ID do feed ID do feed para o relatório PlaceholderFeedItem.
FeedItemId Long Atributo Identificação do item ID do item para o relatório PlaceholderFeedItem.
GeoTargetingCriterionId Long Atributo Localização alvo Local de destino para o relatório PlaceholderFeedItem.
GeoTargetingRestriction String Atributo Restrição de local de destino Restrição de local de destino para o relatório PlaceholderFeedItem. Os valores permitidos são UNKNOWN, LOCATION_OF_PRESENCE.
IsSelfAction Boolean Atributo Esta extensão versus outra Esta extensão versus outra para o relatório PlaceholderFeedItem.
KeywordMatchType String Atributo Tipo de correspondência de palavras-chave de destino Tipo de correspondência de palavra-chave de destino para o relatório PlaceholderFeedItem. Os valores permitidos são EXACT, PHRASE, BROAD.
KeywordTargetingId Long Atributo ID da palavra-chave ID da palavra-chave para o relatório PlaceholderFeedItem.
PlaceholderType Integer Atributo Tipo de espaço reservado para alimentação Feed Placeholder Tipo para o relatório PlaceholderFeedItem.
Scheduling String Atributo Agendamento Agendamento para o relatório PlaceholderFeedItem.
StartTime String Atributo Data de início Data de início do relatório PlaceholderFeedItem.
Status String Atributo Estado do artigo Estado do item para o relatório PlaceholderFeedItem. Os valores permitidos são ENABLED, REMOVED, UNKNOWN.
TargetingAdGroupId Long Atributo ID do grupo de anúncios de destino ID do grupo de anúncios de destino para o relatório PlaceholderFeedItem.
TargetingCampaignId Long Atributo ID da campanha alvo ID da campanha de destino para o relatório PlaceholderFeedItem.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro personalizado para o relatório PlaceholderFeedItem.
ValidationDetails String Atributo Status de aprovação Status de aprovação para o relatório PlaceholderFeedItem.
AdGroupId Long Segmento ID do grupo de anúncios ID do grupo de anúncios para o relatório PlaceholderFeedItem.
AdGroupName String Segmento Grupo de anúncios Grupo de anúncios para o relatório PlaceholderFeedItem.
AdGroupStatus String Segmento Estado do grupo de anúncios Estado do grupo de anúncios para o relatório PlaceholderFeedItem. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
AdNetworkType1 String Segmento Rede Rede para o relatório PlaceholderFeedItem. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório PlaceholderFeedItem. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
CampaignId Long Segmento ID da campanha ID da campanha para o relatório PlaceholderFeedItem.
CampaignName String Segmento Campanha Campanha para o relatório PlaceholderFeedItem.
CampaignStatus String Segmento Estado da campanha Estado da campanha para o relatório PlaceholderFeedItem. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório PlaceholderFeedItem. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório PlaceholderFeedItem.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório PlaceholderFeedItem.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório PlaceholderFeedItem.
Date Date Segmento Dia Dia para o relatório PlaceholderFeedItem.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório PlaceholderFeedItem. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório PlaceholderFeedItem. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório PlaceholderFeedItem. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês para o relatório PlaceholderFeedItem.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório PlaceholderFeedItem. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório PlaceholderFeedItem.
Slot String Segmento Top Vs Outro Top Vs Other para o relatório PlaceholderFeedItem. Os valores permitidos são SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segmento Semana Semana para o relatório PlaceholderFeedItem.
Year Integer Segmento Ano Ano para o relatório PlaceholderFeedItem.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório PlaceholderFeedItem.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório PlaceholderFeedItem.
AllConversionValue Double Métrica Valor de todas as conversões Todo o valor de conv para o relatório PlaceholderFeedItem.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório PlaceholderFeedItem.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório PlaceholderFeedItem.
AverageCpe Double Métrica CPE médio CPE médio para o relatório PlaceholderFeedItem.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório PlaceholderFeedItem.
AverageCpv Double Métrica CPV médio CPV médio para o relatório PlaceholderFeedItem.
AveragePosition Double Métrica Posição Média Posição média para o relatório PlaceholderFeedItem.
Clicks Long Métrica Cliques Cliques para o relatório PlaceholderFeedItem.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório PlaceholderFeedItem.
Conversions Double Métrica Conversões Conversões para o relatório PlaceholderFeedItem.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório PlaceholderFeedItem.
Cost Decimal Métrica Custo Custo do relatório PlaceholderFeedItem.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório PlaceholderFeedItem.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório PlaceholderFeedItem.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório PlaceholderFeedItem.
Ctr Double Métrica CTR CTR para o relatório PlaceholderFeedItem.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório PlaceholderFeedItem.
Engagements Long Métrica Noivados Engajamentos para o relatório PlaceholderFeedItem.
Impressions Long Métrica Impressões Impressões para o relatório PlaceholderFeedItem.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório PlaceholderFeedItem.
Interactions Long Métrica Interações Interações para o relatório PlaceholderFeedItem.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório PlaceholderFeedItem.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório PlaceholderFeedItem.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório PlaceholderFeedItem.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório PlaceholderFeedItem.
VideoViews Long Métrica Visualizações Exibições para o relatório PlaceholderFeedItem.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
PosicionamentoDesempenho

O Relatório de desempenho de veiculações inclui todas as estatísticas agregadas no nível da veiculação, uma linha por veiculação.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório PlacementPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório PlacementPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório PlacementPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório PlacementPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório PlacementPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório PlacementPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
BaseAdGroupId Long Atributo ID do grupo de anúncios base ID do grupo de anúncios base para o relatório PlacementPerformance.
BaseCampaignId Long Atributo ID base da campanha ID de campanha base para o relatório PlacementPerformance.
BiddingStrategyId Long Atributo ID da estratégia de lances ID da estratégia de lances para o relatório PlacementPerformance.
BiddingStrategyName String Atributo Nome da estratégia de lance Nome da estratégia de lances para o relatório PlacementPerformance.
BiddingStrategyType String Atributo Tipo de estratégia de lance Tipo de estratégia de lance para o relatório PlacementPerformance. Os valores permitidos são MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BidModifier Double Atributo Ajuste de lance Ajuste de lance para o relatório PlacementPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório PlacementPerformance.
CampaignName String Atributo Campanha Campanha para o relatório PlacementPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório PlacementPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Atributo CPC máximo CPC máximo para o relatório PlacementPerformance.
CpcBidSource String Atributo Origem do CPC máx. Origem do CPC máximo para o relatório PlacementPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Atributo CPM máximo CPM máximo para o relatório PlacementPerformance.
CpmBidSource String Atributo Origem do CPM máx. Origem do CPM máximo para o relatório PlacementPerformance. Os valores permitidos são ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Atributo Colocação Posicionamento para o relatório PlacementPerformance.
CriteriaDestinationUrl String Atributo URL de destino URL de destino para o relatório PlacementPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório PlacementPerformance.
DisplayName String Atributo Nome de exibição dos critérios Nome de exibição de critérios para o relatório PlacementPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório PlacementPerformance.
FinalAppUrls String Atributo URL final do aplicativo URL final do aplicativo para o relatório PlacementPerformance.
FinalMobileUrls String Atributo URL final móvel URL final móvel para o relatório PlacementPerformance.
FinalUrls String Atributo URL final URL final do relatório PlacementPerformance.
Id Long Atributo ID do critério ID do critério para o relatório PlacementPerformance.
IsNegative Boolean Atributo é negativo É negativo para o relatório PlacementPerformance.
IsRestrict Boolean Atributo está restringindo É uma restrição para o relatório PlacementPerformance.
Status String Atributo Estado da colocação Estado da veiculação para o relatório PlacementPerformance. Os valores permitidos são ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de acompanhamento para o relatório PlacementPerformance.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro personalizado para o relatório PlacementPerformance.
AdNetworkType1 String Segmento Rede Network para o relatório PlacementPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório PlacementPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório PlacementPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório PlacementPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório PlacementPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório PlacementPerformance.
Date Date Segmento Dia Dia do relatório PlacementPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório PlacementPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório PlacementPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório PlacementPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório PlacementPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório PlacementPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório PlacementPerformance.
Week String Segmento Semana Semana para o relatório PlacementPerformance.
Year Integer Segmento Ano Ano para o relatório PlacementPerformance.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório PlacementPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório PlacementPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório PlacementPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impressões por impr mensuráveis do Active View para o relatório PlacementPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório PlacementPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressões mensuráveis do Active View para o relatório PlacementPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório PlacementPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório PlacementPerformance.
AllConversions Double Métrica Todas as conversões Todas as conversões para o relatório PlacementPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório PlacementPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório PlacementPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório PlacementPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório PlacementPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório PlacementPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório PlacementPerformance.
Clicks Long Métrica Cliques Cliques para o relatório PlacementPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório PlacementPerformance.
Conversions Double Métrica Conversões Conversões para o relatório PlacementPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório PlacementPerformance.
Cost Decimal Métrica Custo Custo do relatório PlacementPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório PlacementPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório PlacementPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório PlacementPerformance.
Ctr Double Métrica CTR CTR para o relatório PlacementPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório PlacementPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório PlacementPerformance.
GmailForwards Long Métrica Encaminhamentos do Gmail Encaminhamentos do Gmail para o relatório PlacementPerformance.
GmailSaves Long Métrica Gmail salva O Gmail salva para o relatório PlacementPerformance.
GmailSecondaryClicks Long Métrica Cliques do Gmail para o site Gmail Clicks To Website para o relatório PlacementPerformance.
Impressions Long Métrica Impressões Impressões para o relatório PlacementPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório PlacementPerformance.
Interactions Long Métrica Interações Interações para o relatório PlacementPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório PlacementPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório PlacementPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório PlacementPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido em 100% para o relatório PlacementPerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido em 25% para o relatório PlacementPerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido em 50% para o relatório PlacementPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido em 75% para o relatório PlacementPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório PlacementPerformance.
VideoViews Long Métrica Visualizações Exibições do relatório PlacementPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório PlacementPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
ProductPartition

O relatório Partição de produto fornece estatísticas de campanha de compras agregadas no nível de partição de produto (campo Id).

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountDescriptiveName String Atributo Conta Conta para o relatório ProductPartition.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório ProductPartition.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório ProductPartition.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório ProductPartition. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
BiddingStrategyType String Atributo Tipo de estratégia de lance Tipo de estratégia de lance para o relatório ProductPartition. Os valores permitidos são MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório ProductPartition.
CampaignName String Atributo Campanha Campanha para o relatório ProductPartition.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório ProductPartition. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Atributo CPC máximo CPC máximo para o relatório ProductPartition.
CriteriaDestinationUrl String Atributo URL de destino de palavra-chave por canal URL de destino de palavra-chave por canal para o relatório ProductPartition.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório ProductPartition.
FinalUrlSuffix String Atributo Sufixo do URL final Sufixo de URL final para o relatório ProductPartition.
Id Long Atributo ID do critério ID do critério para o relatório ProductPartition.
IsNegative Boolean Atributo é negativo É negativo para o relatório ProductPartition.
ParentCriterionId Long Atributo ID do critério principal ID do critério pai para o relatório ProductPartition.
ProductGroup String Atributo Grupo de produtos Grupo de produtos para o relatório ProductPartition.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de rastreamento para o relatório ProductPartition.
UrlCustomParameters String Atributo Parâmetro personalizado Parâmetro personalizado para o relatório ProductPartition.
AdNetworkType1 String Segmento Rede Rede para o relatório ProductPartition. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório ProductPartition. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório ProductPartition. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório ProductPartition.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório ProductPartition.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório ProductPartition.
Date Date Segmento Dia Dia para o relatório ProductPartition.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório ProductPartition. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório ProductPartition. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório ProductPartition. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês para o relatório ProductPartition.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório ProductPartition. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
PartitionType String Segmento Tipo de partição Tipo de partição para o relatório ProductPartition. Os valores permitidos são UNKNOWN, SUBDIVISION, UNIT.
Quarter String Segmento Trimestre Trimestre para o relatório ProductPartition.
Week String Segmento Semana Semana para o relatório ProductPartition.
Year Integer Segmento Ano Ano para o relatório ProductPartition.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório ProductPartition.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório ProductPartition.
AllConversionValue Double Métrica Valor de todas as conversões Todo o valor de conv para o relatório ProductPartition.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório ProductPartition.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório ProductPartition.
BenchmarkAverageMaxCpc Decimal Métrica CPC máximo de referência CPC máximo de referência para o relatório ProductPartition.
BenchmarkCtr Double Métrica CTR de referência CTR de referência para o relatório ProductPartition.
Clicks Long Métrica Cliques Cliques para o relatório ProductPartition.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório ProductPartition.
Conversions Double Métrica Conversões Conversões para o relatório ProductPartition.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório ProductPartition.
Cost Decimal Métrica Custo Custo do relatório ProductPartition.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório ProductPartition.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório ProductPartition.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório ProductPartition.
Ctr Double Métrica CTR CTR para o relatório ProductPartition.
Impressions Long Métrica Impressões Impressões para o relatório ProductPartition.
SearchAbsoluteTopImpressionShare Double Métrica Pesquisar Abs Top IS Pesquise Abs Top IS para o relatório ProductPartition.
SearchClickShare Double Métrica Clique em Compartilhar Clique em Compartilhar para o relatório ProductPartition.
SearchImpressionShare Double Métrica Pesquisar Impr Compartilhar Pesquise Impr Share para o relatório ProductPartition.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório ProductPartition.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório ProductPartition.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório ProductPartition.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Desempenho da Consulta de Pesquisa

O relatório de termos de pesquisa inclui todas as estatísticas agregadas no nível dos termos de pesquisa, uma linha por combinação de termos de pesquisa.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório SearchQueryPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório SearchQueryPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório SearchQueryPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório SearchQueryPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório SearchQueryPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório SearchQueryPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório SearchQueryPerformance.
CampaignName String Atributo Campanha Campanha para o relatório SearchQueryPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório SearchQueryPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CreativeId Long Atributo ID do anúncio ID do anúncio para o relatório SearchQueryPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório SearchQueryPerformance.
DestinationUrl String Atributo URL de destino URL de destino para o relatório SearchQueryPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório SearchQueryPerformance.
FinalUrl String Atributo URL final URL final do relatório SearchQueryPerformance.
KeywordId Long Atributo ID da palavra-chave ID da palavra-chave para o relatório SearchQueryPerformance.
KeywordTextMatchingQuery String Atributo Palavra-chave Palavra-chave para o relatório SearchQueryPerformance.
Query String Atributo Termo de pesquisa Termo de pesquisa para o relatório SearchQueryPerformance.
QueryTargetingStatus String Atributo Adicionado por excluído Adicionado por excluído para o relatório SearchQueryPerformance. Os valores permitidos são ADDED, EXCLUDED, BOTH, NONE.
TrackingUrlTemplate String Atributo Modelo de Rastreamento Modelo de rastreamento para o relatório SearchQueryPerformance.
AdFormat String Segmento Tipo de anúncio Tipo de anúncio para o relatório SearchQueryPerformance. Os valores permitidos são UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.
AdNetworkType1 String Segmento Rede Rede para o relatório SearchQueryPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório SearchQueryPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório SearchQueryPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório SearchQueryPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório SearchQueryPerformance.
Date Date Segmento Dia Dia para o relatório SearchQueryPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório SearchQueryPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório SearchQueryPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório SearchQueryPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório SearchQueryPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório SearchQueryPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório SearchQueryPerformance.
QueryMatchTypeWithVariant String Segmento Tipo de correspondência Tipo de correspondência para o relatório SearchQueryPerformance. Os valores permitidos são AUTO, BROAD, EXACT, EXPANDED, PHRASE, NEAR_EXACT, NEAR_PHRASE.
Week String Segmento Semana Semana para o relatório SearchQueryPerformance.
Year Integer Segmento Ano Ano do relatório SearchQueryPerformance.
AbsoluteTopImpressionPercentage Double Métrica Impr Abs Top A porcentagem de impressões adicionadas mostradas como o primeiro anúncio.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório SearchQueryPerformance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório SearchQueryPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório SearchQueryPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório SearchQueryPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório SearchQueryPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório SearchQueryPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório SearchQueryPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório SearchQueryPerformance.
AveragePosition Double Métrica Posição Média Posição média do relatório SearchQueryPerformance.
Clicks Long Métrica Cliques Cliques para o relatório SearchQueryPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório SearchQueryPerformance.
Conversions Double Métrica Conversões Conversões para o relatório SearchQueryPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório SearchQueryPerformance.
Cost Decimal Métrica Custo Custo do relatório SearchQueryPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório SearchQueryPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório SearchQueryPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório SearchQueryPerformance.
Ctr Double Métrica CTR CTR para o relatório SearchQueryPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório SearchQueryPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório SearchQueryPerformance.
Impressions Long Métrica Impressões Impressões para o relatório SearchQueryPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório SearchQueryPerformance.
Interactions Long Métrica Interações Interações para o relatório SearchQueryPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório SearchQueryPerformance.
TopImpressionPercentage Double Métrica Impr Início A porcentagem de impressões adicionadas que são exibidas em qualquer lugar acima dos resultados da pesquisa orgânica.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório SearchQueryPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório SearchQueryPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido em 100% para o relatório SearchQueryPerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido em 25% para o relatório SearchQueryPerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido até 50% para o relatório SearchQueryPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido em 75% para o relatório SearchQueryPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de visualização do relatório SearchQueryPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório SearchQueryPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório SearchQueryPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
SharedSet

O relatório Conjunto compartilhado inclui todos os Conjuntos compartilhados que podem ser compartilhados entre campanhas.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountDescriptiveName String Atributo Conta Conta para o relatório SharedSet.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório SharedSet.
Name String Atributo Nome do Conjunto Compartilhado Nome do conjunto compartilhado para o relatório SharedSet.
SharedSetId Long Atributo ID do Conjunto Compartilhado ID do conjunto compartilhado para o relatório SharedSet.
Status String Atributo Estado Estado para o relatório SharedSet. Os valores permitidos são ENABLED, REMOVED, UNKNOWN.
Type String Atributo Tipo de conjunto compartilhado Tipo de conjunto compartilhado para o relatório SharedSet. Os valores permitidos são NEGATIVE_KEYWORDS, NEGATIVE_PLACEMENTS, UNKNOWN.
MemberCount String Métrica Contagem de membros Contagem de membros para o relatório SharedSet.
ReferenceCount String Métrica Contagem de referência Contagem de referência para o relatório SharedSet.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
SharedSetCriteria

O relatório Shared Set Criteria inclui critérios para cada SharedSet.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountDescriptiveName String Atributo Conta Conta para o relatório SharedSetCriteria.
Criteria String Atributo Palavra-chave negativa Palavra-chave negativa para o relatório SharedSetCriteria.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório SharedSetCriteria.
Id Long Atributo ID da palavra-chave ID da palavra-chave para o relatório SharedSetCriteria.
KeywordMatchType String Atributo Tipo de correspondência Tipo de correspondência para o relatório SharedSetCriteria. Os valores permitidos são EXACT, PHRASE, BROAD.
SharedSetId Long Atributo ID do Conjunto Compartilhado ID do conjunto compartilhado para o relatório SharedSetCriteria.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
ComprasDesempenho

O relatório Desempenho de compras fornece estatísticas de campanha de compras agregadas no nível do produto (campo OfferId).

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountDescriptiveName String Atributo Conta Conta para o relatório ShoppingPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório ShoppingPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório ShoppingPerformance.
AggregatorId Long Atributo Identificação MCA ID MCA para o relatório ShoppingPerformance.
Brand String Atributo Marca Marca para o relatório ShoppingPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório ShoppingPerformance.
CampaignName String Atributo Campanha Campanha para o relatório ShoppingPerformance.
CategoryL1 String Atributo Categoria (1º Nível) Categoria (1º nível) para o relatório ShoppingPerformance.
CategoryL2 String Atributo Categoria (2º Nível) Categoria (2º Nível) para o relatório ShoppingPerformance.
CategoryL3 String Atributo Categoria (3º Nível) Categoria (3º nível) para o relatório ShoppingPerformance.
CategoryL4 String Atributo Categoria (4º Nível) Categoria (4º Nível) para o relatório ShoppingPerformance.
CategoryL5 String Atributo Categoria (5º Nível) Categoria (5º Nível) para o relatório ShoppingPerformance.
CountryCriteriaId Integer Atributo País por território País por território para o relatório ShoppingPerformance.
CustomAttribute0 String Atributo Rótulo personalizado 0 Rótulo personalizado 0 para o relatório ShoppingPerformance.
CustomAttribute1 String Atributo Etiqueta personalizada 1 Rótulo personalizado 1 para o relatório ShoppingPerformance.
CustomAttribute2 String Atributo Etiqueta personalizada 2 Rótulo personalizado 2 para o relatório ShoppingPerformance.
CustomAttribute3 String Atributo Etiqueta personalizada 3 Rótulo personalizado 3 para o relatório ShoppingPerformance.
CustomAttribute4 String Atributo Etiqueta personalizada 4 Rótulo personalizado 4 para o relatório ShoppingPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório ShoppingPerformance.
LanguageCriteriaId Integer Atributo Idioma Idioma do relatório ShoppingPerformance.
MerchantId Long Atributo Identificação do MC ID do MC para o relatório ShoppingPerformance.
OfferId String Atributo Identificação do item ID do item para o relatório ShoppingPerformance.
ProductTitle String Atributo Título do produto Título do produto para o relatório ShoppingPerformance.
ProductTypeL1 String Atributo Tipo de Produto (1º Nível) Tipo de produto (1º nível) para o relatório ShoppingPerformance.
ProductTypeL2 String Atributo Tipo de Produto (2º Nível) Tipo de produto (2º nível) para o relatório ShoppingPerformance.
ProductTypeL3 String Atributo Tipo de produto (3º nível) Tipo de produto (3º nível) para o relatório ShoppingPerformance.
ProductTypeL4 String Atributo Tipo de Produto (4º Nível) Tipo de produto (4º nível) para o relatório ShoppingPerformance.
ProductTypeL5 String Atributo Tipo de Produto (5º Nível) Tipo de produto (5º nível) para o relatório ShoppingPerformance.
StoreId String Atributo Identificação da loja ID da loja para o relatório ShoppingPerformance.
AdGroupStatus String Segmento Estado do grupo de anúncios Estado do grupo de anúncios para o relatório ShoppingPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
AdNetworkType1 String Segmento Rede Rede para o relatório ShoppingPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório ShoppingPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
CampaignStatus String Segmento Estado da campanha Estado da campanha para o relatório ShoppingPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
Channel String Segmento Canal Canal para o relatório ShoppingPerformance. Os valores permitidos são UNKNOWN, ONLINE, LOCAL.
ChannelExclusivity String Segmento Exclusividade do Canal Exclusividade do canal para o relatório ShoppingPerformance. Os valores permitidos são UNKNOWN, SINGLE_CHANNEL, MULTI_CHANNEL.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório ShoppingPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório ShoppingPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório ShoppingPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório ShoppingPerformance.
Date Date Segmento Dia Dia para o relatório ShoppingPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório ShoppingPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório ShoppingPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Fonte de conversão para o relatório ShoppingPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês do relatório ShoppingPerformance.
ProductCondition String Segmento Condição Condição para o relatório ShoppingPerformance. Os valores permitidos são DESCONHECIDO, NOVO, RECONHECIDO, USADO.
Quarter String Segmento Trimestre Trimestre para o relatório ShoppingPerformance.
Week String Segmento Semana Semana do relatório ShoppingPerformance.
Year Integer Segmento Ano Ano para o relatório ShoppingPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório ShoppingPerformance.
AllConversions Double Métrica Todas as conversões Todas as conversões para o relatório ShoppingPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todo o valor de conversão para o relatório ShoppingPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório ShoppingPerformance.
Clicks Long Métrica Cliques Cliques para o relatório ShoppingPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório ShoppingPerformance.
Conversions Double Métrica Conversões Conversões para o relatório ShoppingPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório ShoppingPerformance.
Cost Decimal Métrica Custo Custo do relatório ShoppingPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório ShoppingPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório ShoppingPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório ShoppingPerformance.
Ctr Double Métrica CTR CTR para o relatório ShoppingPerformance.
Impressions Long Métrica Impressões Impressões para o relatório ShoppingPerformance.
SearchAbsoluteTopImpressionShare Double Métrica Pesquisar Abs Top IS Pesquise Abs Top IS para obter o relatório ShoppingPerformance.
SearchClickShare Double Métrica Clique em Compartilhar Clique em Compartilhar para obter o relatório ShoppingPerformance.
SearchImpressionShare Double Métrica Pesquisar Impr Compartilhar Pesquise Parcela de impressão para o relatório ShoppingPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório ShoppingPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório ShoppingPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Melhor Desempenho de Conteúdo

Recupera os dados do relatório TopContentPerformance.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório TopContentPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório TopContentPerformance.
BidModifier Double Atributo Ajuste de lance Ajuste de lance para o relatório TopContentPerformance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório TopContentPerformance.
CampaignName String Atributo Campanha Campanha para o relatório TopContentPerformance.
Id Long Atributo ID do critério ID do critério para o relatório TopContentPerformance.
Date Date Segmento Dia Dia para o relatório TopContentPerformance.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório TopContentPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório TopContentPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório TopContentPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório TopContentPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório TopContentPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório TopContentPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório TopContentPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório TopContentPerformance.
Clicks Long Métrica Cliques Cliques para o relatório TopContentPerformance.
Cost Decimal Métrica Custo Custo do relatório TopContentPerformance.
Ctr Double Métrica CTR CTR para o relatório TopContentPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório TopContentPerformance.
Engagements Long Métrica Noivados Envolvimentos para o relatório TopContentPerformance.
Impressions Long Métrica Impressões Impressões para o relatório TopContentPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório TopContentPerformance.
Interactions Long Métrica Interações Interações para o relatório TopContentPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório TopContentPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório TopContentPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório TopContentPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
UrlDesempenho

O relatório de desempenho da URL inclui todas as estatísticas agregadas na URL e no nível do critério.

Informações Específicas da Tabela

Selecione

O Google AdWords não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console do AdWords.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API do AdWords.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório UrlPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório UrlPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório UrlPerformance.
AdGroupCriterionStatus String Atributo Palavra-chave por estado do canal Palavra-chave por estado de canal para o relatório UrlPerformance. Os valores permitidos são ENABLED, REMOVED, PAUSED.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório UrlPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório UrlPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório UrlPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório UrlPerformance.
CampaignName String Atributo Campanha Campanha para o relatório UrlPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório UrlPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CriteriaParameters String Atributo Palavra-chave por canal Palavra-chave por canal para o relatório UrlPerformance.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório UrlPerformance.
DisplayName String Atributo Nome de exibição dos critérios Nome de exibição dos critérios para o relatório UrlPerformance.
Domain String Atributo Domínio Domínio para o relatório UrlPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório UrlPerformance.
IsBidOnPath String Atributo Adicionado Adicionado para o relatório UrlPerformance.
IsPathExcluded String Atributo Excluído Excluído para o relatório UrlPerformance.
Url String Atributo URL URL para o relatório UrlPerformance.
AdFormat String Segmento Tipo de anúncio Tipo de anúncio para o relatório UrlPerformance. Os valores permitidos são UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.
AdNetworkType1 String Segmento Rede Rede para o relatório UrlPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório UrlPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório UrlPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório UrlPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório UrlPerformance.
Date Date Segmento Dia Dia para o relatório UrlPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório UrlPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório UrlPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório UrlPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
IsAutoOptimized Boolean Segmento Modo de segmentação Modo de segmentação para o relatório UrlPerformance.
Month String Segmento Mês Mês para o relatório UrlPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório UrlPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório UrlPerformance.
Week String Segmento Semana Semana para o relatório UrlPerformance.
Year Integer Segmento Ano Ano para o relatório UrlPerformance.
ActiveViewCpm Decimal Métrica CPM médio do Active View CPM médio do Active View para o relatório UrlPerformance.
ActiveViewCtr Double Métrica Visualização ativa CTR visível Active View CTR visível para o relatório UrlPerformance.
ActiveViewImpressions Long Métrica Impressões Visíveis do Active View Impressões visíveis do Active View para o relatório UrlPerformance.
ActiveViewMeasurability Double Métrica Impressão mensurável do Active View por impressão Impr mensuráveis do Active View por impr para o relatório UrlPerformance.
ActiveViewMeasurableCost Decimal Métrica Custo Mensurável do Active View Custo mensurável do Active View para o relatório UrlPerformance.
ActiveViewMeasurableImpressions Long Métrica Impressões mensuráveis do Active View Impressão mensurável do Active View para o relatório UrlPerformance.
ActiveViewViewability Double Métrica Impressões visíveis do Active View por impressões mensuráveis Impressões visíveis do Active View por impressões mensuráveis para o relatório UrlPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório UrlPerformance.
AllConversions Double Métrica Todas as conversões Todas as conversões para o relatório UrlPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Todo o valor de conversão para o relatório UrlPerformance.
AverageCost Decimal Métrica Custo médio Custo médio para o relatório UrlPerformance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório UrlPerformance.
AverageCpe Double Métrica CPE médio CPE médio para o relatório UrlPerformance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório UrlPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório UrlPerformance.
Clicks Long Métrica Cliques Cliques para o relatório UrlPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório UrlPerformance.
Conversions Double Métrica Conversões Conversões para o relatório UrlPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório UrlPerformance.
Cost Decimal Métrica Custo Custo do relatório UrlPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório UrlPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório UrlPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório UrlPerformance.
Ctr Double Métrica CTR CTR para o relatório UrlPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório UrlPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório UrlPerformance.
Impressions Long Métrica Impressões Impressões para o relatório UrlPerformance.
InteractionRate Double Métrica Taxa de Interação Taxa de interação para o relatório UrlPerformance.
Interactions Long Métrica Interações Interações para o relatório UrlPerformance.
InteractionTypes String Métrica Tipos de interação Tipos de interação para o relatório UrlPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório UrlPerformance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório UrlPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido em 100% para o relatório UrlPerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido em 25% para o relatório UrlPerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido em 50% para o relatório UrlPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido em 75% para o relatório UrlPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório UrlPerformance.
VideoViews Long Métrica Visualizações Exibições para o relatório UrlPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório UrlPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
UserAdDistance

O Relatório de distância do anúncio do usuário fornece estatísticas agregadas pela distância do usuário às suas extensões de local.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório UserAdDistance.
AccountDescriptiveName String Atributo Conta Conta para o relatório UserAdDistance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório UserAdDistance.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório UserAdDistance.
CampaignName String Atributo Campanha Campanha para o relatório UserAdDistance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório UserAdDistance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório UserAdDistance.
DistanceBucket String Atributo Distância das extensões de local Distância de extensões de local para o relatório UserAdDistance. Os valores permitidos são DISTANCE_BUCKET_WITHIN_200M, DISTANCE_BUCKET_WITHIN_500M, DISTANCE_BUCKET_WITHIN_700M, DISTANCE_BUCKET_WITHIN_1KM, DISTANCE_BUCKET_WITHIN_5KM, DISTANCE_BUCKET_WITHIN_10KM, DISTANCE_B UCKET_WITHIN_15KM, DISTANCE_BUCKET_WITHIN_20KM, DISTANCE_BUCKET_WITHIN_25KM, DISTANCE_BUCKET_WITHIN_30KM, DISTANCE_BUCKET_WITHIN_35KM, DISTANCE_BUCKET_WITHIN_40KM, DISTANCE_BUCKET_WITHIN_ 45 KM, DISTANCE_BUCKET_WITHIN_50KM, DISTANCE_BUCKET_WITHIN_55KM, DISTANCE_BUCKET_WITHIN_60KM, DISTANCE_BUCKET_WITHIN_65KM, DISTANCE_BUCKET_BEYOND_65KM, DISTANCE_BUCKET_WITHIN_0_2MILES, DISTÂNCIA_BUCKET_WITHIN_0_5MILES, DISTANCE_BUCKET_WITHIN_0_7MILES, DISTANCE_BUCKET_WITHIN_1MILE, DISTANCE_BUCKET_WITHIN_5MILES, DISTANCE_BUCKET_WITHIN_10MILES, DISTANCE_BUCKET_WITHIN_15MILES, DISTANCE_BUCKET_WITHIN_20MILES, DISTANCE_BUCKET_WITHIN_25MILES, DISTANCE_BUCKET_WITHIN_30MILES, DISTANCE_BUCKET_WITHIN_35MILES, DISTANCE_BUC KET_WITHIN_40MILES, DISTANCE_BUCKET_BEYOND_40MILES, DESCONHECIDO.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório UserAdDistance.
AdNetworkType1 String Segmento Rede Rede para o relatório UserAdDistance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório UserAdDistance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório UserAdDistance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório UserAdDistance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório UserAdDistance.
Date Date Segmento Dia Dia para o relatório UserAdDistance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório UserAdDistance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório UserAdDistance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório UserAdDistance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês para o relatório UserAdDistance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório UserAdDistance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório UserAdDistance.
Week String Segmento Semana Semana para o relatório UserAdDistance.
Year Integer Segmento Ano Ano para o relatório UserAdDistance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório UserAdDistance.
AllConversions Double Métrica Todas as conversões Todas as conv para o relatório UserAdDistance.
AllConversionValue Double Métrica Valor de todas as conversões Todos os valores de conv para o relatório UserAdDistance.
AverageCpc Decimal Métrica CPC médio CPC médio para o relatório UserAdDistance.
AverageCpm Decimal Métrica CPM médio CPM médio para o relatório UserAdDistance.
AveragePosition Double Métrica Posição Média Posição média para o relatório UserAdDistance.
Clicks Long Métrica Cliques Cliques para o relatório UserAdDistance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório UserAdDistance.
Conversions Double Métrica Conversões Conversões para o relatório UserAdDistance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório UserAdDistance.
Cost Decimal Métrica Custo Custo do relatório UserAdDistance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório UserAdDistance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório UserAdDistance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório UserAdDistance.
Ctr Double Métrica CTR CTR para o relatório UserAdDistance.
Impressions Long Métrica Impressões Impressões para o relatório UserAdDistance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório UserAdDistance.
ValuePerConversion Double Métrica Valor por conversão Valor por conversão para o relatório UserAdDistance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório UserAdDistance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
Desempenho de Vídeo

O Relatório de desempenho de vídeo inclui estatísticas das campanhas atualizadas do AdWords para vídeo de sua conta.

Colunas
Nome Tipo Comportamento DisplayName Descrição
AccountCurrencyCode String Atributo Moeda Moeda para o relatório VideoPerformance.
AccountDescriptiveName String Atributo Conta Conta para o relatório VideoPerformance.
AccountTimeZone String Atributo Fuso horário Fuso horário para o relatório VideoPerformance.
AdGroupId Long Atributo ID do grupo de anúncios ID do grupo de anúncios para o relatório VideoPerformance.
AdGroupName String Atributo Grupo de anúncios Grupo de anúncios para o relatório VideoPerformance.
AdGroupStatus String Atributo Estado do grupo de anúncios Estado do grupo de anúncios para o relatório VideoPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Atributo ID da campanha ID da campanha para o relatório VideoPerformance.
CampaignName String Atributo Campanha Campanha para o relatório VideoPerformance.
CampaignStatus String Atributo Estado da campanha Estado da campanha para o relatório VideoPerformance. Os valores permitidos são UNKNOWN, ENABLED, PAUSED, REMOVED.
CreativeId Long Atributo ID do anúncio ID do anúncio para o relatório VideoPerformance.
CreativeStatus String Atributo Estado do anúncio Estado do anúncio para o relatório VideoPerformance. Os valores permitidos são ENABLED, PAUSED, DISABLED.
CustomerDescriptiveName String Atributo Nome do cliente Nome do cliente para o relatório VideoPerformance.
ExternalCustomerId Long Atributo Identificação do cliente ID do cliente para o relatório VideoPerformance.
VideoChannelId String Atributo ID do canal de vídeo ID do canal de vídeo para o relatório VideoPerformance.
VideoDuration Long Atributo Duração do vídeo Duração do vídeo para o relatório VideoPerformance.
VideoId String Atributo ID do vídeo ID do vídeo para o relatório VideoPerformance.
VideoTitle String Atributo Título do vídeo Título do vídeo para o relatório VideoPerformance.
AdNetworkType1 String Segmento Rede Rede para o relatório VideoPerformance. Os valores permitidos são UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segmento Rede (com parceiros de pesquisa) Rede (com parceiros de pesquisa) para o relatório VideoPerformance. Os valores permitidos são UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segmento Clique em Tipo Clique em Tipo para o relatório VideoPerformance. Os valores permitidos são URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_ LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOC ATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, DESCONHECIDO.
ConversionCategoryName String Segmento Categoria de conversão Categoria de conversão para o relatório VideoPerformance.
ConversionTrackerId Long Segmento ID do rastreador de conversão ID do rastreador de conversão para o relatório VideoPerformance.
ConversionTypeName String Segmento Nome da conversão Nome da conversão para o relatório VideoPerformance.
Date Date Segmento Dia Dia do relatório VideoPerformance.
DayOfWeek String Segmento Dia da semana Dia da semana para o relatório VideoPerformance. Os valores permitidos são SEGUNDA, TERÇA, QUARTA, QUINTA, SEXTA, SÁBADO, DOMINGO.
Device String Segmento Dispositivo Dispositivo para o relatório VideoPerformance. Os valores permitidos são UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segmento Origem da conversão Origem da conversão para o relatório VideoPerformance. Os valores permitidos são UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segmento Mês Mês para o relatório VideoPerformance.
MonthOfYear String Segmento mês do ano Mês do ano para o relatório VideoPerformance. Os valores permitidos são JANEIRO, FEVEREIRO, MARÇO, ABRIL, MAIO, JUNHO, JULHO, AGOSTO, SETEMBRO, OUTUBRO, NOVEMBRO, DEZEMBRO.
Quarter String Segmento Trimestre Trimestre para o relatório VideoPerformance.
Week String Segmento Semana Semana do relatório VideoPerformance.
Year Integer Segmento Ano Ano para o relatório VideoPerformance.
AllConversionRate Double Métrica Todas as taxas de conversão Todas as taxas de conversão para o relatório VideoPerformance.
AllConversions Double Métrica Todas as conversões Todas as conversões para o relatório VideoPerformance.
AllConversionValue Double Métrica Valor de todas as conversões Valor de todas as conv para o relatório VideoPerformance.
AverageCpm Double Métrica CPM médio CPM médio para o relatório VideoPerformance.
AverageCpv Double Métrica CPV médio CPV médio para o relatório VideoPerformance.
Clicks Long Métrica Cliques Cliques para o relatório VideoPerformance.
ConversionRate Double Métrica Taxa de conversão Taxa de conversão para o relatório VideoPerformance.
Conversions Double Métrica Conversões Conversões para o relatório VideoPerformance.
ConversionValue Double Métrica Valor total de conversão Valor total de conversão para o relatório VideoPerformance.
Cost Decimal Métrica Custo Custo do relatório VideoPerformance.
CostPerAllConversion Decimal Métrica Custo por todas as conversões Custo por todas as conversões para o relatório VideoPerformance.
CostPerConversion Decimal Métrica Custo por conversão Custo por conversão para o relatório VideoPerformance.
CrossDeviceConversions Double Métrica Conv entre dispositivos Conv entre dispositivos para o relatório VideoPerformance.
Ctr Double Métrica CTR CTR para o relatório VideoPerformance.
EngagementRate Double Métrica Taxa de engajamento Taxa de engajamento para o relatório VideoPerformance.
Engagements Long Métrica Noivados Engajamentos para o relatório VideoPerformance.
Impressions Long Métrica Impressões Impressões para o relatório VideoPerformance.
ValuePerAllConversion Double Métrica Valor por todas as conversões Valor por todas as conv para o relatório VideoPerformance.
VideoQuartile100Rate Double Métrica Vídeo reproduzido a 100% Vídeo reproduzido a 100% para o relatório VideoPerformance.
VideoQuartile25Rate Double Métrica Vídeo reproduzido a 25% Vídeo reproduzido em 25% para o relatório VideoPerformance.
VideoQuartile50Rate Double Métrica Vídeo reproduzido a 50% Vídeo reproduzido em 50% para o relatório VideoPerformance.
VideoQuartile75Rate Double Métrica Vídeo reproduzido a 75% Vídeo reproduzido em 75% para o relatório VideoPerformance.
VideoViewRate Double Métrica Ver Taxa Taxa de exibição para o relatório VideoPerformance.
VideoViews Long Métrica Visualizações Exibições do relatório VideoPerformance.
ViewThroughConversions Long Métrica Conv de visualização View-through Conv para o relatório VideoPerformance.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
StartDate String Data de início para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.
EndDate String Data de término para buscar dados do AdWords. Ambos StartDate e EndDate devem ser definidos para especificar um intervalo de datas personalizado. O intervalo padrão nos últimos sete dias.

Procedimentos Armazenados

Procedimentos armazenados* estão disponíveis para complementar os dados disponíveis no Modelo de Dados. Pode ser necessário atualizar os dados disponíveis em uma exibição usando um procedimento armazenado* porque os dados não fornecem atualizações bidirecionais diretas, semelhantes a tabelas. Nessas situações, a recuperação dos dados é feita usando a visualização ou tabela apropriada, enquanto a atualização é feita chamando um procedimento armazenado. Procedimentos armazenados* pega uma lista de parâmetros e retorna um conjunto de dados que contém a coleção de tuplas que constituem a resposta.

Conector Jitterbit para Procedimentos Armazenados do Google Ads
Nome Descrição
GetOAuthAccessToken Obtém o token de acesso OAuth para ser usado para autenticação com vários serviços do Google.
GetOAuthAuthorizationURL Obtém o URL de autorização OAuth usado para autenticação com vários serviços do Google.
RefreshOAuthAccessToken Obtém o token de acesso OAuth para ser usado para autenticação com vários serviços do Google.
GetOAuthAccessToken

Obtém o token de acesso OAuth para ser usado para autenticação com vários serviços do Google.

Entrada
Nome Tipo Obrigatório Descrição
AuthMode String Verdade O tipo de modo de autenticação a ser usado. Os valores permitidos são APP, WEB. O valor padrão é WEB.
Scope String Verdade O escopo de acesso às APIs do Google. Por padrão, o acesso a todas as APIs usadas por esse provedor de dados será especificado. o valor padrão é https://www.googleapis.com/auth/adwords.
Verifier String Falso O código do verificador retornado pelo Google depois que a permissão para o aplicativo se conectar foi concedida. WEB AuthMode apenas.
CallbackURL String Falso Este campo determina para onde a resposta é enviada. O valor desse parâmetro deve corresponder exatamente a um dos valores registrados no Console de APIs, incluindo os esquemas HTTP ou HTTPS, capitalização e barra final ('/').
Prompt String Verdade Este campo indica o prompt para apresentar ao usuário. Ele aceita um dos seguintes valores: NONE, CONSENT, SELECT ACCOUNT. O padrão é SELECT_ACCOUNT, portanto, um determinado usuário será solicitado a selecionar a conta à qual se conectar. Se estiver definido como CONSENT, o usuário verá uma página de consentimento todas as vezes, mesmo que já tenha dado consentimento ao aplicativo para um determinado conjunto de escopos. Por fim, se for definido como NONE, nenhuma tela de autenticação ou consentimento será exibida ao usuário. O valor padrão é SELECT_ACCOUNT.
AccessType String Verdade Este campo indica se seu aplicativo precisa acessar uma API do Google quando o usuário não está presente no navegador. Este parâmetro é padronizado como OFFLINE. Se seu aplicativo precisar atualizar tokens de acesso quando o usuário não estiver presente no navegador, use OFFLINE. Isso fará com que seu aplicativo obtenha um token de atualização na primeira vez que seu aplicativo trocar um código de autorização para um usuário. Os valores permitidos são ONLINE, OFFLINE. O valor padrão é OFFLINE.
State String Falso Este campo indica qualquer estado que pode ser útil para sua aplicação após o recebimento da resposta. Seu aplicativo recebe o mesmo valor que enviou, pois esse parâmetro faz uma viagem de ida e volta ao servidor de autorização do Google. Os usos incluem redirecionar o usuário para o recurso correto em seu site, usar nonces e atenuar a falsificação de solicitação entre sites.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
OAuthAccessToken String O token de autenticação retornado do Google. Isso pode ser usado em chamadas subseqüentes para outras operações para este serviço específico.
OAuthRefreshToken String Um token que pode ser usado para obter um novo token de acesso.
ExpiresIn String O tempo de vida restante no token de acesso.
GetOAuthAuthorizationURL

Obtém o URL de autorização OAuth usado para autenticação com vários serviços do Google.

Entrada
Nome Tipo Obrigatório Descrição
Scope String Verdade O escopo de acesso às APIs do Google. Por padrão, o acesso a todas as APIs usadas por esse provedor de dados será especificado. o valor padrão é https://www.googleapis.com/auth/adwords.
CallbackURL String Falso Este campo determina para onde a resposta é enviada. O valor desse parâmetro deve corresponder exatamente a um dos valores registrados no Console de APIs, incluindo os esquemas HTTP ou HTTPS, maiúsculas e minúsculas e barra final ('/').
Prompt String Verdade Este campo indica o prompt para apresentar ao usuário. Ele aceita um dos seguintes valores: NONE, CONSENT, SELECT ACCOUNT. O padrão é SELECT_ACCOUNT, portanto, um determinado usuário será solicitado a selecionar a conta à qual se conectar. Se estiver definido como CONSENT, o usuário verá uma página de consentimento todas as vezes, mesmo que já tenha dado consentimento ao aplicativo para um determinado conjunto de escopos. Por fim, se for definido como NONE, nenhuma tela de autenticação ou consentimento será exibida ao usuário. O valor padrão é SELECT_ACCOUNT.
AccessType String Verdade Este campo indica se seu aplicativo precisa acessar uma API do Google quando o usuário não está presente no navegador. Este parâmetro é padronizado como OFFLINE. Se seu aplicativo precisar atualizar tokens de acesso quando o usuário não estiver presente no navegador, use OFFLINE. Isso fará com que seu aplicativo obtenha um token de atualização na primeira vez que seu aplicativo trocar um código de autorização para um usuário. Os valores permitidos são ONLINE, OFFLINE. O valor padrão é OFFLINE.
State String Falso Este campo indica qualquer estado que pode ser útil para sua aplicação após o recebimento da resposta. Seu aplicativo recebe o mesmo valor que enviou, pois esse parâmetro faz uma viagem de ida e volta ao servidor de autorização do Google. Os usos possíveis incluem redirecionar o usuário para o recurso correto em seu site, usar nonces e atenuar a falsificação de solicitação entre sites.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
URL String A URL para concluir a autenticação do usuário.
RefreshOAuthAccessToken

Obtém o token de acesso OAuth para ser usado para autenticação com vários serviços do Google.

Entrada
Nome Tipo Obrigatório Descrição
OAuthRefreshToken String Verdade O token de atualização retornado da troca do código de autorização original.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
OAuthAccessToken String O token de autenticação retornado do Google. Isso pode ser usado em chamadas subseqüentes para outras operações para este serviço específico.
OAuthRefreshToken String O token de autenticação retornado do Google. Isso pode ser usado em chamadas subsequentes para outras operações desse serviço específico.
ExpiresIn String O tempo de vida restante no token de acesso.

Modelo de Dados de Google Ads

Visão Geral

O Jitterbit Connector for Google Ads modela entidades do Google Ads em exibições relacionais e procedimentos armazenados. As visualizações fornecidas darão a você acesso aos seus dados do Google Ads usando a API do Google Ads.

Alterações dos Antigos Relatórios da API do Google Adwords

Todos os nomes de relatório, além de vários nomes de campo, foram alterados do provedor do Google Ads. Consulte a documentação do Google para mapeamentos de nomes entre a obsoleta API do Google AdWords e a atual API do Google Ads.

Características Principais

  • O conector modela entidades do Google Ads como documentos, pastas e grupos como exibições relacionais, permitindo que você escreva SQL para consultar dados do Google Ads.
  • Procedimentos armazenados* permitem que você execute operações no Google Ads.
  • A conectividade ao vivo com esses objetos significa que quaisquer alterações em sua conta do Google Ads são refletidas imediatamente ao usar o conector.

Visualizações

Visualizações descreve as exibições disponíveis. As exibições são definidas estaticamente para modelar campanhas, grupos de anúncios, clientes e muito mais. Eles são usados principalmente como uma forma de criar seus relatórios personalizados, em vez de serem usados de forma independente.

Os recursos mostra os nomes dos recursos, recursos de atributos e recursos de segmentação necessários para o CreateReportSchema procedimento armazenado.

Procedimentos Armazenados

NOTE: Procedimentos armazenados não são suportados atualmente. Veja a nota para detalhes.

Procedimentos armazenados são interfaces semelhantes a funções para o Google Ads. Procedimentos armazenados* permitem que você execute operações para o Google Ads, sendo a mais importante CreateReportSchema, que é usado para criar exibições de recursos (como 'distance_view') com recursos de atributo (como 'cliente' neste caso) e recursos de segmentação (como 'campanha' neste caso).

Processamento de Consultas Colaborativas

O conector transfere o máximo possível do processamento da instrução SELECT para o Google Ads e processa o restante da consultar na memória. As limitações e requisitos da API também estão documentados nesta seção.

Ver SupportEnhancedSQL para obter mais informações sobre como o conector contorna as limitações da API com processamento na memória do lado do cliente.

Visualizações

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto. Para saber mais sobre tabelas e procedimentos armazenados, navegue até as entradas correspondentes neste documento de ajuda.

Conector Jitterbit para Visualizações de Google Ads
Nome Descrição
AccessibleBiddingStrategy Representa uma visualização de BiddingStrategies de propriedade do cliente e compartilhada com ele. Em contraste com BiddingStrategy, este recurso inclui estratégias pertencentes aos gerentes do cliente e compartilhadas com este cliente - além das estratégias pertencentes a este cliente. Este recurso não fornece métricas e apenas expõe um subconjunto limitado dos atributos BiddingStrategy.
AccountBudget Um orçamento em nível de conta. Ele contém informações sobre o próprio orçamento, bem como as alterações aprovadas mais recentemente no orçamento e as alterações propostas que aguardam aprovação. As alterações propostas que estão pendentes de aprovação, se houver, encontram-se em 'pending_proposal'. Detalhes efetivos sobre o orçamento são encontrados nos campos prefixados 'aprovado_', 'ajustado_' e aqueles sem prefixo. Como alguns detalhes efetivos podem diferir do que o usuário solicitou originalmente (por exemplo, limite de gastos), essas diferenças são justapostas por meio de 'proposto_', 'aprovado_' e possivelmente 'ajustado_' Campos. Este recurso é alterado usando AccountBudgetProposal e não pode ser alterado diretamente. Um orçamento pode ter no máximo uma proposta pendente a qualquer momento. Ele é lido por meio de pending_proposal. Depois de aprovado, um orçamento pode estar sujeito a ajustes, como ajustes de crédito. Os ajustes criam diferenças entre os 'aprovados' e 'ajustado' campos, que de outra forma seriam idênticos.
AccountBudgetProposal Uma proposta de orçamento em nível de conta. Todos os campos prefixados com 'proposed' podem não necessariamente ser aplicados diretamente. Por exemplo, os limites de gastos propostos podem ser ajustados antes de sua aplicação. Isso é verdade se a opção 'proposta' tem um campo 'aprovado' correspondente, por ex. limites de gastos. Observe que o tipo de proposta (proposal_type) altera quais campos são obrigatórios e quais devem permanecer vazios.
AccountLink Representa a conexão de compartilhamento de dados entre uma conta do Google Ads e outra conta
AdGroup Um grupo de anúncios.
AdGroupAd Um anúncio de grupo de anúncios.
AdGroupAdAssetCombinationView Uma visão sobre o uso da combinação de ativos de anúncio do grupo de anúncios. Agora oferecemos suporte apenas a AdGroupAdAssetCombinationView para anúncios responsivos de pesquisa, com mais tipos de anúncios planejados para o futuro.
AdGroupAdAssetView Um link entre um AdGroupAd e um recurso. No momento, oferecemos suporte apenas para AdGroupAdAssetView para AppAds.
AdGroupAdLabel Uma relação entre um anúncio de grupo de anúncios e um rótulo.
AdGroupAsset Um link entre um grupo de anúncios e um recurso.
AdGroupAudienceView Uma visualização do público-alvo do grupo de anúncios. Inclui dados de desempenho de interesses e listas de remarketing para anúncios da Rede de Display e do YouTube e listas de remarketing para anúncios de pesquisa (RLSA), agregados no nível do público.
AdGroupBidModifier Representa um modificador de lance de grupo de anúncios.
AdGroupCriterion Um critério de grupo de anúncios.
AdGroupCriterionCustomizer Um valor do personalizador para o CustomizerAttribute associado no nível AdGroupCriterion.
AdGroupCriterionLabel Uma relação entre um critério de grupo de anúncios e um rótulo.
AdGroupCriterionSimulation Uma simulação de critério de grupo de anúncios. As combinações suportadas de tipo de canal de publicidade, tipo de critério, tipo de simulação e método de modificação de simulação são detalhadas abaixo, respectivamente. As operações de simulação do Hotel AdGroupCriterion começam na V5. 1. DISPLAY - KEYWORD - CPC_BID - UNIFORM 2. PESQUISA - KEYWORD - CPC_BID - UNIFORM 3. COMPRAS - LISTING_GROUP - CPC_BID - UNIFORM 4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORM 5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORME
AdGroupCustomizer Um valor personalizador para o CustomizerAttribute associado no nível AdGroup.
AdGroupExtensionSetting Uma configuração de extensão de grupo de anúncios.
AdGroupFeed Um feed de grupo de anúncios.
AdGroupLabel Uma relação entre um grupo de anúncios e um rótulo.
AdGroupSimulation Uma simulação de grupo de anúncios. As combinações suportadas de tipo de canal de publicidade, tipo de simulação e método de modificação de simulação são detalhadas abaixo, respectivamente. 1. PESQUISA - CPC_BID - PADRÃO 2. PESQUISA - CPC_BID - UNIFORME 3. PESQUISA - TARGET_CPA - UNIFORME 4. PESQUISA - TARGET_ROAS - UNIFORME 5. DISPLAY - CPC_BID - PADRÃO 6. DISPLAY - CPC_BID - UNIFORME 7. DISPLAY - TARGET_CPA - UNIFORME
AdParameter Um parâmetro de anúncio usado para atualizar valores numéricos (como preços ou níveis de estoque) em qualquer linha de texto de um anúncio (incluindo URLs). Pode haver no máximo dois AdParameters por critério de grupo de anúncios. (Um com parameter_index = 1 e outro com parameter_index = 2.) No anúncio, os parâmetros são referenciados por um espaço reservado no formato "{param#:value}". Por exemplo, "{param1:$17}"
AdScheduleView Uma exibição de programação de anúncios resume o desempenho das campanhas por critérios do AdSchedule.
AgeRangeView Uma visão de faixa etária.
Asset O ativo é uma parte de um anúncio que pode ser compartilhado em vários anúncios. Pode ser uma imagem (ImageAsset), um vídeo (YouTubeVideoAsset) etc. Os ativos são imutáveis e não podem ser removidos. Para interromper a veiculação de um ativo, remova o ativo da entidade que o está usando.
AssetFieldTypeView Uma exibição de tipo de campo de ativo. Essa exibição relata métricas não contadas em excesso para cada tipo de campo de ativo quando o ativo é usado como extensão.
AssetGroup Um grupo de ativos. AssetGroupAsset será usado para vincular um ativo ao grupo de ativos. AssetGroupHint será usado para associar uma dica a um grupo de ativos.
AssetGroupAsset AssetGroupAsset é o link entre um ativo e um grupo de ativos. Adicionar um AssetGroupAsset vincula um ativo a um grupo de ativos.
AssetGroupListingGroupFilter AssetGroupListingGroupFilter representa um nó de árvore de filtro de grupo de listagem em um grupo de ativos.
AssetGroupSignal AssetGroupSignal representa um sinal em um grupo de ativos. A existência de um sinal informa à campanha de desempenho máximo quem tem maior probabilidade de converter. A campanha de maior desempenho usa o sinal para procurar novas pessoas com intenção semelhante ou mais forte de encontrar conversões em pesquisa, exibição, vídeo e muito mais.
AssetSet Um conjunto de ativos que representa uma coleção de ativos. Use AssetSetAsset para vincular um ativo ao conjunto de ativos.
AssetSetAsset AssetSetAsset é o link entre um ativo e um conjunto de ativos. Adicionar um AssetSetAsset vincula um ativo a um conjunto de ativos.
Audience O público é uma opção de segmentação eficaz que permite cruzar diferentes atributos de segmento, como dados demográficos detalhados e afinidades, para criar públicos que representam seções de seus segmentos-alvo.
BatchJob Uma lista de mutações sendo processadas de forma assíncrona. As mutações são carregadas pelo usuário. As próprias mutações não são legíveis e os resultados do trabalho só podem ser lidos usando BatchJobService.ListBatchJobResults.
BiddingDataExclusion Representa uma exclusão de dados de lances. Consulte "Sobre exclusões de dados" no https://support.google.com/google-ads/answer/10370710.
BiddingSeasonalityAdjustment Representa um ajuste periódico de lances. Consulte "Sobre os ajustes de sazonalidade" no https://support.google.com/google-ads/answer/10369906.
BiddingStrategy Uma estratégia de licitação.
BiddingStrategySimulation Uma simulação de estratégia de lances. As combinações suportadas de tipo de simulação e método de modificação de simulação são detalhadas abaixo, respectivamente. 1. TARGET_CPA - UNIFORME 2. TARGET_ROAS - UNIFORME
BillingSetup Uma configuração de cobrança, que associa uma conta de pagamentos e um anunciante. Uma configuração de cobrança é específica para um anunciante.
CallView Uma visualização de chamada que inclui dados para rastreamento de chamadas de anúncios somente para chamadas ou extensões de chamada.
Campaign Uma campanha.
CampaignAsset Um link entre uma campanha e um ativo.
CampaignAssetSet CampaignAssetSet é a ligação entre uma campanha e um conjunto de ativos. Adicionar um CampaignAssetSet vincula um conjunto de ativos a uma campanha.
CampaignAudienceView Uma visualização do público da campanha. Inclui dados de desempenho de interesses e listas de remarketing para anúncios da Rede de Display e do YouTube e listas de remarketing para anúncios da rede de pesquisa (RLSA), agregados por critério de campanha e público-alvo. Essa exibição inclui apenas públicos vinculados no nível da campanha.
CampaignBidModifier Representa um critério somente modificável por lance no nível da campanha.
CampaignBudget Um orçamento de campanha.
CampaignConversionGoal A configuração de capacidade de lance para a campanha especificada somente para todas as ações de conversão com categoria e origem correspondentes.
CampaignCriterion Um critério de campanha.
CampaignCriterionSimulation Uma simulação de critério de campanha. As combinações suportadas de tipo de canal de publicidade, IDs de critério, tipo de simulação e método de modificação de simulação são detalhadas abaixo, respectivamente. 1. PESQUISA - 30000, 30001, 30002 - BID_MODIFIER - UNIFORME 2. DISPLAY - 30001 - BID_MODIFIER - UNIFORME
CampaignCustomizer Um valor do personalizador para o CustomizerAttribute associado no nível da campanha.
CampaignDraft Um rascunho de campanha.
CampaignExperiment Um experimento A/B que compara o desempenho da campanha base (o controle) e uma variação dessa campanha (o experimento).
CampaignExtensionSetting Uma configuração de extensão de campanha.
CampaignFeed Um feed de campanha.
CampaignLabel Representa uma relação entre uma campanha e um rótulo.
CampaignSharedSet CampaignSharedSets são usados para gerenciar os conjuntos compartilhados associados a uma campanha.
CampaignSimulation Uma simulação de campanha. As combinações suportadas de tipo de canal de publicidade, tipo de simulação e método de modificação de simulação são detalhadas abaixo, respectivamente. SEARCH - CPC_BID - UNIFORM SEARCH - CPC_BID - SCALING SEARCH - TARGET_CPA - UNIFORM SEARCH - TARGET_CPA - SCALING SEARCH - TARGET_ROAS - UNIFORM SEARCH - TARGET_IMPRESSION_SHARE - UNIFORM SEARCH - BUDGET - UNIFORM SHOPPING - BUDGET - UNIFORM SHOPPING - TARGET_ROAS - UNIFORM MULTIPLE - TARGET_C PA - UNIFORME OWNED_AND_OPERATED - TARGET_CPA - EXIBIÇÃO PADRÃO - TARGET_CPA - UNIFORME
CarrierConstant Um critério de operadora que pode ser usado na segmentação da campanha.
ChangeEvent Descreve a alteração granular do recurso retornado de determinados tipos de recurso. As alterações feitas por meio da interface do usuário, API e novas versões do Editor por usuários externos (incluindo usuários externos e usuários internos que podem ser exibidos externamente) nos últimos 30 dias serão exibidas. A alteração mostra os valores antigos dos campos alterados antes da alteração e os novos valores logo após a alteração. ChangeEvent pode ter até 3 minutos de atraso para refletir uma nova alteração.
ChangeStatus Descreve o status do recurso retornado. ChangeStatus pode ter até 3 minutos de atraso para refletir uma nova alteração.
ClickView Uma exibição de clique com métricas agregadas em cada nível de clique, incluindo cliques válidos e inválidos. Para campanhas que não são de pesquisa, métrica.cliques representa o número de interações válidas e inválidas. As consultas que incluem ClickView devem ter um filtro que limite os resultados a um dia e podem ser solicitadas para datas anteriores a 90 dias da solicitação.
CombinedAudience Descreva um recurso para públicos combinados que inclua públicos diferentes.
ConversionAction Uma ação de conversão.
ConversionCustomVariable Uma variável personalizada de conversão Consulte "Sobre variáveis personalizadas para conversões" no https://support.google.com/google-ads/answer/9964350
ConversionGoalCampaignConfig Configurações de meta de conversão para uma campanha.
ConversionValueRule Uma regra de valor de conversão
ConversionValueRuleSet Um conjunto de regras de valor de conversão
CurrencyConstant Uma constante monetária.
CustomAudience Um público personalizado. Esta é uma lista de usuários por interesse.
CustomConversionGoal Meta de conversão personalizada que pode tornar as ações de conversão arbitrárias passíveis de lances.
Customer Um cliente.
CustomerAsset Uma ligação entre um cliente e um ativo.
CustomerClient Uma ligação entre o cliente dado e um cliente cliente. CustomerClients só existe para clientes gerentes. Estão incluídos todos os clientes diretos e indiretos, bem como o próprio gestor.
CustomerClientLink Os vínculos entre as contas do cliente e as contas do gerente
CustomerConversionGoal Controle de capacidade de lance para ações de conversão com categoria e origem correspondentes.
CustomerCustomizer Um valor do personalizador para o CustomizerAttribute associado no nível do cliente.
CustomerExtensionSetting Uma configuração de ramal do cliente.
CustomerFeed Um feed de cliente.
CustomerLabel Representa uma relação entre um cliente e um rótulo. Este cliente pode não ter acesso a todas as etiquetas anexadas a ele. CustomerLabels adicionais podem ser retornados aumentando as permissões com login-customer-id.
CustomerManagerLink Representa a relação de ligação cliente-gerente.
CustomerNegativeCriterion Um critério negativo para exclusões no nível do cliente.
CustomerUserAccess Representa a permissão de um único usuário para um único cliente.
CustomerUserAccessInvitation Representar um convite para um novo usuário nesta conta de cliente.
CustomInterest Um interesse personalizado. Esta é uma lista de usuários por interesse.
CustomizerAttribute Um atributo do personalizador. Use CustomerCustomizer, CampaignCustomizer, AdGroupCustomizer ou AdGroupCriterionCustomizer para associar um atributo personalizador e definir seu valor no cliente, campanha, grupo de anúncios ou nível de critério do grupo de anúncios, respectivamente.
DetailedDemographic Um grupo demográfico detalhado: uma vertical específica com base em interesses a ser segmentada para alcançar usuários com base em fatos da vida de longo prazo.
DetailPlacementView Uma visualização com métricas agregadas por grupo de anúncios e URL ou vídeo do YouTube.
DisplayKeywordView Uma exibição de palavra-chave de exibição.
DistanceView Uma exibição de distância com métricas agregadas pela distância do usuário às extensões de local de um anunciante. Cada DistanceBucket inclui todas as impressões que estão dentro de sua distância e uma única impressão contribuirá para as métricas de todos os DistanceBuckets que incluem a distância do usuário.
DomainCategory Uma categoria gerada automaticamente pelo rastreamento de um domínio. Se uma campanha usar o DynamicSearchAdsSetting, as categorias de domínio serão geradas para o domínio. As categorias podem ser segmentadas usando WebpageConditionInfo. Ver: https://support.google.com/google-ads/answer/2471185
DynamicSearchAdsSearchTermView Uma exibição de termos de pesquisa de anúncios de pesquisa dinâmicos.
ExpandedLandingPageView Uma visualização da página de aterrissagem com métricas agregadas no nível do URL final expandido.
Experiment Um experimento de anúncios do Google para que os usuários experimentem alterações em várias campanhas, comparem o desempenho e apliquem as alterações efetivas.
ExperimentArm Um experimento de anúncios do Google para que os usuários experimentem alterações em várias campanhas, comparem o desempenho e apliquem as alterações efetivas.
ExtensionFeedItem Um item de feed de extensão.
Feed Uma alimentação.
FeedItem Um item de alimentação.
FeedItemSet Representa um conjunto de itens de feed. O conjunto pode ser usado e compartilhado entre certos recursos de itens de alimentação. Por exemplo, o conjunto pode ser referenciado nas funções correspondentes de CustomerFeed, CampaignFeed e AdGroupFeed.
FeedItemSetLink Representa um link entre um FeedItem e um FeedItemSet.
FeedItemTarget Um destino de item de feed.
FeedMapping Um mapeamento de feed.
FeedPlaceholderView Uma exibição de marcador de posição de feed.
GenderView Uma visão de gênero.
GeographicView Uma visão geográfica. A visualização geográfica inclui todas as métricas agregadas no nível do país, uma linha por país. Ele relata métricas na localização física real do usuário ou em uma área de interesse. Se outros campos de segmento forem usados, você poderá obter mais de uma linha por país.
GeoTargetConstant Uma constante de segmentação geográfica.
GroupPlacementView Uma exibição de veiculação de grupo.
HotelGroupView Uma visão do grupo de hotéis.
HotelPerformanceView Uma visão do desempenho do hotel.
HotelReconciliation Uma reconciliação hoteleira. Ele contém informações de conversão de reservas de hotel para reconciliar com os registros do anunciante. Essas linhas podem ser atualizadas ou canceladas antes da cobrança por meio de uploads em massa.
IncomeRangeView Uma visão de faixa de renda.
KeywordPlan Um plano de planejador de palavras-chave. Número máximo de planos de palavras-chave salvos: 10.000. É possível remover planos se o limite for atingido.
KeywordPlanAdGroup Um grupo de anúncios do Planejador de palavras-chave. Número máximo de grupos de anúncios de planos de palavras-chave por plano: 200.
KeywordPlanAdGroupKeyword Uma palavra-chave do grupo de anúncios do Plano de palavras-chave. Número máximo de palavras-chave do plano de palavras-chave por plano: 10.000.
KeywordPlanCampaign Uma campanha de plano de palavra-chave. Número máximo permitido de campanhas de plano de palavra-chave por plano: 1.
KeywordPlanCampaignKeyword Uma palavra-chave de campanha de plano de palavra-chave. Somente palavras-chave negativas são suportadas para a palavra-chave da campanha.
KeywordThemeConstant Uma constante de tema de palavra-chave de campanha inteligente.
KeywordView Uma exibição de palavra-chave.
Label Um rótulo.
LandingPageView Uma visualização da página de aterrissagem com métricas agregadas no nível do URL final não expandido.
LanguageConstant Uma linguagem.
LifeEvent Um evento da vida: um determinado vertical baseado em interesse a ser direcionado para alcançar os usuários quando eles estão no meio de marcos importantes da vida.
LocationView Uma exibição de localização resume o desempenho das campanhas por critérios de localização.
ManagedPlacementView Uma exibição de canal gerenciado.
MediaFile Um arquivo de mídia.
MobileAppCategoryConstant Uma constante de categoria de aplicativo móvel.
MobileDeviceConstant Uma constante de dispositivo móvel.
OfflineUserDataJob Um trabalho contendo dados de usuário offline de visitantes da loja ou membros da lista de usuários que serão processados de forma assíncrona. Os dados carregados não são legíveis e os resultados do processamento do trabalho só podem ser lidos usando GoogleAdsService.Search/SearchStream.
OperatingSystemVersionConstant Uma versão do sistema operacional móvel ou um intervalo de versões, dependendo do operator_type. Lista de plataformas móveis disponíveis em https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms
PaidOrganicSearchTermView Uma visualização de termo de pesquisa orgânica paga que fornece uma visualização das estatísticas de pesquisa em anúncios e listagens orgânicas agregadas por termo de pesquisa no nível do grupo de anúncios.
ParentalStatusView Uma visualização do status parental.
ProductBiddingCategoryConstant Uma categoria de licitação de produtos.
ProductGroupView Uma exibição de grupo de produtos.
Recommendation Uma recomendação.
RemarketingAction Uma ação de remarketing. Um snippet de código JavaScript que coletará o ID do produto e o tipo de página que as pessoas visitaram (página do produto, página do carrinho de compras, página de compra, visita geral ao site) no site de um anunciante.
Resources Lista de recursos que podem ser utilizados para gerar novos Relatórios ou gerar novamente os antigos.
SearchTermView Uma visualização do termo de pesquisa com métricas agregadas por termo de pesquisa no nível do grupo de anúncios.
SharedCriterion Um critério pertencente a um conjunto compartilhado.
SharedSet SharedSets são usados para compartilhar exclusões de critérios em várias campanhas.
ShoppingPerformanceView Visão de desempenho de compras. Fornece estatísticas de campanha do Shopping agregadas em vários níveis de dimensão do produto. Os valores de dimensão do produto do Merchant Center, como marca, categoria, atributos personalizados, condição e tipo de produto, refletirão o estado de cada dimensão na data e hora em que o evento correspondente foi registrado.
SmartCampaignSearchTermView Uma visualização do termo de pesquisa da campanha inteligente.
SmartCampaignSetting Configurações para configuração de campanhas inteligentes.
ThirdPartyAppAnalyticsLink Uma conexão de compartilhamento de dados, permitindo a importação de análises de aplicativos de terceiros para um cliente do Google Ads.
TopicConstant Use tópicos para segmentar ou excluir canais na Rede de Display do Google com base na categoria em que o canal se enquadra (por exemplo, "Animais de estimação & Animais/Animais de estimação/Cães").
TopicView Uma visão de tópico.
UserInterest Um interesse do usuário: um determinado vertical baseado em interesse a ser segmentado.
UserList Uma lista de usuários. Esta é uma lista de usuários que um cliente pode segmentar.
UserLocationView Uma exibição de localização do usuário. A visualização da localização do usuário inclui todas as métricas agregadas no nível do país, uma linha por país. Ele relata métricas no local físico real do usuário por local segmentado ou não segmentado. Se outros campos de segmento forem usados, você poderá obter mais de uma linha por país.
Video Um vídeo.
WebpageView Uma exibição de página da web.
Estratégia de Lances Acessíveis

Representa uma visualização de BiddingStrategies de propriedade do cliente e compartilhada com ele. Em contraste com BiddingStrategy, este recurso inclui estratégias pertencentes aos gerentes do cliente e compartilhadas com este cliente - além das estratégias pertencentes a este cliente. Este recurso não fornece métricas e apenas expõe um subconjunto limitado dos atributos BiddingStrategy.

Colunas
Nome Tipo Comportamento Descrição
AccessibleBiddingStrategyId Long ATRIBUTO Somente saída. O ID da estratégia de lances.
AccessibleBiddingStrategyMaximizeConversionValueTargetRoas Double ATRIBUTO A opção de retorno do investimento em publicidade (ROAS) desejado. Se definida, a estratégia de lances maximizará a receita enquanto calculará a média do retorno do investimento em publicidade desejado. Se o ROAS desejado for alto, a estratégia de lances pode não conseguir gastar todo o orçamento. Se o ROAS desejado não for definido, a estratégia de lances terá como objetivo atingir o ROAS mais alto possível para o orçamento.
AccessibleBiddingStrategyMaximizeConversionsTargetCpa Long ATRIBUTO Somente saída. A opção de custo por aquisição (CPA) desejado. Este é o valor médio que você gostaria de gastar por aquisição.
AccessibleBiddingStrategyName String ATRIBUTO Somente saída. O nome da estratégia de lances.
AccessibleBiddingStrategyOwnerCustomerId Long ATRIBUTO Somente saída. O ID do cliente que possui a estratégia de lances.
AccessibleBiddingStrategyOwnerDescriptiveName String ATRIBUTO Somente saída. descritivo_nome do cliente que possui a estratégia de lances.
AccessibleBiddingStrategyResourceName String ATRIBUTO Somente saída. O nome do recurso da estratégia de lances acessível. Os nomes dos recursos AccessibleBiddingStrategy têm o seguinte formato: customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
AccessibleBiddingStrategyTargetCpaTargetCpaMicros Long ATRIBUTO Somente saída. Meta média de CPA. Essa meta deve ser maior ou igual à unidade faturável mínima com base na moeda da conta.
AccessibleBiddingStrategyTargetImpressionShareCpcBidCeilingMicros Long ATRIBUTO Somente saída. O lance de CPC mais alto que o sistema de lances automatizados pode especificar. Este é um campo obrigatório informado pelo anunciante que define o teto e especificado nos micros locais.
AccessibleBiddingStrategyTargetImpressionShareLocation String ATRIBUTO Somente saída. O local segmentado na página de resultados de pesquisa. Os valores permitidos são ABSOLUTE_TOP_OF_PAGE, ANYWHERE_ON_PAGE, TOP_OF_PAGE, UNKNOWN, UNSPECIFIED.
AccessibleBiddingStrategyTargetImpressionShareLocationFractionMicros Long ATRIBUTO A fração desejada de anúncios a serem exibidos no local segmentado em micros. Por exemplo. 1% é igual a 10.000.
AccessibleBiddingStrategyTargetRoasTargetRoas Double ATRIBUTO Obrigatório. A receita desejada (com base nos dados de conversão) por unidade de gasto. O valor deve estar entre 0,01 e 1000,0, inclusive.
AccessibleBiddingStrategyTargetSpendCpcBidCeilingMicros Long ATRIBUTO Somente saída. Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia.
AccessibleBiddingStrategyTargetSpendTargetSpendMicros Long ATRIBUTO Somente saída. A meta de gasto abaixo da qual maximizar os cliques. Um proponente TargetSpend tentará gastar o menor valor ou o valor de gasto de throttling natural. Se não for especificado, o orçamento será usado como meta de gasto. Este campo está obsoleto e não deve mais ser usado. Ver https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html para detalhes.
AccessibleBiddingStrategyType String ATRIBUTO Somente saída. O tipo da estratégia de lances. Os valores permitidos são COMMISSION, ENHANCED_CPC, INVALID, MANUAL_CPC, MANUAL_CPM, MANUAL_CPV, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, PAGE_ONE_PROMOTED, PERCENT_CPC, TARGET_CPA, TARGET_CPM, TARGET_IMPRESSION_SHARE, TARGET_OUTRANK_SHARE, TARGET_ROAS, TARGE T_SPEND, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Conta Orçamento

Um orçamento em nível de conta. Ele contém informações sobre o próprio orçamento, bem como as alterações aprovadas mais recentemente no orçamento e as alterações propostas que aguardam aprovação. As alterações propostas que estão pendentes de aprovação, se houver, encontram-se em 'pending_proposal'. Detalhes efetivos sobre o orçamento são encontrados nos campos prefixados 'aprovado_', 'ajustado_' e aqueles sem prefixo. Como alguns detalhes efetivos podem diferir do que o usuário solicitou originalmente (por exemplo, limite de gastos), essas diferenças são justapostas por meio de 'proposto_', 'aprovado_' e possivelmente 'ajustado_' Campos. Este recurso é alterado usando AccountBudgetProposal e não pode ser modificado diretamente. Um orçamento pode ter no máximo uma proposta pendente a qualquer momento. Ele é lido por meio de pending_proposal. Depois de aprovado, um orçamento pode estar sujeito a ajustes, como ajustes de crédito. Os ajustes criam diferenças entre os 'aprovados' e 'ajustado' campos, que de outra forma seriam idênticos.

Colunas
Nome Tipo Comportamento Descrição
AccountBudgetAdjustedSpendingLimitMicros Long ATRIBUTO Somente saída. O limite de gastos ajustado em micros. Um milhão é equivalente a uma unidade. Se o limite de gastos aprovado for finito, o limite de gastos ajustado pode variar dependendo dos tipos de ajustes aplicados a este orçamento, se aplicável. Os diferentes tipos de ajustes são descritos aqui: https://support.google.com/google-ads/answer/1704323 por exemplo, um ajuste de débito reduz quanto a conta pode gastar.
AccountBudgetAdjustedSpendingLimitType String ATRIBUTO Somente saída. O limite de gastos ajustado como um tipo bem definido, por ex. INFINITO. Isso só será preenchido se o limite de gastos ajustado for INFINITO, o que é garantido se o limite de gastos aprovado for INFINITO. Os valores permitidos são INFINITO, DESCONHECIDO, NÃO ESPECIFICADO.
AccountBudgetAmountServedMicros Long ATRIBUTO Somente saída. O valor dos anúncios que foram exibidos, em micros. Isso inclui custos de entrega em excesso, caso em que um crédito pode ser aplicado automaticamente ao orçamento (consulte total_adjustments_micros).
AccountBudgetApprovedEndDateTime Date ATRIBUTO Somente saída. A hora de término aprovada no formato aaaa-MM-dd HH🇲🇲ss.
AccountBudgetApprovedEndTimeType String ATRIBUTO Somente saída. A hora final aprovada como um tipo bem definido, por exemplo PARA SEMPRE. Os valores permitidos são FOREVER, NOW, UNKNOWN, UNSPECIFED.
AccountBudgetApprovedSpendingLimitMicros Long ATRIBUTO Somente saída. O limite de gastos aprovado em micros. Um milhão é equivalente a uma unidade. Isso só será preenchido se o limite de gasto proposto for finito e sempre será maior ou igual ao limite de gasto proposto.
AccountBudgetApprovedSpendingLimitType String ATRIBUTO Somente saída. O limite de gastos aprovado como um tipo bem definido, por exemplo INFINITO. Isso só será preenchido se o limite de gastos aprovado for INFINITO. Os valores permitidos são INFINITO, DESCONHECIDO, NÃO ESPECIFICADO.
AccountBudgetApprovedStartDateTime Date ATRIBUTO Somente saída. A hora de início aprovada do orçamento em nível de conta no formato aaaa-MM-dd HH🇲🇲ss. Por exemplo, se um novo orçamento for aprovado após o horário de início proposto, o horário de início aprovado será o horário de aprovação.
AccountBudgetBillingSetup String ATRIBUTO Somente saída. O nome do recurso da configuração de cobrança associada a este orçamento no nível da conta. Os nomes dos recursos BillingSetup têm o formato: customers/{customer_id}/billingSetups/{billing_setup_id}
AccountBudgetId Long ATRIBUTO Somente saída. A ID do orçamento no nível da conta.
AccountBudgetName String ATRIBUTO Somente saída. O nome do orçamento no nível da conta.
AccountBudgetNotes String ATRIBUTO Somente saída. Notas associadas ao orçamento.
AccountBudgetPendingProposalAccountBudgetProposal String ATRIBUTO Somente saída. O nome do recurso da proposta. Os nomes dos recursos AccountBudgetProposal têm o formato: customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}
AccountBudgetPendingProposalCreationDateTime Date ATRIBUTO Somente saída. A hora em que esta proposta de orçamento no nível da conta foi criada. Formatado como aaaa-MM-dd HH🇲🇲ss.
AccountBudgetPendingProposalEndDateTime Date ATRIBUTO Somente saída. A hora de término no formato aaaa-MM-dd HH🇲🇲ss.
AccountBudgetPendingProposalEndTimeType String ATRIBUTO Somente saída. A hora final como um tipo bem definido, por ex. PARA SEMPRE. Os valores permitidos são FOREVER, NOW, UNKNOWN, UNSPECIFED.
AccountBudgetPendingProposalName String ATRIBUTO Somente saída. O nome a ser atribuído ao orçamento no nível da conta.
AccountBudgetPendingProposalNotes String ATRIBUTO Somente saída. Notas associadas a este orçamento.
AccountBudgetPendingProposalProposalType String ATRIBUTO Somente saída. O tipo desta proposta, por ex. END para encerrar o orçamento associado a esta proposta. Os valores permitidos são CREATE, END, REMOVE, UNKNOWN, UNSPECIFIED, UPDATE.
AccountBudgetPendingProposalPurchaseOrderNumber String ATRIBUTO Somente saída. Um número de ordem de compra é um valor que ajuda os usuários a fazer referência a esse orçamento em suas faturas mensais.
AccountBudgetPendingProposalSpendingLimitMicros Long ATRIBUTO Somente saída. O limite de gastos em micros. Um milhão é equivalente a uma unidade.
AccountBudgetPendingProposalSpendingLimitType String ATRIBUTO Somente saída. O limite de gastos como um tipo bem definido, por ex. INFINITO. Os valores permitidos são INFINITO, DESCONHECIDO, NÃO ESPECIFICADO.
AccountBudgetPendingProposalStartDateTime Date ATRIBUTO Somente saída. A hora de início no formato aaaa-MM-dd HH🇲🇲ss.
AccountBudgetProposedEndDateTime Date ATRIBUTO Somente saída. A hora de término proposta no formato aaaa-MM-dd HH🇲🇲ss.
AccountBudgetProposedEndTimeType String ATRIBUTO Somente saída. O horário de término proposto como um tipo bem definido, por ex. PARA SEMPRE. Os valores permitidos são FOREVER, NOW, UNKNOWN, UNSPECIFED.
AccountBudgetProposedSpendingLimitMicros Long ATRIBUTO Somente saída. O limite de gastos proposto em micros. Um milhão é equivalente a uma unidade.
AccountBudgetProposedSpendingLimitType String ATRIBUTO Somente saída. O limite de gastos proposto como um tipo bem definido, por ex. INFINITO. Os valores permitidos são INFINITO, DESCONHECIDO, NÃO ESPECIFICADO.
AccountBudgetProposedStartDateTime Date ATRIBUTO Somente saída. A hora de início proposta do orçamento em nível de conta no formato aaaa-MM-dd HH🇲🇲ss. Se foi proposto um tipo de hora de início AGORA, esta é a hora da solicitação.
AccountBudgetPurchaseOrderNumber String ATRIBUTO Somente saída. Um número de ordem de compra é um valor que ajuda os usuários a fazer referência a esse orçamento em suas faturas mensais.
AccountBudgetResourceName String ATRIBUTO Somente saída. O nome do recurso do orçamento no nível da conta. Os nomes dos recursos AccountBudget têm o formato: customers/{customer_id}/accountBudgets/{account_budget_id}
AccountBudgetStatus String ATRIBUTO Somente saída. O status desse orçamento no nível da conta. Os valores permitidos são APROVADO, CANCELADO, PENDENTE, DESCONHECIDO, NÃO ESPECIFICADO.
AccountBudgetTotalAdjustmentsMicros Long ATRIBUTO Somente saída. O valor total dos ajustes. Um exemplo de ajuste são os créditos de cortesia.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ContaOrçamentoProposta

Uma proposta de orçamento em nível de conta. Todos os campos prefixados com 'proposed' podem não necessariamente ser aplicados diretamente. Por exemplo, os limites de gastos propostos podem ser ajustados antes de sua aplicação. Isso é verdade se a opção 'proposta' tem um campo 'aprovado' correspondente, por ex. limites de gastos. Observe que o tipo de proposta (proposal_type) altera quais campos são obrigatórios e quais devem permanecer vazios.

Colunas
Nome Tipo Comportamento Descrição
AccountBudgetProposalAccountBudget String ATRIBUTO Imutável. O nome do recurso do orçamento em nível de conta associado a esta proposta.
AccountBudgetProposalApprovalDateTime Date ATRIBUTO Somente saída. A data e hora em que o orçamento no nível da conta foi aprovado, se aplicável.
AccountBudgetProposalApprovedEndDateTime Date ATRIBUTO Somente saída. A data e hora final aprovada no formato aaaa-mm-dd hh🇲🇲ss.
AccountBudgetProposalApprovedEndTimeType String ATRIBUTO Somente saída. A data de término aprovada como um tipo bem definido, por exemplo PARA SEMPRE. Os valores permitidos são FOREVER, NOW, UNKNOWN, UNSPECIFED.
AccountBudgetProposalApprovedSpendingLimitMicros Long ATRIBUTO Somente saída. O limite de gastos aprovado em micros. Um milhão é equivalente a uma unidade.
AccountBudgetProposalApprovedSpendingLimitType String ATRIBUTO Somente saída. O limite de gastos aprovado como um tipo bem definido, por exemplo INFINITO. Os valores permitidos são INFINITO, DESCONHECIDO, NÃO ESPECIFICADO.
AccountBudgetProposalApprovedStartDateTime Date ATRIBUTO Somente saída. A data e hora de início aprovadas no formato aaaa-mm-dd hh🇲🇲ss.
AccountBudgetProposalBillingSetup String ATRIBUTO Imutável. O nome do recurso da configuração de cobrança associada a esta proposta.
AccountBudgetProposalCreationDateTime Date ATRIBUTO Somente saída. A data e hora em que esta proposta de orçamento em nível de conta foi criada, que não é a mesma que a data e hora de aprovação, se aplicável.
AccountBudgetProposalId Long ATRIBUTO Somente saída. O ID da proposta.
AccountBudgetProposalProposalType String ATRIBUTO Imutável. O tipo desta proposta, por ex. END para encerrar o orçamento associado a esta proposta. Os valores permitidos são CREATE, END, REMOVE, UNKNOWN, UNSPECIFIED, UPDATE.
AccountBudgetProposalProposedEndDateTime Date ATRIBUTO Imutável. A data e hora de término propostas no formato aaaa-mm-dd hh🇲🇲ss.
AccountBudgetProposalProposedEndTimeType String ATRIBUTO Imutável. A data de término proposta como um tipo bem definido, por exemplo PARA SEMPRE. Os valores permitidos são FOREVER, NOW, UNKNOWN, UNSPECIFED.
AccountBudgetProposalProposedName String ATRIBUTO Imutável. O nome a ser atribuído ao orçamento no nível da conta.
AccountBudgetProposalProposedNotes String ATRIBUTO Imutável. Notas associadas a este orçamento.
AccountBudgetProposalProposedPurchaseOrderNumber String ATRIBUTO Imutável. Um número de ordem de compra é um valor que permite ao usuário ajudá-lo a fazer referência a esse orçamento em suas faturas mensais.
AccountBudgetProposalProposedSpendingLimitMicros Long ATRIBUTO Imutável. O limite de gastos proposto em micros. Um milhão é equivalente a uma unidade.
AccountBudgetProposalProposedSpendingLimitType String ATRIBUTO Imutável. O limite de gastos proposto como um tipo bem definido, por ex. INFINITO. Os valores permitidos são INFINITO, DESCONHECIDO, NÃO ESPECIFICADO.
AccountBudgetProposalProposedStartDateTime Date ATRIBUTO Imutável. A data e hora de início propostas no formato aaaa-mm-dd hh🇲🇲ss.
AccountBudgetProposalResourceName String ATRIBUTO Imutável. O nome do recurso da proposta. Os nomes dos recursos AccountBudgetProposal têm o formato: customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}
AccountBudgetProposalStatus String ATRIBUTO Somente saída. O status desta proposta. Quando uma nova proposta é criada, o status padrão é PENDENTE. Os valores permitidos são APPROVED, APPROVED_HELD, CANCELLED, PENDING, REJECTED, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.

Representa a conexão de compartilhamento de dados entre uma conta do Google Ads e outra conta

Colunas
Nome Tipo Comportamento Descrição
AccountLinkAccountLinkId Long ATRIBUTO Somente saída. O ID do link. Este campo é só de leitura.
AccountLinkDataPartnerDataPartnerId Long ATRIBUTO Imutável. O ID do cliente da conta do parceiro de dados. Este campo é obrigatório e não deve ficar vazio ao criar um novo link de parceiro de dados. Não é possível modificá-lo após a criação do link.
AccountLinkGoogleAdsCustomer String ATRIBUTO Imutável. O nome do recurso da conta do Google Ads. Este campo é obrigatório e não deve ficar vazio ao criar um novo link do Google Ads. Não é possível modificá-lo após a criação do link.
AccountLinkResourceName String ATRIBUTO Imutável. Nome do recurso do link da conta. Os nomes dos recursos AccountLink têm o formato: customers/{customer_id}/accountLinks/{account_link_id}
AccountLinkStatus String ATRIBUTO O status do link. Os valores permitidos são ENABLED, PENDING_APPROVAL, REJECTED, REMOVED, REQUESTED, REVOKED, UNKNOWN, UNSPECIFIED.
AccountLinkThirdPartyAppAnalyticsAppAnalyticsProviderId Long ATRIBUTO Imutável. O ID do provedor de análise de aplicativo. Este campo não deve estar vazio ao criar um novo link de análise de aplicativo de terceiros. Não é possível modificá-lo após a criação do link.
AccountLinkThirdPartyAppAnalyticsAppId String ATRIBUTO Imutável. Uma string que identifica exclusivamente um aplicativo para celular do qual os dados foram coletados para a API do Google Ads. Para iOS, a string de ID é a string de 9 dígitos que aparece no final de um URL da App Store (por exemplo, "422689480" para "Gmail" cujo link da App Store é https://apps.apple.com/us/app/gmail-email-by-google/id422689480). Para Android, a string de ID é o nome do pacote do aplicativo (por exemplo, "com.google.android.gm" para "Gmail" dado o link do Google Play https://play.google.com/store/apps/details?id=com.google.android.gm) Este campo não deve estar vazio ao criar um novo link de análise de aplicativo de terceiros. Não é possível modificá-lo após a criação do link.
AccountLinkThirdPartyAppAnalyticsAppVendor String ATRIBUTO Imutável. O fornecedor do aplicativo. Este campo não deve estar vazio ao criar um novo link de análise de aplicativo de terceiros. Não é possível modificá-lo após a criação do link. Os valores permitidos são APPLE_APP_STORE, GOOGLE_APP_STORE, UNKNOWN, UNSPECIFIED.
AccountLinkType String ATRIBUTO Somente saída. O tipo da conta vinculada. Os valores permitidos são DATA_PARTNER, GOOGLE_ADS, THIRD_PARTY_APP_ANALYTICS, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroup

Um grupo de anúncios.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
AdGroupAdRotationMode String ATRIBUTO O modo de rotação de anúncios do grupo de anúncios. Os valores permitidos são OPTIMIZE, ROTATE_FOREVER, UNKNOWN, UNSPECIFIED.
AdGroupAudienceSettingUseAudienceGrouped Bool ATRIBUTO Imutável. Se verdadeiro, esta campanha usa um recurso de público para segmentação de público. Se falso, esta campanha pode usar critérios de segmento de público.
AdGroupBaseAdGroup String ATRIBUTO Somente saída. Para grupos de anúncios de rascunho ou experimento, esse campo é o nome do recurso do grupo de anúncios base a partir do qual esse grupo de anúncios foi criado. Se um grupo de anúncios de rascunho ou experimental não tiver um grupo de anúncios base, esse campo será nulo. Para grupos de anúncios básicos, esse campo é igual ao nome do recurso do grupo de anúncios. Este campo é só de leitura.
AdGroupCampaign String ATRIBUTO Imutável. A campanha à qual o grupo de anúncios pertence.
AdGroupCpcBidMicros Long ATRIBUTO O lance máximo de CPC (custo por clique).
AdGroupCpmBidMicros Long ATRIBUTO O lance máximo de CPM (custo por mil impressões visíveis).
AdGroupCpvBidMicros Long ATRIBUTO Somente saída. O lance de CPV (custo por visualização).
AdGroupDisplayCustomBidDimension String ATRIBUTO Permite que os anunciantes especifiquem uma dimensão de segmentação na qual colocar lances absolutos. Isso se aplica apenas a campanhas que segmentam apenas a Rede de Display e não a Rede de Pesquisa. Os valores permitidos são AGE_RANGE, AUDIENCE, GENDER, INCOME_RANGE, KEYWORD, PARENTAL_STATUS, PLACEMENT, TOPIC, UNKNOWN, UNSPECIFIED.
AdGroupEffectiveCpcBidMicros Long ATRIBUTO Somente saída. O valor será igual ao valor do lance de CPC (custo por clique) quando a estratégia de lance for CPC manual, CPC otimizado, página um promovida ou compartilhamento de classificação superior desejado. Caso contrário, o valor será nulo.
AdGroupEffectiveTargetCpaMicros Long ATRIBUTO Somente saída. O CPA desejado efetivo (custo por aquisição). Este campo é só de leitura.
AdGroupEffectiveTargetCpaSource String ATRIBUTO Somente saída. Origem do CPA desejado efetivo. Este campo é só de leitura. Os valores permitidos são AD_GROUP, AD_GROUP_CRITERION, CAMPAIGN_BIDDING_STRATEGY, UNKNOWN, UNSPECIFIED.
AdGroupEffectiveTargetRoas Double ATRIBUTO Somente saída. O ROAS desejado efetivo (retorno do investimento em publicidade). Este campo é só de leitura.
AdGroupEffectiveTargetRoasSource String ATRIBUTO Somente saída. Origem do ROAS desejado efetivo. Este campo é só de leitura. Os valores permitidos são AD_GROUP, AD_GROUP_CRITERION, CAMPAIGN_BIDDING_STRATEGY, UNKNOWN, UNSPECIFIED.
AdGroupExcludedParentAssetFieldTypes String ATRIBUTO Os tipos de campo de ativo que devem ser excluídos deste grupo de anúncios. Os links de recursos com esses tipos de campo não serão herdados por esse grupo de anúncios dos níveis superiores. Os valores permitidos são BOOK_ON_GOOGLE, BUSINESS_NAME, CALL, CALLOUT, CALL_TO_ACTION_SELECTION, DESCRIPTION, HEADLINE, HOTEL_CALLOUT, LANDSCAPE_LOGO, LEAD_FORM, LOGO, LONG_HEADLINE, MANDATORY_AD_TEXT, MARKETING_IMAGE, MEDIA_BUNDLE, MOBILE_APP, PORTRAIT_MARKETING_IMAGE, PRICE, PROMOÇÃO, SITELINK, SQUARE_MARKETING_IMAGE, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO, VÍDEO, YOUTUBE_VIDEO.
AdGroupExplorerAutoOptimizerSettingOptIn Bool ATRIBUTO Indica se o otimizador está ativado.
AdGroupFinalUrlSuffix String ATRIBUTO Modelo de URL para anexar parâmetros ao URL final.
AdGroupId Long ATRIBUTO Somente saída. O ID do grupo de anúncios.
AdGroupLabels String ATRIBUTO Somente saída. Os nomes dos recursos dos rótulos anexados a este grupo de anúncios.
AdGroupName String ATRIBUTO O nome do grupo de anúncios. Este campo é obrigatório e não deve ficar vazio ao criar novos grupos de anúncios. Ele deve conter menos de 255 caracteres UTF-8 de largura total. Ele não deve conter nenhum caractere nulo (ponto de código 0x0), avanço de linha NL (ponto de código 0xA) ou retorno de linha (ponto de código 0xD).
AdGroupPercentCpcBidMicros Long ATRIBUTO O valor percentual do lance de CPC, expresso como uma fração do preço anunciado para algum bem ou serviço. O intervalo válido para a fração é [0, 1) e o valor armazenado aqui é 1, 000, 000 * [fração].
AdGroupResourceName String ATRIBUTO Imutável. O nome do recurso do grupo de anúncios. Os nomes dos recursos do grupo de anúncios têm o formato: clientes/{customer_id}/adGroups/{ad_group_id}
AdGroupStatus String ATRIBUTO O status do grupo de anúncios. Os valores permitidos são ATIVADO, PAUSADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
AdGroupTargetCpaMicros Long ATRIBUTO O CPA desejado (custo por aquisição). Se a estratégia de lances da campanha do grupo de anúncios for TargetCpa ou MaximizeConversions (com seu campo target_cpa definido), esse campo substituirá o CPA desejado especificado na estratégia de lances da campanha. Caso contrário, esse valor é ignorado.
AdGroupTargetCpmMicros Long ATRIBUTO Valor médio em micros que o anunciante está disposto a pagar a cada mil vezes que o anúncio for exibido.
AdGroupTargetRoas Double ATRIBUTO A substituição de ROAS (retorno do investimento em publicidade) desejado. Se a estratégia de lances da campanha do grupo de anúncios for TargetRoas ou MaximizeConversionValue (com o campo target_roas definido), esse campo substituirá o ROAS desejado especificado na estratégia de lances da campanha. Caso contrário, esse valor é ignorado.
AdGroupTargetingSettingTargetRestrictions String ATRIBUTO A configuração por dimensão de segmentação para restringir o alcance de sua campanha ou grupo de anúncios.
AdGroupTrackingUrlTemplate String ATRIBUTO O modelo de URL para construir um URL de rastreamento.
AdGroupType String ATRIBUTO Imutável. O tipo do grupo de anúncios. Os valores permitidos são DISPLAY_STANDARD, HOTEL_ADS, PROMOTED_HOTEL_ADS, SEARCH_DYNAMIC_ADS, SEARCH_STANDARD, SHOPPING_COMPARISON_LISTING_ADS, SHOPPING_PRODUCT_ADS, SHOPPING_SMART_ADS, SMART_CAMPAIGN_ADS, UNKNOWN, UNSPECIFIED, VIDEO_BUMPER, VIDEO_EFFICIENT_R EACH, VIDEO_NON_SKIPPABLE_IN_STREAM, VIDEO_OUTSTREAM, VIDEO_RESPONSIVE, VIDEO_TRUE_VIEW_IN_DISPLAY, VIDEO_TRUE_VIEW_IN_STREAM.
AdGroupUrlCustomParameters String ATRIBUTO A lista de mapeamentos usados para substituir tags de parâmetro personalizado em um tracking_url_template, final_urls ou mobile_final_urls.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsByConversionDate Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValueByConversionDate Double MÉTRICA O valor de todas as conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
AveragePageViews Double MÉTRICA Número médio de páginas visualizadas por sessão.
AverageTimeOnSite Double MÉTRICA Duração total de todas as sessões (em segundos) / número de sessões. Importado do Google Analytics.
BounceRate Double MÉTRICA Porcentagem de cliques em que o usuário visitou apenas uma única página em seu site. Importado do Google Analytics.
Clicks Long MÉTRICA O número de cliques.
ContentImpressionShare Double MÉTRICA As impressões recebidas na Rede de Display divididas pelo número estimado de impressões que você estava qualificado para receber. Observação: a parcela de impressões de conteúdo é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
ContentRankLostImpressionShare Double MÉTRICA A porcentagem estimada de impressões na Rede de Display que seus anúncios não receberam devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas da classificação do conteúdo é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsByConversionDate Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValueByConversionDate Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostPerCurrentModelAttributedConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões atribuídas ao modelo atual. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
CurrentModelAttributedConversions Double MÉTRICA Mostra como seus dados históricos de conversões ficariam no modelo de atribuição que você selecionou no momento. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CurrentModelAttributedConversionsValue Double MÉTRICA O valor das conversões atribuídas ao modelo atual. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
PercentNewVisitors Double MÉTRICA Porcentagem de sessões pela primeira vez (de pessoas que nunca visitaram seu site antes). Importado do Google Analytics.
PhoneCalls Long MÉTRICA Número de chamadas telefônicas off-line.
PhoneImpressions Long MÉTRICA Número de impressões telefônicas off-line.
PhoneThroughRate Double MÉTRICA Número de chamadas telefônicas recebidas (phone_calls) dividido pelo número de vezes que seu número de telefone é exibido (phone_impressions).
RelativeCtr Double MÉTRICA Sua taxa de cliques (Ctr) dividida pela taxa média de cliques de todos os anunciantes nos sites que exibem seus anúncios. Mede o desempenho de seus anúncios em sites da Rede de Display em comparação com outros anúncios nos mesmos sites.
SearchAbsoluteTopImpressionShare Double MÉTRICA A porcentagem de impressões de anúncios do Shopping ou de pesquisa do cliente que são exibidas na posição mais proeminente do Shopping. Ver https://support.google.com/google-ads/answer/7501826 para detalhes. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchBudgetLostAbsoluteTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi o primeiro anúncio acima dos resultados da pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões absolutas na parte superior perdida do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchBudgetLostTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi exibido acima dos resultados de pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões na parte superior perdida do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchExactMatchImpressionShare Double MÉTRICA As impressões recebidas divididas pelo número estimado de impressões que você estava qualificado para receber na Rede de Pesquisa para termos de pesquisa que correspondiam exatamente às suas palavras-chave (ou eram variantes aproximadas de sua palavra-chave), independentemente dos tipos de correspondência de palavras-chave. Observação: a parcela de impressões de correspondência exata da pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchImpressionShare Double MÉTRICA As impressões que você recebeu na Rede de Pesquisa divididas pelo número estimado de impressões que você estava qualificado para receber. Observação: a parcela de impressões de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchRankLostAbsoluteTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi o primeiro anúncio acima dos resultados da pesquisa orgânica devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões absolutas perdidas na classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchRankLostImpressionShare Double MÉTRICA A porcentagem estimada de impressões na rede de pesquisa que seus anúncios não receberam devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas da classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchRankLostTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi exibido em nenhum lugar acima dos resultados de pesquisa orgânica devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas na classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchTopImpressionShare Double MÉTRICA As impressões que você recebeu no local superior (em qualquer lugar acima dos resultados da pesquisa orgânica) em comparação com o número estimado de impressões que você estava qualificado para receber no local superior. Observação: a parcela de impressões na parte superior da pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
TopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas em qualquer lugar acima dos resultados de pesquisa orgânica.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerAllConversionsByConversionDate Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ValuePerConversionsByConversionDate Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ValuePerCurrentModelAttributedConversion Double MÉTRICA O valor das conversões atribuídas ao modelo atual dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdDestinationType String SEGMENTO Tipo de destino do anúncio. Os valores permitidos são APP_DEEP_LINK, APP_STORE, LEAD_FORM, LOCATION_LISTING, MAP_DIRECTIONS, MESSAGE, NOT_APPLICABLE, PHONE_CALL, UNKNOWN, UNMODELED_FOR_CONVERSIONS, UNSPECIFIED, WEBSITE, YOUTUBE.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
ConversionAdjustment Bool SEGMENTO Isso segmenta suas colunas de conversão pela conversão original e pelo valor da conversão em comparação com o delta se as conversões forem ajustadas. A linha falsa contém os dados conforme declarados originalmente; Embora a linha verdadeira tenha o delta entre os dados agora e os dados originalmente declarados. A soma dos dois resulta em dados pós-ajuste.
ConversionLagBucket String SEGMENTO Um valor de enumeração que representa o número de dias entre a impressão e a conversão. Os valores permitidos são EIGHT_TO_NINE_DAYS, ELEVEN_TO_TWELVE_DAYS, FIVE_TO_SIX_DAYS, FORTY_FIVE_TO_SIXTY_DAYS, FOURTEEN_TO_TWENTY_ONE_DAYS, FOUR_TO_FIVE_DAYS, LESS_THAN_ONE_DAY, NINE_TO_TEN_DAYS, ONE_TO_TWO_DAYS, SEVEN_TO_EIGHT_DAYS S, SEXTY_TO_NINETY_DAYS, SIX_TO_SEVEN_DAYS, TEN_TO_ELEVEN_DAYS, TREZE_TO_FOURTEEN_DAYS, TRINTA_TO_FORTY_FIVE_DAYS, TRÊS_TO_FOUR_DAYS, DOZE_TO_THIRTEEN_DAYS, TWENTY_ONE_TO_THIRTY_DAYS, DOIS_TO_THREE_DAYS, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionOrAdjustmentLagBucket String SEGMENTO Um valor de enumeração que representa o número de dias entre a impressão e a conversão ou entre a impressão e os ajustes na conversão. Os valores permitidos são ADJUSTMENT_EIGHT_TO_NINE_DAYS, ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS, ADJUSTMENT_FIVE_TO_SIX_DAYS, ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS, ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS, ADJUSTMENT_FOUR_TO_FIVE_DAYS, ADJUSTMENT_LESS_THAN_ONE_DAY, ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS, ADJUSTMENT_NINE_TO_TEN_DAYS, ADJUSTMENT_ONE_TO_TWO_DAYS, ADJUSTMENT_SEVEN_TO_EIGHT_DAYS, ADJUSTMENT_SIXTY_TO_NINETY_DAYS, ADJUSTMENT_SIX_TO_SEVEN_DAYS, ADJUSTMENT_TEN_TO_ELEVEN_DAYS, ADJUSTMENT_THIRTEEN_ TO_FOURTEEN_DAYS, ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS, ADJUSTMENT_THREE_TO_FOUR_DAYS, ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS, ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS, ADJUSTMENT_TWO_TO_THREE_DAYS, ADJUSTMENT_UNKNOWN, CONVERSION_EIGHT_TO_NINE_DAYS, CONVERSION_ELEVEN_TO_TWELVE_DAYS, CONVERSION_FIVE_TO_SIX_DAYS, CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS, CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS, CONVERSION_FOUR_TO_FIVE_DAYS, CONVERSION_LESS_THAN_ONE_DAY, CONVERSION_NINE_TO_TEN_DAYS, CONVERSION_ONE_TO_TWO_DAYS, CONVERSION_SEVEN_TO_ OITO_DIAS, CONVERSION_SIXTY_TO_NINETY_DAYS, CONVERSION_SIX_TO_SEVEN_DAYS, CONVERSION_TEN_TO_ELEVEN_DAYS, CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS, CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS, CONVERSION_THREE_TO_FOUR_DAYS, CONVERSION_TWELVE_TO_THIRTEEN_DAYS, CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS, CONVERSION_TWO_TO_THREE_DAYS, CONVERSION_UNKNOWN, DESCONHECIDO, NÃO ESPECIFICADO.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Hour Int SEGMENTO Hora do dia como um número entre 0 e 23, inclusive.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupAd

Um anúncio de grupo de anúncios.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
AdGroupAdActionItems String ATRIBUTO Somente saída. Uma lista de recomendações para melhorar a qualidade do anúncio. Por exemplo, uma recomendação poderia ser "Seus títulos são um pouco parecidos demais. Tente adicionar títulos mais distintos".
AdGroupAdAdAddedByGoogleAds Bool ATRIBUTO Somente saída. Indica se este anúncio foi adicionado automaticamente pelo Google Ads e não por um usuário. Por exemplo, isso pode acontecer quando os anúncios são criados automaticamente como sugestões para novos anúncios com base no conhecimento do desempenho dos anúncios existentes.
AdGroupAdAdAppAdDescriptions String ATRIBUTO Lista de ativos de texto para descrições. Quando o anúncio for exibido, as descrições serão selecionadas nessa lista.
AdGroupAdAdAppAdHeadlines String ATRIBUTO Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista.
AdGroupAdAdAppAdHtml5MediaBundles String ATRIBUTO Lista de recursos do pacote de mídia que podem ser usados com o anúncio.
AdGroupAdAdAppAdImages String ATRIBUTO Lista de ativos de imagem que podem ser exibidos com o anúncio.
AdGroupAdAdAppAdMandatoryAdText String ATRIBUTO Texto de anúncio obrigatório.
AdGroupAdAdAppAdYouTubeVideos String ATRIBUTO Lista de recursos de vídeo do YouTube que podem ser exibidos com o anúncio.
AdGroupAdAdAppEngagementAdDescriptions String ATRIBUTO Lista de recursos de texto para descrições. Quando o anúncio for exibido, as descrições serão selecionadas nessa lista.
AdGroupAdAdAppEngagementAdHeadlines String ATRIBUTO Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista.
AdGroupAdAdAppEngagementAdImages String ATRIBUTO Lista de ativos de imagem que podem ser exibidos com o anúncio.
AdGroupAdAdAppEngagementAdVideos String ATRIBUTO Lista de recursos de vídeo que podem ser exibidos com o anúncio.
AdGroupAdAdAppPreRegistrationAdDescriptions String ATRIBUTO Lista de recursos de texto para descrições. Quando o anúncio for exibido, as descrições serão selecionadas nessa lista.
AdGroupAdAdAppPreRegistrationAdHeadlines String ATRIBUTO Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista.
AdGroupAdAdAppPreRegistrationAdImages String ATRIBUTO Lista de IDs de recursos de imagem cujas imagens podem ser exibidas com o anúncio.
AdGroupAdAdAppPreRegistrationAdYouTubeVideos String ATRIBUTO Lista de IDs de recursos de vídeo do YouTube cujos vídeos podem ser exibidos com o anúncio.
AdGroupAdAdCallAdBusinessName String ATRIBUTO O nome da empresa no anúncio.
AdGroupAdAdCallAdCallTracked Bool ATRIBUTO Se o rastreamento de chamadas deve ser ativado para o criativo. A ativação do rastreamento de chamadas também permite conversões de chamadas.
AdGroupAdAdCallAdConversionAction String ATRIBUTO A ação de conversão à qual atribuir uma conversão de chamada. Se não for definido, uma ação de conversão padrão será usada. Este campo só tem efeito se call_tracked for definido como verdadeiro. Caso contrário, este campo é ignorado.
AdGroupAdAdCallAdConversionReportingState String ATRIBUTO O comportamento de conversão de chamada deste anúncio de chamada. Ele pode usar sua própria configuração de conversão de chamada, herdar a configuração de nível de conta ou ser desativado. Os valores permitidos são DISABLED, UNKNOWN, UNSPECIFIED, USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION, USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
AdGroupAdAdCallAdCountryCode String ATRIBUTO O código do país no anúncio.
AdGroupAdAdCallAdDescription1 String ATRIBUTO A primeira linha da descrição do anúncio.
AdGroupAdAdCallAdDescription2 String ATRIBUTO A segunda linha da descrição do anúncio.
AdGroupAdAdCallAdDisableCallConversion Bool ATRIBUTO Se a conversão de chamada deve ser desativada para o criativo. Se definido como verdadeiro, desativa as conversões de chamada mesmo quando call_tracked é verdadeiro. Se call_tracked for falso, esse campo será ignorado.
AdGroupAdAdCallAdHeadline1 String ATRIBUTO Primeiro título do anúncio.
AdGroupAdAdCallAdHeadline2 String ATRIBUTO Segundo título do anúncio.
AdGroupAdAdCallAdPath1 String ATRIBUTO Primeira parte do texto que pode ser anexada ao URL do anúncio. Opcional.
AdGroupAdAdCallAdPath2 String ATRIBUTO Segunda parte do texto que pode ser anexada ao URL do anúncio. Este campo só pode ser definido quando path1 também estiver definido. Opcional.
AdGroupAdAdCallAdPhoneNumber String ATRIBUTO O número de telefone no anúncio.
AdGroupAdAdCallAdPhoneNumberVerificationUrl String ATRIBUTO A URL a ser usada para verificação do número de telefone.
AdGroupAdAdDevicePreference String ATRIBUTO A preferência de dispositivo para o anúncio. Você só pode especificar uma preferência para dispositivos móveis. Quando essa preferência é definida, o anúncio terá preferência sobre outros anúncios ao ser exibido em um dispositivo móvel. O anúncio ainda pode ser exibido em outros tipos de dispositivos, por ex. se nenhum outro anúncio estiver disponível. Se não for especificado (sem preferência de dispositivo), todos os dispositivos serão direcionados. Isso é compatível apenas com alguns tipos de anúncio. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
AdGroupAdAdDisplayUploadAdDisplayUploadProductType String ATRIBUTO O tipo de produto deste anúncio. Consulte os comentários na enumeração para obter detalhes. Os valores permitidos são DYNAMIC_HTML5_CUSTOM_AD, DYNAMIC_HTML5_EDUCATION_AD, DYNAMIC_HTML5_FLIGHT_AD, DYNAMIC_HTML5_HOTEL_AD, DYNAMIC_HTML5_HOTEL_RENTAL_AD, DYNAMIC_HTML5_JOB_AD, DYNAMIC_HTML5_LOCAL_AD, DYNAMIC_HTML 5_REAL_ESTATE_AD, DYNAMIC_HTML5_TRAVEL_AD, HTML5_UPLOAD_AD, DESCONHECIDO, NÃO ESPECIFICADO.
AdGroupAdAdDisplayUploadAdMediaBundle String ATRIBUTO Um recurso de pacote de mídia a ser usado no anúncio. Para obter informações sobre o pacote de mídia para HTML5_UPLOAD_AD, consulte https://support.google.com/google-ads/answer/1722096 os pacotes de mídia que fazem parte de tipos de produtos dinâmicos usam um formato especial que precisa ser criado por meio do Google Web Designer. Ver https://support.google.com/webdesigner/answer/7543898 para maiores informações.
AdGroupAdAdDisplayUrl String ATRIBUTO O URL que aparece na descrição do anúncio para alguns formatos de anúncio.
AdGroupAdAdExpandedDynamicSearchAdDescription String ATRIBUTO A descrição do anúncio.
AdGroupAdAdExpandedDynamicSearchAdDescription2 String ATRIBUTO A segunda descrição do anúncio.
AdGroupAdAdExpandedTextAdDescription String ATRIBUTO A descrição do anúncio.
AdGroupAdAdExpandedTextAdDescription2 String ATRIBUTO A segunda descrição do anúncio.
AdGroupAdAdExpandedTextAdHeadlinePart1 String ATRIBUTO A primeira parte do título do anúncio.
AdGroupAdAdExpandedTextAdHeadlinePart2 String ATRIBUTO A segunda parte do título do anúncio.
AdGroupAdAdExpandedTextAdHeadlinePart3 String ATRIBUTO A terceira parte do título do anúncio.
AdGroupAdAdExpandedTextAdPath1 String ATRIBUTO O texto que pode aparecer ao lado do URL exibido do anúncio.
AdGroupAdAdExpandedTextAdPath2 String ATRIBUTO Texto adicional que pode aparecer ao lado do URL exibido do anúncio.
AdGroupAdAdFinalAppUrls String ATRIBUTO Uma lista de URLs de aplicativos finais que serão usados em dispositivos móveis se o usuário tiver o aplicativo específico instalado.
AdGroupAdAdFinalMobileUrls String ATRIBUTO A lista de possíveis URLs finais para celular após todos os redirecionamentos entre domínios do anúncio.
AdGroupAdAdFinalUrlSuffix String ATRIBUTO O sufixo a ser usado ao construir um URL final.
AdGroupAdAdFinalUrls String ATRIBUTO A lista de possíveis URLs finais após todos os redirecionamentos entre domínios do anúncio.
AdGroupAdAdGmailAdHeaderImage String ATRIBUTO O nome do recurso MediaFile da imagem do cabeçalho. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é de 300x100 pixels e a proporção deve estar entre 3:1 e 5:1 (+-1%).
AdGroupAdAdGmailAdMarketingImage String ATRIBUTO O nome do recurso MediaFile da imagem de marketing. Os tipos de imagem válidos são GIF, JPEG e PNG. A imagem deve ser paisagem com tamanho mínimo de 600x314 pixels e proporção de 600:314 (+-1%) ou quadrada com tamanho mínimo de 300x300 pixels e proporção de 1:1 (+-1%)
AdGroupAdAdGmailAdMarketingImageDescription String ATRIBUTO Descrição da imagem de marketing.
AdGroupAdAdGmailAdMarketingImageDisplayCallToActionText String ATRIBUTO Texto para a call-to-action de exibição.
AdGroupAdAdGmailAdMarketingImageDisplayCallToActionTextColor String ATRIBUTO Cor do texto para a call-to-action de exibição em hexadecimal, por exemplo #ffffff para branco.
AdGroupAdAdGmailAdMarketingImageDisplayCallToActionUrlCollectionId String ATRIBUTO Identifica a coleção de URL no campo ad.url_collections. Se não for definido, o URL padrão será final_url.
AdGroupAdAdGmailAdMarketingImageHeadline String ATRIBUTO Título da imagem de marketing.
AdGroupAdAdGmailAdProductImages String ATRIBUTO Imagens do produto. Até 15 imagens são suportadas.
AdGroupAdAdGmailAdProductVideos String ATRIBUTO Vídeos de produtos. Até 7 vídeos são suportados. Pelo menos um vídeo de produto ou imagem de marketing deve ser especificado.
AdGroupAdAdGmailAdTeaserBusinessName String ATRIBUTO Nome comercial do anunciante.
AdGroupAdAdGmailAdTeaserDescription String ATRIBUTO Descrição do teaser.
AdGroupAdAdGmailAdTeaserHeadline String ATRIBUTO Título do teaser.
AdGroupAdAdGmailAdTeaserLogoImage String ATRIBUTO O nome do recurso MediaFile da imagem do logotipo. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 144x144 pixels e a proporção deve ser 1:1 (+-1%).
AdGroupAdAdHotelAd String ATRIBUTO Detalhes relativos a um anúncio de hotel.
AdGroupAdAdId Long ATRIBUTO Somente saída. O ID do anúncio.
AdGroupAdAdImageAdImageUrl String ATRIBUTO URL da imagem em tamanho real.
AdGroupAdAdImageAdMimeType String ATRIBUTO O tipo mime da imagem. Os valores permitidos são AUDIO_MP3, AUDIO_WAV, FLASH, HTML5_AD_ZIP, IMAGE_GIF, IMAGE_JPEG, IMAGE_PNG, MSEXCEL, MSWORD, PDF, RTF, TEXT_HTML, UNKNOWN, UNSPECIFIED.
AdGroupAdAdImageAdName String ATRIBUTO O nome da imagem. Se a imagem foi criada a partir de um MediaFile, este é o nome do MediaFile. Se a imagem foi criada a partir de bytes, está vazio.
AdGroupAdAdImageAdPixelHeight Long ATRIBUTO Altura em pixels da imagem em tamanho real.
AdGroupAdAdImageAdPixelWidth Long ATRIBUTO Largura em pixels da imagem em tamanho real.
AdGroupAdAdImageAdPreviewImageUrl String ATRIBUTO URL da imagem de tamanho de visualização.
AdGroupAdAdImageAdPreviewPixelHeight Long ATRIBUTO Altura em pixels da imagem de tamanho de visualização.
AdGroupAdAdImageAdPreviewPixelWidth Long ATRIBUTO Largura em pixels da imagem de tamanho de visualização.
AdGroupAdAdLegacyAppInstallAd String ATRIBUTO Imutável. Detalhes relativos a um anúncio de instalação de aplicativo herdado.
AdGroupAdAdLegacyResponsiveDisplayAdAccentColor String ATRIBUTO A cor de destaque do anúncio em hexadecimal, por exemplo #ffffff para branco. Se um de main_color e acent_color for definido, o outro também será necessário.
AdGroupAdAdLegacyResponsiveDisplayAdAllowFlexibleColor Bool ATRIBUTO Consentimento do anunciante para permitir cores flexíveis. Quando true, o anúncio pode ser veiculado com cores diferentes, se necessário. Quando falso, o anúncio será exibido com as cores especificadas ou com uma cor neutra. O valor padrão é verdadeiro. Deve ser true se main_color e acent_color não estiverem definidos.
AdGroupAdAdLegacyResponsiveDisplayAdBusinessName String ATRIBUTO O nome da empresa no anúncio.
AdGroupAdAdLegacyResponsiveDisplayAdCallToActionText String ATRIBUTO O texto da frase de chamariz do anúncio.
AdGroupAdAdLegacyResponsiveDisplayAdDescription String ATRIBUTO A descrição do anúncio.
AdGroupAdAdLegacyResponsiveDisplayAdFormatSetting String ATRIBUTO Especifica em qual formato o anúncio será exibido. O padrão é ALL_FORMATS. Os valores permitidos são ALL_FORMATS, NATIVE, NON_NATIVE, UNKNOWN, UNSPECIFIED.
AdGroupAdAdLegacyResponsiveDisplayAdLogoImage String ATRIBUTO O nome do recurso MediaFile da imagem do logotipo usado no anúncio.
AdGroupAdAdLegacyResponsiveDisplayAdLongHeadline String ATRIBUTO A versão longa do título do anúncio.
AdGroupAdAdLegacyResponsiveDisplayAdMainColor String ATRIBUTO A cor principal do anúncio em hexadecimal, por exemplo #ffffff para branco. Se um de main_color e acent_color for definido, o outro também será necessário.
AdGroupAdAdLegacyResponsiveDisplayAdMarketingImage String ATRIBUTO O nome do recurso MediaFile da imagem de marketing usada no anúncio.
AdGroupAdAdLegacyResponsiveDisplayAdPricePrefix String ATRIBUTO Prefixo antes do preço. Por exemplo. 'tão baixo quanto'.
AdGroupAdAdLegacyResponsiveDisplayAdPromoText String ATRIBUTO Texto promocional usado para formatos dinâmicos de anúncios responsivos. Por exemplo, 'Envio grátis em dois dias'.
AdGroupAdAdLegacyResponsiveDisplayAdShortHeadline String ATRIBUTO A versão curta do título do anúncio.
AdGroupAdAdLegacyResponsiveDisplayAdSquareLogoImage String ATRIBUTO O nome do recurso MediaFile da imagem do logotipo quadrado usado no anúncio.
AdGroupAdAdLegacyResponsiveDisplayAdSquareMarketingImage String ATRIBUTO O nome do recurso MediaFile da imagem de marketing quadrada usada no anúncio.
AdGroupAdAdLocalAdCallToActions String ATRIBUTO Lista de ativos de texto para call-to-actions. Quando o anúncio for veiculado, as frases de chamariz serão selecionadas nessa lista. Call-to-actions são opcionais e no máximo 5 podem ser especificados.
AdGroupAdAdLocalAdDescriptions String ATRIBUTO Lista de ativos de texto para descrições. Quando o anúncio for exibido, as descrições serão selecionadas nessa lista. Pelo menos 1 e no máximo 5 descrições devem ser especificadas.
AdGroupAdAdLocalAdHeadlines String ATRIBUTO Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista. No mínimo 1 e no máximo 5 títulos devem ser especificados.
AdGroupAdAdLocalAdLogoImages String ATRIBUTO Lista de ativos de imagem de logotipo que podem ser exibidos com o anúncio. As imagens devem ter 128x128 pixels e não ultrapassar 120KB. Pelo menos 1 e no máximo 5 recursos de imagem devem ser especificados.
AdGroupAdAdLocalAdMarketingImages String ATRIBUTO Lista de ativos de imagem de marketing que podem ser exibidos com o anúncio. As imagens devem ter 314x600 pixels ou 320x320 pixels. Pelo menos 1 e no máximo 20 ativos de imagem devem ser especificados.
AdGroupAdAdLocalAdPath1 String ATRIBUTO Primeira parte do texto opcional que pode ser anexado ao URL do anúncio.
AdGroupAdAdLocalAdPath2 String ATRIBUTO Segunda parte do texto opcional que pode ser anexado ao URL do anúncio. Este campo só pode ser definido quando path1 também estiver definido.
AdGroupAdAdLocalAdVideos String ATRIBUTO Lista de recursos de vídeo do YouTube que podem ser exibidos com o anúncio. Os vídeos são opcionais e podem ser especificados no máximo 20.
AdGroupAdAdName String ATRIBUTO Imutável. O nome do anúncio. Isso é usado apenas para poder identificar o anúncio. Ele não precisa ser exclusivo e não afeta o anúncio exibido. No momento, o campo de nome é compatível apenas com DisplayUploadAd, ImageAd, ShoppingComparisonListingAd e VideoAd.
AdGroupAdAdResourceName String ATRIBUTO Imutável. O nome do recurso do anúncio. Os nomes dos recursos de anúncios têm o formato: clientes/{customer_id}/ads/{ad_id}
AdGroupAdAdResponsiveDisplayAdAccentColor String ATRIBUTO A cor de destaque do anúncio em hexadecimal, por exemplo #ffffff para branco. Se um de main_color e acent_color for definido, o outro também será necessário.
AdGroupAdAdResponsiveDisplayAdAllowFlexibleColor Bool ATRIBUTO Consentimento do anunciante para permitir cores flexíveis. Quando true, o anúncio pode ser veiculado com cores diferentes, se necessário. Quando falso, o anúncio será exibido com as cores especificadas ou com uma cor neutra. O valor padrão é verdadeiro. Deve ser true se main_color e acent_color não estiverem definidos.
AdGroupAdAdResponsiveDisplayAdBusinessName String ATRIBUTO O nome do anunciante/marca. A largura máxima de exibição é 25.
AdGroupAdAdResponsiveDisplayAdCallToActionText String ATRIBUTO O texto da frase de chamariz do anúncio. A largura máxima de exibição é 30.
AdGroupAdAdResponsiveDisplayAdControlSpecEnableAssetEnhancements Bool ATRIBUTO Se o anunciante optou pelo recurso de melhorias de recursos.
AdGroupAdAdResponsiveDisplayAdControlSpecEnableAutogenVideo Bool ATRIBUTO Se o anunciante optou pelo recurso de geração automática de vídeo.
AdGroupAdAdResponsiveDisplayAdDescriptions String ATRIBUTO Textos descritivos para o anúncio. O comprimento máximo é de 90 caracteres. Podem ser especificados pelo menos 1 e no máximo 5 títulos.
AdGroupAdAdResponsiveDisplayAdFormatSetting String ATRIBUTO Especifica em qual formato o anúncio será exibido. O padrão é ALL_FORMATS. Os valores permitidos são ALL_FORMATS, NATIVE, NON_NATIVE, UNKNOWN, UNSPECIFIED.
AdGroupAdAdResponsiveDisplayAdHeadlines String ATRIBUTO Títulos de formato curto para o anúncio. O comprimento máximo é de 30 caracteres. Podem ser especificados pelo menos 1 e no máximo 5 títulos.
AdGroupAdAdResponsiveDisplayAdLogoImages String ATRIBUTO Imagens do logotipo a serem usadas no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 512 x 128 e a proporção deve ser 4:1 (+-1%). Combinado com square_logo_images, o máximo é 5.
AdGroupAdAdResponsiveDisplayAdLongHeadline String ATRIBUTO Um título de formato longo obrigatório. O comprimento máximo é de 90 caracteres.
AdGroupAdAdResponsiveDisplayAdMainColor String ATRIBUTO A cor principal do anúncio em hexadecimal, por exemplo #ffffff para branco. Se um de main_color e acent_color for definido, o outro também será necessário.
AdGroupAdAdResponsiveDisplayAdMarketingImages String ATRIBUTO Imagens de marketing a serem usadas no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 600 x 314 e a proporção deve ser 1,91:1 (+-1%). Pelo menos uma imagem_de_marketing é necessária. Combinado com square_marketing_images, o máximo é 15.
AdGroupAdAdResponsiveDisplayAdPricePrefix String ATRIBUTO Prefixo antes do preço. Por exemplo. 'tão baixo quanto'.
AdGroupAdAdResponsiveDisplayAdPromoText String ATRIBUTO Texto promocional usado para formatos dinâmicos de anúncios responsivos. Por exemplo, 'Envio grátis em dois dias'.
AdGroupAdAdResponsiveDisplayAdSquareLogoImages String ATRIBUTO Imagens de logotipo Square a serem usadas no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 128 x 128 e a proporção deve ser 1:1 (+-1%). Combinado com square_logo_images, o máximo é 5.
AdGroupAdAdResponsiveDisplayAdSquareMarketingImages String ATRIBUTO Imagens Square de marketing para serem usadas no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 300 x 300 e a proporção deve ser 1:1 (+-1%). É necessário pelo menos um quadrado marketing_image. Combinado com marketing_images, o máximo é 15.
AdGroupAdAdResponsiveDisplayAdYouTubeVideos String ATRIBUTO Vídeos opcionais do YouTube para o anúncio. Podem ser especificados no máximo 5 vídeos.
AdGroupAdAdResponsiveSearchAdDescriptions String ATRIBUTO Lista de recursos de texto para descrições. Quando o anúncio for exibido, as descrições serão selecionadas nessa lista.
AdGroupAdAdResponsiveSearchAdHeadlines String ATRIBUTO Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista.
AdGroupAdAdResponsiveSearchAdPath1 String ATRIBUTO Primeira parte do texto que pode ser anexada ao URL do anúncio.
AdGroupAdAdResponsiveSearchAdPath2 String ATRIBUTO Segunda parte do texto que pode ser anexada ao URL do anúncio. Este campo só pode ser definido quando path1 também estiver definido.
AdGroupAdAdShoppingComparisonListingAdHeadline String ATRIBUTO Título do anúncio. Este campo é obrigatório. O comprimento permitido é entre 25 e 45 caracteres.
AdGroupAdAdShoppingProductAd String ATRIBUTO Detalhes relativos a um anúncio de produto do Shopping.
AdGroupAdAdShoppingSmartAd String ATRIBUTO Detalhes relativos a um anúncio inteligente do Shopping.
AdGroupAdAdSmartCampaignAdDescriptions String ATRIBUTO Lista de ativos de texto para descrições. Quando o anúncio for exibido, as descrições serão selecionadas nessa lista. 2 descrições devem ser especificadas.
AdGroupAdAdSmartCampaignAdHeadlines String ATRIBUTO Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista. 3 títulos devem ser especificados.
AdGroupAdAdSystemManagedResourceSource String ATRIBUTO Somente saída. Se este anúncio for gerenciado pelo sistema, este campo indicará a origem. Este campo é só de leitura. Os valores permitidos são AD_VARIATIONS, UNKNOWN, UNSPECIFED.
AdGroupAdAdTextAdDescription1 String ATRIBUTO A primeira linha da descrição do anúncio.
AdGroupAdAdTextAdDescription2 String ATRIBUTO A segunda linha da descrição do anúncio.
AdGroupAdAdTextAdHeadline String ATRIBUTO O título do anúncio.
AdGroupAdAdTrackingUrlTemplate String ATRIBUTO O modelo de URL para construir um URL de rastreamento.
AdGroupAdAdType String ATRIBUTO Somente saída. O tipo de anúncio. Os valores permitidos são APP_AD, APP_ENGAGEMENT_AD, APP_PRE_REGISTRATION_AD, CALL_AD, DYNAMIC_HTML5_AD, EXPANDED_DYNAMIC_SEARCH_AD, EXPANDED_TEXT_AD, GMAIL_AD, HOTEL_AD, HTML5_UPLOAD_AD, IMAGE_AD, IN_FEED_VIDEO_AD, LEGACY_APP_INSTALL_AD, LEGACY_RESPONSIVE_DISPLAY_AD, LOCAL_AD, RESPONSIVE_DISPLAY_AD, RESPONSIVE_SEARCH_AD, SHOPPING_COMPARISON_LISTING_AD, SHOPPING_PRODUCT_AD, SHOPPING_SMART_AD, SMART_CAMPAIGN_AD, TEXT_AD, DESCONHECIDO, NÃO ESPECIFICADO, VIDEO_AD, VIDEO_BUMPER_AD, VIDEO_NON_SKIPPABLE_IN_STREAM_AD, VIDEO_OUTSTREAM_AD, VIDEO_RESPONSIVE_AD, VIDEO_TRUEVIEW_IN_STREAM_AD.
AdGroupAdAdUrlCollections String ATRIBUTO URLs adicionais para o anúncio marcados com um identificador exclusivo que pode ser referenciado em outros campos do anúncio.
AdGroupAdAdUrlCustomParameters String ATRIBUTO A lista de mapeamentos que podem ser usados para substituir tags de parâmetro personalizado em um tracking_url_template, final_urls ou mobile_final_urls. Para mutações, use operações de parâmetro personalizado de URL.
AdGroupAdAdVideoAdBumperCompanionBannerAsset String ATRIBUTO O nome do recurso Asset desta imagem.
AdGroupAdAdVideoAdInFeedDescription1 String ATRIBUTO Primeira linha de texto do anúncio.
AdGroupAdAdVideoAdInFeedDescription2 String ATRIBUTO Segunda linha de texto do anúncio.
AdGroupAdAdVideoAdInFeedHeadline String ATRIBUTO O título do anúncio.
AdGroupAdAdVideoAdInFeedThumbnail String ATRIBUTO Imagem em miniatura do vídeo a ser usada. Os valores permitidos são DEFAULT_THUMBNAIL, THUMBNAIL_1, THUMBNAIL_2, THUMBNAIL_3, UNKNOWN, UNSPECIFIED.
AdGroupAdAdVideoAdInStreamActionButtonLabel String ATRIBUTO Rótulo no botão CTA (call-to-action) que leva o usuário ao URL final do anúncio em vídeo. Obrigatório para campanhas TrueView for Action, caso contrário é opcional.
AdGroupAdAdVideoAdInStreamActionHeadline String ATRIBUTO Texto adicional exibido com o botão CTA (call-to-action) para fornecer contexto e incentivar o clique no botão.
AdGroupAdAdVideoAdInStreamCompanionBannerAsset String ATRIBUTO O nome do recurso Asset desta imagem.
AdGroupAdAdVideoAdNonSkippableActionButtonLabel String ATRIBUTO Rótulo no botão "Chamada para ação" que leva o usuário ao URL final do anúncio em vídeo.
AdGroupAdAdVideoAdNonSkippableActionHeadline String ATRIBUTO Texto adicional exibido com o botão "Call To Action" para fornecer contexto e incentivar o clique no botão.
AdGroupAdAdVideoAdNonSkippableCompanionBannerAsset String ATRIBUTO O nome do recurso Asset desta imagem.
AdGroupAdAdVideoAdOutStreamDescription String ATRIBUTO A linha de descrição.
AdGroupAdAdVideoAdOutStreamHeadline String ATRIBUTO O título do anúncio.
AdGroupAdAdVideoAdVideoAsset String ATRIBUTO O nome do recurso Asset deste vídeo.
AdGroupAdAdVideoResponsiveAdCallToActions String ATRIBUTO Lista de recursos de texto usados para o botão, por exemplo o botão "Call To Action". Atualmente, apenas um único valor para o botão é suportado.
AdGroupAdAdVideoResponsiveAdCompanionBanners String ATRIBUTO Lista de recursos de imagem usados para o banner complementar. Atualmente, apenas um único valor para o recurso de banner complementar é compatível.
AdGroupAdAdVideoResponsiveAdDescriptions String ATRIBUTO Lista de recursos de texto usados para a descrição. Atualmente, apenas um único valor para a descrição é suportado.
AdGroupAdAdVideoResponsiveAdHeadlines String ATRIBUTO Lista de recursos de texto usados para o título curto, por exemplo o banner "Call To Action". Atualmente, apenas um único valor para o título curto é suportado.
AdGroupAdAdVideoResponsiveAdLongHeadlines String ATRIBUTO Lista de recursos de texto usados para o título longo. Atualmente, apenas um único valor para o título longo é suportado.
AdGroupAdAdVideoResponsiveAdVideos String ATRIBUTO Lista de recursos de vídeo do YouTube usados para o anúncio. Atualmente, apenas um único valor para o recurso de vídeo do YouTube é compatível.
AdGroupAdAdGroup String ATRIBUTO Imutável. O grupo de anúncios ao qual o anúncio pertence.
AdGroupAdAdStrength String ATRIBUTO Somente saída. Potência geral do anúncio para este anúncio de grupo de anúncios. Os valores permitidos são AVERAGE, EXCELLENT, GOOD, NO_ADS, PENDING, POOR, UNKNOWN, UNSPECIFIED.
AdGroupAdLabels String ATRIBUTO Somente saída. Os nomes dos recursos dos rótulos anexados a este anúncio de grupo de anúncios.
AdGroupAdPolicySummaryApprovalStatus String ATRIBUTO Somente saída. O status de aprovação geral deste anúncio, calculado com base no status de suas entradas de tópico de política individuais. Os valores permitidos são APPROVED, APPROVED_LIMITED, AREA_OF_INTEREST_ONLY, DISAPPROVED, UNKNOWN, UNSPECIFIED.
AdGroupAdPolicySummaryPolicyTopicEntries String ATRIBUTO Somente saída. A lista de descobertas da política para este anúncio.
AdGroupAdPolicySummaryReviewStatus String ATRIBUTO Somente saída. Em que parte do processo de revisão este anúncio está. Os valores permitidos são ELIGIBLE_MAY_SERVE, REVIEWED, REVIEW_IN_PROGRESS, UNDER_APPEAL, UNKNOWN, UNSPECIFIED.
AdGroupAdResourceName String ATRIBUTO Imutável. O nome do recurso do anúncio. Os nomes dos recursos de anúncios do grupo de anúncios têm o formato: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
AdGroupAdStatus String ATRIBUTO O status do anúncio. Os valores permitidos são ATIVADO, PAUSADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsByConversionDate Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValueByConversionDate Double MÉTRICA O valor de todas as conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
AveragePageViews Double MÉTRICA Número médio de páginas visualizadas por sessão.
AverageTimeOnSite Double MÉTRICA Duração total de todas as sessões (em segundos) / número de sessões. Importado do Google Analytics.
BounceRate Double MÉTRICA Porcentagem de cliques em que o usuário visitou apenas uma única página em seu site. Importado do Google Analytics.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsByConversionDate Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValueByConversionDate Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostPerCurrentModelAttributedConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões atribuídas ao modelo atual. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
CurrentModelAttributedConversions Double MÉTRICA Mostra como seus dados históricos de conversões ficariam no modelo de atribuição que você selecionou no momento. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CurrentModelAttributedConversionsValue Double MÉTRICA O valor das conversões atribuídas ao modelo atual. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
PercentNewVisitors Double MÉTRICA Porcentagem de sessões pela primeira vez (de pessoas que nunca visitaram seu site antes). Importado do Google Analytics.
TopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas em qualquer lugar acima dos resultados de pesquisa orgânica.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerAllConversionsByConversionDate Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ValuePerConversionsByConversionDate Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ValuePerCurrentModelAttributedConversion Double MÉTRICA O valor das conversões atribuídas ao modelo atual dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdDestinationType String SEGMENTO Tipo de destino do anúncio. Os valores permitidos são APP_DEEP_LINK, APP_STORE, LEAD_FORM, LOCATION_LISTING, MAP_DIRECTIONS, MESSAGE, NOT_APPLICABLE, PHONE_CALL, UNKNOWN, UNMODELED_FOR_CONVERSIONS, UNSPECIFIED, WEBSITE, YOUTUBE.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
ConversionAdjustment Bool SEGMENTO Isso segmenta suas colunas de conversão pela conversão original e pelo valor da conversão em comparação com o delta se as conversões forem ajustadas. A linha falsa contém os dados conforme declarados originalmente; Embora a linha verdadeira tenha o delta entre os dados agora e os dados originalmente declarados. A soma dos dois resulta em dados pós-ajuste.
ConversionLagBucket String SEGMENTO Um valor de enumeração que representa o número de dias entre a impressão e a conversão. Os valores permitidos são EIGHT_TO_NINE_DAYS, ELEVEN_TO_TWELVE_DAYS, FIVE_TO_SIX_DAYS, FORTY_FIVE_TO_SIXTY_DAYS, FOURTEEN_TO_TWENTY_ONE_DAYS, FOUR_TO_FIVE_DAYS, LESS_THAN_ONE_DAY, NINE_TO_TEN_DAYS, ONE_TO_TWO_DAYS, SEVEN_TO_EIGHT_DAYS S, SEXTY_TO_NINETY_DAYS, SIX_TO_SEVEN_DAYS, TEN_TO_ELEVEN_DAYS, TREZE_TO_FOURTEEN_DAYS, TRINTA_TO_FORTY_FIVE_DAYS, TRÊS_TO_FOUR_DAYS, DOZE_TO_THIRTEEN_DAYS, TWENTY_ONE_TO_THIRTY_DAYS, DOIS_TO_THREE_DAYS, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionOrAdjustmentLagBucket String SEGMENTO Um valor de enumeração que representa o número de dias entre a impressão e a conversão ou entre a impressão e os ajustes na conversão. Os valores permitidos são ADJUSTMENT_EIGHT_TO_NINE_DAYS, ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS, ADJUSTMENT_FIVE_TO_SIX_DAYS, ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS, ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS, ADJUSTMENT_FOUR_TO_FIVE_DAYS, ADJUSTMENT_LESS_THAN_ONE_DAY, ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS, ADJUSTMENT_NINE_TO_TEN_DAYS, ADJUSTMENT_ONE_TO_TWO_DAYS, ADJUSTMENT_SEVEN_TO_EIGHT_DAYS, ADJUSTMENT_SIXTY_TO_NINETY_DAYS, ADJUSTMENT_SIX_TO_SEVEN_DAYS, ADJUSTMENT_TEN_TO_ELEVEN_DAYS, ADJUSTMENT_THIRTEEN_ TO_FOURTEEN_DAYS, ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS, ADJUSTMENT_THREE_TO_FOUR_DAYS, ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS, ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS, ADJUSTMENT_TWO_TO_THREE_DAYS, ADJUSTMENT_UNKNOWN, CONVERSION_EIGHT_TO_NINE_DAYS, CONVERSION_ELEVEN_TO_TWELVE_DAYS, CONVERSION_FIVE_TO_SIX_DAYS, CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS, CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS, CONVERSION_FOUR_TO_FIVE_DAYS, CONVERSION_LESS_THAN_ONE_DAY, CONVERSION_NINE_TO_TEN_DAYS, CONVERSION_ONE_TO_TWO_DAYS, CONVERSION_SEVEN_TO_ OITO_DIAS, CONVERSION_SIXTY_TO_NINETY_DAYS, CONVERSION_SIX_TO_SEVEN_DAYS, CONVERSION_TEN_TO_ELEVEN_DAYS, CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS, CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS, CONVERSION_THREE_TO_FOUR_DAYS, CONVERSION_TWELVE_TO_THIRTEEN_DAYS, CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS, CONVERSION_TWO_TO_THREE_DAYS, CONVERSION_UNKNOWN, DESCONHECIDO, NÃO ESPECIFICADO.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
KeywordAdGroupCriterion String SEGMENTO O nome do recurso AdGroupCriterion.
KeywordInfoMatchType String SEGMENTO O tipo de correspondência da palavra-chave. Os valores permitidos são BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
KeywordInfoText String SEGMENTO O texto da palavra-chave (no máximo 80 caracteres e 10 palavras).
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupAdAssetCombinationView

Uma visão sobre o uso da combinação de ativos de anúncio do grupo de anúncios. Agora oferecemos suporte apenas a AdGroupAdAssetCombinationView para anúncios responsivos de pesquisa, com mais tipos de anúncios planejados para o futuro.

Colunas
Nome Tipo Comportamento Descrição
AdGroupAdAssetCombinationViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização de combinação de recursos de anúncios do grupo de anúncios. O ID de combinação tem 128 bits de comprimento, onde os 64 bits superiores são armazenados em asset_combination_id_high e os 64 bits inferiores são armazenados em asset_combination_id_low. Os nomes dos recursos de exibição de combinação de ativos AdGroupAd têm o formato: customers/{customer_id}/adGroupAdAssetCombinationViews/{AdGroupAd.ad_group_id}~{AdGroupAd.ad.ad_id}~{AssetCombination.asset_combination_id_low}~{AssetCombination.asset_combination_id_high}
AdGroupAdAssetCombinationViewServedAssets String ATRIBUTO Somente saída. Ativos atendidos.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupAdAssetView

Um link entre um AdGroupAd e um recurso. No momento, oferecemos suporte apenas para AdGroupAdAssetView para AppAds.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
AdGroupAdAssetViewAdGroupAd String ATRIBUTO Somente saída. O anúncio do grupo de anúncios ao qual o recurso está vinculado.
AdGroupAdAssetViewAsset String ATRIBUTO Somente saída. O recurso que está vinculado ao anúncio do grupo de anúncios.
AdGroupAdAssetViewEnabled Bool ATRIBUTO Somente saída. O status entre o recurso e a versão mais recente do anúncio. Se verdadeiro, o recurso está vinculado à versão mais recente do anúncio. Se falso, significa que o link já existiu, mas foi removido e não está mais presente na versão mais recente do anúncio.
AdGroupAdAssetViewFieldType String ATRIBUTO Somente saída. Função que o ativo assume no anúncio. Os valores permitidos são BOOK_ON_GOOGLE, BUSINESS_NAME, CALL, CALLOUT, CALL_TO_ACTION_SELECTION, DESCRIPTION, HEADLINE, HOTEL_CALLOUT, LANDSCAPE_LOGO, LEAD_FORM, LOGO, LONG_HEADLINE, MANDATORY_AD_TEXT, MARKETING_IMAGE, MEDIA_BUNDLE, MOBILE_APP, PORTRAIT_MARKETING_IMAGE, PRICE, PROMOÇÃO, SITELINK, SQUARE_MARKETING_IMAGE, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO, VÍDEO, YOUTUBE_VIDEO.
AdGroupAdAssetViewPerformanceLabel String ATRIBUTO Somente saída. Desempenho de uma vinculação de ativos. Os valores permitidos são BEST, GOOD, LEARNING, LOW, PENDING, UNKNOWN, UNSPECIFIED.
AdGroupAdAssetViewPolicySummary String ATRIBUTO Somente saída. Informações de política para o recurso de anúncio do grupo de anúncios.
AdGroupAdAssetViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição do recurso de anúncio do grupo de anúncios. Os nomes dos recursos de visualização de recursos de anúncios do grupo de anúncios têm o formato (antes da V4): clientes/{customer_id}/adGroupAdAssets/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type} Grupo de anúncios os nomes dos recursos de exibição de ativo de anúncio têm o formato (a partir da V4): clientes/{customer_id}/adGroupAdAssetViews/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
BiddableAppInstallConversions Double MÉTRICA Número de instalações de aplicativos.
BiddableAppPostInstallConversions Double MÉTRICA Número de ações no aplicativo.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValuePerCost Double MÉTRICA O valor das conversões dividido pelo custo das interações com o anúncio. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupAdLabel

Uma relação entre um anúncio de grupo de anúncios e um rótulo.

Colunas
Nome Tipo Comportamento Descrição
AdGroupAdLabelAdGroupAd String ATRIBUTO Imutável. O anúncio do grupo de anúncios ao qual o rótulo está anexado.
AdGroupAdLabelLabel String ATRIBUTO Imutável. O rótulo atribuído ao anúncio do grupo de anúncios.
AdGroupAdLabelResourceName String ATRIBUTO Imutável. O nome do recurso do rótulo de anúncio do grupo de anúncios. Os nomes dos recursos de rótulos de anúncios do grupo de anúncios têm o seguinte formato: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupAsset

Um link entre um grupo de anúncios e um recurso.

Colunas
Nome Tipo Comportamento Descrição
AdGroupAssetAdGroup String ATRIBUTO Obrigatório. Imutável. O grupo de anúncios ao qual o recurso está vinculado.
AdGroupAssetAsset String ATRIBUTO Obrigatório. Imutável. O recurso que está vinculado ao grupo de anúncios.
AdGroupAssetFieldType String ATRIBUTO Obrigatório. Imutável. Função que o recurso assume no grupo de anúncios vinculado. Os valores permitidos são BOOK_ON_GOOGLE, BUSINESS_NAME, CALL, CALLOUT, CALL_TO_ACTION_SELECTION, DESCRIPTION, HEADLINE, HOTEL_CALLOUT, LANDSCAPE_LOGO, LEAD_FORM, LOGO, LONG_HEADLINE, MANDATORY_AD_TEXT, MARKETING_IMAGE, MEDIA_BUNDLE, MOBILE_APP, PORTRAIT_MARKETING_IMAGE, PRICE, PROMOÇÃO, SITELINK, SQUARE_MARKETING_IMAGE, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO, VÍDEO, YOUTUBE_VIDEO.
AdGroupAssetResourceName String ATRIBUTO Imutável. O nome do recurso do ativo do grupo de anúncios. Os nomes dos recursos AdGroupAsset têm o formato: customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
AdGroupAssetStatus String ATRIBUTO Status do ativo do grupo de anúncios. Os valores permitidos são ATIVADO, PAUSADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
PhoneCalls Long MÉTRICA Número de chamadas telefônicas off-line.
PhoneImpressions Long MÉTRICA Número de impressões telefônicas off-line.
PhoneThroughRate Double MÉTRICA Número de chamadas telefônicas recebidas (phone_calls) dividido pelo número de vezes que seu número de telefone é exibido (phone_impressions).
TopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas em qualquer lugar acima dos resultados de pesquisa orgânica.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
AssetInteractionTargetAsset String SEGMENTO O nome do recurso ativo.
AssetInteractionTargetInteractionOnThisAsset Bool SEGMENTO Usado apenas com as métricas CustomerAsset, CampaignAsset e AdGroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupAudienceView

Uma visualização do público-alvo do grupo de anúncios. Inclui dados de desempenho de interesses e listas de remarketing para anúncios da Rede de Display e do YouTube e listas de remarketing para anúncios de pesquisa (RLSA), agregados no nível do público.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
AdGroupAudienceViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização de público do grupo de anúncios. Os nomes dos recursos de exibição do público-alvo do grupo de anúncios têm o formato: customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsByConversionDate Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValueByConversionDate Double MÉTRICA O valor de todas as conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsByConversionDate Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValueByConversionDate Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerAllConversionsByConversionDate Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ValuePerConversionsByConversionDate Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
HotelDateSelectionType String SEGMENTO Tipo de seleção de data do hotel. Os valores permitidos são DEFAULT_SELECTION, UNKNOWN, UNSPECIFIED, USER_SELECTED.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupBidModifier

Representa um modificador de lance de grupo de anúncios.

Colunas
Nome Tipo Comportamento Descrição
AdGroupBidModifierAdGroup String ATRIBUTO Imutável. O grupo de anúncios ao qual esse critério pertence.
AdGroupBidModifierBaseAdGroup String ATRIBUTO Somente saída. O grupo de anúncios base a partir do qual esse modificador de lance de grupo de anúncios de rascunho/teste foi criado. Se ad_group for um grupo de anúncios base, esse campo será igual a ad_group. Se o grupo de anúncios tiver sido criado no rascunho ou teste e não tiver um grupo de anúncios base correspondente, esse campo será nulo. Este campo é só de leitura.
AdGroupBidModifierBidModifier Double ATRIBUTO O modificador para o lance quando o critério corresponde. O modificador deve estar no intervalo: 0,1 - 10,0. O intervalo é de 1,0 a 6,0 para PreferredContent. Use 0 para desativar um tipo de dispositivo.
AdGroupBidModifierBidModifierSource String ATRIBUTO Somente saída. Origem do modificador de lance. Os valores permitidos são AD_GROUP, CAMPAIGN, UNKNOWN, UNSPECIFIED.
AdGroupBidModifierCriterionId Long ATRIBUTO Somente saída. O ID do critério para modificar o lance. Este campo é ignorado para mutações.
AdGroupBidModifierDeviceType String ATRIBUTO Tipo do dispositivo. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
AdGroupBidModifierHotelAdvanceBookingWindowMaxDays Long ATRIBUTO Fim máximo do número de dias anteriores à estadia.
AdGroupBidModifierHotelAdvanceBookingWindowMinDays Long ATRIBUTO Fim inferior do número de dias anteriores à estadia.
AdGroupBidModifierHotelCheckInDateRangeEndDate String ATRIBUTO Data final no formato AAAA-MM-DD.
AdGroupBidModifierHotelCheckInDateRangeStartDate String ATRIBUTO Data de início no formato AAAA-MM-DD.
AdGroupBidModifierHotelCheckInDayDayOfWeek String ATRIBUTO O dia da semana. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
AdGroupBidModifierHotelDateSelectionTypeType String ATRIBUTO Tipo de seleção de data do hotel Os valores permitidos são DEFAULT_SELECTION, UNKNOWN, UNSPECIFIED, USER_SELECTED.
AdGroupBidModifierHotelLengthOfStayMaxNights Long ATRIBUTO Extremidade alta do número de noites na estadia.
AdGroupBidModifierHotelLengthOfStayMinNights Long ATRIBUTO Extremidade baixa do número de noites na estadia.
AdGroupBidModifierPreferredContentType String ATRIBUTO Tipo do conteúdo preferido. Os valores permitidos são UNKNOWN, UNSPECIFIED, YOUTUBE_TOP_CONTENT.
AdGroupBidModifierResourceName String ATRIBUTO Imutável. O nome do recurso do modificador de lance do grupo de anúncios. Os nomes dos recursos do modificador de lance do grupo de anúncios têm o seguinte formato: customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupCriterion

Um critério de grupo de anúncios.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
AdGroupCriterionAdGroup String ATRIBUTO Imutável. O grupo de anúncios ao qual o critério pertence.
AdGroupCriterionAgeRangeType String ATRIBUTO Tipo da faixa etária. Os valores permitidos são AGE_RANGE_18_24, AGE_RANGE_25_34, AGE_RANGE_35_44, AGE_RANGE_45_54, AGE_RANGE_55_64, AGE_RANGE_65_UP, AGE_RANGE_UNDETERMINED, UNKNOWN, UNSPECIFIED.
AdGroupCriterionAppPaymentModelType String ATRIBUTO Tipo do modelo de pagamento do app. Os valores permitidos são PAID, UNKNOWN, UNSPECIFIED.
AdGroupCriterionApprovalStatus String ATRIBUTO Somente saída. Status de aprovação do critério. Os valores permitidos são APPROVED, DISAPPROVED, PENDING_REVIEW, UNDER_REVIEW, UNKNOWN, UNSPECIFIED.
AdGroupCriterionAudienceAudience String ATRIBUTO O nome do recurso Audience.
AdGroupCriterionBidModifier Double ATRIBUTO O modificador para o lance quando o critério corresponde. O modificador deve estar no intervalo: 0,1 - 10,0. A maioria dos tipos de critérios segmentáveis oferece suporte a modificadores.
AdGroupCriterionCombinedAudienceCombinedAudience String ATRIBUTO O nome do recurso CombinedAudience.
AdGroupCriterionCpcBidMicros Long ATRIBUTO O lance de CPC (custo por clique).
AdGroupCriterionCpmBidMicros Long ATRIBUTO O lance de CPM (custo por mil impressões visíveis).
AdGroupCriterionCpvBidMicros Long ATRIBUTO O lance de CPV (custo por visualização).
AdGroupCriterionCriterionId Long ATRIBUTO Somente saída. O ID do critério. Este campo é ignorado para mutações.
AdGroupCriterionCustomAffinityCustomAffinity String ATRIBUTO O nome do recurso CustomInterest.
AdGroupCriterionCustomAudienceCustomAudience String ATRIBUTO O nome do recurso CustomAudience.
AdGroupCriterionCustomIntentCustomIntent String ATRIBUTO O nome do recurso CustomInterest.
AdGroupCriterionDisapprovalReasons String ATRIBUTO Somente saída. Lista de motivos de reprovação do critério. Os diferentes motivos para reprovar um critério podem ser encontrados aqui: https://support.google.com/adspolicy/answer/6008942 este campo é só de leitura.
AdGroupCriterionDisplayName String ATRIBUTO Somente saída. O nome de exibição do critério. Este campo é ignorado para mutações.
AdGroupCriterionEffectiveCpcBidMicros Long ATRIBUTO Somente saída. O lance efetivo de CPC (custo por clique).
AdGroupCriterionEffectiveCpcBidSource String ATRIBUTO Somente saída. Origem do lance de CPC efetivo. Os valores permitidos são AD_GROUP, AD_GROUP_CRITERION, CAMPAIGN_BIDDING_STRATEGY, UNKNOWN, UNSPECIFIED.
AdGroupCriterionEffectiveCpmBidMicros Long ATRIBUTO Somente saída. O lance efetivo de CPM (custo por mil impressões visíveis).
AdGroupCriterionEffectiveCpmBidSource String ATRIBUTO Somente saída. Origem do lance de CPM efetivo. Os valores permitidos são AD_GROUP, AD_GROUP_CRITERION, CAMPAIGN_BIDDING_STRATEGY, UNKNOWN, UNSPECIFIED.
AdGroupCriterionEffectiveCpvBidMicros Long ATRIBUTO Somente saída. O lance efetivo de CPV (custo por visualização).
AdGroupCriterionEffectiveCpvBidSource String ATRIBUTO Somente saída. Origem do lance de CPV efetivo. Os valores permitidos são AD_GROUP, AD_GROUP_CRITERION, CAMPAIGN_BIDDING_STRATEGY, UNKNOWN, UNSPECIFIED.
AdGroupCriterionEffectivePercentCpcBidMicros Long ATRIBUTO Somente saída. O valor efetivo do lance de CPC percentual.
AdGroupCriterionEffectivePercentCpcBidSource String ATRIBUTO Somente saída. Origem do lance de CPC percentual efetivo. Os valores permitidos são AD_GROUP, AD_GROUP_CRITERION, CAMPAIGN_BIDDING_STRATEGY, UNKNOWN, UNSPECIFIED.
AdGroupCriterionFinalMobileUrls String ATRIBUTO A lista de possíveis URLs finais para dispositivos móveis após todos os redirecionamentos entre domínios.
AdGroupCriterionFinalUrlSuffix String ATRIBUTO Modelo de URL para anexar parâmetros ao URL final.
AdGroupCriterionFinalUrls String ATRIBUTO A lista de possíveis URLs finais após todos os redirecionamentos entre domínios do anúncio.
AdGroupCriterionGenderType String ATRIBUTO Tipo do gênero. Os valores permitidos são FEMALE, MALE, INDETERMINADO, DESCONHECIDO, NÃO ESPECIFICADO.
AdGroupCriterionIncomeRangeType String ATRIBUTO Tipo da faixa de renda. Os valores permitidos são INCOME_RANGE_0_50, INCOME_RANGE_50_60, INCOME_RANGE_60_70, INCOME_RANGE_70_80, INCOME_RANGE_80_90, INCOME_RANGE_90_UP, INCOME_RANGE_UNDETERMINED, UNKNOWN, UNSPECIFIED.
AdGroupCriterionKeywordMatchType String ATRIBUTO O tipo de correspondência da palavra-chave. Os valores permitidos são BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
AdGroupCriterionKeywordText String ATRIBUTO O texto da palavra-chave (no máximo 80 caracteres e 10 palavras).
AdGroupCriterionLabels String ATRIBUTO Somente saída. Os nomes dos recursos dos rótulos anexados a esse critério de grupo de anúncios.
AdGroupCriterionListingGroupCaseValueHotelCityCityCriterion String ATRIBUTO O nome do recurso Geo Target Constant.
AdGroupCriterionListingGroupCaseValueHotelClassValue Long ATRIBUTO Valor longo da classe hoteleira.
AdGroupCriterionListingGroupCaseValueHotelCountryRegionCountryRegionCriterion String ATRIBUTO O nome do recurso Geo Target Constant.
AdGroupCriterionListingGroupCaseValueHotelIdValue String ATRIBUTO Valor da string do ID do hotel.
AdGroupCriterionListingGroupCaseValueHotelStateStateCriterion String ATRIBUTO O nome do recurso Geo Target Constant.
AdGroupCriterionListingGroupCaseValueProductBiddingCategoryCountryCode String ATRIBUTO Código do país com duas letras maiúsculas da categoria de licitação do produto. Ele deve corresponder ao campo Campaign.shopping_setting.sales_country.
AdGroupCriterionListingGroupCaseValueProductBiddingCategoryId Long ATRIBUTO ID da categoria de lance do produto. Este ID é equivalente ao ID google_product_category conforme descrito neste artigo: https://support.google.com/merchants/answer/6324436
AdGroupCriterionListingGroupCaseValueProductBiddingCategoryLevel String ATRIBUTO Nível da categoria de licitação do produto. Os valores permitidos são LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5, UNKNOWN, UNSPECIFIED.
AdGroupCriterionListingGroupCaseValueProductBrandValue String ATRIBUTO Valor da string da marca do produto.
AdGroupCriterionListingGroupCaseValueProductChannelChannel String ATRIBUTO Valor da localidade. Os valores permitidos são LOCAL, ONLINE, DESCONHECIDO, NÃO ESPECIFICADO.
AdGroupCriterionListingGroupCaseValueProductChannelExclusivityChannelExclusivity String ATRIBUTO Valor da disponibilidade. Os valores permitidos são MULTI_CHANNEL, SINGLE_CHANNEL, UNKNOWN, UNSPECIFIED.
AdGroupCriterionListingGroupCaseValueProductConditionCondition String ATRIBUTO Valor da condição. Os valores permitidos são NOVO, RECONHECIDO, DESCONHECIDO, NÃO ESPECIFICADO, USADO.
AdGroupCriterionListingGroupCaseValueProductCustomAttributeIndex String ATRIBUTO Indica o índice do atributo customizado. Os valores permitidos são INDEX0, INDEX1, INDEX2, INDEX3, INDEX4, DESCONHECIDO, NÃO ESPECIFICADO.
AdGroupCriterionListingGroupCaseValueProductCustomAttributeValue String ATRIBUTO Valor de string do atributo personalizado do produto.
AdGroupCriterionListingGroupCaseValueProductItemIdValue String ATRIBUTO Valor do id.
AdGroupCriterionListingGroupCaseValueProductTypeLevel String ATRIBUTO Nível do tipo. Os valores permitidos são LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5, UNKNOWN, UNSPECIFIED.
AdGroupCriterionListingGroupCaseValueProductTypeValue String ATRIBUTO Valor do tipo.
AdGroupCriterionListingGroupParentAdGroupCriterion String ATRIBUTO Nome do recurso do critério do grupo de anúncios, que é a subdivisão do grupo de listagem principal. Nulo para o grupo raiz.
AdGroupCriterionListingGroupType String ATRIBUTO Tipo do grupo de listagem. Os valores permitidos são SUBDIVISION, UNIT, UNKNOWN, UNSPECIFIED.
AdGroupCriterionMobileAppCategoryMobileAppCategoryConstant String ATRIBUTO O nome do recurso constante da categoria do aplicativo móvel.
AdGroupCriterionMobileApplicationAppId String ATRIBUTO Uma string que identifica exclusivamente um aplicativo para celular para a Google Ads API. O formato dessa string é "{platform}-{platform_native_id}", onde platform é "1" para aplicativos iOS e "2" para aplicativos Android, e platform_native_id é o identificador de aplicativo móvel nativo da plataforma correspondente. Para iOS, esse identificador nativo é a sequência de 9 dígitos que aparece no final de um URL da App Store (por exemplo, "476943146" para "Flood-It! 2" cujo link da App Store é " http://itunes.apple.com/us/app/flood-it!-2/id476943146 "). Para Android, esse identificador nativo é o nome do pacote do aplicativo (por exemplo, "com.labpixies.colordrips" para "Color Drips" dado o link do Google Play " <a
href="https://play.google.com/store/apps/details?id=com.labpixies.colordrips">https://play.google.com/store/apps/details?id=com .labpixies.colordrips "). Um ID de aplicativo bem formado para a Google Ads API seria "1-476943146" para iOS e "2-com.labpixies.colordrips" para Android. Este campo é obrigatório e deve ser configurado nas operações CREATE.
AdGroupCriterionMobileApplicationName String ATRIBUTO Nome deste aplicativo móvel.
AdGroupCriterionNegative Bool ATRIBUTO Imutável. Se deve segmentar (falso) ou excluir (verdadeiro) o critério. Este campo é imutável. Para mudar um critério de positivo para negativo, remova-o e adicione-o novamente.
AdGroupCriterionParentalStatusType String ATRIBUTO Tipo do status parental. Os valores permitidos são NOT_A_PARENT, PARENT, UNDETERMINED, UNKNOWN, UNSPECIFIED.
AdGroupCriterionPercentCpcBidMicros Long ATRIBUTO O valor do lance de CPC, expresso como uma fração do preço anunciado de algum bem ou serviço. O intervalo válido para a fração é [0, 1) e o valor armazenado aqui é 1, 000, 000 * [fração].
AdGroupCriterionPlacementUrl String ATRIBUTO URL da veiculação. Por exemplo, "http://www.domain.com.
AdGroupCriterionPositionEstimatesEstimatedAddClicksAtFirstPositionCpc Long ATRIBUTO Somente saída. Estimativa de quantos cliques por semana você pode obter alterando seu lance de palavra-chave para o valor em first_position_cpc_micros.
AdGroupCriterionPositionEstimatesEstimatedAddCostAtFirstPositionCpc Long ATRIBUTO Somente saída. Estimativa de como seu custo por semana pode mudar ao alterar seu lance de palavra-chave para o valor em first_position_cpc_micros.
AdGroupCriterionPositionEstimatesFirstPageCpcMicros Long ATRIBUTO Somente saída. A estimativa do lance de CPC necessário para que o anúncio seja exibido na primeira página dos resultados de pesquisa.
AdGroupCriterionPositionEstimatesFirstPositionCpcMicros Long ATRIBUTO Somente saída. A estimativa do lance de CPC necessário para que o anúncio seja exibido na primeira posição, na parte superior da primeira página de resultados de pesquisa.
AdGroupCriterionPositionEstimatesTopOfPageCpcMicros Long ATRIBUTO Somente saída. A estimativa do lance de CPC necessário para que o anúncio seja exibido na parte superior da primeira página de resultados de pesquisa.
AdGroupCriterionQualityInfoCreativeQualityScore String ATRIBUTO Somente saída. O desempenho do anúncio em comparação com outros anunciantes. Os valores permitidos são ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE, UNKNOWN, UNSPECIFIED.
AdGroupCriterionQualityInfoPostClickQualityScore String ATRIBUTO Somente saída. O índice de qualidade da página de aterrissagem. Os valores permitidos são ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE, UNKNOWN, UNSPECIFIED.
AdGroupCriterionQualityInfoQualityScore Int ATRIBUTO Somente saída. O índice de qualidade. Este campo pode não ser preenchido se o Google não tiver informações suficientes para determinar um valor.
AdGroupCriterionQualityInfoSearchPredictedCtr String ATRIBUTO Somente saída. A taxa de cliques em comparação com a de outros anunciantes. Os valores permitidos são ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE, UNKNOWN, UNSPECIFIED.
AdGroupCriterionResourceName String ATRIBUTO Imutável. O nome do recurso do critério do grupo de anúncios. Os nomes dos recursos do critério do grupo de anúncios têm o formato: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
AdGroupCriterionStatus String ATRIBUTO O status do critério. Este é o status da entidade de critério do grupo de anúncios, definido pelo cliente. Observação: os relatórios de IU podem incorporar informações adicionais que afetam a qualificação de um critério para execução. Em alguns casos, um critério REMOVIDO na API ainda pode ser exibido como ativado na IU. Por exemplo, as campanhas por padrão são exibidas para usuários de todas as faixas etárias, a menos que sejam excluídas. A IU mostrará cada faixa etária como "ativada", já que eles estão qualificados para ver os anúncios; mas AdGroupCriterion.status mostrará "removido", pois nenhum critério positivo foi adicionado. Os valores permitidos são ATIVADO, PAUSADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
AdGroupCriterionSystemServingStatus String ATRIBUTO Somente saída. Status de exibição do critério. Os valores permitidos são ELIGIBLE, RARELY_SERVED, UNKNOWN, UNSPECIFIED.
AdGroupCriterionTopicPath String ATRIBUTO A categoria a segmentar ou excluir. Cada elemento subseqüente na matriz descreve uma subcategoria mais específica. Por exemplo, "Pets & Animals", "Pets", "Cães" representa a categoria "Pets & Animals/Pets/Cães".
AdGroupCriterionTopicTopicConstant String ATRIBUTO O nome do recurso da constante de tópico.
AdGroupCriterionTrackingUrlTemplate String ATRIBUTO O modelo de URL para construir um URL de rastreamento.
AdGroupCriterionType String ATRIBUTO Somente saída. O tipo do critério. Os valores permitidos são AD_SCHEDULE, AGE_RANGE, APP_PAYMENT_MODEL, AUDIENCE, CARRIER, COMBINED_AUDIENCE, CONTENT_LABEL, CUSTOM_AFFINITY, CUSTOM_AUDIENCE, CUSTOM_INTENT, DEVICE, GENDER, INCOME_RANGE, IP_BLOCK, KEYWORD, KEYWORD_THEME, LANGUAGE, LISTING_GROUP, LIST ING_SCOPE, LOCATION, LOCATION_GROUP, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, MOBILE_DEVICE, OPERATING_SYSTEM_VERSION, PARENTAL_STATUS, PLACEMENT, PROXIMITY, TOPIC, UNKNOWN, UNSPECIFIED, USER_INTEREST, USER_LIST, WEBPAGE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO.
AdGroupCriterionUrlCustomParameters String ATRIBUTO A lista de mapeamentos usados para substituir tags de parâmetro personalizado em um tracking_url_template, final_urls ou mobile_final_urls.
AdGroupCriterionUserInterestUserInterestCategory String ATRIBUTO O nome do recurso UserInterest.
AdGroupCriterionUserListUserList String ATRIBUTO O nome do recurso Lista de usuários.
AdGroupCriterionWebpageConditions String ATRIBUTO Condições ou expressões lógicas para segmentação de página da web. A lista de condições de segmentação de página da web é agrupada quando avaliada para segmentação. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.
AdGroupCriterionWebpageCoveragePercentage Double ATRIBUTO Porcentagem de cobertura dos critérios do site. Esta é a porcentagem calculada de cobertura do site com base no destino do site, destino do site negativo e palavras-chave negativas no grupo de anúncios e na campanha. Por exemplo, quando a cobertura retorna como 1, indica que tem 100% de cobertura. Este campo é só de leitura.
AdGroupCriterionWebpageCriterionName String ATRIBUTO O nome do critério definido por este parâmetro. O valor do nome será usado para identificar, classificar e filtrar os critérios com esse tipo de parâmetro. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.
AdGroupCriterionWebpageSampleSampleUrls String ATRIBUTO URLs de exemplo de página da Web
AdGroupCriterionYouTubeChannelChannelId String ATRIBUTO O ID do canal do uploader do YouTube ou o código do canal de um canal do YouTube.
AdGroupCriterionYouTubeVideoVideoId String ATRIBUTO ID do vídeo do YouTube conforme aparece na página de exibição do YouTube.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupCriterionCustomizer

Um valor do personalizador para o CustomizerAttribute associado no nível AdGroupCriterion.

Colunas
Nome Tipo Comportamento Descrição
AdGroupCriterionCustomizerAdGroupCriterion String ATRIBUTO Imutável. O critério do grupo de anúncios ao qual o atributo do personalizador está vinculado. Deve ser um critério de palavra-chave.
AdGroupCriterionCustomizerCustomizerAttribute String ATRIBUTO Obrigatório. Imutável. O atributo do personalizador vinculado ao critério do grupo de anúncios.
AdGroupCriterionCustomizerResourceName String ATRIBUTO Imutável. O nome do recurso do personalizador de critérios do grupo de anúncios. Os nomes dos recursos do personalizador de critério do grupo de anúncios têm o seguinte formato: customers/{customer_id}/adGroupCriterionCustomizers/{ad_group_id}~{criterion_id}~{customizer_attribute_id}
AdGroupCriterionCustomizerStatus String ATRIBUTO Somente saída. O status do personalizador de critérios do grupo de anúncios. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
AdGroupCriterionCustomizerValueStringValue String ATRIBUTO Obrigatório. Valor a ser inserido no texto criativo. Os valores do personalizador de todos os tipos são armazenados como string para tornar a formatação inequívoca.
AdGroupCriterionCustomizerValueType String ATRIBUTO Obrigatório. O tipo de dados para o valor do personalizador. Ele deve corresponder ao tipo de atributo. O conteúdo string_value deve corresponder às restrições associadas ao tipo. Os valores permitidos são NÚMERO, PORCENTO, PREÇO, TEXTO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupCriterionLabel

Uma relação entre um critério de grupo de anúncios e um rótulo.

Colunas
Nome Tipo Comportamento Descrição
AdGroupCriterionLabelAdGroupCriterion String ATRIBUTO Imutável. O critério do grupo de anúncios ao qual o rótulo está anexado.
AdGroupCriterionLabelLabel String ATRIBUTO Imutável. O rótulo atribuído ao critério do grupo de anúncios.
AdGroupCriterionLabelResourceName String ATRIBUTO Imutável. O nome do recurso do rótulo do critério do grupo de anúncios. Os nomes dos recursos dos rótulos dos critérios do grupo de anúncios têm o seguinte formato: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupCriterionSimulação

Uma simulação de critério de grupo de anúncios. As combinações suportadas de tipo de canal de publicidade, tipo de critério, tipo de simulação e método de modificação de simulação são detalhadas abaixo, respectivamente. As operações de simulação do Hotel AdGroupCriterion começam na V5. 1. DISPLAY - KEYWORD - CPC_BID - UNIFORM 2. PESQUISA - KEYWORD - CPC_BID - UNIFORME 3. COMPRAS - LISTING_GROUP - CPC_BID - UNIFORME 4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORME 5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORME

Colunas
Nome Tipo Comportamento Descrição
AdGroupCriterionSimulationAdGroupId Long ATRIBUTO Somente saída. ID do AdGroup da simulação.
AdGroupCriterionSimulationCpcBidPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores de lance de CPC.
AdGroupCriterionSimulationCriterionId Long ATRIBUTO Somente saída. ID do critério da simulação.
AdGroupCriterionSimulationEndDate Date ATRIBUTO Somente saída. Último dia em que se baseia a simulação, no formato AAAA-MM-DD.
AdGroupCriterionSimulationModificationMethod String ATRIBUTO Somente saída. Como a simulação modifica o campo. Os valores permitidos são PADRÃO, ESCALA, UNIFORME, DESCONHECIDO, NÃO ESPECIFICADO.
AdGroupCriterionSimulationPercentCpcBidPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores percentuais de lances de CPC.
AdGroupCriterionSimulationResourceName String ATRIBUTO Somente saída. O nome do recurso da simulação do critério do grupo de anúncios. Os nomes dos recursos de simulação de critério do grupo de anúncios têm o formato: customers/{customer_id}/adGroupCriterionSimulations/{ad_group_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}
AdGroupCriterionSimulationStartDate Date ATRIBUTO Somente saída. Primeiro dia em que se baseia a simulação, no formato AAAA-MM-DD.
AdGroupCriterionSimulationType String ATRIBUTO Somente saída. O campo que a simulação modifica. Os valores permitidos são BID_MODIFIER, BUDGET, CPC_BID, CPV_BID, PERCENT_CPC_BID, TARGET_CPA, TARGET_IMPRESSION_SHARE, TARGET_ROAS, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupCustomizer

Um valor personalizador para o CustomizerAttribute associado no nível AdGroup.

Colunas
Nome Tipo Comportamento Descrição
AdGroupCustomizerAdGroup String ATRIBUTO Imutável. O grupo de anúncios ao qual o atributo do personalizador está vinculado.
AdGroupCustomizerCustomizerAttribute String ATRIBUTO Obrigatório. Imutável. O atributo do personalizador vinculado ao grupo de anúncios.
AdGroupCustomizerResourceName String ATRIBUTO Imutável. O nome do recurso do personalizador do grupo de anúncios. Os nomes dos recursos do personalizador do grupo de anúncios têm o formato: customers/{customer_id}/adGroupCustomizers/{ad_group_id}~{customizer_attribute_id}
AdGroupCustomizerStatus String ATRIBUTO Somente saída. O status do personalizador do grupo de anúncios. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
AdGroupCustomizerValueStringValue String ATRIBUTO Obrigatório. Valor a ser inserido no texto criativo. Os valores do personalizador de todos os tipos são armazenados como string para tornar a formatação inequívoca.
AdGroupCustomizerValueType String ATRIBUTO Obrigatório. O tipo de dados para o valor do personalizador. Ele deve corresponder ao tipo de atributo. O conteúdo string_value deve corresponder às restrições associadas ao tipo. Os valores permitidos são NÚMERO, PORCENTO, PREÇO, TEXTO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupExtensionSetting

Uma configuração de extensão de grupo de anúncios.

Colunas
Nome Tipo Comportamento Descrição
AdGroupExtensionSettingAdGroup String ATRIBUTO Imutável. O nome do recurso do grupo de anúncios. Os itens de feed de extensão vinculados serão veiculados neste grupo de anúncios. Os nomes dos recursos AdGroup têm o formato: clientes/{customer_id}/adGroups/{ad_group_id}
AdGroupExtensionSettingDevice String ATRIBUTO O dispositivo para o qual as extensões servirão. Opcional. Os valores permitidos são DESKTOP, MOBILE, UNKNOWN, UNSPECIFIED.
AdGroupExtensionSettingExtensionFeedItems String ATRIBUTO Os nomes dos recursos dos itens de feed de extensão a serem veiculados no grupo de anúncios. Os nomes dos recursos ExtensionFeedItem têm o formato: clientes/{customer_id}/extensionFeedItems/{feed_item_id}
AdGroupExtensionSettingExtensionType String ATRIBUTO Imutável. O tipo de extensão da configuração de extensão do grupo de anúncios. Os valores permitidos são AFFILIATE_LOCATION, APP, CALL, CALLOUT, HOTEL_CALLOUT, IMAGE, LOCATION, MESSAGE, NONE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
AdGroupExtensionSettingResourceName String ATRIBUTO Imutável. O nome do recurso da configuração de extensão do grupo de anúncios. Os nomes dos recursos AdGroupExtensionSetting têm o formato: customers/{customer_id}/adGroupExtensionSettings/{ad_group_id}~{extension_type}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupFeed

Um feed de grupo de anúncios.

Colunas
Nome Tipo Comportamento Descrição
AdGroupFeedAdGroup String ATRIBUTO Imutável. O grupo de anúncios vinculado ao feed.
AdGroupFeedFeed String ATRIBUTO Imutável. O feed sendo vinculado ao grupo de anúncios.
AdGroupFeedMatchingFunctionFunctionString String ATRIBUTO Representação de string da função. Exemplos: 1. IDENTIDADE(verdadeiro) ou IDENTIDADE(falso). Todos ou nenhum item de feed foi veiculado. 2. EQUALS(CONTEXT.DEVICE, "Mobile") 3. IN(FEED_ITEM_ID, {1000001, 1000002, 1000003}) 4. CONTAINS_ANY(FeedAttribute[12345678, 0], {"Mars cruise", "Venus cruise"}) 5. AND(IN(FEED_ITEM_ID, {10001, 10002}), EQUALS(CONTEXT.DEVICE, "Mobile")) Para mais detalhes, visite https://developers.google.com/adwords/api/docs/guides/feed-matching-functions observe que, como várias strings podem representar a mesma função subjacente (espaço em branco e aspas simples versus aspas duplas, por exemplo), o valor retornado pode não ser idêntico à string enviada em uma solicitação mutate.
AdGroupFeedMatchingFunctionLeftOperands String ATRIBUTO Os operandos no lado esquerdo da equação. Este também é o operando a ser usado para expressões de operando único, como NOT.
AdGroupFeedMatchingFunctionOperator String ATRIBUTO Operador para uma função. Os valores permitidos são AND, CONTAINS_ANY, EQUALS, IDENTITY, IN, UNKNOWN, UNSPECIFIED.
AdGroupFeedMatchingFunctionRightOperands String ATRIBUTO Os operandos no lado direito da equação.
AdGroupFeedPlaceholderTypes String ATRIBUTO Indica quais tipos de espaço reservado o feed pode preencher no grupo de anúncios conectado. Obrigatório. Os valores permitidos são AD_CUSTOMIZER, AFFILIATE_LOCATION, APP, CALL, CALLOUT, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHT, DYNAMIC_HOTEL, DYNAMIC_JOB, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, IMAGE, LOCATION, MESSAGE, PRICE, PROMOÇÃO, SITELINK, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO.
AdGroupFeedResourceName String ATRIBUTO Imutável. O nome do recurso do feed do grupo de anúncios. Os nomes dos recursos de feed do grupo de anúncios têm o formato: `customers/{customer_id}/adGroupFeeds/{ad_group_id}~{feed_id}
AdGroupFeedStatus Corda ATTRIBUTE Output only. Status of the ad group feed. This field is read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
Identificação do Cliente Longo ATTRIBUTE Output only. The ID of the customer.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdGroupLabel

Uma relação entre um grupo de anúncios e um rótulo.

Colunas
Nome Tipo Comportamento Descrição
AdGroupLabelAdGroup String ATRIBUTO Imutável. O grupo de anúncios ao qual o rótulo está anexado.
AdGroupLabelLabel String ATRIBUTO Imutável. O rótulo atribuído ao grupo de anúncios.
AdGroupLabelResourceName String ATRIBUTO Imutável. O nome do recurso do rótulo do grupo de anúncios. Os nomes dos recursos de rótulos do grupo de anúncios têm o formato: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Simulação de Grupo de Anúncios

Uma simulação de grupo de anúncios. As combinações suportadas de tipo de canal de publicidade, tipo de simulação e método de modificação de simulação são detalhadas abaixo, respectivamente. 1. PESQUISA - CPC_BID - PADRÃO 2. PESQUISA - CPC_BID - UNIFORME 3. PESQUISA - TARGET_CPA - UNIFORME 4. PESQUISA - TARGET_ROAS - UNIFORME 5. DISPLAY - CPC_BID - PADRÃO 6. DISPLAY - CPC_BID - UNIFORME 7. DISPLAY - TARGET_CPA - UNIFORME

Colunas
Nome Tipo Comportamento Descrição
AdGroupSimulationAdGroupId Long ATRIBUTO Somente saída. ID do grupo de anúncios da simulação.
AdGroupSimulationCpcBidPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores de lance de CPC.
AdGroupSimulationCpvBidPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores de lances de CPV.
AdGroupSimulationEndDate Date ATRIBUTO Somente saída. Último dia em que se baseia a simulação, no formato AAAA-MM-DD
AdGroupSimulationModificationMethod String ATRIBUTO Somente saída. Como a simulação modifica o campo. Os valores permitidos são PADRÃO, ESCALA, UNIFORME, DESCONHECIDO, NÃO ESPECIFICADO.
AdGroupSimulationResourceName String ATRIBUTO Somente saída. O nome do recurso da simulação do grupo de anúncios. Os nomes dos recursos de simulação do grupo de anúncios têm o formato: customers/{customer_id}/adGroupSimulations/{ad_group_id}~{type}~{modification_method}~{start_date}~{end_date}
AdGroupSimulationStartDate Date ATRIBUTO Somente saída. Primeiro dia em que se baseia a simulação, no formato AAAA-MM-DD.
AdGroupSimulationTargetCpaPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores de CPA desejados.
AdGroupSimulationTargetRoasPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores de ROAS desejados.
AdGroupSimulationType String ATRIBUTO Somente saída. O campo que a simulação modifica. Os valores permitidos são BID_MODIFIER, BUDGET, CPC_BID, CPV_BID, PERCENT_CPC_BID, TARGET_CPA, TARGET_IMPRESSION_SHARE, TARGET_ROAS, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdParameter

Um parâmetro de anúncio usado para atualizar valores numéricos (como preços ou níveis de estoque) em qualquer linha de texto de um anúncio (incluindo URLs). Pode haver no máximo dois AdParameters por critério de grupo de anúncios. (Um com parameter_index = 1 e outro com parameter_index = 2.) No anúncio, os parâmetros são referenciados por um espaço reservado no formato "{param#:value}". Por exemplo, "{param1:$17}"

Colunas
Nome Tipo Comportamento Descrição
AdParameterAdGroupCriterion String ATRIBUTO Imutável. O critério do grupo de anúncios ao qual esse parâmetro de anúncio pertence.
AdParameterInsertionText String ATRIBUTO Valor numérico a ser inserido no texto do anúncio. As seguintes restrições se aplicam: - Pode usar vírgula ou ponto como separador, com ponto ou vírgula opcional (respectivamente) para valores fracionários. Por exemplo, 1, 000, 000,00 e 2.000.000, 10 são válidos. - Pode ser anexado ou anexado com um símbolo de moeda. Por exemplo, $ 99,99 é válido. - Pode ser anexado ou anexado com um código de moeda. Por exemplo, 99,99USD e EUR200 são válidos. - Pode usar '%'. Por exemplo, 1,0% e 1,0% são válidos. - Pode usar mais ou menos. Por exemplo, -10,99 e 25+ são válidos. - Pode usar '/' entre dois números. Por exemplo, 4/1 e 0,95/0,45 são válidos.
AdParameterParameterIndex Long ATRIBUTO Imutável. O índice exclusivo desse parâmetro de anúncio. Deve ser 1 ou 2.
AdParameterResourceName String ATRIBUTO Imutável. O nome do recurso do parâmetro de anúncio. Os nomes dos recursos de parâmetro de anúncio têm o formato: customers/{customer_id}/adParameters/{ad_group_id}~{criterion_id}~{parameter_index}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AdScheduleView

Uma exibição de programação de anúncios resume o desempenho das campanhas por critérios do AdSchedule.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
AdScheduleViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização da programação de anúncios. Os nomes dos recursos de exibição do AdSchedule têm o formato: clientes/{customer_id}/adScheduleViews/{campaign_id}~{criterion_id}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AgeRangeView

Uma visão de faixa etária.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
AgeRangeViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização da faixa etária. Os nomes dos recursos de exibição de faixa etária têm o formato: customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de exibição.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Ativo

O ativo é uma parte de um anúncio que pode ser compartilhado em vários anúncios. Pode ser uma imagem (ImageAsset), um vídeo (YouTubeVideoAsset) etc. Os ativos são imutáveis e não podem ser removidos. Para interromper a veiculação de um ativo, remova o ativo da entidade que o está usando.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
AssetBookOnGoogleAsset String ATRIBUTO Um livro sobre ativos do Google.
AssetCallAssetAdScheduleTargets String ATRIBUTO Lista de programações não sobrepostas especificando todos os intervalos de tempo para os quais o ativo pode servir. Pode haver no máximo 6 horários por dia, 42 no total.
AssetCallAssetCallConversionAction String ATRIBUTO A ação de conversão à qual atribuir uma conversão de chamada. Se não for definido, a ação de conversão padrão será usada. Este campo só tem efeito se call_conversion_reporting_state for definido como USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
AssetCallAssetCallConversionReportingState String ATRIBUTO Indica se este CallAsset deve usar sua própria configuração de conversão de chamada, seguir a configuração de nível de conta ou desabilitar a conversão de chamada. Os valores permitidos são DISABLED, UNKNOWN, UNSPECIFIED, USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION, USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
AssetCallAssetCountryCode String ATRIBUTO Obrigatório. Código de país de duas letras do número de telefone. Exemplos: 'EUA', 'nós'.
AssetCallAssetPhoneNumber String ATRIBUTO Obrigatório. O número de telefone bruto do anunciante. Exemplos: '1234567890', '(123)456-7890'
AssetCallToActionAssetCallToAction String ATRIBUTO Chamada à ação. Os valores permitidos são APPLY_NOW, BOOK_NOW, CONTACT_US, DOWNLOAD, GET_QUOTE, LEARN_MORE, SHOP_NOW, SIGN_UP, SUBSCRIBE, UNKNOWN, UNSPECIFIED.
AssetCalloutAssetAdScheduleTargets String ATRIBUTO Lista de programações não sobrepostas especificando todos os intervalos de tempo para os quais o ativo pode servir. Pode haver no máximo 6 horários por dia, 42 no total.
AssetCalloutAssetCalloutText String ATRIBUTO Obrigatório. O texto explicativo. O comprimento desta string deve estar entre 1 e 25, inclusive.
AssetCalloutAssetEndDate Date ATRIBUTO Última data em que este recurso está em vigor e ainda está em exibição, no formato aaaa-MM-dd.
AssetCalloutAssetStartDate Date ATRIBUTO Data de início de quando este recurso entra em vigor e pode começar a ser veiculado, no formato aaaa-MM-dd.
AssetDynamicEducationAssetAddress String ATRIBUTO Endereço da escola que pode ser especificado em um dos seguintes formatos. (1) Cidade, estado, código, país, por ex. Mountain View, CA, EUA. (2) Endereço completo, por ex. 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude no formato DDD, por ex. 41.40338, 2.17403
AssetDynamicEducationAssetAndroidAppLink String ATRIBUTO Link direto do Android, por exemplo android-app://com.example.android/http/example.com/gizmos?1234.
AssetDynamicEducationAssetContextualKeywords String ATRIBUTO Palavras-chave contextuais, por exemplo Certificação de enfermagem, Saúde, Mountain View.
AssetDynamicEducationAssetImageUrl String ATRIBUTO URL da imagem, por exemplo http://www.example.com/image.png. A imagem não será carregada como recurso de imagem.
AssetDynamicEducationAssetIosAppLink String ATRIBUTO Link direto do iOS, por exemplo exampleApp://content/page.
AssetDynamicEducationAssetIosAppStoreId Long ATRIBUTO ID da loja de aplicativos iOS. Isso é usado para verificar se o usuário tem o aplicativo instalado em seu dispositivo antes do link direto. Se esse campo for definido, o campo ios_app_link também deverá estar presente.
AssetDynamicEducationAssetLocationId String ATRIBUTO ID do local, que pode ser qualquer sequência de letras e dígitos e deve ser exclusivo.
AssetDynamicEducationAssetProgramDescription String ATRIBUTO Descrição do programa, por exemplo Certificação de Enfermagem.
AssetDynamicEducationAssetProgramId String ATRIBUTO Obrigatório. ID do programa, que pode ser qualquer sequência de letras e dígitos, e deve ser exclusivo e corresponder aos valores da tag de remarketing. Obrigatório.
AssetDynamicEducationAssetProgramName String ATRIBUTO Obrigatório. Nome do programa, por exemplo Enfermagem. Obrigatório.
AssetDynamicEducationAssetSchoolName String ATRIBUTO Nome da escola, por exemplo Escola de Enfermagem de Mountain View.
AssetDynamicEducationAssetSimilarProgramIds String ATRIBUTO IDs de programas semelhantes.
AssetDynamicEducationAssetSubject String ATRIBUTO Objeto de estudo, por ex. Saúde.
AssetDynamicEducationAssetThumbnailImageUrl String ATRIBUTO URL da imagem em miniatura, por exemplo http://www.example.com/thumbnail.png. A imagem em miniatura não será carregada como recurso de imagem.
AssetFinalMobileUrls String ATRIBUTO Uma lista de possíveis URLs finais para dispositivos móveis após todos os redirecionamentos entre domínios.
AssetFinalUrlSuffix String ATRIBUTO Modelo de URL para anexar parâmetros a URLs de página de aterrissagem veiculados com rastreamento paralelo.
AssetFinalUrls String ATRIBUTO Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios.
AssetHotelCalloutAssetLanguageCode String ATRIBUTO Obrigatório. O idioma da chamada do hotel. Representado como tag de idioma BCP 47.
AssetHotelCalloutAssetText String ATRIBUTO Obrigatório. O texto do recurso de frase de destaque do hotel. O comprimento desta string deve estar entre 1 e 25, inclusive.
AssetId Long ATRIBUTO Somente saída. O ID do recurso.
AssetImageAssetFileSize Long ATRIBUTO Tamanho do arquivo do recurso de imagem em bytes.
AssetImageAssetFullSizeHeightPixels Long ATRIBUTO Altura da imagem.
AssetImageAssetFullSizeUrl String ATRIBUTO Uma URL que retorna a imagem com esta altura e largura.
AssetImageAssetFullSizeWidthPixels Long ATRIBUTO Largura da imagem.
AssetImageAssetMimeType String ATRIBUTO Tipo MIME do recurso de imagem. Os valores permitidos são AUDIO_MP3, AUDIO_WAV, FLASH, HTML5_AD_ZIP, IMAGE_GIF, IMAGE_JPEG, IMAGE_PNG, MSEXCEL, MSWORD, PDF, RTF, TEXT_HTML, UNKNOWN, UNSPECIFIED.
AssetLeadFormAssetBackgroundImageAsset String ATRIBUTO Nome do recurso de recurso da imagem de plano de fundo. O tamanho mínimo é 600 x 314 e a proporção deve ser 1,91:1 (+-1%).
AssetLeadFormAssetBusinessName String ATRIBUTO Obrigatório. O nome da empresa que está sendo anunciada.
AssetLeadFormAssetCallToActionDescription String ATRIBUTO Obrigatório. Texto com uma proposta de valor clara do que os usuários esperam quando expandem o formulário.
AssetLeadFormAssetCallToActionType String ATRIBUTO Obrigatório. Texto de exibição predefinido que incentiva o usuário a expandir o formulário. Os valores permitidos são APPLY_NOW, BOOK_NOW, CONTACT_US, DOWNLOAD, GET_INFO, GET_OFFER, GET_QUOTE, GET_STARTED, JOIN_NOW, LEARN_MORE, REGISTER, REQUEST_DEMO, SIGN_UP, SUBSCRIBE, UNKNOWN, UNSPECIFIED.
AssetLeadFormAssetCustomDisclosure String ATRIBUTO Divulgação personalizada exibida junto com o aviso de isenção de responsabilidade do Google no formulário de lead. Acessível apenas a clientes permitidos.
AssetLeadFormAssetDeliveryMethods String ATRIBUTO Métodos configurados para dados de leads coletados a serem entregues ao anunciante. Apenas um método digitado como WebhookDelivery pode ser configurado.
AssetLeadFormAssetDescription String ATRIBUTO Obrigatório. Descrição detalhada do formulário expandido para descrever o que o formulário está pedindo ou facilitando.
AssetLeadFormAssetDesiredIntent String ATRIBUTO Intenção desejada para o formulário de lead, por exemplo mais volume ou mais qualificado. Os valores permitidos são HIGH_INTENT, LOW_INTENT, UNKNOWN, UNSPECIFIED.
AssetLeadFormAssetFields String ATRIBUTO Lista ordenada de campos de entrada.
AssetLeadFormAssetHeadline String ATRIBUTO Obrigatório. Título do formulário expandido para descrever o que o formulário está pedindo ou facilitando.
AssetLeadFormAssetPostSubmitCallToActionType String ATRIBUTO Texto de exibição predefinido que incentiva a ação do usuário após o envio do formulário. Os valores permitidos são DOWNLOAD, LEARN_MORE, SHOP_NOW, UNKNOWN, UNSPECIFIED, VISIT_SITE.
AssetLeadFormAssetPostSubmitDescription String ATRIBUTO Descrição detalhada mostrada após o envio do formulário que descreve como o anunciante fará o acompanhamento do usuário.
AssetLeadFormAssetPostSubmitHeadline String ATRIBUTO Título do texto exibido após o envio do formulário que descreve como o anunciante fará o acompanhamento do usuário.
AssetLeadFormAssetPrivacyPolicyUrl String ATRIBUTO Obrigatório. Link para uma página que descreve a política de como os dados coletados são tratados pelo anunciante/empresa.
AssetMobileAppAssetAppId String ATRIBUTO Obrigatório. Uma cadeia de caracteres que identifica exclusivamente um aplicativo móvel. Ele deve conter apenas o ID nativo da plataforma, como "com.android.ebay" para Android ou "12345689" para iOS.
AssetMobileAppAssetAppStore String ATRIBUTO Obrigatório. A loja de aplicativos que distribui esse aplicativo específico. Os valores permitidos são APPLE_APP_STORE, GOOGLE_APP_STORE, UNKNOWN, UNSPECIFIED.
AssetMobileAppAssetEndDate Date ATRIBUTO Última data em que este recurso está em vigor e ainda está em exibição, no formato aaaa-MM-dd.
AssetMobileAppAssetLinkText String ATRIBUTO Obrigatório. O texto visível exibido quando o link é renderizado em um anúncio. O comprimento desta string deve estar entre 1 e 25, inclusive.
AssetMobileAppAssetStartDate Date ATRIBUTO Data de início de quando este recurso entra em vigor e pode começar a ser veiculado, no formato aaaa-MM-dd.
AssetName String ATRIBUTO Nome opcional do recurso.
AssetPageFeedAssetLabels String ATRIBUTO Rótulos usados para agrupar os URLs da página.
AssetPageFeedAssetPageUrl String ATRIBUTO Obrigatório. A página da Web que os anunciantes desejam segmentar.
AssetPolicySummaryApprovalStatus String ATRIBUTO Somente saída. O status de aprovação geral desse ativo, calculado com base no status de suas entradas de tópico de política individuais. Os valores permitidos são APPROVED, APPROVED_LIMITED, AREA_OF_INTEREST_ONLY, DISAPPROVED, UNKNOWN, UNSPECIFIED.
AssetPolicySummaryPolicyTopicEntries String ATRIBUTO Somente saída. A lista de descobertas de política para este recurso.
AssetPolicySummaryReviewStatus String ATRIBUTO Somente saída. Onde no processo de revisão este ativo está. Os valores permitidos são ELIGIBLE_MAY_SERVE, REVIEWED, REVIEW_IN_PROGRESS, UNDER_APPEAL, UNKNOWN, UNSPECIFIED.
AssetPriceAssetLanguageCode String ATRIBUTO Obrigatório. A linguagem do ativo de preço. Representado como tag de idioma BCP 47.
AssetPriceAssetPriceOfferings String ATRIBUTO As ofertas de preço do ativo de preço. O tamanho desta coleção deve estar entre 3 e 8, inclusive.
AssetPriceAssetPriceQualifier String ATRIBUTO O qualificador de preço do ativo de preço. Os valores permitidos são AVERAGE, FROM, UNKNOWN, UNSPECIFIED, UP_TO.
AssetPriceAssetType String ATRIBUTO Obrigatório. O tipo do ativo de preço. Os valores permitidos são BRANDS, EVENTS, LOCATIONS, NEIGHBORHOODS, PRODUCT_CATEGORIES, PRODUCT_TIERS, SERVICES, SERVICE_CATEGORIES, SERVICE_TIERS, UNKNOWN, UNSPECIFED.
AssetPromotionAssetAdScheduleTargets String ATRIBUTO Lista de programações não sobrepostas especificando todos os intervalos de tempo para os quais o ativo pode servir. Pode haver no máximo 6 horários por dia, 42 no total.
AssetPromotionAssetDiscountModifier String ATRIBUTO Um modificador para qualificação do desconto. Os valores permitidos são UNKNOWN, UNSPECIFIED, UP_TO.
AssetPromotionAssetEndDate Date ATRIBUTO Última data em que este recurso está em vigor e ainda está em exibição, no formato aaaa-MM-dd.
AssetPromotionAssetLanguageCode String ATRIBUTO O idioma da promoção. Representado como tag de idioma BCP 47.
AssetPromotionAssetMoneyAmountOffAmountMicros Long ATRIBUTO Quantidade em micros. Um milhão é equivalente a uma unidade.
AssetPromotionAssetMoneyAmountOffCurrencyCode String ATRIBUTO Código de moeda ISO 4217 de três caracteres.
AssetPromotionAssetOccasion String ATRIBUTO A ocasião a que se destinava a promoção. Se uma ocasião for definida, a janela de resgate precisará estar dentro do intervalo de datas associado à ocasião. Os valores permitidos são BACK_TO_SCHOOL, BLACK_FRIDAY, BOXING_DAY, CARNIVAL, CHINESE_NEW_YEAR, CHRISTMAS, CYBER_MONDAY, DIWALI, EASTER, EID_AL_ADHA, EID_AL_FITR, END_OF_SEASON, EPIPHANY, FALL_SALE, FATHERS_DAY, HALLOWEEN, HANUKKAH, HOLI, INDEP ENDENCE_DAY, LABOR_DAY, MOTHERS_DAY, NATIONAL_DAY, NAVRATRI, NEW_YEARS, PARENTS_DAY, PASSOVER, RAMADAN, ROSH_HASHANAH, SINGLES_DAY, SONGKRAN, SPRING_SALE, ST_NICHOLAS_DAY, SUMMER_SALE, UNKNOWN, UNSPECIFIED, VALENTINES_DAY, WINTER_SALE, WOMENS_DAY, YEAR_END_GIFT.
AssetPromotionAssetOrdersOverAmountAmountMicros Long ATRIBUTO Quantidade em micros. Um milhão é equivalente a uma unidade.
AssetPromotionAssetOrdersOverAmountCurrencyCode String ATRIBUTO Código de moeda ISO 4217 de três caracteres.
AssetPromotionAssetPercentOff Long ATRIBUTO Porcentagem de desconto na promoção. 1, 000, 000 = 100%. Isso ou money_amount_off é obrigatório.
AssetPromotionAssetPromotionCode String ATRIBUTO Um código que o usuário deve usar para se qualificar para a promoção.
AssetPromotionAssetPromotionTarget String ATRIBUTO Obrigatório. Uma descrição de forma livre do alvo da promoção.
AssetPromotionAssetRedemptionEndDate Date ATRIBUTO Última data em que a promoção está qualificada para ser resgatada, no formato aaaa-MM-dd.
AssetPromotionAssetRedemptionStartDate Date ATRIBUTO Data de início em que a promoção é elegível para resgate, no formato aaaa-MM-dd.
AssetPromotionAssetStartDate Date ATRIBUTO Data de início de quando este recurso entra em vigor e pode começar a ser veiculado, no formato aaaa-MM-dd.
AssetResourceName String ATRIBUTO Imutável. O nome do recurso do ativo. Os nomes dos recursos de ativos têm o formato: clientes/{customer_id}/assets/{asset_id}
AssetSitelinkAssetAdScheduleTargets String ATRIBUTO Lista de programações não sobrepostas especificando todos os intervalos de tempo para os quais o ativo pode servir. Pode haver no máximo 6 horários por dia, 42 no total.
AssetSitelinkAssetDescription1 String ATRIBUTO Primeira linha da descrição do sitelink. Se definido, o comprimento deve estar entre 1 e 35, inclusive, e a descrição2 também deve ser definida.
AssetSitelinkAssetDescription2 String ATRIBUTO Segunda linha da descrição do sitelink. Se definido, o comprimento deve estar entre 1 e 35, inclusive, e a descrição1 também deve ser definida.
AssetSitelinkAssetEndDate Date ATRIBUTO Última data em que este recurso está em vigor e ainda está em exibição, no formato aaaa-MM-dd.
AssetSitelinkAssetLinkText String ATRIBUTO Obrigatório. Texto de exibição do URL para o sitelink. O comprimento desta string deve estar entre 1 e 25, inclusive.
AssetSitelinkAssetStartDate Date ATRIBUTO Data de início de quando este recurso entra em vigor e pode começar a ser veiculado, no formato aaaa-MM-dd.
AssetStructuredSnippetAssetHeader String ATRIBUTO Obrigatório. O cabeçalho do trecho. Esta string deve ser um dos valores predefinidos em https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers
AssetStructuredSnippetAssetValues String ATRIBUTO Obrigatório. Os valores no snippet. O tamanho desta coleção deve estar entre 3 e 10, inclusive. O comprimento de cada valor deve estar entre 1 e 25 caracteres, inclusive.
AssetTextAssetText String ATRIBUTO Conteúdo de texto do recurso de texto.
AssetTrackingUrlTemplate String ATRIBUTO Modelo de URL para construir um URL de rastreamento.
AssetType String ATRIBUTO Somente saída. Tipo do ativo. Os valores permitidos são BOOK_ON_GOOGLE, CALL, CALLOUT, CALL_TO_ACTION, DYNAMIC_EDUCATION, HOTEL_CALLOUT, IMAGE, LEAD_FORM, MEDIA_BUNDLE, MOBILE_APP, PAGE_FEED, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, TEXT, UNKNOWN, UNSPECIFIED, YOUTUBE_VIDEO.
AssetUrlCustomParameters String ATRIBUTO Uma lista de mapeamentos a serem usados para substituir tags de parâmetro personalizado de URL em tracking_url_template, final_urls e/ou final_mobile_urls.
AssetYouTubeVideoAssetYouTubeVideoId String ATRIBUTO ID do vídeo do YouTube. Este é o valor da string de 11 caracteres usado no URL do vídeo do YouTube.
AssetYouTubeVideoAssetYouTubeVideoTitle String ATRIBUTO Título do vídeo do YouTube.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
ConversionAdjustment Bool SEGMENTO Isso segmenta suas colunas de conversão pela conversão original e pelo valor da conversão em comparação com o delta se as conversões forem ajustadas. A linha falsa contém os dados conforme declarados originalmente; Embora a linha verdadeira tenha o delta entre os dados agora e os dados originalmente declarados. A soma dos dois resulta em dados pós-ajuste.
ConversionLagBucket String SEGMENTO Um valor de enumeração que representa o número de dias entre a impressão e a conversão. Os valores permitidos são EIGHT_TO_NINE_DAYS, ELEVEN_TO_TWELVE_DAYS, FIVE_TO_SIX_DAYS, FORTY_FIVE_TO_SIXTY_DAYS, FOURTEEN_TO_TWENTY_ONE_DAYS, FOUR_TO_FIVE_DAYS, LESS_THAN_ONE_DAY, NINE_TO_TEN_DAYS, ONE_TO_TWO_DAYS, SEVEN_TO_EIGHT_DAYS S, SEXTY_TO_NINETY_DAYS, SIX_TO_SEVEN_DAYS, TEN_TO_ELEVEN_DAYS, TREZE_TO_FOURTEEN_DAYS, TRINTA_TO_FORTY_FIVE_DAYS, TRÊS_TO_FOUR_DAYS, DOZE_TO_THIRTEEN_DAYS, TWENTY_ONE_TO_THIRTY_DAYS, DOIS_TO_THREE_DAYS, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionOrAdjustmentLagBucket String SEGMENTO Um valor de enumeração que representa o número de dias entre a impressão e a conversão ou entre a impressão e os ajustes na conversão. Os valores permitidos são ADJUSTMENT_EIGHT_TO_NINE_DAYS, ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS, ADJUSTMENT_FIVE_TO_SIX_DAYS, ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS, ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS, ADJUSTMENT_FOUR_TO_FIVE_DAYS, ADJUSTMENT_LESS_THAN_ONE_DAY, ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS, ADJUSTMENT_NINE_TO_TEN_DAYS, ADJUSTMENT_ONE_TO_TWO_DAYS, ADJUSTMENT_SEVEN_TO_EIGHT_DAYS, ADJUSTMENT_SIXTY_TO_NINETY_DAYS, ADJUSTMENT_SIX_TO_SEVEN_DAYS, ADJUSTMENT_TEN_TO_ELEVEN_DAYS, ADJUSTMENT_THIRTEEN_ TO_FOURTEEN_DAYS, ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS, ADJUSTMENT_THREE_TO_FOUR_DAYS, ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS, ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS, ADJUSTMENT_TWO_TO_THREE_DAYS, ADJUSTMENT_UNKNOWN, CONVERSION_EIGHT_TO_NINE_DAYS, CONVERSION_ELEVEN_TO_TWELVE_DAYS, CONVERSION_FIVE_TO_SIX_DAYS, CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS, CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS, CONVERSION_FOUR_TO_FIVE_DAYS, CONVERSION_LESS_THAN_ONE_DAY, CONVERSION_NINE_TO_TEN_DAYS, CONVERSION_ONE_TO_TWO_DAYS, CONVERSION_SEVEN_TO_ OITO_DIAS, CONVERSION_SIXTY_TO_NINETY_DAYS, CONVERSION_SIX_TO_SEVEN_DAYS, CONVERSION_TEN_TO_ELEVEN_DAYS, CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS, CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS, CONVERSION_THREE_TO_FOUR_DAYS, CONVERSION_TWELVE_TO_THIRTEEN_DAYS, CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS, CONVERSION_TWO_TO_THREE_DAYS, CONVERSION_UNKNOWN, DESCONHECIDO, NÃO ESPECIFICADO.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AssetFieldTypeView

Uma exibição de tipo de campo de ativo. Esta exibição relata métricas não contadas em excesso para cada tipo de campo de ativo quando o ativo é usado como extensão.

Colunas
Nome Tipo Comportamento Descrição
AssetFieldTypeViewFieldType String ATRIBUTO Somente saída. O tipo de campo de ativo da visualização do tipo de campo de ativo. Os valores permitidos são BOOK_ON_GOOGLE, BUSINESS_NAME, CALL, CALLOUT, CALL_TO_ACTION_SELECTION, DESCRIPTION, HEADLINE, HOTEL_CALLOUT, LANDSCAPE_LOGO, LEAD_FORM, LOGO, LONG_HEADLINE, MANDATORY_AD_TEXT, MARKETING_IMAGE, MEDIA_BUNDLE, MOBILE_APP, PORTRAIT_MARKETING_IMAGE, PRICE, PROMOÇÃO, SITELINK, SQUARE_MARKETING_IMAGE, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO, VÍDEO, YOUTUBE_VIDEO.
AssetFieldTypeViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição do tipo de campo de ativo. Os nomes dos recursos de exibição de tipo de campo de ativo têm o formato: customers/{customer_id}/assetFieldTypeViews/{field_type}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
PhoneCalls Long MÉTRICA Número de chamadas telefônicas off-line.
PhoneImpressions Long MÉTRICA Número de impressões telefônicas off-line.
PhoneThroughRate Double MÉTRICA Número de chamadas telefônicas recebidas (phone_calls) dividido pelo número de vezes que seu número de telefone é exibido (phone_impressions).
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AssetGroup

Um grupo de ativos. AssetGroupAsset será usado para vincular um ativo ao grupo de ativos. AssetGroupHint será usado para associar uma dica a um grupo de ativos.

Colunas
Nome Tipo Comportamento Descrição
AssetGroupCampaign String ATRIBUTO Imutável. A campanha à qual este grupo de recursos está associado. O ativo que está vinculado ao grupo de ativos.
AssetGroupFinalMobileUrls String ATRIBUTO Uma lista de URLs móveis finais após todos os redirecionamentos entre domínios. No desempenho máximo, por padrão, os URLs serão qualificados para expansão, a menos que sejam desativados.
AssetGroupFinalUrls String ATRIBUTO Uma lista de URLs finais após todos os redirecionamentos entre domínios. No desempenho máximo, por padrão, os URLs serão qualificados para expansão, a menos que sejam desativados.
AssetGroupId Long ATRIBUTO Somente saída. O ID do grupo de ativos.
AssetGroupName String ATRIBUTO Obrigatório. Nome do grupo de ativos. Obrigatório. Deve ter um comprimento mínimo de 1 e comprimento máximo de 128. Deve ser único em uma campanha.
AssetGroupPath1 String ATRIBUTO Primeira parte do texto que pode aparecer anexada ao URL exibido no anúncio.
AssetGroupPath2 String ATRIBUTO Segunda parte do texto que pode aparecer anexada ao URL exibido no anúncio. Este campo só pode ser definido quando path1 é definido.
AssetGroupResourceName String ATRIBUTO Imutável. O nome do recurso do grupo de ativos. Os nomes dos recursos do grupo de ativos têm o formato: customers/{customer_id}/assetGroups/{asset_group_id}
AssetGroupStatus String ATRIBUTO O status do grupo de ativos. Os valores permitidos são ATIVADO, PAUSADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AssetGroupAsset

AssetGroupAsset é o link entre um ativo e um grupo de ativos. Adicionar um AssetGroupAsset vincula um ativo a um grupo de ativos.

Colunas
Nome Tipo Comportamento Descrição
AssetGroupAssetAsset String ATRIBUTO Imutável. O recurso ao qual esse recurso de grupo de recursos está vinculado.
AssetGroupAssetAssetGroup String ATRIBUTO Imutável. O grupo de recursos ao qual esse recurso de grupo de recursos está vinculado.
AssetGroupAssetFieldType String ATRIBUTO A descrição da colocação do ativo dentro do grupo de ativos. Ex.: HEADLINE, YOUTUBE_VIDEO etc. Os valores permitidos são BOOK_ON_GOOGLE, BUSINESS_NAME, CALL, CALLOUT, CALL_TO_ACTION_SELECTION, DESCRIPTION, HEADLINE, HOTEL_CALLOUT, LANDSCAPE_LOGO, LEAD_FORM, LOGO, LONG_HEADLINE, MANDATORY_AD_TEXT, MARKETING_IMAGE, MEDIA_BUNDLE, MOBILE_ APP, PORTRAIT_MARKETING_IMAGE, PREÇO, PROMOÇÃO, SITELINK, SQUARE_MARKETING_IMAGE, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO, VÍDEO, YOUTUBE_VIDEO.
AssetGroupAssetPerformanceLabel String ATRIBUTO Somente saída. O desempenho deste recurso de grupo de recursos. Os valores permitidos são BEST, GOOD, LEARNING, LOW, PENDING, UNKNOWN, UNSPECIFIED.
AssetGroupAssetPolicySummaryApprovalStatus String ATRIBUTO O status de aprovação geral, que é calculado com base no status de suas entradas de tópico de política individuais. Os valores permitidos são APPROVED, APPROVED_LIMITED, AREA_OF_INTEREST_ONLY, DISAPPROVED, UNKNOWN, UNSPECIFIED.
AssetGroupAssetPolicySummaryPolicyTopicEntries String ATRIBUTO A lista de descobertas de políticas.
AssetGroupAssetPolicySummaryReviewStatus String ATRIBUTO Onde no processo de revisão o recurso está. Os valores permitidos são ELIGIBLE_MAY_SERVE, REVIEWED, REVIEW_IN_PROGRESS, UNDER_APPEAL, UNKNOWN, UNSPECIFIED.
AssetGroupAssetResourceName String ATRIBUTO Imutável. O nome do recurso do ativo do grupo de ativos. O nome do recurso do grupo de ativos tem o formato: customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
AssetGroupAssetStatus String ATRIBUTO O status do link entre um ativo e um grupo de ativos. Os valores permitidos são ATIVADO, PAUSADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AssetGroupListingGroupFilter

AssetGroupListingGroupFilter representa um nó de árvore de filtro de grupo de listagem em um grupo de ativos.

Colunas
Nome Tipo Comportamento Descrição
AssetGroupListingGroupFilterAssetGroup String ATRIBUTO Imutável. O grupo de recursos do qual este filtro de grupo de listagem de grupos de recursos faz parte.
AssetGroupListingGroupFilterCaseValueProductBiddingCategoryId Long ATRIBUTO ID da categoria de lance do produto. Este ID é equivalente ao ID google_product_category conforme descrito neste artigo: https://support.google.com/merchants/answer/6324436
AssetGroupListingGroupFilterCaseValueProductBiddingCategoryLevel String ATRIBUTO Indica o nível da categoria na taxonomia. Os valores permitidos são LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5, UNKNOWN, UNSPECIFIED.
AssetGroupListingGroupFilterCaseValueProductBrandValue String ATRIBUTO Valor da string da marca do produto.
AssetGroupListingGroupFilterCaseValueProductChannelChannel String ATRIBUTO Valor da localidade. Os valores permitidos são LOCAL, ONLINE, DESCONHECIDO, NÃO ESPECIFICADO.
AssetGroupListingGroupFilterCaseValueProductConditionCondition String ATRIBUTO Valor da condição. Os valores permitidos são NOVO, RECONHECIDO, DESCONHECIDO, NÃO ESPECIFICADO, USADO.
AssetGroupListingGroupFilterCaseValueProductCustomAttributeIndex String ATRIBUTO Indica o índice do atributo customizado. Os valores permitidos são INDEX0, INDEX1, INDEX2, INDEX3, INDEX4, DESCONHECIDO, NÃO ESPECIFICADO.
AssetGroupListingGroupFilterCaseValueProductCustomAttributeValue String ATRIBUTO Valor de string do atributo personalizado do produto.
AssetGroupListingGroupFilterCaseValueProductItemIdValue String ATRIBUTO Valor do id.
AssetGroupListingGroupFilterCaseValueProductTypeLevel String ATRIBUTO Nível do tipo. Os valores permitidos são LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5, UNKNOWN, UNSPECIFIED.
AssetGroupListingGroupFilterCaseValueProductTypeValue String ATRIBUTO Valor do tipo.
AssetGroupListingGroupFilterId Long ATRIBUTO Somente saída. O ID do ListingGroupFilter.
AssetGroupListingGroupFilterParentListingGroupFilter String ATRIBUTO Imutável. Nome do recurso da subdivisão do grupo de listagem principal. Nulo para o nó de filtro do grupo de listagem raiz.
AssetGroupListingGroupFilterResourceName String ATRIBUTO Imutável. O nome do recurso do filtro do grupo de listagem do grupo de ativos. O nome do recurso do filtro do grupo de listagem do grupo de ativos tem o formato: customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
AssetGroupListingGroupFilterType String ATRIBUTO Imutável. Tipo de um nó de filtro de grupo de listagem. Os valores permitidos são SUBDIVISION, UNIT_EXCLUDED, UNIT_INCLUDED, UNKNOWN, UNSPECIFIED.
AssetGroupListingGroupFilterVertical String ATRIBUTO Imutável. A vertical que a árvore do nó atual representa. Todos os nós na mesma árvore devem pertencer à mesma vertical. Os valores permitidos são COMPRA, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AssetGroupSignal

AssetGroupSignal representa um sinal em um grupo de ativos. A existência de um sinal informa à campanha de desempenho máximo quem tem maior probabilidade de converter. A campanha de maior desempenho usa o sinal para procurar novas pessoas com intenção semelhante ou mais forte de encontrar conversões em pesquisa, exibição, vídeo e muito mais.

Colunas
Nome Tipo Comportamento Descrição
AssetGroupSignalAssetGroup String ATRIBUTO Imutável. O grupo de ativos ao qual este sinal de grupo de ativos pertence.
AssetGroupSignalAudienceAudience String ATRIBUTO O nome do recurso Audience.
AssetGroupSignalResourceName String ATRIBUTO Imutável. O nome do recurso do sinal do grupo de ativos. O nome do recurso de sinal do grupo de ativos tem o formato: customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AssetSet

Um conjunto de ativos que representa uma coleção de ativos. Use AssetSetAsset para vincular um ativo ao conjunto de ativos.

Colunas
Nome Tipo Comportamento Descrição
AssetSetMerchantCenterFeedFeedLabel String ATRIBUTO Opcional. Rótulo de feed do Google Merchant Center.
AssetSetMerchantCenterFeedMerchantId Long ATRIBUTO Obrigatório. ID do comerciante do Google Merchant Center
AssetSetName String ATRIBUTO Obrigatório. Nome do conjunto de ativos. Obrigatório. Deve ter um comprimento mínimo de 1 e comprimento máximo de 128.
AssetSetResourceName String ATRIBUTO Imutável. O nome do recurso do conjunto de ativos. Os nomes dos recursos do conjunto de ativos têm o formato: customers/{customer_id}/assetSets/{asset_set_id}
AssetSetStatus String ATRIBUTO Somente saída. O status do conjunto de ativos. Somente leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
AssetSetType String ATRIBUTO Obrigatório. Imutável. O tipo do conjunto de ativos. Obrigatório. Os valores permitidos são DYNAMIC_EDUCATION, MERCHANT_CENTER_FEED, PAGE_FEED, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
AssetSetAsset

AssetSetAsset é o link entre um ativo e um conjunto de ativos. Adicionar um AssetSetAsset vincula um ativo a um conjunto de ativos.

Colunas
Nome Tipo Comportamento Descrição
AssetSetAssetAsset String ATRIBUTO Imutável. O ativo ao qual este ativo do conjunto de ativos está vinculado.
AssetSetAssetAssetSet String ATRIBUTO Imutável. O conjunto de ativos ao qual este ativo de conjunto de ativos está vinculado.
AssetSetAssetResourceName String ATRIBUTO Imutável. O nome do recurso do ativo do conjunto de ativos. Os nomes dos recursos de ativos do conjunto de ativos têm o formato: customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
AssetSetAssetStatus String ATRIBUTO Somente saída. O status do ativo do conjunto de ativos. Somente leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Público

O público é uma opção de segmentação eficaz que permite cruzar diferentes atributos de segmento, como dados demográficos detalhados e afinidades, para criar públicos que representam seções de seus segmentos-alvo.

Colunas
Nome Tipo Comportamento Descrição
AudienceDescription String ATRIBUTO Descrição deste público.
AudienceDimensions String ATRIBUTO Dimensões positivas que especificam a composição do público.
AudienceExclusionDimension String ATRIBUTO Dimensão negativa que especifica a composição do público.
AudienceId Long ATRIBUTO Somente saída. ID do público.
AudienceName String ATRIBUTO Obrigatório. Nome do público. Deve ser único em todos os públicos. Deve ter um comprimento mínimo de 1 e comprimento máximo de 255.
AudienceResourceName String ATRIBUTO Imutável. O nome do recurso do público. Os nomes de público têm o formato: clientes/{customer_id}/audiences/{audience_id}
AudienceStatus String ATRIBUTO Somente saída. Status deste público. Indica se o público está habilitado ou removido. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
BatchJob

Uma lista de mutações sendo processadas de forma assíncrona. As mutações são carregadas pelo usuário. As próprias mutações não são legíveis e os resultados do trabalho só podem ser lidos usando BatchJobService.ListBatchJobResults.

Colunas
Nome Tipo Comportamento Descrição
BatchJobId Long ATRIBUTO Somente saída. ID deste trabalho em lote.
BatchJobLongRunningOperation String ATRIBUTO Somente saída. O nome do recurso da operação de execução longa que pode ser usada para pesquisar a conclusão. Definido apenas quando o status do trabalho em lote é EM EXECUÇÃO ou CONCLUÍDO.
BatchJobMetadataCompletionDateTime Date ATRIBUTO Somente saída. A hora em que esta tarefa em lote foi concluída. Formatado como aaaa-MM-dd HH🇲🇲ss. Exemplo: "2018-03-05 09:16:00"
BatchJobMetadataCreationDateTime Date ATRIBUTO Somente saída. A hora em que esse trabalho em lote foi criado. Formatado como aaaa-mm-dd hh🇲🇲ss. Exemplo: "2018-03-05 09:15:00"
BatchJobMetadataEstimatedCompletionRatio Double ATRIBUTO Somente saída. A fração (entre 0,0 e 1,0) de mutações que foram processadas. Está vazio se o trabalho ainda não começou a ser executado.
BatchJobMetadataExecutedOperationCount Long ATRIBUTO Somente saída. O número de operações mutate executadas pela tarefa em lote. Presente apenas se a tarefa tiver começado a ser executada.
BatchJobMetadataOperationCount Long ATRIBUTO Somente saída. O número de operações mutate na tarefa em lote.
BatchJobMetadataStartDateTime Date ATRIBUTO Somente saída. A hora em que esta tarefa em lote começou a ser executada. Formatado como aaaa-mm-dd hh🇲🇲ss. Exemplo: "2018-03-05 09:15:30"
BatchJobNextAddSequenceToken String ATRIBUTO Somente saída. O próximo token de sequência a ser usado ao adicionar operações. Definido apenas quando o status do trabalho em lote é PENDENTE.
BatchJobResourceName String ATRIBUTO Imutável. O nome do recurso da tarefa em lote. Os nomes dos recursos de trabalho em lote têm o formato: clientes/{customer_id}/batchJobs/{batch_job_id}
BatchJobStatus String ATRIBUTO Somente saída. Status deste trabalho em lote. Os valores permitidos são DONE, PENDING, RUNNING, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
BiddingDataExclusion

Representa uma exclusão de dados de lances. Consulte "Sobre exclusões de dados" no https://support.google.com/google-ads/answer/10370710.

Colunas
Nome Tipo Comportamento Descrição
BiddingDataExclusionAdvertisingChannelTypes String ATRIBUTO A exclusão de dados será aplicada a todas as campanhas nos canais listados retroativamente, bem como no futuro, quando o escopo dessa exclusão for CHANNEL. Os tipos de canais de publicidade suportados são DISPLAY, SEARCH e SHOPPING. Observação: uma exclusão de dados com Advertising_channel_types e Campaign_IDs não é suportada. Os valores permitidos são DISPLAY, HOTEL, LOCAL, LOCAL_SERVICES, MULTI_CHANNEL, PERFORMANCE_MAX, SEARCH, SHOPPING, SMART, UNKNOWN, UNSPECIFIED, VIDEO.
BiddingDataExclusionCampaigns String ATRIBUTO A exclusão de dados será aplicada às campanhas listadas quando o escopo dessa exclusão for CAMPANHA. O número máximo de campanhas por evento é 2.000. Nota: uma exclusão de dados com Advertising_channel_types e Campaign_IDs não é suportada.
BiddingDataExclusionDataExclusionId Long ATRIBUTO Somente saída. O ID da exclusão de dados.
BiddingDataExclusionDescription String ATRIBUTO A descrição da exclusão de dados. A descrição pode ter no máximo 2.048 caracteres.
BiddingDataExclusionDevices String ATRIBUTO Se não for especificado, todos os dispositivos serão incluídos nesta exclusão. Caso contrário, apenas os dispositivos de destino especificados serão incluídos nesta exclusão. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
BiddingDataExclusionEndDateTime String ATRIBUTO Obrigatório. A hora final exclusiva da exclusão de dados no formato aaaa-MM-dd HH🇲🇲ss. A duração do intervalo [start_date_time, end_date_time) deve estar dentro de (0, 14 dias).TABLEROWEND
BiddingDataExclusionName String ATRIBUTO O nome da exclusão de dados. O nome pode ter no máximo 255 caracteres.
BiddingDataExclusionResourceName String ATRIBUTO Imutável. O nome do recurso da exclusão de dados. Os nomes dos recursos de exclusão de dados têm o formato: customers/{customer_id}/biddingDataExclusions/{data_exclusion_id}
BiddingDataExclusionScope String ATRIBUTO O escopo da exclusão de dados. Os valores permitidos são CAMPAIGN, CHANNEL, CUSTOMER, UNKNOWN, UNSPECIFED.
BiddingDataExclusionStartDateTime String ATRIBUTO Obrigatório. A hora de início inclusiva da exclusão de dados no formato aaaa-MM-dd HH🇲🇲ss. Uma exclusão de dados é retrospectiva e deve ser usada para eventos que começam no passado e terminam no passado ou no futuro.
BiddingDataExclusionStatus String ATRIBUTO Somente saída. O status da exclusão de dados. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Ajuste de Sazonalidade de Lances

Representa um ajuste periódico de lances. Consulte "Sobre os ajustes de sazonalidade" no https://support.google.com/google-ads/answer/10369906.

Colunas
Nome Tipo Comportamento Descrição
BiddingSeasonalityAdjustmentAdvertisingChannelTypes String ATRIBUTO O ajuste de sazonalidade será aplicado a todas as campanhas nos canais listados retroativamente, bem como no futuro, quando o escopo desse ajuste for CANAL. Os tipos de canais de publicidade suportados são DISPLAY, SEARCH e SHOPPING. Observação: um ajuste sazonal com Advertising_channel_types e Campaign_IDs não é compatível. Os valores permitidos são DISPLAY, HOTEL, LOCAL, LOCAL_SERVICES, MULTI_CHANNEL, PERFORMANCE_MAX, SEARCH, SHOPPING, SMART, UNKNOWN, UNSPECIFIED, VIDEO.
BiddingSeasonalityAdjustmentCampaigns String ATRIBUTO O ajuste sazonal será aplicado às campanhas listadas quando o escopo desse ajuste for CAMPANHA. O número máximo de campanhas por evento é 2.000. Observação: não há suporte para um ajuste sazonal com Advertising_channel_types e Campaign_ids.
BiddingSeasonalityAdjustmentConversionRateModifier Double ATRIBUTO Modificador da taxa de conversão estimado com base nas alterações esperadas na taxa de conversão. Quando este campo estiver desativado ou definido como 1.0, nenhum ajuste será aplicado ao tráfego. O intervalo permitido é de 0,1 a 10,0.
BiddingSeasonalityAdjustmentDescription String ATRIBUTO A descrição do ajuste sazonal. A descrição pode ter no máximo 2.048 caracteres.
BiddingSeasonalityAdjustmentDevices String ATRIBUTO Se não for especificado, todos os dispositivos serão incluídos neste ajuste. Caso contrário, apenas os dispositivos de destino especificados serão incluídos neste ajuste. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
BiddingSeasonalityAdjustmentEndDateTime String ATRIBUTO Obrigatório. A hora de término exclusiva do ajuste sazonal no formato aaaa-MM-dd HH🇲🇲ss. A duração do intervalo [start_date_time, end_date_time) deve estar dentro de (0, 14 dias).TABLEROWEND
BiddingSeasonalityAdjustmentName String ATRIBUTO O nome do ajuste sazonal. O nome pode ter no máximo 255 caracteres.
BiddingSeasonalityAdjustmentResourceName String ATRIBUTO Imutável. O nome do recurso do ajuste sazonal. Os nomes dos recursos de ajuste sazonal têm o seguinte formato: customers/{customer_id}/biddingSeasonalityAdjustments/{seasonality_adjustment_id}
BiddingSeasonalityAdjustmentScope String ATRIBUTO O escopo do ajuste de sazonalidade. Os valores permitidos são CAMPAIGN, CHANNEL, CUSTOMER, UNKNOWN, UNSPECIFED.
BiddingSeasonalityAdjustmentSeasonalityAdjustmentId Long ATRIBUTO Somente saída. A ID do ajuste sazonal.
BiddingSeasonalityAdjustmentStartDateTime String ATRIBUTO Obrigatório. A hora de início inclusiva do ajuste sazonal no formato aaaa-MM-dd HH🇲🇲ss. Um ajuste de sazonalidade é voltado para o futuro e deve ser usado para eventos que começam e terminam no futuro.
BiddingSeasonalityAdjustmentStatus String ATRIBUTO Somente saída. O status do ajuste sazonal. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Estratégia de Licitação

Uma estratégia de lances.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
BiddingStrategyCampaignCount Long ATRIBUTO Somente saída. O número de campanhas anexadas a esta estratégia de lances. Este campo é só de leitura.
BiddingStrategyCurrencyCode String ATRIBUTO Imutável. A moeda usada pela estratégia de lances (código ISO 4217 de três letras). Para estratégias de lances em clientes gerentes, essa moeda pode ser definida na criação e padronizada para a moeda do cliente gerente. Para atender clientes, este campo não pode ser definido; todas as estratégias em um cliente servidor usam implicitamente a moeda do cliente servidor. Em todos os casos, o campo Effective_currency_code retorna a moeda usada pela estratégia.
BiddingStrategyEffectiveCurrencyCode String ATRIBUTO Somente saída. A moeda usada pela estratégia de lances (código ISO 4217 de três letras). Para estratégias de lances em clientes gerentes, esta é a moeda definida pelo anunciante ao criar a estratégia. Para atender clientes, este é o currency_code do cliente. As métricas da estratégia de lances são informadas nessa moeda. Este campo é só de leitura.
BiddingStrategyEnhancedCpc String ATRIBUTO Uma estratégia de lances que aumenta os lances para cliques com maior probabilidade de gerar uma conversão e os reduz para cliques em que parecem menos prováveis.
BiddingStrategyId Long ATRIBUTO Somente saída. O ID da estratégia de lances.
BiddingStrategyMaximizeConversionValueCpcBidCeilingMicros Long ATRIBUTO Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Mutável apenas para estratégias de lances de portfólio.
BiddingStrategyMaximizeConversionValueCpcBidFloorMicros Long ATRIBUTO Limite de lance mínimo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Mutável apenas para estratégias de lances de portfólio.
BiddingStrategyMaximizeConversionValueTargetRoas Double ATRIBUTO A opção de retorno do investimento em publicidade (ROAS) desejado. Se definida, a estratégia de lances maximizará a receita enquanto calculará a média do retorno do investimento em publicidade desejado. Se o ROAS desejado for alto, a estratégia de lances pode não conseguir gastar todo o orçamento. Se o ROAS desejado não for definido, a estratégia de lances terá como objetivo atingir o ROAS mais alto possível para o orçamento.
BiddingStrategyMaximizeConversionsCpcBidCeilingMicros Long ATRIBUTO Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Mutável apenas para estratégias de lances de portfólio.
BiddingStrategyMaximizeConversionsCpcBidFloorMicros Long ATRIBUTO Limite de lance mínimo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Mutável apenas para estratégias de lances de portfólio.
BiddingStrategyMaximizeConversionsTargetCpa Long ATRIBUTO Somente saída. A opção de custo por aquisição (CPA) desejado. Este é o valor médio que você gostaria de gastar por aquisição.
BiddingStrategyName String ATRIBUTO O nome da estratégia de lances. Todas as estratégias de lances em uma conta devem ter nomes distintos. O comprimento desta string deve estar entre 1 e 255, inclusive, em bytes UTF-8 (aparados).
BiddingStrategyNonRemovedCampaignCount Long ATRIBUTO Somente saída. O número de campanhas não removidas anexadas a esta estratégia de lances. Este campo é só de leitura.
BiddingStrategyResourceName String ATRIBUTO Imutável. O nome do recurso da estratégia de lances. Os nomes dos recursos da estratégia de lances têm o formato: customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
BiddingStrategyStatus String ATRIBUTO Somente saída. O status da estratégia de lances. Este campo é só de leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
BiddingStrategyTargetCpaCpcBidCeilingMicros Long ATRIBUTO Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Isso só deve ser definido para estratégias de lances de portfólio.
BiddingStrategyTargetCpaCpcBidFloorMicros Long ATRIBUTO Limite de lance mínimo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Isso só deve ser definido para estratégias de lances de portfólio.
BiddingStrategyTargetCpaTargetCpaMicros Long ATRIBUTO Somente saída. Meta média de CPA. Essa meta deve ser maior ou igual à unidade faturável mínima com base na moeda da conta.
BiddingStrategyTargetImpressionShareCpcBidCeilingMicros Long ATRIBUTO Somente saída. O lance de CPC mais alto que o sistema de lances automatizados pode especificar. Este é um campo obrigatório informado pelo anunciante que define o teto e especificado nos micros locais.
BiddingStrategyTargetImpressionShareLocation String ATRIBUTO Somente saída. O local segmentado na página de resultados de pesquisa. Os valores permitidos são ABSOLUTE_TOP_OF_PAGE, ANYWHERE_ON_PAGE, TOP_OF_PAGE, UNKNOWN, UNSPECIFIED.
BiddingStrategyTargetImpressionShareLocationFractionMicros Long ATRIBUTO A fração desejada de anúncios a serem exibidos no local segmentado em micros. Por exemplo. 1% é igual a 10.000.
BiddingStrategyTargetRoasCpcBidCeilingMicros Long ATRIBUTO Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Isso só deve ser definido para estratégias de lances de portfólio.
BiddingStrategyTargetRoasCpcBidFloorMicros Long ATRIBUTO Limite de lance mínimo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Isso só deve ser definido para estratégias de lances de portfólio.
BiddingStrategyTargetRoasTargetRoas Double ATRIBUTO Obrigatório. A receita desejada (com base nos dados de conversão) por unidade de gasto. O valor deve estar entre 0,01 e 1000,0, inclusive.
BiddingStrategyTargetSpendCpcBidCeilingMicros Long ATRIBUTO Somente saída. Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia.
BiddingStrategyTargetSpendTargetSpendMicros Long ATRIBUTO Somente saída. A meta de gasto abaixo da qual maximizar os cliques. Um proponente TargetSpend tentará gastar o menor valor ou o valor de gasto de throttling natural. Se não for especificado, o orçamento será usado como meta de gasto. Este campo está obsoleto e não deve mais ser usado. Ver https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html para detalhes.
BiddingStrategyType String ATRIBUTO Somente saída. O tipo da estratégia de lances. Crie uma estratégia de lances definindo o esquema de lances. Este campo é só de leitura. Os valores permitidos são COMMISSION, ENHANCED_CPC, INVALID, MANUAL_CPC, MANUAL_CPM, MANUAL_CPV, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, PAGE_ONE_PROMOTED, PERCENT_CPC, TARGET_CPA, TARGET_CPM, TARGET_IMPRESSION_SHARE, TARGET_OUTRANK_SHARE, TARGET_ROAS, TARGE T_SPEND, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Hour Int SEGMENTO Hora do dia como um número entre 0 e 23, inclusive.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
LicitaçãoEstratégiaSimulação

Uma simulação de estratégia de lances. As combinações suportadas de tipo de simulação e método de modificação de simulação são detalhadas abaixo, respectivamente. 1. TARGET_CPA - UNIFORME 2. TARGET_ROAS - UNIFORME

Colunas
Nome Tipo Comportamento Descrição
BiddingStrategySimulationBiddingStrategyId Long ATRIBUTO Somente saída. ID do conjunto compartilhado da estratégia de lances da simulação.
BiddingStrategySimulationEndDate Date ATRIBUTO Somente saída. Último dia em que se baseia a simulação, no formato AAAA-MM-DD
BiddingStrategySimulationModificationMethod String ATRIBUTO Somente saída. Como a simulação modifica o campo. Os valores permitidos são PADRÃO, ESCALA, UNIFORME, DESCONHECIDO, NÃO ESPECIFICADO.
BiddingStrategySimulationResourceName String ATRIBUTO Somente saída. O nome do recurso da simulação da estratégia de lances. Os nomes dos recursos de simulação de estratégia de lances têm o formato: customers/{customer_id}/biddingStrategySimulations/{bidding_strategy_id}~{type}~{modification_method}~{start_date}~{end_date}
BiddingStrategySimulationStartDate Date ATRIBUTO Somente saída. Primeiro dia em que se baseia a simulação, no formato AAAA-MM-DD.
BiddingStrategySimulationTargetCpaPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores de CPA desejados.
BiddingStrategySimulationTargetRoasPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores de ROAS desejados.
BiddingStrategySimulationType String ATRIBUTO Somente saída. O campo que a simulação modifica. Os valores permitidos são BID_MODIFIER, BUDGET, CPC_BID, CPV_BID, PERCENT_CPC_BID, TARGET_CPA, TARGET_IMPRESSION_SHARE, TARGET_ROAS, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Configuração de Faturamento

Uma configuração de cobrança, que associa uma conta de pagamentos e um anunciante. Uma configuração de cobrança é específica para um anunciante.

Colunas
Nome Tipo Comportamento Descrição
BillingSetupEndDateTime Date ATRIBUTO Somente saída. A hora da data final no formato aaaa-MM-dd ou aaaa-MM-dd HH🇲🇲ss.
BillingSetupEndTimeType String ATRIBUTO Somente saída. A hora de término como um tipo. O único valor possível é PARA SEMPRE. Os valores permitidos são FOREVER, NOW, UNKNOWN, UNSPECIFED.
BillingSetupId Long ATRIBUTO Somente saída. O ID da configuração de cobrança.
BillingSetupPaymentsAccount String ATRIBUTO Imutável. O nome do recurso da conta de pagamentos associada a esta configuração de faturamento. Os nomes dos recursos de pagamentos têm o formato: clientes/{customer_id}/paymentsAccounts/{payments_account_id} Ao configurar o faturamento, isso é usado para se inscrever com uma conta de pagamentos existente (e então Payments_account_info não deve ser definido). Ao obter uma configuração de faturamento, este e payment_account_info serão preenchidos.
BillingSetupPaymentsAccountInfoPaymentsAccountId String ATRIBUTO Somente saída. Um ID de 16 dígitos usado para identificar a conta de pagamentos associada à configuração de faturamento. Isso deve ser passado como uma string com hífens, por exemplo "1234-5678-9012-3456".
BillingSetupPaymentsAccountInfoPaymentsAccountName String ATRIBUTO Imutável. O nome da conta de pagamentos associada à configuração de faturamento. Isso permite que o usuário especifique um nome significativo para uma conta de pagamentos para ajudar na reconciliação de faturas mensais. Este nome será impresso nas faturas mensais.
BillingSetupPaymentsAccountInfoPaymentsProfileId String ATRIBUTO Imutável. Um ID de 12 dígitos usado para identificar o perfil de pagamentos associado à configuração de cobrança. Isso deve ser passado como uma string com hífens, por exemplo "1234-5678-9012".
BillingSetupPaymentsAccountInfoPaymentsProfileName String ATRIBUTO Somente saída. O nome do perfil de pagamentos associado à configuração de cobrança.
BillingSetupPaymentsAccountInfoSecondaryPaymentsProfileId String ATRIBUTO Somente saída. Um ID de perfil de pagamentos secundário presente em situações incomuns, por exemplo quando um acordo de responsabilidade sequencial foi arranjado.
BillingSetupResourceName String ATRIBUTO Imutável. O nome do recurso da configuração de cobrança. Os nomes dos recursos BillingSetup têm o formato: customers/{customer_id}/billingSetups/{billing_setup_id}
BillingSetupStartDateTime Date ATRIBUTO Imutável. A data e hora de início no formato aaaa-MM-dd ou aaaa-MM-dd HH🇲🇲ss. Apenas um tempo futuro é permitido.
BillingSetupStatus String ATRIBUTO Somente saída. O status da configuração de cobrança. Os valores permitidos são APPROVED, APPROVED_HELD, CANCELLED, PENDING, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
CallView

Uma visualização de chamada que inclui dados para rastreamento de chamadas de anúncios somente para chamadas ou extensões de chamada.

Colunas
Nome Tipo Comportamento Descrição
CallViewCallDurationSeconds Long ATRIBUTO Somente saída. A duração da chamada fornecida pelo anunciante em segundos.
CallViewCallStatus String ATRIBUTO Somente saída. O status da chamada. Os valores permitidos são PERDIDO, RECEBIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CallViewCallTrackingDisplayLocation String ATRIBUTO Somente saída. O local de exibição do rastreamento de chamadas. Os valores permitidos são AD, LANDING_PAGE, UNKNOWN, UNSPECIFIED.
CallViewCallerAreaCode String ATRIBUTO Somente saída. Código de área do chamador. Nulo se a duração da chamada for inferior a 15 segundos.
CallViewCallerCountryCode String ATRIBUTO Somente saída. Código do país do chamador.
CallViewEndCallDateTime Date ATRIBUTO Somente saída. A data e hora de término da chamada fornecida pelo anunciante.
CallViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização da chamada. Os nomes dos recursos de exibição de chamada têm o formato: customers/{customer_id}/callViews/{call_detail_id}
CallViewStartCallDateTime Date ATRIBUTO Somente saída. A data e hora de início da chamada fornecida pelo anunciante.
CallViewType String ATRIBUTO Somente saída. O tipo da chamada. Os valores permitidos são HIGH_END_MOBILE_SEARCH, MANUALLY_DIALED, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Campanha

Uma campanha.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CampaignAccessibleBiddingStrategy String ATRIBUTO Somente saída. Nome do recurso de AccessibleBiddingStrategy, uma exibição somente leitura dos atributos irrestritos da estratégia de lances de portfólio anexada identificada por 'bidding_strategy'. Vazio, se a campanha não utilizar uma estratégia de portfólio. Atributos de estratégia irrestritos estão disponíveis para todos os clientes com quem a estratégia é compartilhada e são lidos do recurso AccessibleBiddingStrategy. Em contraste, os atributos restritos estão disponíveis apenas para o cliente proprietário da estratégia e seus gerentes. Os atributos restritos só podem ser lidos do recurso BiddingStrategy.
CampaignAdServingOptimizationStatus String ATRIBUTO O status de otimização da veiculação do anúncio da campanha. Os valores permitidos são CONVERSION_OPTIMIZE, OPTIMIZE, ROTATE, ROTATE_INDEFINITELY, UNAVAILABLE, UNKNOWN, UNSPECIFIED.
CampaignAdvertisingChannelSubType String ATRIBUTO Imutável. Refinamento opcional para Advertising_channel_type. Deve ser um subtipo válido do tipo de canal principal. Pode ser definido apenas ao criar campanhas. Após a criação da campanha, o campo não poderá ser alterado. Os valores permitidos são APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT, APP_CAMPAIGN_FOR_PRE_REGISTRATION, DISPLAY_EXPRESS, DISPLAY_GMAIL_AD, DISPLAY_MOBILE_APP, DISPLAY_SMART_CAMPAIGN, LOCAL_CAMPAIGN, SEARCH_EXPRESS, SEARCH_MOBILE_APP, SHOPPING_COMPARISON_LIS TING_ADS, SHOPPING_SMART_ADS, SMART_CAMPAIGN, DESCONHECIDO, NÃO ESPECIFICADO, VIDEO_ACTION, VIDEO_NON_SKIPPABLE, VIDEO_OUTSTREAM, VIDEO_SEQUENCE.
CampaignAdvertisingChannelType String ATRIBUTO Imutável. O destino de veiculação principal para anúncios dentro da campanha. As opções de segmentação podem ser refinadas em network_settings. Este campo é obrigatório e não deve ficar vazio ao criar novas campanhas. Pode ser definido apenas ao criar campanhas. Após a criação da campanha, o campo não poderá ser alterado. Os valores permitidos são DISPLAY, HOTEL, LOCAL, LOCAL_SERVICES, MULTI_CHANNEL, PERFORMANCE_MAX, SEARCH, SHOPPING, SMART, UNKNOWN, UNSPECIFIED, VIDEO.
CampaignAppCampaignSettingAppId String ATRIBUTO Imutável. Uma cadeia de caracteres que identifica exclusivamente um aplicativo móvel.
CampaignAppCampaignSettingAppStore String ATRIBUTO Imutável. A loja de aplicativos que distribui esse aplicativo específico. Os valores permitidos são APPLE_APP_STORE, GOOGLE_APP_STORE, UNKNOWN, UNSPECIFIED.
CampaignAppCampaignSettingBiddingStrategyGoalType String ATRIBUTO Representa a meta para a qual a estratégia de lances dessa campanha para apps deve ser otimizada. Os valores permitidos são OPTIMIZE_INSTALLS_TARGET_INSTALL_COST, OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST, OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST, OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST, OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME, OPTIMIZE_RETURN_ON_ADVERTISING_SPEND, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignAudienceSettingUseAudienceGrouped Bool ATRIBUTO Imutável. Se verdadeiro, esta campanha usa um recurso de público para segmentação de público. Se falso, esta campanha pode usar critérios de segmento de público.
CampaignBaseCampaign String ATRIBUTO Somente saída. O nome do recurso da campanha base de um rascunho ou campanha experimental. Para campanhas base, é igual a resource_name. Este campo é só de leitura.
CampaignBiddingStrategy String ATRIBUTO Estratégia de lance de portfólio usada pela campanha.
CampaignBiddingStrategyType String ATRIBUTO Somente saída. O tipo de estratégia de lance. Uma estratégia de lances pode ser criada definindo o esquema de lances para criar uma estratégia de lances padrão ou o campo bidding_strategy para criar uma estratégia de lances de portfólio. Este campo é só de leitura. Os valores permitidos são COMMISSION, ENHANCED_CPC, INVALID, MANUAL_CPC, MANUAL_CPM, MANUAL_CPV, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, PAGE_ONE_PROMOTED, PERCENT_CPC, TARGET_CPA, TARGET_CPM, TARGET_IMPRESSION_SHARE, TARGET_OUTRANK_SHARE, TARGET_ROAS, TARGE T_SPEND, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignCampaignBudget String ATRIBUTO O orçamento da campanha.
CampaignCommissionCommissionRateMicros Long ATRIBUTO A taxa de comissão define a parte do valor da conversão que será cobrada do anunciante. Uma taxa de comissão de x deve ser passada para este campo como (x * 1, 000, 000). Por exemplo, 106.000 representa uma taxa de comissão de 0,106 (10,6%).
CampaignDynamicSearchAdsSettingDomainName String ATRIBUTO Obrigatório. O nome de domínio da Internet que essa configuração representa, por exemplo, "google.com" ou "www.google.com".
CampaignDynamicSearchAdsSettingFeeds String ATRIBUTO A lista de feeds de página associados à campanha.
CampaignDynamicSearchAdsSettingLanguageCode String ATRIBUTO Obrigatório. O código de idioma que especifica o idioma do domínio, por exemplo, "en".
CampaignDynamicSearchAdsSettingUseSuppliedUrlsOnly Bool ATRIBUTO Se a campanha usa URLs fornecidos pelo anunciante exclusivamente.
CampaignEndDate Date ATRIBUTO O último dia da campanha para atender o fuso horário do cliente no formato AAAA-MM-DD.
CampaignExcludedParentAssetFieldTypes String ATRIBUTO Os tipos de campo de ativo que devem ser excluídos desta campanha. Os links de recursos com esses tipos de campo não serão herdados por esta campanha do nível superior. Os valores permitidos são BOOK_ON_GOOGLE, BUSINESS_NAME, CALL, CALLOUT, CALL_TO_ACTION_SELECTION, DESCRIPTION, HEADLINE, HOTEL_CALLOUT, LANDSCAPE_LOGO, LEAD_FORM, LOGO, LONG_HEADLINE, MANDATORY_AD_TEXT, MARKETING_IMAGE, MEDIA_BUNDLE, MOBILE_APP, PORTRAIT_MARKETING_IMAGE, PRICE, PROMOÇÃO, SITELINK, SQUARE_MARKETING_IMAGE, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO, VÍDEO, YOUTUBE_VIDEO.
CampaignExperimentType String ATRIBUTO Somente saída. O tipo de campanha: normal, rascunho ou experimental. Os valores permitidos são BASE, DRAFT, EXPERIMENT, UNKNOWN, UNSPECIFED.
CampaignFinalUrlSuffix String ATRIBUTO Sufixo usado para anexar parâmetros de consultar a páginas de destino que são exibidas com rastreamento paralelo.
CampaignFrequencyCaps String ATRIBUTO Uma lista que limita a frequência com que cada usuário verá os anúncios dessa campanha.
CampaignGeoTargetTypeSettingNegativeGeoTargetType String ATRIBUTO A configuração usada para segmentação geográfica negativa nesta campanha específica. Os valores permitidos são PRESENCE, PRESENCE_OR_INTEREST, UNKNOWN, UNSPECIFIED.
CampaignGeoTargetTypeSettingPositiveGeoTargetType String ATRIBUTO A configuração usada para segmentação geográfica positiva nesta campanha específica. Os valores permitidos são PRESENCE, PRESENCE_OR_INTEREST, SEARCH_INTEREST, UNKNOWN, UNSPECIFIED.
CampaignHotelSettingHotelCenterId Long ATRIBUTO Imutável. A conta vinculada do Hotel Center.
CampaignId Long ATRIBUTO Somente saída. O ID da campanha.
CampaignLabels String ATRIBUTO Somente saída. Os nomes dos recursos dos rótulos anexados a esta campanha.
CampaignLocalCampaignSettingLocationSourceType String ATRIBUTO O tipo de fonte de localização para esta campanha local. Os valores permitidos são AFFILIATE, GOOGLE_MY_BUSINESS, UNKNOWN, UNSPECIFIED.
CampaignManualCpcEnhancedCpcEnabled Bool ATRIBUTO Se os lances devem ser aprimorados com base nos dados do otimizador de conversão.
CampaignManualCpm String ATRIBUTO Estratégia de lance de CPM manual padrão. Lances manuais baseados em impressões em que o usuário paga por mil impressões.
CampaignManualCpv String ATRIBUTO Somente saída. Uma estratégia de lances que paga um valor configurável por exibição de vídeo.
CampaignMaximizeConversionValueTargetRoas Double ATRIBUTO A opção de retorno do investimento em publicidade (ROAS) desejado. Se definida, a estratégia de lances maximizará a receita enquanto calculará a média do retorno do investimento em publicidade desejado. Se o ROAS desejado for alto, a estratégia de lances pode não conseguir gastar todo o orçamento. Se o ROAS desejado não for definido, a estratégia de lances terá como objetivo atingir o ROAS mais alto possível para o orçamento.
CampaignMaximizeConversionsTargetCpa Long ATRIBUTO Somente saída. A opção de custo por aquisição (CPA) desejado. Este é o valor médio que você gostaria de gastar por aquisição.
CampaignName String ATRIBUTO O nome da campanha. Este campo é obrigatório e não deve ficar vazio ao criar novas campanhas. Ele não deve conter nenhum caractere nulo (ponto de código 0x0), avanço de linha NL (ponto de código 0xA) ou retorno de linha (ponto de código 0xD).
CampaignNetworkSettingsTargetContentNetwork Bool ATRIBUTO Se os anúncios serão exibidos em canais especificados na Rede de Display do Google. As veiculações são especificadas usando o critério de veiculação.
CampaignNetworkSettingsTargetGoogleSearch Bool ATRIBUTO Se os anúncios serão exibidos com os resultados de pesquisa do google.com.
CampaignNetworkSettingsTargetPartnerSearchNetwork Bool ATRIBUTO Se os anúncios serão veiculados na rede de parceiros do Google. Isso está disponível apenas para algumas contas selecionadas de parceiros do Google.
CampaignNetworkSettingsTargetSearchNetwork Bool ATRIBUTO Se os anúncios serão exibidos em sites parceiros na Rede de Pesquisa do Google (requer que target_google_search também seja verdadeiro).
CampaignOptimizationGoalSettingOptimizationGoalTypes String ATRIBUTO A lista de tipos de meta de otimização. Os valores permitidos são APP_PRE_REGISTRATION, CALL_CLICKS, DRIVING_DIRECTIONS, UNKNOWN, UNSPECIFIED.
CampaignOptimizationScore Double ATRIBUTO Somente saída. Pontuação de otimização da campanha. A pontuação de otimização é uma estimativa do desempenho de uma campanha. Ele varia de 0% (0,0) a 100% (1,0), com 100% indicando que a campanha está funcionando com todo o potencial. Este campo é nulo para campanhas sem pontuação. Consulte "Sobre a pontuação de otimização" em https://support.google.com/google-ads/answer/9061546. Este campo é só de leitura.
CampaignPaymentMode String ATRIBUTO Forma de pagamento da campanha. Os valores permitidos são CLICKS, CONVERSIONS, CONVERSION_VALUE, GUEST_STAY, UNKNOWN, UNSPECIFIED.
CampaignPercentCpcCpcBidCeilingMicros Long ATRIBUTO Limite de lance máximo que pode ser definido pela estratégia de lances. Este é um campo opcional inserido pelo anunciante e especificado nos micros locais. Nota: Um valor zero é interpretado da mesma forma que bid_ceiling indefinido.
CampaignPercentCpcEnhancedCpcEnabled Bool ATRIBUTO Ajusta o lance de cada leilão para cima ou para baixo, dependendo da probabilidade de uma conversão. Lances individuais podem exceder cpc_bid_ceiling_micros, mas o valor médio do lance para uma campanha não.
CampaignRealTimeBiddingSettingOptIn Bool ATRIBUTO Se a campanha está ativada para lances em tempo real.
CampaignResourceName String ATRIBUTO Imutável. O nome do recurso da campanha. Os nomes dos recursos da campanha têm o formato: clientes/{customer_id}/campaigns/{campaign_id}
CampaignSelectiveOptimizationConversionActions String ATRIBUTO O conjunto selecionado de ações de conversão para otimizar esta campanha.
CampaignServingStatus String ATRIBUTO Somente saída. O status de veiculação do anúncio da campanha. Os valores permitidos são ENDED, NONE, PENDING, SERVING, SUSPENDED, UNKNOWN, UNSPECIFED.
CampaignShoppingSettingCampaignPriority Int ATRIBUTO Prioridade da campanha. Campanhas com prioridades numericamente mais altas têm precedência sobre aquelas com prioridades mais baixas. Este campo é obrigatório para Campanhas do Shopping, com valores entre 0 e 2, inclusive. Este campo é opcional para campanhas inteligentes do Shopping, mas deve ser igual a 3 se definido.
CampaignShoppingSettingEnableLocal Bool ATRIBUTO Se deve incluir produtos locais.
CampaignShoppingSettingMerchantId Long ATRIBUTO Imutável. ID da conta do Merchant Center. Este campo é obrigatório para operações de criação. Este campo é imutável para campanhas do Shopping.
CampaignShoppingSettingSalesCountry String ATRIBUTO País de venda dos produtos a incluir na campanha. Este campo é obrigatório para campanhas do Shopping. Este campo é opcional para campanhas não relacionadas ao Shopping, mas deve ser igual a 'ZZ' se definido.
CampaignShoppingSettingUseVehicleInventory Bool ATRIBUTO Imutável. Se deve segmentar o inventário de listagem de veículos.
CampaignStartDate Date ATRIBUTO A data em que a campanha começou a atender o fuso horário do cliente no formato AAAA-MM-DD.
CampaignStatus String ATRIBUTO O status da campanha. Quando uma nova campanha é adicionada, o status padrão é ATIVADO. Os valores permitidos são ATIVADO, PAUSADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignTargetCpaCpcBidCeilingMicros Long ATRIBUTO Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Isso só deve ser definido para estratégias de lances de portfólio.
CampaignTargetCpaCpcBidFloorMicros Long ATRIBUTO Limite de lance mínimo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Isso só deve ser definido para estratégias de lances de portfólio.
CampaignTargetCpaTargetCpaMicros Long ATRIBUTO Somente saída. Meta média de CPA. Essa meta deve ser maior ou igual à unidade faturável mínima com base na moeda da conta.
CampaignTargetCpm String ATRIBUTO Uma estratégia de lances que otimiza automaticamente o custo por mil impressões.
CampaignTargetImpressionShareCpcBidCeilingMicros Long ATRIBUTO Somente saída. O lance de CPC mais alto que o sistema de lances automatizados pode especificar. Este é um campo obrigatório informado pelo anunciante que define o teto e especificado nos micros locais.
CampaignTargetImpressionShareLocation String ATRIBUTO Somente saída. O local segmentado na página de resultados de pesquisa. Os valores permitidos são ABSOLUTE_TOP_OF_PAGE, ANYWHERE_ON_PAGE, TOP_OF_PAGE, UNKNOWN, UNSPECIFIED.
CampaignTargetImpressionShareLocationFractionMicros Long ATRIBUTO A fração desejada de anúncios a serem exibidos no local segmentado em micros. Por exemplo. 1% é igual a 10.000.
CampaignTargetRoasCpcBidCeilingMicros Long ATRIBUTO Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Isso só deve ser definido para estratégias de lances de portfólio.
CampaignTargetRoasCpcBidFloorMicros Long ATRIBUTO Limite de lance mínimo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Isso só deve ser definido para estratégias de lances de portfólio.
CampaignTargetRoasTargetRoas Double ATRIBUTO Obrigatório. A receita desejada (com base nos dados de conversão) por unidade de gasto. O valor deve estar entre 0,01 e 1000,0, inclusive.
CampaignTargetSpendCpcBidCeilingMicros Long ATRIBUTO Somente saída. Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia.
CampaignTargetSpendTargetSpendMicros Long ATRIBUTO Somente saída. A meta de gasto abaixo da qual maximizar os cliques. Um proponente TargetSpend tentará gastar o menor valor ou o valor de gasto de throttling natural. Se não for especificado, o orçamento será usado como meta de gasto. Este campo está obsoleto e não deve mais ser usado. Ver https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html para detalhes.
CampaignTargetingSettingTargetRestrictions String ATRIBUTO A configuração por dimensão de segmentação para restringir o alcance de sua campanha ou grupo de anúncios.
CampaignTrackingSettingTrackingUrl String ATRIBUTO Somente saída. A URL usada para rastreamento dinâmico.
CampaignTrackingUrlTemplate String ATRIBUTO O modelo de URL para construir um URL de rastreamento.
CampaignUrlCustomParameters String ATRIBUTO A lista de mapeamentos usados para substituir tags de parâmetro personalizado em um tracking_url_template, final_urls ou mobile_final_urls.
CampaignUrlExpansionOptOut Bool ATRIBUTO Representa a desativação da expansão de URL para URLs mais segmentados. Se desativado (verdadeiro), apenas os URLs finais no grupo de recursos ou os URLs especificados no Google Merchant Center do anunciante ou nos feeds de dados da empresa serão segmentados. Se ativado (falso), todo o domínio será segmentado. Este campo só pode ser definido para campanhas de maior desempenho, em que o valor padrão é falso.
CampaignVanityPharmaVanityPharmaDisplayUrlMode String ATRIBUTO O modo de exibição para URLs de produtos farmacêuticos personalizados. Os valores permitidos são MANUFACTURER_WEBSITE_URL, UNKNOWN, UNSPECIFIED, WEBSITE_DESCRIPTION.
CampaignVanityPharmaVanityPharmaText String ATRIBUTO O texto que será exibido no URL de visualização do anúncio de texto quando a descrição do site for o modo de exibição selecionado para URLs de produtos farmacêuticos personalizados. Os valores permitidos são MEDICAL_DEVICE_WEBSITE_EN, MEDICAL_DEVICE_WEBSITE_ES, PRESCRIPTION_CONTRACEPTION_WEBSITE_EN, PRESCRIPTION_CONTRACEPTION_WEBSITE_ES, PRESCRIPTION_DEVICE_WEBSITE_EN, PRESCRIPTION_DEVICE_WEBSITE_ES, PRESCRIPTION_TREATMENT_WEBSITE_EN, PRESCRIPTION_TREATMENT_WEBSITE_ES, PRESCRIPTION_VACCINE_WEBSITE_EN, PRESCRIPTION_VACCINE_WEBSITE_ES, PREVENTATIVE_TREATMENT_WEBSITE_EN, PREVENTATIVE_TREATMENT_WEBSITE_ES, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignVideoBrandSafetySuitability String ATRIBUTO Somente saída. Configuração de Brand Safety de 3 níveis para a campanha. Os valores permitidos são EXPANDED_INVENTORY, LIMITED_INVENTORY, STANDARD_INVENTORY, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsByConversionDate Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValueByConversionDate Double MÉTRICA O valor de todas as conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
AveragePageViews Double MÉTRICA Número médio de páginas visualizadas por sessão.
AverageTimeOnSite Double MÉTRICA Duração total de todas as sessões (em segundos) / número de sessões. Importado do Google Analytics.
BounceRate Double MÉTRICA Porcentagem de cliques em que o usuário visitou apenas uma única página em seu site. Importado do Google Analytics.
Clicks Long MÉTRICA O número de cliques.
ContentBudgetLostImpressionShare Double MÉTRICA A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na Rede de Display, mas não porque seu orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de conteúdo é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
ContentImpressionShare Double MÉTRICA As impressões recebidas na Rede de Display divididas pelo número estimado de impressões que você estava qualificado para receber. Observação: a parcela de impressões de conteúdo é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
ContentRankLostImpressionShare Double MÉTRICA A porcentagem estimada de impressões na Rede de Display que seus anúncios não receberam devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas da classificação do conteúdo é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsByConversionDate Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValueByConversionDate Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostPerCurrentModelAttributedConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões atribuídas ao modelo atual. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
CurrentModelAttributedConversions Double MÉTRICA Mostra como seus dados históricos de conversões ficariam no modelo de atribuição que você selecionou no momento. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CurrentModelAttributedConversionsFromInteractionsRate Double MÉTRICA O modelo atual atribuiu conversões de interações divididas pelo número de interações com anúncios (como cliques para anúncios de texto ou visualizações para anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CurrentModelAttributedConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor das conversões atribuídas ao modelo atual de interações dividido pelo número de interações com o anúncio. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CurrentModelAttributedConversionsValue Double MÉTRICA O valor das conversões atribuídas ao modelo atual. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CurrentModelAttributedConversionsValuePerCost Double MÉTRICA O valor das conversões atribuídas ao modelo atual dividido pelo custo das interações com o anúncio. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
InvalidClickRate Double MÉTRICA A porcentagem de cliques filtrados de seu número total de cliques (filtrados + não filtrados) durante o período do relatório.
InvalidClicks Long MÉTRICA Número de cliques que o Google considera ilegítimos e pelos quais não cobra.
OptimizationScoreUplift Double MÉTRICA Aumento total da pontuação de otimização de todas as recomendações.
OptimizationScoreUrl String MÉTRICA URL da página de pontuação de otimização na interface da Web do Google Ads. Essa métrica pode ser selecionada de cliente ou campanha e pode ser segmentada por segmentos.recommendation_type. Por exemplo, SELECTmetrics.optimization_score_url, segment.recommendation_type FROM customer retornará uma URL para cada combinação exclusiva (cliente, tipo_de_recomendação).
PercentNewVisitors Double MÉTRICA Porcentagem de sessões pela primeira vez (de pessoas que nunca visitaram seu site antes). Importado do Google Analytics.
PhoneCalls Long MÉTRICA Número de chamadas telefônicas off-line.
PhoneImpressions Long MÉTRICA Número de impressões telefônicas off-line.
PhoneThroughRate Double MÉTRICA Número de chamadas telefônicas recebidas (phone_calls) dividido pelo número de vezes que seu número de telefone é exibido (phone_impressions).
RelativeCtr Double MÉTRICA Sua taxa de cliques (Ctr) dividida pela taxa média de cliques de todos os anunciantes nos sites que exibem seus anúncios. Mede o desempenho de seus anúncios em sites da Rede de Display em comparação com outros anúncios nos mesmos sites.
SearchAbsoluteTopImpressionShare Double MÉTRICA A porcentagem de impressões de anúncios do Shopping ou de pesquisa do cliente que são exibidas na posição mais proeminente do Shopping. Ver https://support.google.com/google-ads/answer/7501826 para detalhes. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchBudgetLostAbsoluteTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi o primeiro anúncio acima dos resultados da pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões absolutas na parte superior perdida do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchBudgetLostImpressionShare Double MÉTRICA A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na Rede de Pesquisa, mas não porque seu orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchBudgetLostTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi exibido acima dos resultados de pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões na parte superior perdida do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchClickShare Double MÉTRICA O número de cliques que você recebeu na Rede de Pesquisa dividido pelo número estimado de cliques que você estava qualificado para receber. Observação: a parcela de cliques de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchExactMatchImpressionShare Double MÉTRICA As impressões recebidas divididas pelo número estimado de impressões que você estava qualificado para receber na Rede de Pesquisa para termos de pesquisa que correspondiam exatamente às suas palavras-chave (ou eram variantes aproximadas de sua palavra-chave), independentemente dos tipos de correspondência de palavras-chave. Observação: a parcela de impressões de correspondência exata da pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchImpressionShare Double MÉTRICA As impressões que você recebeu na Rede de Pesquisa divididas pelo número estimado de impressões que você estava qualificado para receber. Observação: a parcela de impressões de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchRankLostAbsoluteTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi o primeiro anúncio acima dos resultados da pesquisa orgânica devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões absolutas perdidas na classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchRankLostImpressionShare Double MÉTRICA A porcentagem estimada de impressões na rede de pesquisa que seus anúncios não receberam devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas da classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchRankLostTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi exibido em nenhum lugar acima dos resultados de pesquisa orgânica devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas na classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchTopImpressionShare Double MÉTRICA As impressões que você recebeu no local superior (em qualquer lugar acima dos resultados da pesquisa orgânica) em comparação com o número estimado de impressões que você estava qualificado para receber no local superior. Observação: a parcela de impressões na parte superior da pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SkAdNetworkConversions Long MÉTRICA O número de conversões da rede de anúncios do kit da loja iOS.
TopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas em qualquer lugar acima dos resultados de pesquisa orgânica.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerAllConversionsByConversionDate Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ValuePerConversionsByConversionDate Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ValuePerCurrentModelAttributedConversion Double MÉTRICA O valor das conversões atribuídas ao modelo atual dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdDestinationType String SEGMENTO Tipo de destino do anúncio. Os valores permitidos são APP_DEEP_LINK, APP_STORE, LEAD_FORM, LOCATION_LISTING, MAP_DIRECTIONS, MESSAGE, NOT_APPLICABLE, PHONE_CALL, UNKNOWN, UNMODELED_FOR_CONVERSIONS, UNSPECIFIED, WEBSITE, YOUTUBE.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
ConversionAdjustment Bool SEGMENTO Isso segmenta suas colunas de conversão pela conversão original e pelo valor da conversão em comparação com o delta se as conversões forem ajustadas. A linha falsa contém os dados conforme declarados originalmente; Embora a linha verdadeira tenha o delta entre os dados agora e os dados originalmente declarados. A soma dos dois resulta em dados pós-ajuste.
ConversionAttributionEventType String SEGMENTO Tipo de evento de atribuição de conversão. Os valores permitidos são IMPRESSÃO, INTERAÇÃO, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionLagBucket String SEGMENTO Um valor de enumeração que representa o número de dias entre a impressão e a conversão. Os valores permitidos são EIGHT_TO_NINE_DAYS, ELEVEN_TO_TWELVE_DAYS, FIVE_TO_SIX_DAYS, FORTY_FIVE_TO_SIXTY_DAYS, FOURTEEN_TO_TWENTY_ONE_DAYS, FOUR_TO_FIVE_DAYS, LESS_THAN_ONE_DAY, NINE_TO_TEN_DAYS, ONE_TO_TWO_DAYS, SEVEN_TO_EIGHT_DAYS S, SEXTY_TO_NINETY_DAYS, SIX_TO_SEVEN_DAYS, TEN_TO_ELEVEN_DAYS, TREZE_TO_FOURTEEN_DAYS, TRINTA_TO_FORTY_FIVE_DAYS, TRÊS_TO_FOUR_DAYS, DOZE_TO_THIRTEEN_DAYS, TWENTY_ONE_TO_THIRTY_DAYS, DOIS_TO_THREE_DAYS, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionOrAdjustmentLagBucket String SEGMENTO Um valor de enumeração que representa o número de dias entre a impressão e a conversão ou entre a impressão e os ajustes na conversão. Os valores permitidos são ADJUSTMENT_EIGHT_TO_NINE_DAYS, ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS, ADJUSTMENT_FIVE_TO_SIX_DAYS, ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS, ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS, ADJUSTMENT_FOUR_TO_FIVE_DAYS, ADJUSTMENT_LESS_THAN_ONE_DAY, ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS, ADJUSTMENT_NINE_TO_TEN_DAYS, ADJUSTMENT_ONE_TO_TWO_DAYS, ADJUSTMENT_SEVEN_TO_EIGHT_DAYS, ADJUSTMENT_SIXTY_TO_NINETY_DAYS, ADJUSTMENT_SIX_TO_SEVEN_DAYS, ADJUSTMENT_TEN_TO_ELEVEN_DAYS, ADJUSTMENT_THIRTEEN_ TO_FOURTEEN_DAYS, ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS, ADJUSTMENT_THREE_TO_FOUR_DAYS, ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS, ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS, ADJUSTMENT_TWO_TO_THREE_DAYS, ADJUSTMENT_UNKNOWN, CONVERSION_EIGHT_TO_NINE_DAYS, CONVERSION_ELEVEN_TO_TWELVE_DAYS, CONVERSION_FIVE_TO_SIX_DAYS, CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS, CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS, CONVERSION_FOUR_TO_FIVE_DAYS, CONVERSION_LESS_THAN_ONE_DAY, CONVERSION_NINE_TO_TEN_DAYS, CONVERSION_ONE_TO_TWO_DAYS, CONVERSION_SEVEN_TO_ OITO_DIAS, CONVERSION_SIXTY_TO_NINETY_DAYS, CONVERSION_SIX_TO_SEVEN_DAYS, CONVERSION_TEN_TO_ELEVEN_DAYS, CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS, CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS, CONVERSION_THREE_TO_FOUR_DAYS, CONVERSION_TWELVE_TO_THIRTEEN_DAYS, CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS, CONVERSION_TWO_TO_THREE_DAYS, CONVERSION_UNKNOWN, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionValueRulePrimaryDimension String SEGMENTO Dimensão principal das regras de valor de conversão aplicadas. NO_RULE_APPLIED mostra o valor total registrado de conversões que não têm uma regra de valor aplicada. ORIGINAL mostra o valor original das conversões às quais uma regra de valor foi aplicada. GEO_LOCATION, DEVICE, AUDIENCE mostram o ajuste líquido após a aplicação das regras de valor. Os valores permitidos são AUDIENCE, DEVICE, GEO_LOCATION, MULTIPLE, NEW_VS_RETURNING_USER, NO_RULE_APPLIED, ORIGINAL, UNKNOWN, UNSPECIFIED.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Hour Int SEGMENTO Hora do dia como um número entre 0 e 23, inclusive.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
RecommendationType String SEGMENTO Tipo de recomendação. Os valores permitidos são CALLOUT_EXTENSION, CALL_EXTENSION, CAMPAIGN_BUDGET, ENHANCED_CPC_OPT_IN, FORECASTING_CAMPAIGN_BUDGET, KEYWORD, KEYWORD_MATCH_TYPE, MARGINAL_ROI_CAMPAIGN_BUDGET, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MOVE_UNUSED_BUDGET, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UNKNOWN, UNSPECIFIED, USE_BROAD_MATCH_KEYWORD.
SkAdNetworkAdEventType String SEGMENTO Tipo de evento de anúncio do iOS Store Kit Ad Network. Os valores permitidos são INTERAÇÃO, INDISPONÍVEL, DESCONHECIDO, NÃO ESPECIFICADO, VISUALIZAR.
SkAdNetworkConversionValue Long SEGMENTO Valor de conversão da rede de anúncios do kit da loja iOS. Valor nulo significa que este segmento não é aplicável, por exemplo campanha não iOS.
SkAdNetworkSourceAppSkAdNetworkSourceAppId String SEGMENTO ID do aplicativo em que o anúncio que impulsionou a instalação da rede de anúncios do Kit da loja iOS foi exibido.
SkAdNetworkUserType String SEGMENTO Tipo de usuário da rede de anúncios do kit da loja iOS. Os valores permitidos são NEW_INSTALLER, REINSTALLER, UNAVAILABLE, UNKNOWN, UNSPECIFIED.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Recurso da Campanha

Um link entre uma campanha e um ativo.

Colunas
Nome Tipo Comportamento Descrição
CampaignAssetAsset String ATRIBUTO Imutável. O recurso que está vinculado à campanha.
CampaignAssetCampaign String ATRIBUTO Imutável. A campanha à qual o ativo está vinculado.
CampaignAssetFieldType String ATRIBUTO Imutável. Função que o recurso assume na campanha vinculada. Obrigatório. Os valores permitidos são BOOK_ON_GOOGLE, BUSINESS_NAME, CALL, CALLOUT, CALL_TO_ACTION_SELECTION, DESCRIPTION, HEADLINE, HOTEL_CALLOUT, LANDSCAPE_LOGO, LEAD_FORM, LOGO, LONG_HEADLINE, MANDATORY_AD_TEXT, MARKETING_IMAGE, MEDIA_BUNDLE, MOBILE_APP, PORTRAIT_MARKETING_IMAGE, PRICE, PROMOÇÃO, SITELINK, SQUARE_MARKETING_IMAGE, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO, VÍDEO, YOUTUBE_VIDEO.
CampaignAssetResourceName String ATRIBUTO Imutável. O nome do recurso do ativo da campanha. Os nomes dos recursos CampaignAsset têm o formato: customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}
CampaignAssetStatus String ATRIBUTO Status do ativo da campanha. Os valores permitidos são ATIVADO, PAUSADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
PhoneCalls Long MÉTRICA Número de chamadas telefônicas off-line.
PhoneImpressions Long MÉTRICA Número de impressões telefônicas off-line.
PhoneThroughRate Double MÉTRICA Número de chamadas telefônicas recebidas (phone_calls) dividido pelo número de vezes que seu número de telefone é exibido (phone_impressions).
TopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas em qualquer lugar acima dos resultados de pesquisa orgânica.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
AssetInteractionTargetAsset String SEGMENTO O nome do recurso ativo.
AssetInteractionTargetInteractionOnThisAsset Bool SEGMENTO Usado apenas com as métricas CustomerAsset, CampaignAsset e AdGroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Conjunto de Ativos da Campanha

CampaignAssetSet é a ligação entre uma campanha e um conjunto de ativos. Adicionar um CampaignAssetSet vincula um conjunto de ativos a uma campanha.

Colunas
Nome Tipo Comportamento Descrição
CampaignAssetSetAssetSet String ATRIBUTO Imutável. O conjunto de ativos vinculado à campanha.
CampaignAssetSetCampaign String ATRIBUTO Imutável. A campanha à qual este conjunto de recursos está vinculado.
CampaignAssetSetResourceName String ATRIBUTO Imutável. O nome do recurso do conjunto de ativos da campanha. Os nomes dos recursos de ativos do conjunto de recursos têm o formato: clientes/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}
CampaignAssetSetStatus String ATRIBUTO Somente saída. O status do ativo do conjunto de ativos da campanha. Somente leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
CampaignAudienceView

Uma visualização do público da campanha. Inclui dados de desempenho de interesses e listas de remarketing para anúncios da Rede de Display e do YouTube e listas de remarketing para anúncios da rede de pesquisa (RLSA), agregados por critério de campanha e público-alvo. Essa exibição inclui apenas públicos vinculados no nível da campanha.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CampaignAudienceViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização de público da campanha. Os nomes dos recursos de exibição de público-alvo da campanha têm o formato: clientes/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsByConversionDate Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValueByConversionDate Double MÉTRICA O valor de todas as conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsByConversionDate Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValueByConversionDate Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerAllConversionsByConversionDate Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ValuePerConversionsByConversionDate Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
HotelDateSelectionType String SEGMENTO Tipo de seleção de data do hotel. Os valores permitidos são DEFAULT_SELECTION, UNKNOWN, UNSPECIFIED, USER_SELECTED.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
CampaignBidModifier

Representa um critério somente modificável por lance no nível da campanha.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CampaignBidModifierBidModifier Double ATRIBUTO O modificador para o lance quando o critério corresponde.
CampaignBidModifierCampaign String ATRIBUTO Somente saída. A campanha à qual este critério pertence.
CampaignBidModifierCriterionId Long ATRIBUTO Somente saída. O ID do critério para modificar o lance. Este campo é ignorado para mutações.
CampaignBidModifierInteractionTypeType String ATRIBUTO O tipo de interação. Os valores permitidos são CALLS, UNKNOWN, UNSPECIFIED.
CampaignBidModifierResourceName String ATRIBUTO Imutável. O nome do recurso do modificador de lance da campanha. Os nomes dos recursos do modificador de lance da campanha têm o formato: customers/{customer_id}/campaignBidModifiers/{campaign_id}~{criterion_id}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Orçamento de Campanha

Um orçamento de campanha.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CampaignBudgetAmountMicros Long ATRIBUTO O valor do orçamento, na moeda local da conta. O valor é especificado em micros, onde um milhão é equivalente a uma unidade monetária. O gasto mensal é limitado a 30,4 vezes esse valor.
CampaignBudgetDeliveryMethod String ATRIBUTO O método de entrega que determina a taxa na qual o orçamento da campanha é gasto. O padrão é STANDARD se não for especificado em uma operação de criação. Os valores permitidos são ACELERADO, PADRÃO, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignBudgetExplicitlyShared Bool ATRIBUTO Especifica se o orçamento é explicitamente compartilhado. O padrão é true se não for especificado em uma operação de criação. Se verdadeiro, o orçamento foi criado com o objetivo de compartilhar em uma ou mais campanhas. Se falso, o orçamento foi criado com a intenção de ser usado apenas em uma única campanha. O nome e o status do orçamento permanecerão sincronizados com o nome e o status da campanha. Tentar compartilhar o orçamento com uma segunda campanha resultará em erro. Um orçamento não compartilhado pode se tornar explicitamente compartilhado. A mesma operação também deve atribuir um nome ao orçamento. Um orçamento de campanha compartilhado nunca pode se tornar não compartilhado.
CampaignBudgetHasRecommendedBudget Bool ATRIBUTO Somente saída. Indica se há um orçamento recomendado para este orçamento de campanha. Este campo é só de leitura.
CampaignBudgetId Long ATRIBUTO Somente saída. O ID do orçamento da campanha. Um orçamento de campanha é criado usando a operação de criação CampaignBudgetService e recebe um ID de orçamento. Um ID de orçamento pode ser compartilhado entre diferentes campanhas; o sistema então alocará o orçamento da campanha entre diferentes campanhas para obter os melhores resultados.
CampaignBudgetName String ATRIBUTO O nome do orçamento da campanha. Ao criar um orçamento de campanha por meio de CampaignBudgetService, todo orçamento de campanha explicitamente compartilhado deve ter um nome não nulo e não vazio. Os orçamentos de campanha que não são explicitamente compartilhados derivam seu nome do nome da campanha anexada. O comprimento desta string deve estar entre 1 e 255, inclusive, em UTF-8 bytes, (aparados).
CampaignBudgetPeriod String ATRIBUTO Imutável. Período durante o qual gastar o orçamento. O padrão é DIÁRIO se não for especificado. Os valores permitidos são CUSTOM_PERIOD, DAILY, UNKNOWN, UNSPECIFIED.
CampaignBudgetRecommendedBudgetAmountMicros Long ATRIBUTO Somente saída. O valor do orçamento recomendado. Se nenhuma recomendação estiver disponível, isso será definido como o valor do orçamento. O valor é especificado em micros, onde um milhão é equivalente a uma unidade monetária. Este campo é só de leitura.
CampaignBudgetRecommendedBudgetEstimatedChangeWeeklyClicks Long ATRIBUTO Somente saída. A alteração estimada em cliques semanais se o orçamento recomendado for aplicado. Este campo é só de leitura.
CampaignBudgetRecommendedBudgetEstimatedChangeWeeklyCostMicros Long ATRIBUTO Somente saída. A alteração estimada no custo semanal em micros se o orçamento recomendado for aplicado. Um milhão é equivalente a uma unidade monetária. Este campo é só de leitura.
CampaignBudgetRecommendedBudgetEstimatedChangeWeeklyInteractions Long ATRIBUTO Somente saída. A alteração estimada nas interações semanais se o orçamento recomendado for aplicado. Este campo é só de leitura.
CampaignBudgetRecommendedBudgetEstimatedChangeWeeklyViews Long ATRIBUTO Somente saída. A alteração estimada nas visualizações semanais se o orçamento recomendado for aplicado. Este campo é só de leitura.
CampaignBudgetReferenceCount Long ATRIBUTO Somente saída. O número de campanhas que usam ativamente o orçamento. Este campo é só de leitura.
CampaignBudgetResourceName String ATRIBUTO Imutável. O nome do recurso do orçamento da campanha. Os nomes dos recursos de orçamento de campanha têm o formato: clientes/{customer_id}/campaignBudgets/{campaign_budget_id}
CampaignBudgetStatus String ATRIBUTO Somente saída. O status do orçamento desta campanha. Este campo é só de leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignBudgetTotalAmountMicros Long ATRIBUTO O valor vitalício do orçamento, na moeda local da conta. O valor é especificado em micros, onde um milhão é equivalente a uma unidade monetária.
CampaignBudgetType String ATRIBUTO Imutável. O tipo de orçamento da campanha. Os valores permitidos são FIXED_CPA, LOCAL_SERVICES, SMART_CAMPAIGN, STANDARD, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
BudgetCampaignAssociationStatusCampaign String SEGMENTO O nome do recurso da campanha.
BudgetCampaignAssociationStatusStatus String SEGMENTO Status de associação da campanha de orçamento. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Objetivo de Conversão da Campanha

A configuração de capacidade de lance para a campanha especificada somente para todas as ações de conversão com categoria e origem correspondentes.

Colunas
Nome Tipo Comportamento Descrição
CampaignConversionGoalBiddable Bool ATRIBUTO A capacidade de lance da meta de conversão da campanha.
CampaignConversionGoalCampaign String ATRIBUTO Imutável. A campanha à qual essa meta de conversão de campanha está associada.
CampaignConversionGoalCategory String ATRIBUTO A categoria de conversão dessa meta de conversão da campanha. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignConversionGoalOrigin String ATRIBUTO A origem da conversão dessa meta de conversão da campanha. Os valores permitidos são APP, CALL_FROM_ADS, GOOGLE_HOSTED, STORE, UNKNOWN, UNSPECIFIED, WEBSITE, YOUTUBE_HOSTED.
CampaignConversionGoalResourceName String ATRIBUTO Imutável. O nome do recurso da meta de conversão da campanha. Os nomes dos recursos da meta de conversão da campanha têm o formato: customers/{customer_id}/campaignConversionGoals/{campaign_id}~{category}~{origin}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Critério de Campanha

Um critério de campanha.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CampaignCriterionAdScheduleDayOfWeek String ATRIBUTO Dia da semana ao qual a programação se aplica. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
CampaignCriterionAdScheduleEndHour Int ATRIBUTO Hora final em 24 horas; 24 significa fim do dia. Este campo deve estar entre 0 e 24, inclusive. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.
CampaignCriterionAdScheduleEndMinute String ATRIBUTO Minutos após a hora final em que esta programação termina. O horário é exclusivo do minuto final. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. Os valores permitidos são FIFTEEN, FORTY_FIVE, THIRTY, UNKNOWN, UNSPECIFIED, ZERO.
CampaignCriterionAdScheduleStartHour Int ATRIBUTO Hora inicial em 24 horas. Este campo deve estar entre 0 e 23, inclusive. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.
CampaignCriterionAdScheduleStartMinute String ATRIBUTO Minutos após a hora de início em que esta programação começa. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. Os valores permitidos são FIFTEEN, FORTY_FIVE, THIRTY, UNKNOWN, UNSPECIFIED, ZERO.
CampaignCriterionAgeRangeType String ATRIBUTO Tipo da faixa etária. Os valores permitidos são AGE_RANGE_18_24, AGE_RANGE_25_34, AGE_RANGE_35_44, AGE_RANGE_45_54, AGE_RANGE_55_64, AGE_RANGE_65_UP, AGE_RANGE_UNDETERMINED, UNKNOWN, UNSPECIFIED.
CampaignCriterionBidModifier String ATRIBUTO O modificador para os lances quando o critério corresponde. O modificador deve estar no intervalo: 0,1 - 10,0. A maioria dos tipos de critérios segmentáveis oferece suporte a modificadores. Use 0 para desativar um tipo de dispositivo.
CampaignCriterionCampaign String ATRIBUTO Imutável. A campanha à qual o critério pertence.
CampaignCriterionCarrierCarrierConstant String ATRIBUTO O nome do recurso da constante Carrier.
CampaignCriterionCombinedAudienceCombinedAudience String ATRIBUTO O nome do recurso CombinedAudience.
CampaignCriterionContentLabelType String ATRIBUTO Tipo de rótulo de conteúdo, necessário para operações CREATE. Os valores permitidos são BELOW_THE_FOLD, EMBEDDED_VIDEO, JUVENILE, LIVE_STREAMING_VIDEO, PARKED_DOMAIN, PROFANITY, SEXUALLY_SUGGESTIVE, SOCIAL_ISSUES, TRAGEDY, UNKNOWN, UNSPECIFIED, VIDEO, VIDEO_NOT_YET_RATED, VIDEO_RATING_DV_G, VIDEO_RATING_DV_MA, VIDEO_RATING_DV_PG, VIDEO_RATING_DV_T.
CampaignCriterionCriterionId Long ATRIBUTO Somente saída. O ID do critério. Este campo é ignorado durante a mutação.
CampaignCriterionCustomAffinityCustomAffinity String ATRIBUTO O nome do recurso CustomInterest.
CampaignCriterionCustomAudienceCustomAudience String ATRIBUTO O nome do recurso CustomAudience.
CampaignCriterionDeviceType String ATRIBUTO Tipo do dispositivo. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
CampaignCriterionDisplayName String ATRIBUTO Somente saída. O nome de exibição do critério. Este campo é ignorado para mutações.
CampaignCriterionGenderType String ATRIBUTO Tipo do gênero. Os valores permitidos são FEMALE, MALE, INDETERMINADO, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignCriterionIncomeRangeType String ATRIBUTO Tipo da faixa de renda. Os valores permitidos são INCOME_RANGE_0_50, INCOME_RANGE_50_60, INCOME_RANGE_60_70, INCOME_RANGE_70_80, INCOME_RANGE_80_90, INCOME_RANGE_90_UP, INCOME_RANGE_UNDETERMINED, UNKNOWN, UNSPECIFIED.
CampaignCriterionIpBlockIpAddress String ATRIBUTO O endereço IP deste bloco de IP.
CampaignCriterionKeywordMatchType String ATRIBUTO O tipo de correspondência da palavra-chave. Os valores permitidos são BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
CampaignCriterionKeywordText String ATRIBUTO O texto da palavra-chave (no máximo 80 caracteres e 10 palavras).
CampaignCriterionKeywordThemeFreeFormKeywordTheme String ATRIBUTO Texto de formato livre a ser correspondido a uma constante de tema de palavra-chave de campanha inteligente com base no melhor esforço.
CampaignCriterionKeywordThemeKeywordThemeConstant String ATRIBUTO O nome do recurso de uma constante de tema de palavra-chave de campanha inteligente. keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}
CampaignCriterionLanguageLanguageConstant String ATRIBUTO O nome do recurso constante de idioma.
CampaignCriterionListingScopeDimensions String ATRIBUTO Escopo do critério da campanha.
CampaignCriterionLocationGeoTargetConstant String ATRIBUTO O nome do recurso constante de segmentação geográfica.
CampaignCriterionLocationGroup String ATRIBUTO Imutável. Grupo de localização
CampaignCriterionLocationGroupFeed String ATRIBUTO Feed especificando locais para segmentação. Isso é obrigatório e deve ser definido nas operações CREATE.
CampaignCriterionMobileAppCategoryMobileAppCategoryConstant String ATRIBUTO O nome do recurso constante da categoria do aplicativo móvel.
CampaignCriterionMobileApplicationAppId String ATRIBUTO Uma string que identifica exclusivamente um aplicativo para celular para a Google Ads API. O formato dessa string é "{platform}-{platform_native_id}", onde platform é "1" para aplicativos iOS e "2" para aplicativos Android, e platform_native_id é o identificador de aplicativo móvel nativo da plataforma correspondente. Para iOS, esse identificador nativo é a sequência de 9 dígitos que aparece no final de um URL da App Store (por exemplo, "476943146" para "Flood-It! 2" cujo link da App Store é " http://itunes.apple.com/us/app/flood-it!-2/id476943146 "). Para Android, esse identificador nativo é o nome do pacote do aplicativo (por exemplo, "com.labpixies.colordrips" para "Color Drips" dado o link do Google Play " <a
href="https://play.google.com/store/apps/details?id=com.labpixies.colordrips">https://play.google.com/store/apps/details?id=com .labpixies.colordrips "). Um ID de aplicativo bem formado para a Google Ads API seria "1-476943146" para iOS e "2-com.labpixies.colordrips" para Android. Este campo é obrigatório e deve ser definido nas operações CREATE.
CampaignCriterionMobileApplicationName String ATRIBUTO Nome deste aplicativo móvel.
CampaignCriterionMobileDeviceMobileDeviceConstant String ATRIBUTO O nome do recurso constante do dispositivo móvel.
CampaignCriterionNegative Bool ATRIBUTO Imutável. Se deve segmentar (falso) ou excluir (verdadeiro) o critério.
CampaignCriterionOperatingSystemVersionOperatingSystemVersionConstant String ATRIBUTO O nome do recurso constante da versão do sistema operacional.
CampaignCriterionParentalStatusType String ATRIBUTO Tipo do status parental. Os valores permitidos são NOT_A_PARENT, PARENT, INDETERMINED, UNKNOWN, UNSPECIFIED.
CampaignCriterionPlacementUrl String ATRIBUTO URL da veiculação. Por exemplo, "http://www.domain.com.
CampaignCriterionProximityAddressCityName String ATRIBUTO Nome da cidade.
CampaignCriterionProximityAddressCountryCode String ATRIBUTO Código do país.
CampaignCriterionProximityAddressPostalCode String ATRIBUTO Código postal.
CampaignCriterionProximityAddressProvinceCode String ATRIBUTO Província ou código do estado.
CampaignCriterionProximityAddressProvinceName String ATRIBUTO Província ou nome do estado.
CampaignCriterionProximityAddressStreetAddress String ATRIBUTO Rua endereço linha 1.
CampaignCriterionProximityGeoPointLatitudeInMicroDegrees Int ATRIBUTO Micrograus para a latitude.
CampaignCriterionProximityGeoPointLongitudeInMicroDegrees Int ATRIBUTO Micrograus para a longitude.
CampaignCriterionProximityRadius Double ATRIBUTO O raio da proximidade.
CampaignCriterionProximityRadiusUnits String ATRIBUTO A unidade de medida do raio. O padrão é QUILÔMETROS. Os valores permitidos são QUILÔMETROS, MILHAS, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignCriterionResourceName String ATRIBUTO Imutável. O nome do recurso do critério da campanha. Os nomes dos recursos do critério da campanha têm o formato: customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
CampaignCriterionStatus String ATRIBUTO O status do critério. Os valores permitidos são ATIVADO, PAUSADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignCriterionTopicPath String ATRIBUTO A categoria a segmentar ou excluir. Cada elemento subsequente na matriz descreve uma subcategoria mais específica. Por exemplo, "Pets & Animals", "Pets", "Cães" representa a categoria "Pets & Animals/Pets/Cães".
CampaignCriterionTopicTopicConstant String ATRIBUTO O nome do recurso da constante de tópico.
CampaignCriterionType String ATRIBUTO Somente saída. O tipo do critério. Os valores permitidos são AD_SCHEDULE, AGE_RANGE, APP_PAYMENT_MODEL, AUDIENCE, CARRIER, COMBINED_AUDIENCE, CONTENT_LABEL, CUSTOM_AFFINITY, CUSTOM_AUDIENCE, CUSTOM_INTENT, DEVICE, GENDER, INCOME_RANGE, IP_BLOCK, KEYWORD, KEYWORD_THEME, LANGUAGE, LISTING_GROUP, LIST ING_SCOPE, LOCATION, LOCATION_GROUP, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, MOBILE_DEVICE, OPERATING_SYSTEM_VERSION, PARENTAL_STATUS, PLACEMENT, PROXIMITY, TOPIC, UNKNOWN, UNSPECIFIED, USER_INTEREST, USER_LIST, WEBPAGE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO.
CampaignCriterionUserInterestUserInterestCategory String ATRIBUTO O nome do recurso UserInterest.
CampaignCriterionUserListUserList String ATRIBUTO O nome do recurso Lista de usuários.
CampaignCriterionWebpageConditions String ATRIBUTO Condições ou expressões lógicas para segmentação de página da web. A lista de condições de segmentação de página da web é agrupada quando avaliada para segmentação. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.
CampaignCriterionWebpageCoveragePercentage Double ATRIBUTO Porcentagem de cobertura dos critérios do site. Esta é a porcentagem calculada de cobertura do site com base no destino do site, destino do site negativo e palavras-chave negativas no grupo de anúncios e na campanha. Por exemplo, quando a cobertura retorna como 1, indica que tem 100% de cobertura. Este campo é só de leitura.
CampaignCriterionWebpageCriterionName String ATRIBUTO O nome do critério definido por este parâmetro. O valor do nome será usado para identificar, classificar e filtrar os critérios com esse tipo de parâmetro. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.
CampaignCriterionWebpageSampleSampleUrls String ATRIBUTO URLs de exemplo de página da Web
CampaignCriterionYouTubeChannelChannelId String ATRIBUTO O ID do canal do uploader do YouTube ou o código do canal de um canal do YouTube.
CampaignCriterionYouTubeVideoVideoId String ATRIBUTO ID do vídeo do YouTube conforme aparece na página de exibição do YouTube.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Simulação de Critério de Campanha

Uma simulação de critério de campanha. As combinações suportadas de tipo de canal de publicidade, IDs de critério, tipo de simulação e método de modificação de simulação são detalhadas abaixo, respectivamente. 1. PESQUISA - 30000,30001,30002 - BID_MODIFIER - UNIFORME 2. DISPLAY - 30001 - BID_MODIFIER - UNIFORME

Colunas
Nome Tipo Comportamento Descrição
CampaignCriterionSimulationBidModifierPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores de modificadores de lance.
CampaignCriterionSimulationCampaignId Long ATRIBUTO Somente saída. ID da campanha da simulação.
CampaignCriterionSimulationCriterionId Long ATRIBUTO Somente saída. ID do critério da simulação.
CampaignCriterionSimulationEndDate Date ATRIBUTO Somente saída. Último dia em que se baseia a simulação, no formato AAAA-MM-DD.
CampaignCriterionSimulationModificationMethod String ATRIBUTO Somente saída. Como a simulação modifica o campo. Os valores permitidos são PADRÃO, ESCALA, UNIFORME, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignCriterionSimulationResourceName String ATRIBUTO Somente saída. O nome do recurso da simulação do critério da campanha. Os nomes dos recursos de simulação de critério de campanha têm o formato: clientes/{customer_id}/campaignCriterionSimulations/{campaign_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}
CampaignCriterionSimulationStartDate Date ATRIBUTO Somente saída. Primeiro dia em que se baseia a simulação, no formato AAAA-MM-DD.
CampaignCriterionSimulationType String ATRIBUTO Somente saída. O campo que a simulação modifica. Os valores permitidos são BID_MODIFIER, BUDGET, CPC_BID, CPV_BID, PERCENT_CPC_BID, TARGET_CPA, TARGET_IMPRESSION_SHARE, TARGET_ROAS, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Personalizador de Campanha

Um valor do personalizador para o CustomizerAttribute associado no nível da campanha.

Colunas
Nome Tipo Comportamento Descrição
CampaignCustomizerCampaign String ATRIBUTO Imutável. A campanha à qual o atributo do personalizador está vinculado.
CampaignCustomizerCustomizerAttribute String ATRIBUTO Obrigatório. Imutável. O atributo do personalizador que está vinculado à campanha.
CampaignCustomizerResourceName String ATRIBUTO Imutável. O nome do recurso do personalizador de campanha. Os nomes dos recursos do personalizador de campanha têm o formato: customers/{customer_id}/campaignCustomizers/{campaign_id}~{customizer_attribute_id}
CampaignCustomizerStatus String ATRIBUTO Somente saída. O status do personalizador de campanha. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignCustomizerValueStringValue String ATRIBUTO Obrigatório. Valor a ser inserido no texto criativo. Os valores do personalizador de todos os tipos são armazenados como string para tornar a formatação inequívoca.
CampaignCustomizerValueType String ATRIBUTO Obrigatório. O tipo de dados para o valor do personalizador. Ele deve corresponder ao tipo de atributo. O conteúdo string_value deve corresponder às restrições associadas ao tipo. Os valores permitidos são NÚMERO, PORCENTO, PREÇO, TEXTO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Rascunho da Campanha

Um rascunho de campanha.

Colunas
Nome Tipo Comportamento Descrição
CampaignDraftBaseCampaign String ATRIBUTO Imutável. A campanha base à qual o rascunho pertence.
CampaignDraftDraftCampaign String ATRIBUTO Somente saída. Nome do recurso da campanha resultante da sobreposição das alterações de rascunho na campanha base. Este campo é só de leitura.
CampaignDraftDraftId Long ATRIBUTO Somente saída. A ID do rascunho. Este campo é só de leitura.
CampaignDraftHasExperimentRunning Bool ATRIBUTO Somente saída. Se há um experimento baseado neste rascunho sendo veiculado no momento.
CampaignDraftLongRunningOperation String ATRIBUTO Somente saída. O nome do recurso da operação de longa duração que pode ser usada para sondar a conclusão da promoção de rascunho. Isso só é definido se a promoção de rascunho estiver em andamento ou concluída.
CampaignDraftName String ATRIBUTO O nome do rascunho da campanha. Este campo é obrigatório e não deve ficar vazio ao criar novos rascunhos de campanha. Ele não deve conter nenhum caractere nulo (ponto de código 0x0), avanço de linha NL (ponto de código 0xA) ou retorno de linha (ponto de código 0xD).
CampaignDraftResourceName String ATRIBUTO Imutável. O nome do recurso do rascunho da campanha. Os nomes dos recursos de rascunho da campanha têm o formato: customers/{customer_id}/campaignDrafts/{base_campaign_id}~{draft_id}
CampaignDraftStatus String ATRIBUTO Somente saída. O status do rascunho da campanha. Este campo é só de leitura. Quando um novo rascunho de campanha é adicionado, o status padrão é PROPOSTO. Os valores permitidos são PROMOTED, PROMOTE_FAILED, PROMOTING, PROPOSED, REMOVED, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
CampanhaExperiência

Um experimento A/B que compara o desempenho da campanha base (o controle) e uma variação dessa campanha (o experimento).

Colunas
Nome Tipo Comportamento Descrição
CampaignExperimentCampaignDraft String ATRIBUTO Imutável. O rascunho da campanha com alterações graduadas na campanha base.
CampaignExperimentDescription String ATRIBUTO A descrição do experimento.
CampaignExperimentEndDate Date ATRIBUTO O último dia do experimento da campanha. Por padrão, o experimento termina na data de término da campanha. Se esse campo for definido, o experimento terminará no final da data especificada no fuso horário do cliente. Formato: AAAA-MM-DD Exemplo: 2019-04-18
CampaignExperimentExperimentCampaign String ATRIBUTO Somente saída. A campanha experimental, em oposição à campanha base.
CampaignExperimentId Long ATRIBUTO Somente saída. O ID da experiência de campanha. Este campo é só de leitura.
CampaignExperimentLongRunningOperation String ATRIBUTO Somente saída. O nome do recurso da operação de longa duração que pode ser usada para pesquisar a conclusão da criação ou promoção do experimento. A operação de execução longa mais recente é retornada.
CampaignExperimentName String ATRIBUTO O nome da experiência de campanha. Este campo é obrigatório ao criar novas experiências de campanha e não deve entrar em conflito com o nome de outra campanha ou experiência de campanha não removida. Ele não deve conter nenhum caractere nulo (ponto de código 0x0), avanço de linha NL (ponto de código 0xA) ou retorno de linha (ponto de código 0xD).
CampaignExperimentResourceName String ATRIBUTO Imutável. O nome do recurso da experiência de campanha. Os nomes dos recursos de experiência de campanha têm o formato: customers/{customer_id}/campaignExperiments/{campaign_experiment_id}
CampaignExperimentStartDate Date ATRIBUTO Data de início da experiência da campanha. Por padrão, o experimento começa agora ou na data de início da campanha, o que ocorrer depois. Se esse campo for definido, o experimento começará no início da data especificada no fuso horário do cliente. Não pode ser alterado após o início do experimento. Formato: AAAA-MM-DD Exemplo: 2019-03-14
CampaignExperimentStatus String ATRIBUTO Somente saída. O status da experiência da campanha. Este campo é só de leitura. Os valores permitidos são ENABLED, ENDED_MANUALLY, GRADUATED, INITIALIZATION_FAILED, INITIALIZING, PROMOTED, PROMOTING, PROMOTION_FAILED, REMOVED, UNKNOWN, UNSPECIFIED.
CampaignExperimentTrafficSplitPercent Long ATRIBUTO Imutável. Compartilhamento do tráfego direcionado para a experiência como uma porcentagem (deve estar entre 1 e 99 inclusive. A campanha base recebe o restante do tráfego (100 - traffic_split_percent). Obrigatório para criar.
CampaignExperimentTrafficSplitType String ATRIBUTO Imutável. Determina o comportamento da divisão de tráfego. Os valores permitidos são COOKIE, RANDOM_QUERY, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Configuração da Extensão da Campanha

Uma configuração de extensão de campanha.

Colunas
Nome Tipo Comportamento Descrição
CampaignExtensionSettingCampaign String ATRIBUTO Imutável. O nome do recurso da campanha. Os itens de feed de extensão vinculados serão veiculados nesta campanha. Os nomes dos recursos da campanha têm o formato: clientes/{customer_id}/campaigns/{campaign_id}
CampaignExtensionSettingDevice String ATRIBUTO O dispositivo para o qual as extensões servirão. Opcional. Os valores permitidos são DESKTOP, MOBILE, UNKNOWN, UNSPECIFIED.
CampaignExtensionSettingExtensionFeedItems String ATRIBUTO Os nomes dos recursos dos itens de feed de extensão a serem veiculados na campanha. Os nomes dos recursos ExtensionFeedItem têm o formato: clientes/{customer_id}/extensionFeedItems/{feed_item_id}
CampaignExtensionSettingExtensionType String ATRIBUTO Imutável. O tipo de ramal da configuração do ramal do cliente. Os valores permitidos são AFFILIATE_LOCATION, APP, CALL, CALLOUT, HOTEL_CALLOUT, IMAGE, LOCATION, MESSAGE, NONE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
CampaignExtensionSettingResourceName String ATRIBUTO Imutável. O nome do recurso da configuração de extensão da campanha. Os nomes dos recursos CampaignExtensionSetting têm o formato: customers/{customer_id}/campaignExtensionSettings/{campaign_id}~{extension_type}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
CampanhaFeed

Um feed de campanha.

Colunas
Nome Tipo Comportamento Descrição
CampaignFeedCampaign String ATRIBUTO Imutável. A campanha à qual o CampaignFeed pertence.
CampaignFeedFeed String ATRIBUTO Imutável. O feed ao qual o CampaignFeed pertence.
CampaignFeedMatchingFunctionFunctionString String ATRIBUTO Representação de string da função. Exemplos: 1. IDENTIDADE(verdadeiro) ou IDENTIDADE(falso). Todos ou nenhum item de feed foi veiculado. 2. EQUALS(CONTEXT.DEVICE, "Mobile") 3. IN(FEED_ITEM_ID, {1000001, 1000002, 1000003}) 4. CONTAINS_ANY(FeedAttribute[12345678, 0], {"Mars cruise", "Venus cruise"}) 5. AND(IN(FEED_ITEM_ID, {10001, 10002}), EQUALS(CONTEXT.DEVICE, "Mobile")) Para mais detalhes, visite https://developers.google.com/adwords/api/docs/guides/feed-matching-functions observe que, como várias strings podem representar a mesma função subjacente (espaço em branco e aspas simples versus aspas duplas, por exemplo), o valor retornado pode não ser idêntico à string enviada em uma solicitação mutate.
CampaignFeedMatchingFunctionLeftOperands String ATRIBUTO Os operandos no lado esquerdo da equação. Este também é o operando a ser usado para expressões de operando único, como NOT.
CampaignFeedMatchingFunctionOperator String ATRIBUTO Operador para uma função. Os valores permitidos são AND, CONTAINS_ANY, EQUALS, IDENTITY, IN, UNKNOWN, UNSPECIFIED.
CampaignFeedMatchingFunctionRightOperands String ATRIBUTO Os operandos no lado direito da equação.
CampaignFeedPlaceholderTypes String ATRIBUTO Indica quais tipos de espaço reservado o feed pode preencher na campanha conectada. Obrigatório. Os valores permitidos são AD_CUSTOMIZER, AFFILIATE_LOCATION, APP, CALL, CALLOUT, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHT, DYNAMIC_HOTEL, DYNAMIC_JOB, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, IMAGE, LOCATION, MESSAGE, PRICE, PROMOÇÃO, SITELINK, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignFeedResourceName String ATRIBUTO Imutável. O nome do recurso do feed da campanha. Os nomes dos recursos de feed de campanha têm o formato: `customers/{customer_id}/campaignFeeds/{campaign_id}~{feed_id}
StatusFeedCampanha Corda ATTRIBUTE Output only. Status of the campaign feed. This field is read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
Identificação do Cliente Longo ATTRIBUTE Output only. The ID of the customer.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Rótulo da Campanha

Representa uma relação entre uma campanha e um rótulo.

Colunas
Nome Tipo Comportamento Descrição
CampaignLabelCampaign String ATRIBUTO Imutável. A campanha à qual o rótulo está anexado.
CampaignLabelLabel String ATRIBUTO Imutável. O rótulo atribuído à campanha.
CampaignLabelResourceName String ATRIBUTO Imutável. Nome do recurso. Os nomes dos recursos de rótulos de campanha têm o formato: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
CampaignSharedSet

CampaignSharedSets são usados para gerenciar os conjuntos compartilhados associados a uma campanha.

Colunas
Nome Tipo Comportamento Descrição
CampaignSharedSetCampaign String ATRIBUTO Imutável. A campanha à qual o conjunto compartilhado de campanha pertence.
CampaignSharedSetResourceName String ATRIBUTO Imutável. O nome do recurso do conjunto compartilhado da campanha. Os nomes dos recursos do conjunto compartilhado da campanha têm o formato: customers/{customer_id}/campaignSharedSets/{campaign_id}~{shared_set_id}
CampaignSharedSetSharedSet String ATRIBUTO Imutável. O conjunto compartilhado associado à campanha. Pode ser um conjunto compartilhado de palavras-chave negativas de outro cliente. Este cliente deve ser um gerente do outro cliente, caso contrário, o conjunto compartilhado da campanha existirá, mas não terá efeito de veiculação. Somente conjuntos compartilhados de palavras-chave negativas podem ser associados a campanhas do Shopping. Somente conjuntos compartilhados de canais negativos podem ser associados a campanhas de aplicativos para dispositivos móveis da Rede de Display.
CampaignSharedSetStatus String ATRIBUTO Somente saída. O status deste conjunto compartilhado de campanha. Somente leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Simulação de Campanha

Uma simulação de campanha. As combinações suportadas de tipo de canal de publicidade, tipo de simulação e método de modificação de simulação são detalhadas abaixo, respectivamente. SEARCH - CPC_BID - UNIFORM SEARCH - CPC_BID - SCALING SEARCH - TARGET_CPA - UNIFORM SEARCH - TARGET_CPA - SCALING SEARCH - TARGET_ROAS - UNIFORM SEARCH - TARGET_IMPRESSION_SHARE - UNIFORM SEARCH - BUDGET - UNIFORM SHOPPING - BUDGET - UNIFORM SHOPPING - TARGET_ROAS - UNIFORM MULTIPLE - TARGET_C PA - UNIFORME OWNED_AND_OPERATED - TARGET_CPA - EXIBIÇÃO PADRÃO - TARGET_CPA - UNIFORME

Colunas
Nome Tipo Comportamento Descrição
CampaignSimulationBudgetPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores de orçamento.
CampaignSimulationCampaignId Long ATRIBUTO Somente saída. ID da campanha da simulação.
CampaignSimulationCpcBidPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores de lance de CPC.
CampaignSimulationEndDate Date ATRIBUTO Somente saída. Último dia em que se baseia a simulação, no formato AAAA-MM-DD
CampaignSimulationModificationMethod String ATRIBUTO Somente saída. Como a simulação modifica o campo. Os valores permitidos são PADRÃO, ESCALA, UNIFORME, DESCONHECIDO, NÃO ESPECIFICADO.
CampaignSimulationResourceName String ATRIBUTO Somente saída. O nome do recurso da simulação de campanha. Os nomes dos recursos de simulação de campanha têm o formato: customers/{customer_id}/campaignSimulations/{campaign_id}~{type}~{modification_method}~{start_date}~{end_date}
CampaignSimulationStartDate Date ATRIBUTO Somente saída. Primeiro dia em que se baseia a simulação, no formato AAAA-MM-DD.
CampaignSimulationTargetCpaPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores de CPA desejados.
CampaignSimulationTargetImpressionSharePointListPoints String ATRIBUTO Métricas projetadas para um valor de parcela de impressão de destino específico.
CampaignSimulationTargetRoasPointListPoints String ATRIBUTO Métricas projetadas para uma série de valores de ROAS desejados.
CampaignSimulationType String ATRIBUTO Somente saída. O campo que a simulação modifica. Os valores permitidos são BID_MODIFIER, BUDGET, CPC_BID, CPV_BID, PERCENT_CPC_BID, TARGET_CPA, TARGET_IMPRESSION_SHARE, TARGET_ROAS, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Carrier Constant

Um critério de operadora que pode ser usado na segmentação da campanha.

Colunas
Nome Tipo Comportamento Descrição
CarrierConstantCountryCode String ATRIBUTO Somente saída. O código do país onde a transportadora está localizada, por exemplo, "AR", "FR", etc.
CarrierConstantId Long ATRIBUTO Somente saída. O ID do critério da transportadora.
CarrierConstantName String ATRIBUTO Somente saída. O nome completo da operadora em inglês.
CarrierConstantResourceName String ATRIBUTO Somente saída. O nome do recurso do critério da transportadora. Os nomes dos recursos do critério da operadora têm o formato: carrierConstants/{criterion_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ChangeEvent

Descreve a alteração granular do recurso retornado de determinados tipos de recurso. As alterações feitas por meio da interface do usuário, API e novas versões do Editor por usuários externos (incluindo usuários externos e usuários internos que podem ser exibidos externamente) nos últimos 30 dias serão exibidas. A alteração mostra os valores antigos dos campos alterados antes da alteração e os novos valores logo após a alteração. ChangeEvent pode ter até 3 minutos de atraso para refletir uma nova alteração.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

A tabela ChangeEvent tem limitações extras. Você precisa fornecer um tempo não superior a 30 dias e um limite, por exemplo:

SELECT ChangeEventCampaign, CustomerId FROM ChangeEvent WHERE ChangeEventChangeDateTime DURING LAST_14_DAYS LIMIT 10
Colunas
Nome Tipo Comportamento Descrição
ChangeEventAdGroup String ATRIBUTO Somente saída. O AdGroup afetado por essa alteração.
ChangeEventAsset String ATRIBUTO Somente saída. O Ativo afetado por esta alteração.
ChangeEventCampaign String ATRIBUTO Somente saída. A campanha afetada por esta alteração.
ChangeEventChangeDateTime Date ATRIBUTO Somente saída. Hora em que a alteração foi confirmada neste recurso.
ChangeEventChangeResourceName String ATRIBUTO Somente saída. O recurso Simply em que essa alteração ocorreu.
ChangeEventChangeResourceType String ATRIBUTO Somente saída. O tipo do recurso alterado. Isso determina qual recurso será definido em old_resource e new_resource. Os valores permitidos são AD, AD_GROUP, AD_GROUP_AD, AD_GROUP_ASSET, AD_GROUP_BID_MODIFIER, AD_GROUP_CRITERION, AD_GROUP_FEED, ASSET, CAMPAIGN, CAMPAIGN_ASSET, CAMPAIGN_BUDGET, CAMPAIGN_CRITERION, CAMPAIGN_FEED, CUSTOMER_ASSET, FEED, FEED_ ITEM, DESCONHECIDO, NÃO ESPECIFICADO.
ChangeEventChangedFields String ATRIBUTO Somente saída. Uma lista de campos que são alterados no recurso retornado.
ChangeEventClientType String ATRIBUTO Somente saída. Por onde foi feita a alteração. Os valores permitidos são GOOGLE_ADS_API, GOOGLE_ADS_AUTOMATED_RULE, GOOGLE_ADS_BULK_UPLOAD, GOOGLE_ADS_EDITOR, GOOGLE_ADS_MOBILE_APP, GOOGLE_ADS_RECOMMENDATIONS, GOOGLE_ADS_SCRIPTS, GOOGLE_ADS_WEB_CLIENT, INTERNAL_TOOL, OUTRO, SEARCH_ADS_360_POST, SEARCH_ADS_360_SYNC, DESCONHECIDO, NÃO ESPECIFICADO.
ChangeEventFeed String ATRIBUTO Somente saída. O feed afetado por essa alteração.
ChangeEventFeedItem String ATRIBUTO Somente saída. O FeedItem afetado por essa alteração.
ChangeEventNewResource String ATRIBUTO Somente saída. O novo recurso após a alteração. Somente os campos alterados serão preenchidos.
ChangeEventOldResource String ATRIBUTO Somente saída. O recurso antigo antes da mudança. Apenas os campos alterados serão preenchidos.
ChangeEventResourceChangeOperation String ATRIBUTO Somente saída. A operação no recurso alterado. Os valores permitidos são CRIAR, REMOVER, DESCONHECIDO, NÃO ESPECIFICADO, ATUALIZAR.
ChangeEventResourceName String ATRIBUTO Somente saída. O nome do recurso do evento de alteração. Nomes de recursos de eventos de alteração têm o formato: customers/{customer_id}/changeEvents/{timestamp_micros}~{command_index}~{mutate_index}
ChangeEventUserEmail String ATRIBUTO Somente saída. O e-mail do usuário que fez essa alteração.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ChangeStatus

Descreve o status do recurso retornado. ChangeStatus pode ter até 3 minutos de atraso para refletir uma nova alteração.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

A tabela ChangeStatus tem limitações extras. Você precisa fornecer um tempo não superior a 30 dias e um limite, por exemplo:

SELECT ChangeStatusCampaign, CustomerId FROM ChangeStatus WHERE ChangeStatusLastChangeDateTime DURING LAST_14_DAYS LIMIT 10
Colunas
Nome Tipo Comportamento Descrição
ChangeStatusAdGroup String ATRIBUTO Somente saída. O AdGroup afetado por essa alteração.
ChangeStatusAdGroupAd String ATRIBUTO Somente saída. O AdGroupAd afetado por essa alteração.
ChangeStatusAdGroupAsset String ATRIBUTO Somente saída. O AdGroupAsset afetado por essa alteração.
ChangeStatusAdGroupBidModifier String ATRIBUTO Somente saída. O AdGroupBidModifier afetado por essa alteração.
ChangeStatusAdGroupCriterion String ATRIBUTO Somente saída. O AdGroupCriterion afetado por essa alteração.
ChangeStatusAdGroupFeed String ATRIBUTO Somente saída. O AdGroupFeed afetado por essa alteração.
ChangeStatusAsset String ATRIBUTO Somente saída. O Ativo afetado por esta alteração.
ChangeStatusCampaign String ATRIBUTO Somente saída. A campanha afetada por esta alteração.
ChangeStatusCampaignAsset String ATRIBUTO Somente saída. O CampaignAsset afetado por essa alteração.
ChangeStatusCampaignCriterion String ATRIBUTO Somente saída. O CampaignCriterion afetado por essa alteração.
ChangeStatusCampaignFeed String ATRIBUTO Somente saída. O CampaignFeed afetado por essa alteração.
ChangeStatusCampaignSharedSet String ATRIBUTO Somente saída. O CampaignSharedSet afetado por essa alteração.
ChangeStatusCustomerAsset String ATRIBUTO Somente saída. O CustomerAsset afetado por essa alteração.
ChangeStatusFeed String ATRIBUTO Somente saída. O feed afetado por essa alteração.
ChangeStatusFeedItem String ATRIBUTO Somente saída. O FeedItem afetado por essa alteração.
ChangeStatusLastChangeDateTime Date ATRIBUTO Somente saída. Hora em que ocorreu a alteração mais recente neste recurso.
ChangeStatusResourceName String ATRIBUTO Somente saída. O nome do recurso do status de mudança. Os nomes dos recursos de status de alteração têm o formato: customers/{customer_id}/changeStatus/{change_status_id}
ChangeStatusResourceStatus String ATRIBUTO Somente saída. Representa o status do recurso alterado. Os valores permitidos são ADDED, CHANGED, REMOVED, UNKNOWN, UNSPECIFED.
ChangeStatusResourceType String ATRIBUTO Somente saída. Representa o tipo do recurso alterado. Isso determina quais campos serão definidos. Por exemplo, para AD_GROUP, os campos de campanha e ad_group serão definidos. Os valores permitidos são AD_GROUP, AD_GROUP_AD, AD_GROUP_ASSET, AD_GROUP_BID_MODIFIER, AD_GROUP_CRITERION, AD_GROUP_FEED, ASSET, CAMPAIGN, CAMPAIGN_ASSET, CAMPAIGN_CRITERION, CAMPAIGN_FEED, CAMPAIGN_SHARED_SET, CUSTOMER_ASSET, FEED, FEED_I TEM, SHARED_SET, DESCONHECIDO, NÃO ESPECIFICADO.
ChangeStatusSharedSet String ATRIBUTO Somente saída. O SharedSet afetado por essa alteração.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ClickView

Uma exibição de clique com métricas agregadas em cada nível de clique, incluindo cliques válidos e inválidos. Para campanhas que não são de pesquisa, métrica.cliques representa o número de interações válidas e inválidas. As consultas que incluem ClickView devem ter um filtro limitando os resultados a um dia e podem ser solicitadas para datas anteriores a 90 dias da solicitação.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

As consultas ao ClickView devem ter um filtro limitando os resultados a um dia e podem ser solicitadas para datas até 90 dias antes do horário da solicitação.

SELECT * FROM ClickView WHERE Date DURING Yesterday
Colunas
Nome Tipo Comportamento Descrição
ClickViewAdGroupAd String ATRIBUTO Somente saída. O anúncio associado.
ClickViewAreaOfInterestCity String ATRIBUTO O critério de localização da cidade associado à impressão.
ClickViewAreaOfInterestCountry String ATRIBUTO O critério de localização do país associado à impressão.
ClickViewAreaOfInterestMetro String ATRIBUTO O critério de localização metropolitana associado à impressão.
ClickViewAreaOfInterestMostSpecific String ATRIBUTO O critério de localização mais específico associado à impressão.
ClickViewAreaOfInterestRegion String ATRIBUTO O critério de localização da região associado à impressão.
ClickViewCampaignLocationTarget String ATRIBUTO Somente saída. A segmentação por local da campanha associada, se houver.
ClickViewGclid String ATRIBUTO Somente saída. O ID de clique do Google.
ClickViewKeyword String ATRIBUTO Somente saída. A palavra-chave associada, se existir e o clique corresponde ao canal SEARCH.
ClickViewKeywordInfoMatchType String ATRIBUTO O tipo de correspondência da palavra-chave. Os valores permitidos são BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
ClickViewKeywordInfoText String ATRIBUTO O texto da palavra-chave (no máximo 80 caracteres e 10 palavras).
ClickViewLocationOfPresenceCity String ATRIBUTO O critério de localização da cidade associado à impressão.
ClickViewLocationOfPresenceCountry String ATRIBUTO O critério de localização do país associado à impressão.
ClickViewLocationOfPresenceMetro String ATRIBUTO O critério de localização metropolitana associado à impressão.
ClickViewLocationOfPresenceMostSpecific String ATRIBUTO O critério de localização mais específico associado à impressão.
ClickViewLocationOfPresenceRegion String ATRIBUTO O critério de localização da região associado à impressão.
ClickViewPageNumber Long ATRIBUTO Somente saída. Número da página nos resultados de pesquisa em que o anúncio foi exibido.
ClickViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição de clique. Os nomes dos recursos de exibição de clique têm o formato: customers/{customer_id}/clickViews/{date (yyyy-MM-dd)}~{gclid}
ClickViewUserList String ATRIBUTO Somente saída. A lista de usuários associados, se houver.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Clicks Long MÉTRICA O número de cliques.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Audiência Combinada

Descreva um recurso para públicos combinados que inclua públicos diferentes.

Colunas
Nome Tipo Comportamento Descrição
CombinedAudienceDescription String ATRIBUTO Somente saída. Descrição deste público combinado.
CombinedAudienceId Long ATRIBUTO Somente saída. ID do público combinado.
CombinedAudienceName String ATRIBUTO Somente saída. Nome do público combinado. Deve ser único em todos os públicos combinados.
CombinedAudienceResourceName String ATRIBUTO Imutável. O nome do recurso do público combinado. Os nomes de público combinados têm o formato: clientes/{customer_id}/combinedAudience/{combined_audience_id}
CombinedAudienceStatus String ATRIBUTO Somente saída. Status desse público combinado. Indica se o público combinado está habilitado ou removido. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Ação de Conversão

Uma ação de conversão.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
ConversionActionAppId String ATRIBUTO ID do aplicativo para uma ação de conversão de aplicativo.
ConversionActionAttributionModelSettingsAttributionModel String ATRIBUTO O tipo de modelo de atribuição desta ação de conversão. Os valores permitidos são EXTERNAL, GOOGLE_ADS_LAST_CLICK, GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN, GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK, GOOGLE_SEARCH_ATTRIBUTION_LINEAR, GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED, GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY, UNK AGORA, NÃO ESPECIFICADO.
ConversionActionAttributionModelSettingsDataDrivenModelStatus String ATRIBUTO Somente saída. O status do modelo de atribuição baseada em dados para a ação de conversão. Os valores permitidos são AVAILABLE, EXPIRED, NEVER_GENERATED, STALE, UNKNOWN, UNSPECIFIED.
ConversionActionCategory String ATRIBUTO A categoria de conversões relatada para esta ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionClickThroughLookbackWindowDays Long ATRIBUTO O número máximo de dias que podem decorrer entre uma interação (por exemplo, um clique) e um evento de conversão.
ConversionActionCountingType String ATRIBUTO Como contar eventos de conversão para a ação de conversão. Os valores permitidos são MANY_PER_CLICK, ONE_PER_CLICK, UNKNOWN, UNSPECIFIED.
ConversionActionFirebaseSettingsEventName String ATRIBUTO Somente saída. O nome do evento de uma conversão do Firebase.
ConversionActionFirebaseSettingsProjectId String ATRIBUTO Somente saída. O ID do projeto Firebase da conversão.
ConversionActionId Long ATRIBUTO Somente saída. O ID da ação de conversão.
ConversionActionIncludeInConversionsMetric Bool ATRIBUTO Se essa ação de conversão deve ser incluída na métrica "conversões".
ConversionActionMobileAppVendor String ATRIBUTO Somente saída. Fornecedor de aplicativos para dispositivos móveis para uma ação de conversão de aplicativo. Os valores permitidos são APPLE_APP_STORE, GOOGLE_APP_STORE, UNKNOWN, UNSPECIFIED.
ConversionActionName String ATRIBUTO O nome da ação de conversão. Este campo é obrigatório e não deve ficar vazio ao criar novas ações de conversão.
ConversionActionOrigin String ATRIBUTO Somente saída. A origem da conversão dessa ação de conversão. Os valores permitidos são APP, CALL_FROM_ADS, GOOGLE_HOSTED, STORE, UNKNOWN, UNSPECIFIED, WEBSITE, YOUTUBE_HOSTED.
ConversionActionOwnerCustomer String ATRIBUTO Somente saída. O nome do recurso do cliente proprietário da ação de conversão ou nulo se esta for uma ação de conversão definida pelo sistema.
ConversionActionPhoneCallDurationSeconds Long ATRIBUTO A duração da chamada telefônica em segundos após a qual uma conversão deve ser informada para esta ação de conversão. O valor deve estar entre 0 e 10000, inclusive.
ConversionActionPrimaryForGoal Bool ATRIBUTO Se o bit primary_for_goal de uma ação de conversão for falso, a ação de conversão não receberá lances para todas as campanhas, independentemente de sua meta de conversão do cliente ou meta de conversão da campanha. No entanto, as metas de conversão personalizadas não respeitam primary_for_goal, portanto, se uma campanha tiver uma meta de conversão personalizada configurada com uma ação de conversão primary_for_goal = false, essa ação de conversão ainda poderá receber lances. Por padrão, primary_for_goal será verdadeiro se não for definido. No V9, primary_for_goal só pode ser definido como false após a criação por meio de uma operação de 'atualização' porque não é declarado como opcional.
ConversionActionResourceName String ATRIBUTO Imutável. O nome do recurso da ação de conversão. Os nomes dos recursos de ação de conversão têm o formato: customers/{customer_id}/conversionActions/{conversion_action_id}
ConversionActionStatus String ATRIBUTO O status desta ação de conversão para acúmulo de evento de conversão. Os valores permitidos são ATIVADO, OCULTO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionTagSnippets String ATRIBUTO Somente saída. Os snippets usados para rastrear conversões.
ConversionActionThirdPartyAppAnalyticsSettingsEventName String ATRIBUTO Somente saída. O nome do evento de uma conversão de análise de aplicativo de externo.
ConversionActionThirdPartyAppAnalyticsSettingsProviderName String ATRIBUTO Somente saída. Nome do provedor de análise de aplicativo externo.
ConversionActionType String ATRIBUTO Imutável. O tipo desta ação de conversão. Os valores permitidos são AD_CALL, ANDROID_APP_PRE_REGISTRATION, ANDROID_INSTALLS_ALL_OTHER_APPS, CLICK_TO_CALL, FIREBASE_ANDROID_CUSTOM, FIREBASE_ANDROID_FIRST_OPEN, FIREBASE_ANDROID_IN_APP_PURCHASE, FIREBASE_IOS_CUSTOM, FIREBASE_IOS_FIRST_OPEN, FIRE BASE_IOS_IN_APP_PURCHASE, FLOODLIGHT_ACTION, FLOODLIGHT_TRANSACTION, GOOGLE_HOSTED, GOOGLE_PLAY_DOWNLOAD, GOOGLE_PLAY_IN_APP_PURCHASE, LEAD_FORM_SUBMIT, SALESFORCE, SEARCH_ADS_360, SMART_CAMPAIGN_AD_CLICKS_TO_CALL, SMART_CAMPAI GN_MAP_CLICKS_TO_CALL, SMART_CAMPAIGN_MAP_DIRECTIONS, SMART_CAMPAIGN_TRACKED_CALLS, STORE_SALES, STORE_SALES_DIRECT_UPLOAD, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM, THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN, THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE, THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM, THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN, THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD_CALLS, UPLOAD_CLICKS, WEBPAGE, WEBSITE_CALL.
ConversionActionValueSettingsAlwaysUseDefaultValue Bool ATRIBUTO Controla se o valor padrão e o código de moeda padrão são usados no lugar do valor e do código de moeda especificados em eventos de conversão para esta ação de conversão.
ConversionActionValueSettingsDefaultCurrencyCode String ATRIBUTO O código da moeda a ser usado quando os eventos de conversão para esta ação de conversão são enviados com um código de moeda inválido ou ausente, ou quando esta ação de conversão é configurada para sempre usar o valor padrão.
ConversionActionValueSettingsDefaultValue Double ATRIBUTO O valor a ser usado quando os eventos de conversão para esta ação de conversão são enviados com um valor inválido, não permitido ou ausente, ou quando esta ação de conversão é configurada para sempre usar o valor padrão.
ConversionActionViewThroughLookbackWindowDays Long ATRIBUTO O número máximo de dias que podem decorrer entre uma impressão e uma conversão sem interação.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ConversionLastConversionDate Date MÉTRICA A data da conversão mais recente para esta ação de conversão. A data está no fuso horário do cliente.
ConversionLastReceivedRequestDateTime Date MÉTRICA A última data/hora em que uma tag de conversão para esta ação de conversão foi disparada e vista pelo Google Ads. Esse evento de disparo pode não ter sido o resultado de uma conversão atribuível (por exemplo, porque a tag foi disparada de um navegador que não clicou anteriormente em um anúncio de um anunciante apropriado). A data/hora está no fuso horário do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Variável Personalizada de Conversão

Uma variável personalizada de conversão Consulte "Sobre variáveis personalizadas para conversões" no https://support.google.com/google-ads/answer/9964350

Colunas
Nome Tipo Comportamento Descrição
ConversionCustomVariableId Long ATRIBUTO Somente saída. O ID da variável personalizada de conversão.
ConversionCustomVariableName String ATRIBUTO Obrigatório. O nome da variável personalizada de conversão. O nome deve ser único. O comprimento máximo do nome é de 100 caracteres. Não deve haver nenhum espaço extra antes e depois.
ConversionCustomVariableOwnerCustomer String ATRIBUTO Somente saída. O nome do recurso do cliente que possui a variável personalizada de conversão.
ConversionCustomVariableResourceName String ATRIBUTO Imutável. O nome do recurso da variável personalizada de conversão. Os nomes de recursos de variáveis personalizadas de conversão têm o formato: customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
ConversionCustomVariableStatus String ATRIBUTO O status da variável personalizada de conversão para acúmulo de eventos de conversão. Os valores permitidos são ACTIVATION_NEEDED, ENABLED, PAUSED, UNKNOWN, UNSPECIFIED.
ConversionCustomVariableTag String ATRIBUTO Obrigatório. Imutável. A tag da variável personalizada de conversão. Ele é usado no snippet de evento e enviado ao Google Ads junto com os pings de conversão. Para uploads de conversão na Google Ads API, o nome do recurso da variável personalizada de conversão é usado. A etiqueta deve ser única. O tamanho máximo da tag é de 100 bytes. Não deve haver nenhum espaço extra antes e depois. Atualmente, apenas letras minúsculas, números e sublinhados são permitidos na tag.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ConversionGoalCampaignConfig

Configurações de meta de conversão para uma campanha.

Colunas
Nome Tipo Comportamento Descrição
ConversionGoalCampaignConfigCampaign String ATRIBUTO Imutável. A campanha à qual esta configuração de campanha de meta de conversão está associada.
ConversionGoalCampaignConfigCustomConversionGoal String ATRIBUTO A meta de conversão personalizada que a campanha está usando para otimização.
ConversionGoalCampaignConfigGoalConfigLevel String ATRIBUTO O nível de configuração de meta que a campanha está usando. Os valores permitidos são CAMPAIGN, CUSTOMER, UNKNOWN, UNSPECIFIED.
ConversionGoalCampaignConfigResourceName String ATRIBUTO Imutável. O nome do recurso da configuração da campanha de meta de conversão. Os nomes dos recursos de configuração da campanha de meta de conversão têm o formato: customers/{customer_id}/conversionGoalCampaignConfigs/{campaign_id}
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ConversionValueRule

Uma regra de valor de conversão

Colunas
Nome Tipo Comportamento Descrição
ConversionValueRuleActionOperation String ATRIBUTO Especifica a operação aplicada. Os valores permitidos são ADD, MULTIPLY, SET, UNKNOWN, UNSPECIFIED.
ConversionValueRuleActionValue Double ATRIBUTO Especifica o valor aplicado.
ConversionValueRuleAudienceConditionUserInterests String ATRIBUTO Interesses do usuário.
ConversionValueRuleAudienceConditionUserLists String ATRIBUTO Listas de usuários.
ConversionValueRuleDeviceConditionDeviceTypes String ATRIBUTO Valor para condição de tipo de dispositivo. Os valores permitidos são DESKTOP, MOBILE, TABLET, UNKNOWN, UNSPECIFIED.
ConversionValueRuleGeoLocationConditionExcludedGeoMatchType String ATRIBUTO Tipo de correspondência de localização geográfica excluído. Os valores permitidos são ANY, LOCATION_OF_PRESENCE, UNKNOWN, UNSPECIFIED.
ConversionValueRuleGeoLocationConditionExcludedGeoTargetConstants String ATRIBUTO Localizações geográficas que os anunciantes desejam excluir.
ConversionValueRuleGeoLocationConditionGeoMatchType String ATRIBUTO Tipo de correspondência de localização geográfica incluído. Os valores permitidos são ANY, LOCATION_OF_PRESENCE, UNKNOWN, UNSPECIFIED.
ConversionValueRuleGeoLocationConditionGeoTargetConstants String ATRIBUTO Localizações geográficas que os anunciantes desejam incluir.
ConversionValueRuleId Long ATRIBUTO Somente saída. O ID da regra de valor de conversão.
ConversionValueRuleOwnerCustomer String ATRIBUTO Somente saída. O nome do recurso do cliente proprietário da regra de valor de conversão. Quando a regra de valor é herdada de um cliente gerente, owner_customer será o nome do recurso do gerente, enquanto o cliente no resource_name será do cliente solicitante que atende. ** Somente leitura **
ConversionValueRuleResourceName String ATRIBUTO Imutável. O nome do recurso da regra de valor de conversão. Os nomes dos recursos da regra de valor de conversão têm o seguinte formato: clientes/{customer_id}/conversionValueRules/{conversion_value_rule_id}
ConversionValueRuleStatus String ATRIBUTO O status da regra de valor de conversão. Os valores permitidos são ATIVADO, PAUSADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ConversionValueRuleSet

Um conjunto de regras de valor de conversão

Colunas
Nome Tipo Comportamento Descrição
ConversionValueRuleSetAttachmentType String ATRIBUTO Imutável. Define o escopo ao qual o conjunto de regras de valor de conversão é anexado. Os valores permitidos são CAMPAIGN, CUSTOMER, UNKNOWN, UNSPECIFIED.
ConversionValueRuleSetCampaign String ATRIBUTO O nome do recurso da campanha quando o conjunto de regras de valor de conversão é anexado a uma campanha.
ConversionValueRuleSetConversionActionCategories String ATRIBUTO Imutável. As categorias de ação de conversão do conjunto de regras de valor de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionValueRuleSetConversionValueRules String ATRIBUTO Nomes de recursos de regras dentro do conjunto de regras.
ConversionValueRuleSetDimensions String ATRIBUTO Define as dimensões para as condições da Regra de Valor. Os tipos de condição de regras de valor nesse conjunto de regras de valor devem ter essas dimensões. A primeira entrada nesta lista é a dimensão principal das regras de valor incluídas. Ao usar a segmentação de dimensão primária da regra de valor, os valores de conversão serão segmentados nos valores ajustados pelas regras de valor e nos valores originais, se algumas regras de valor se aplicarem. Os valores permitidos são AUDIENCE, DEVICE, GEO_LOCATION, NO_CONDITION, UNKNOWN, UNSPECIFIED.
ConversionValueRuleSetId Long ATRIBUTO Somente saída. O ID do conjunto de regras de valor de conversão.
ConversionValueRuleSetOwnerCustomer String ATRIBUTO Somente saída. O nome do recurso do cliente proprietário do conjunto de regras de valor de conversão. Quando o conjunto de regras de valor é herdado de um cliente gerente, owner_customer será o nome do recurso do gerente, enquanto o cliente no resource_name será do cliente solicitante que atende. ** Somente leitura **
ConversionValueRuleSetResourceName String ATRIBUTO Imutável. O nome do recurso do conjunto de regras de valor de conversão. Os nomes de recursos do conjunto de regras de valor de conversão têm o formato: clientes/{customer_id}/conversionValueRuleSets/{conversion_value_rule_set_id}
ConversionValueRuleSetStatus String ATRIBUTO Somente saída. O status do conjunto de regras de valor de conversão. ** Somente leitura ** Os valores permitidos são ATIVADO, PAUSADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
MoedaConstante

Uma constante monetária.

Colunas
Nome Tipo Comportamento Descrição
CurrencyConstantBillableUnitMicros Long ATRIBUTO Somente saída. A unidade faturável dessa moeda. Os valores faturados devem ser múltiplos desse valor.
CurrencyConstantCode String ATRIBUTO Somente saída. Código de moeda de três letras ISO 4217, por exemplo "USD"
CurrencyConstantName String ATRIBUTO Somente saída. Nome completo da moeda em inglês.
CurrencyConstantResourceName String ATRIBUTO Somente saída. O nome do recurso da constante monetária. Os nomes de recursos de constante de moeda têm o formato: currencyConstants/{code}
CurrencyConstantSymbol String ATRIBUTO Somente saída. Símbolo padrão para descrever esta moeda, por ex. '$' para dólares americanos.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Público Personalizado

Um público personalizado. Esta é uma lista de usuários por interesse.

Colunas
Nome Tipo Comportamento Descrição
CustomAudienceDescription String ATRIBUTO Descrição deste público personalizado.
CustomAudienceId Long ATRIBUTO Somente saída. ID do público personalizado.
CustomAudienceMembers String ATRIBUTO Lista de membros do público personalizado dos quais esse público personalizado é composto. Os membros podem ser adicionados durante a criação do CustomAudience. Se os membros forem apresentados na operação UPDATE, os membros existentes serão substituídos.
CustomAudienceName String ATRIBUTO Nome do público personalizado. Deve ser exclusivo para todos os públicos personalizados criados por um cliente. Este campo é obrigatório para a criação de operações.
CustomAudienceResourceName String ATRIBUTO Imutável. O nome do recurso do público personalizado. Os nomes dos recursos de público personalizado têm o formato: customers/{customer_id}/customAudiences/{custom_audience_id}
CustomAudienceStatus String ATRIBUTO Somente saída. Status desse público personalizado. Indica se o público personalizado está habilitado ou removido. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomAudienceType String ATRIBUTO Tipo do público personalizado. ("INTEREST" OU "PURCHASE_INTENT" não é permitido para público personalizado recém-criado, mas mantido para públicos existentes) Os valores permitidos são AUTO, INTEREST, PURCHASE_INTENT, SEARCH, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Meta de Conversão Personalizada

Meta de conversão personalizada que pode tornar as ações de conversão arbitrárias passíveis de lances.

Colunas
Nome Tipo Comportamento Descrição
CustomConversionGoalConversionActions String ATRIBUTO Ações de conversão que a meta de conversão personalizada torna passível de lance.
CustomConversionGoalId Long ATRIBUTO Imutável. O ID dessa meta de conversão personalizada.
CustomConversionGoalName String ATRIBUTO O nome dessa meta de conversão personalizada.
CustomConversionGoalResourceName String ATRIBUTO Imutável. O nome do recurso da meta de conversão personalizada. Os nomes dos recursos de meta de conversão personalizada têm o formato: customers/{customer_id}/customConversionGoals/{goal_id}
CustomConversionGoalStatus String ATRIBUTO O status da meta de conversão personalizada. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Cliente

Um cliente.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerAutoTaggingEnabled Bool ATRIBUTO Se a marcação automática está habilitada para o cliente.
CustomerCallReportingSettingCallConversionAction String ATRIBUTO Ação de conversão de chamada no nível do cliente para atribuir uma conversão de chamada. Se não for definido, uma ação de conversão padrão será usada. Somente em vigor quando call_conversion_reporting_enabled é definido como verdadeiro.
CustomerCallReportingSettingCallConversionReportingEnabled Bool ATRIBUTO Se os relatórios de conversão de chamadas devem ser ativados.
CustomerCallReportingSettingCallReportingEnabled Bool ATRIBUTO Ative o relatório de eventos de chamadas telefônicas redirecionando-os por meio do sistema do Google.
CustomerConversionTrackingSettingAcceptedCustomerDataTerms Bool ATRIBUTO Somente saída. Se o cliente aceitou os termos de dados do cliente. Se estiver usando o acompanhamento de conversões entre contas, esse valor será herdado do gerente. Este campo é só de leitura. Para mais informações, veja https://support.google.com/adspolicy/answer/7475709.
CustomerConversionTrackingSettingConversionTrackingId Long ATRIBUTO Somente saída. O ID de rastreamento de conversão usado para esta conta. Esse ID é atribuído automaticamente depois que qualquer recurso de rastreamento de conversão é usado. Se o cliente não usar o rastreamento de conversão, será 0. Este campo é somente leitura.
CustomerConversionTrackingSettingConversionTrackingStatus String ATRIBUTO Somente saída. Status de rastreamento de conversão. Ele indica se o cliente está usando o acompanhamento de conversões e quem é o proprietário do acompanhamento de conversões desse cliente. Se esse cliente estiver usando o rastreamento de conversão entre contas, o valor retornado será diferente com base no login-customer-id da solicitação. Os valores permitidos são CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER, CONVERSION_TRACKING_MANAGED_BY_SELF, CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER, NOT_CONVERSION_TRACKED, UNKNOWN, UNSPECIFIED.
CustomerConversionTrackingSettingCrossAccountConversionTrackingId Long ATRIBUTO Somente saída. O ID de rastreamento de conversão do gerente do cliente. Isso é definido quando o cliente optou pelo acompanhamento de conversões de várias contas e substitui o conversion_tracking_id. Este campo só pode ser gerenciado por meio da IU do Google Ads. Este campo é só de leitura.
CustomerConversionTrackingSettingEnhancedConversionsForLeadsEnabled Bool ATRIBUTO Somente saída. Se o cliente optou por conversões otimizadas para leads. Se estiver usando o acompanhamento de conversões entre contas, esse valor será herdado do gerente. Este campo é só de leitura.
CustomerCurrencyCode String ATRIBUTO Imutável. A moeda na qual a conta opera. Um subconjunto dos códigos de moeda do padrão ISO 4217 é suportado.
CustomerDescriptiveName String ATRIBUTO Nome descritivo opcional e não exclusivo do cliente.
CustomerFinalUrlSuffix String ATRIBUTO O modelo de URL para anexar parâmetros ao URL final
CustomerHasPartnersBadge Bool ATRIBUTO Somente saída. Se o cliente tem um selo do programa Partners. Se o Cliente não estiver associado ao programa Partners, isso será falso. Para mais informações, veja https://support.google.com/partners/answer/3125774.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomerManager Bool ATRIBUTO Somente saída. Se o cliente é um gerente.
CustomerOptimizationScore Double ATRIBUTO Somente saída. Pontuação de otimização do cliente. A pontuação de otimização é uma estimativa do desempenho das campanhas de um cliente. Varia de 0% (0,0) a 100% (1,0). Este campo é nulo para todos os clientes gerentes e para clientes não gerentes não pontuados. Consulte "Sobre a pontuação de otimização" em https://support.google.com/google-ads/answer/9061546. Este campo é só de leitura.
CustomerOptimizationScoreWeight Double ATRIBUTO Somente saída. Peso da pontuação de otimização do cliente. O peso da pontuação de otimização pode ser usado para comparar/agregar pontuações de otimização em vários clientes não gerentes. A pontuação de otimização agregada de um gerente é calculada como a soma de todos os seus clientes de Customer.optimization_score * Customer.optimization_score_weight. Este campo é 0 para todos os clientes gerentes e para clientes não gerentes não pontuados. Este campo é só de leitura.
CustomerPayPerConversionEligibilityFailureReasons String ATRIBUTO Somente saída. Motivos pelos quais o cliente não está qualificado para usar PaymentMode.CONVERSIONS. Se a lista estiver vazia, o cliente está qualificado. Este campo é só de leitura. Os valores permitidos são ANALYSIS_NOT_COMPLETE, AVERAGE_DAILY_SPEND_TOO_HIGH, CONVERSION_LAG_TOO_HIGH, HAS_CAMPAIGN_WITH_SHARED_BUDGET, HAS_UPLOAD_CLICKS_CONVERSION, NOT_ENOUGH_CONVERSIONS, OTHER, UNKNOWN, UNSPECIFIED.
CustomerRemarketingSettingGoogleGlobalSiteTag String ATRIBUTO Somente saída. A tag global do site do Google.
CustomerResourceName String ATRIBUTO Imutável. O nome do recurso do cliente. Os nomes de recursos do cliente têm o formato: customers/{customer_id}
CustomerStatus String ATRIBUTO Somente saída. A situação do cliente. Os valores permitidos são CANCELADO, FECHADO, HABILITADO, SUSPENSO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerTestAccount Bool ATRIBUTO Somente saída. Se o cliente é uma conta de teste.
CustomerTimeZone String ATRIBUTO Imutável. O ID do fuso horário local do cliente.
CustomerTrackingUrlTemplate String ATRIBUTO O modelo de URL para construir um URL de rastreamento fora dos parâmetros.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Ativo do Cliente

Uma ligação entre um cliente e um ativo.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomerAssetAsset String ATRIBUTO Obrigatório. Imutável. O ativo que está vinculado ao cliente.
CustomerAssetFieldType String ATRIBUTO Obrigatório. Imutável. Papel que o ativo assume para o link do cliente. Os valores permitidos são BOOK_ON_GOOGLE, BUSINESS_NAME, CALL, CALLOUT, CALL_TO_ACTION_SELECTION, DESCRIPTION, HEADLINE, HOTEL_CALLOUT, LANDSCAPE_LOGO, LEAD_FORM, LOGO, LONG_HEADLINE, MANDATORY_AD_TEXT, MARKETING_IMAGE, MEDIA_BUNDLE, MOBILE_APP, PORTRAIT_MARKETING_IMAGE, PRICE, PROMOÇÃO, SITELINK, SQUARE_MARKETING_IMAGE, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO, VÍDEO, YOUTUBE_VIDEO.
CustomerAssetResourceName String ATRIBUTO Imutável. O nome do recurso do ativo do cliente. Os nomes dos recursos CustomerAsset têm o formato: customers/{customer_id}/customerAssets/{asset_id}~{field_type}
CustomerAssetStatus String ATRIBUTO Status do ativo do cliente. Os valores permitidos são ATIVADO, PAUSADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
PhoneCalls Long MÉTRICA Número de chamadas telefônicas off-line.
PhoneImpressions Long MÉTRICA Número de impressões telefônicas off-line.
PhoneThroughRate Double MÉTRICA Número de chamadas telefônicas recebidas (phone_calls) dividido pelo número de vezes que seu número de telefone é exibido (phone_impressions).
TopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas em qualquer lugar acima dos resultados de pesquisa orgânica.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
AssetInteractionTargetAsset String SEGMENTO O nome do recurso ativo.
AssetInteractionTargetInteractionOnThisAsset Bool SEGMENTO Usado apenas com as métricas CustomerAsset, CampaignAsset e AdGroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ClienteCliente

Uma ligação entre o cliente dado e um cliente cliente. CustomerClients só existe para clientes gerentes. Estão incluídos todos os clientes diretos e indiretos, bem como o próprio gestor.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomerClientAppliedLabels String ATRIBUTO Somente saída. Os nomes de recursos dos rótulos pertencentes ao cliente solicitante que são aplicados ao cliente cliente. Os nomes dos recursos de rótulo têm o formato: customers/{customer_id}/labels/{label_id}
CustomerClientClientCustomer String ATRIBUTO Somente saída. O nome do recurso do cliente-cliente que está vinculado ao cliente fornecido. Somente leitura.
CustomerClientCurrencyCode String ATRIBUTO Somente saída. Código da moeda (por exemplo, 'USD', 'EUR') para o cliente. Somente leitura.
CustomerClientDescriptiveName String ATRIBUTO Somente saída. Nome descritivo para o cliente. Somente leitura.
CustomerClientHidden Bool ATRIBUTO Somente saída. Especifica se esta é uma conta oculta. Somente leitura.
CustomerClientId Long ATRIBUTO Somente saída. O ID do cliente cliente. Somente leitura.
CustomerClientLevel Long ATRIBUTO Somente saída. Distância entre determinado cliente e cliente. Para autolink, o valor do nível será 0. Somente leitura.
CustomerClientManager Bool ATRIBUTO Somente saída. Identifica se o cliente é um gerente. Somente leitura.
CustomerClientResourceName String ATRIBUTO Somente saída. O nome do recurso do cliente cliente. Os nomes de recursos CustomerClient têm o formato: customers/{customer_id}/customerClients/{client_customer_id}
CustomerClientStatus String ATRIBUTO Somente saída. O status do cliente cliente. Somente leitura. Os valores permitidos são CANCELADO, FECHADO, HABILITADO, SUSPENSO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerClientTestAccount Bool ATRIBUTO Somente saída. Identifica se o cliente é uma conta de teste. Somente leitura.
CustomerClientTimeZone String ATRIBUTO Somente saída. Representação de cadeia de caracteres Common Locale Data Repository (CLDR) do fuso horário do cliente, por exemplo América/Los_Angeles. Somente leitura.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.

Os vínculos entre contas de clientes e contas de administrador

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Consulte a tabela CustomerClientLink para obter uma lista das subcontas vinculadas de IDs de cliente do cliente, começando pelo ManagerId especificado na propriedade de conexão. Se desejar recuperar a listagem, a partir de um nível hierárquico diferente, poderá fazê-lo filtrando com a pseudocoluna CustomerId, especificando o ID do cliente da conta para a qual deseja obter as subcontas vinculadas. Se você deseja evitar a listagem de hierarquia completa e obter apenas subcontas para um conjunto específico de gerente/CustomerId RecurseChildren propriedade da conexão para false. Observe que ManagerId propriedade deve ser especificada para poder obter dados desta tabela.

SELECT * FROM CustomerClientLink Where CustomerId='2705304492'
Colunas
Nome Tipo Comportamento Descrição
ClientCustomerId String Atributo Imutável. O cliente cliente vinculado a este cliente.
Hidden String Atributo A visibilidade do link. Os usuários podem optar por ver ou não os links ocultos na IU do Google Ads. O valor padrão é falso
ManagerLinkId String Atributo Somente saída. Isso identifica exclusivamente um link de cliente do cliente. Somente leitura.
ResourceName String Atributo Imutável. Nome do recurso.
Status String Atributo Este é o status do link entre cliente e gerente.
LinkedManagerId String Atributo Id do gerente vinculado.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
CustomerId Long CustomerId para o qual obter os IDs de cliente do cliente vinculado.
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Meta de Conversão do Cliente

Controle de capacidade de lance para ações de conversão com categoria e origem correspondentes.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomerConversionGoalBiddable Bool ATRIBUTO A possibilidade de lance da meta de conversão do cliente.
CustomerConversionGoalCategory String ATRIBUTO A categoria de conversão dessa meta de conversão do cliente. Somente as ações de conversão que tiverem essa categoria serão incluídas nessa meta. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerConversionGoalOrigin String ATRIBUTO A origem da conversão dessa meta de conversão do cliente. Somente as ações de conversão que tiverem essa origem de conversão serão incluídas nessa meta. Os valores permitidos são APP, CALL_FROM_ADS, GOOGLE_HOSTED, STORE, UNKNOWN, UNSPECIFIED, WEBSITE, YOUTUBE_HOSTED.
CustomerConversionGoalResourceName String ATRIBUTO Imutável. O nome do recurso da meta de conversão do cliente. Os nomes dos recursos da meta de conversão do cliente têm o formato: customers/{customer_id}/customerConversionGoals/{category}~{origin}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
CustomerCustomizer

Um valor do personalizador para o CustomizerAttribute associado no nível do cliente.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomerCustomizerCustomizerAttribute String ATRIBUTO Obrigatório. Imutável. O atributo do personalizador que está vinculado ao cliente.
CustomerCustomizerResourceName String ATRIBUTO Imutável. O nome do recurso do personalizador do cliente. Os nomes de recursos do personalizador de clientes têm o formato: customers/{customer_id}/customerCustomizers/{customizer_attribute_id}
CustomerCustomizerStatus String ATRIBUTO Somente saída. O status do atributo personalizador do cliente. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerCustomizerValueStringValue String ATRIBUTO Obrigatório. Valor a ser inserido no texto criativo. Os valores do personalizador de todos os tipos são armazenados como string para tornar a formatação inequívoca.
CustomerCustomizerValueType String ATRIBUTO Obrigatório. O tipo de dados para o valor do personalizador. Ele deve corresponder ao tipo de atributo. O conteúdo string_value deve corresponder às restrições associadas ao tipo. Os valores permitidos são NÚMERO, PORCENTO, PREÇO, TEXTO, DESCONHECIDO, NÃO ESPECIFICADO.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
CustomerExtensionSetting

Uma configuração de ramal do cliente.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomerExtensionSettingDevice String ATRIBUTO O dispositivo para o qual as extensões servirão. Opcional. Os valores permitidos são DESKTOP, MOBILE, UNKNOWN, UNSPECIFIED.
CustomerExtensionSettingExtensionFeedItems String ATRIBUTO Os nomes dos recursos dos itens de feed de extensão a serem veiculados no cliente. Os nomes dos recursos ExtensionFeedItem têm o formato: clientes/{customer_id}/extensionFeedItems/{feed_item_id}
CustomerExtensionSettingExtensionType String ATRIBUTO Imutável. O tipo de ramal da configuração do ramal do cliente. Os valores permitidos são AFFILIATE_LOCATION, APP, CALL, CALLOUT, HOTEL_CALLOUT, IMAGE, LOCATION, MESSAGE, NONE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
CustomerExtensionSettingResourceName String ATRIBUTO Imutável. O nome do recurso da configuração do ramal do cliente. Os nomes dos recursos CustomerExtensionSetting têm o formato: customers/{customer_id}/customerExtensionSettings/{extension_type}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
CustomerFeed

Um feed de cliente.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomerFeedFeed String ATRIBUTO Imutável. O feed sendo vinculado ao cliente.
CustomerFeedMatchingFunctionFunctionString String ATRIBUTO Representação de string da função. Exemplos: 1. IDENTIDADE(verdadeiro) ou IDENTIDADE(falso). Todos ou nenhum item de feed foi veiculado. 2. EQUALS(CONTEXT.DEVICE, "Mobile") 3. IN(FEED_ITEM_ID, {1000001, 1000002, 1000003}) 4. CONTAINS_ANY(FeedAttribute[12345678, 0], {"Mars cruise", "Venus cruise"}) 5. AND(IN(FEED_ITEM_ID, {10001, 10002}), EQUALS(CONTEXT.DEVICE, "Mobile")) Para mais detalhes, visite https://developers.google.com/adwords/api/docs/guides/feed-matching-functions observe que, como várias strings podem representar a mesma função subjacente (espaço em branco e aspas simples versus aspas duplas, por exemplo), o valor retornado pode não ser idêntico à string enviada em uma solicitação mutate.
CustomerFeedMatchingFunctionLeftOperands String ATRIBUTO Os operandos no lado esquerdo da equação. Este também é o operando a ser usado para expressões de operando único, como NOT.
CustomerFeedMatchingFunctionOperator String ATRIBUTO Operador para uma função. Os valores permitidos são AND, CONTAINS_ANY, EQUALS, IDENTITY, IN, UNKNOWN, UNSPECIFIED.
CustomerFeedMatchingFunctionRightOperands String ATRIBUTO Os operandos no lado direito da equação.
CustomerFeedPlaceholderTypes String ATRIBUTO Indica quais tipos de espaço reservado o feed pode preencher no cliente conectado. Obrigatório. Os valores permitidos são AD_CUSTOMIZER, AFFILIATE_LOCATION, APP, CALL, CALLOUT, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHT, DYNAMIC_HOTEL, DYNAMIC_JOB, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, IMAGE, LOCATION, MESSAGE, PRICE, PROMOÇÃO, SITELINK, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO.
CustomerFeedResourceName String ATRIBUTO Imutável. O nome do recurso do feed do cliente. Os nomes dos recursos de feed do cliente têm o formato: customers/{customer_id}/customerFeeds/{feed_id}
CustomerFeedStatus String ATRIBUTO Somente saída. Status do feed do cliente. Este campo é só de leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
CustomerLabel

Representa uma relação entre um cliente e um rótulo. Este cliente pode não ter acesso a todas as etiquetas anexadas a ele. CustomerLabels adicionais podem ser retornados aumentando as permissões com login-customer-id.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomerLabelCustomer String ATRIBUTO Somente saída. O nome do recurso do cliente ao qual o rótulo está anexado. Somente leitura.
CustomerLabelLabel String ATRIBUTO Somente saída. O nome do recurso do rótulo atribuído ao cliente. Observação: a parte do ID do cliente do nome do recurso de rótulo não é validada ao criar um novo CustomerLabel.
CustomerLabelResourceName String ATRIBUTO Imutável. Nome do recurso. Os nomes dos recursos de rótulo do cliente têm o formato: customers/{customer_id}/customerLabels/{label_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.

Representa a relação de ligação cliente-gerente.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomerManagerLinkManagerCustomer String ATRIBUTO Somente saída. O cliente gerente vinculado ao cliente.
CustomerManagerLinkManagerLinkId Long ATRIBUTO Somente saída. ID do link cliente-gerente. Este campo é só de leitura.
CustomerManagerLinkResourceName String ATRIBUTO Imutável. Nome do recurso. Os nomes dos recursos CustomerManagerLink têm o formato: customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}
CustomerManagerLinkStatus String ATRIBUTO Status do link entre o cliente e o gerente. Os valores permitidos são ATIVO, CANCELADO, INATIVO, PENDENTE, RECUSADO, DESCONHECIDO, NÃO ESPECIFICADO.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ClienteNegativoCritério

Um critério negativo para exclusões no nível do cliente.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomerNegativeCriterionContentLabelType String ATRIBUTO Tipo de rótulo de conteúdo, necessário para operações CREATE. Os valores permitidos são BELOW_THE_FOLD, EMBEDDED_VIDEO, JUVENILE, LIVE_STREAMING_VIDEO, PARKED_DOMAIN, PROFANITY, SEXUALLY_SUGGESTIVE, SOCIAL_ISSUES, TRAGEDY, UNKNOWN, UNSPECIFIED, VIDEO, VIDEO_NOT_YET_RATED, VIDEO_RATING_DV_G, VIDEO_RATING_DV_MA, VIDEO_RATING_DV_PG, VIDEO_RATING_DV_T.
CustomerNegativeCriterionId Long ATRIBUTO Somente saída. O ID do critério.
CustomerNegativeCriterionMobileAppCategoryMobileAppCategoryConstant String ATRIBUTO O nome do recurso constante da categoria do aplicativo móvel.
CustomerNegativeCriterionMobileApplicationAppId String ATRIBUTO Uma string que identifica exclusivamente um aplicativo para celular para a Google Ads API. O formato dessa string é "{platform}-{platform_native_id}", onde platform é "1" para aplicativos iOS e "2" para aplicativos Android, e platform_native_id é o identificador de aplicativo móvel nativo da plataforma correspondente. Para iOS, esse identificador nativo é a sequência de 9 dígitos que aparece no final de um URL da App Store (por exemplo, "476943146" para "Flood-It! 2" cujo link da App Store é " http://itunes.apple.com/us/app/flood-it!-2/id476943146 "). Para Android, esse identificador nativo é o nome do pacote do aplicativo (por exemplo, "com.labpixies.colordrips" para "Color Drips" dado o link do Google Play " <a
href="https://play.google.com/store/apps/details?id=com.labpixies.colordrips">https://play.google.com/store/apps/details?id=com .labpixies.colordrips "). Um ID de aplicativo bem formado para a Google Ads API seria "1-476943146" para iOS e "2-com.labpixies.colordrips" para Android. Este campo é obrigatório e deve ser definido nas operações CREATE.
CustomerNegativeCriterionMobileApplicationName String ATRIBUTO Nome deste aplicativo móvel.
CustomerNegativeCriterionPlacementUrl String ATRIBUTO URL da veiculação. Por exemplo, "http://www.domain.com.
CustomerNegativeCriterionResourceName String ATRIBUTO Imutável. O nome do recurso do critério negativo do cliente. Os nomes de recursos de critério negativo do cliente têm o formato: customers/{customer_id}/customerNegativeCriteria/{criterion_id}
CustomerNegativeCriterionType String ATRIBUTO Somente saída. O tipo do critério. Os valores permitidos são AD_SCHEDULE, AGE_RANGE, APP_PAYMENT_MODEL, AUDIENCE, CARRIER, COMBINED_AUDIENCE, CONTENT_LABEL, CUSTOM_AFFINITY, CUSTOM_AUDIENCE, CUSTOM_INTENT, DEVICE, GENDER, INCOME_RANGE, IP_BLOCK, KEYWORD, KEYWORD_THEME, LANGUAGE, LISTING_GROUP, LIST ING_SCOPE, LOCATION, LOCATION_GROUP, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, MOBILE_DEVICE, OPERATING_SYSTEM_VERSION, PARENTAL_STATUS, PLACEMENT, PROXIMITY, TOPIC, UNKNOWN, UNSPECIFIED, USER_INTEREST, USER_LIST, WEBPAGE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO.
CustomerNegativeCriterionYouTubeChannelChannelId String ATRIBUTO O ID do canal do uploader do YouTube ou o código do canal de um canal do YouTube.
CustomerNegativeCriterionYouTubeVideoVideoId String ATRIBUTO ID do vídeo do YouTube conforme aparece na página de exibição do YouTube.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
CustomerUserAccess

Representa a permissão de um único usuário para um único cliente.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomerUserAccessAccessCreationDateTime Date ATRIBUTO Somente saída. A hora de criação do acesso do usuário cliente. Campo somente leitura O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
CustomerUserAccessAccessRole String ATRIBUTO papel de acesso do usuário. Os valores permitidos são ADMIN, EMAIL_ONLY, READ_ONLY, STANDARD, UNKNOWN, UNSPECIFIED.
CustomerUserAccessEmailAddress String ATRIBUTO Somente saída. Endereço E-mail do usuário. Campo somente leitura
CustomerUserAccessInviterUserEmailAddress String ATRIBUTO Somente saída. O endereço e-mail do usuário do convite. Campo somente leitura
CustomerUserAccessResourceName String ATRIBUTO Imutável. Nome do recurso. Os nomes dos recursos têm o formato: customers/{customer_id}/customerUserAccesses/{user_id}
CustomerUserAccessUserId Long ATRIBUTO Somente saída. ID do usuário com acesso de cliente. Campo somente leitura
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
CustomerUserAccessInvitation

Representar um convite para um novo usuário nesta conta de cliente.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomerUserAccessInvitationAccessRole String ATRIBUTO Imutável. papel de acesso do usuário. Os valores permitidos são ADMIN, EMAIL_ONLY, READ_ONLY, STANDARD, UNKNOWN, UNSPECIFIED.
CustomerUserAccessInvitationCreationDateTime Date ATRIBUTO Somente saída. O convite de horário foi criado. Este campo é só de leitura. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
CustomerUserAccessInvitationEmailAddress String ATRIBUTO Imutável. Endereço E-mail para o qual o convite foi enviado. Isso pode diferir do endereço e-mail da conta que aceita o convite.
CustomerUserAccessInvitationInvitationId Long ATRIBUTO Somente saída. A ID do convite. Este campo é só de leitura.
CustomerUserAccessInvitationInvitationStatus String ATRIBUTO Somente saída. Status do convite do usuário. Os valores permitidos são DECLINED, EXPIRED, PENDING, UNKNOWN, UNSPECIFED.
CustomerUserAccessInvitationResourceName String ATRIBUTO Imutável. Nome do recurso. Os nomes dos recursos têm o formato: customers/{customer_id}/customerUserAccessInvitations/{invitation_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Interesse Personalizado

Um interesse personalizado. Esta é uma lista de usuários por interesse.

Colunas
Nome Tipo Comportamento Descrição
CustomInterestDescription String ATRIBUTO Descrição desse público-alvo de interesse personalizado.
CustomInterestId Long ATRIBUTO Somente saída. ID do interesse personalizado.
CustomInterestMembers String ATRIBUTO Lista de membros de interesses customizados dos quais este interesse customizado é composto. Os membros podem ser adicionados durante a criação de CustomInterest. Se os membros forem apresentados na operação UPDATE, os membros existentes serão substituídos.
CustomInterestName String ATRIBUTO Nome do interesse personalizado. Ele deve ser exclusivo no mesmo público-alvo de afinidade personalizado. Este campo é obrigatório para operações de criação.
CustomInterestResourceName String ATRIBUTO Imutável. O nome do recurso do interesse personalizado. Os nomes de recursos de interesse personalizados têm o formato: customers/{customer_id}/customInterests/{custom_interest_id}
CustomInterestStatus String ATRIBUTO Status deste interesse personalizado. Indica se o interesse personalizado está ativado ou removido. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomInterestType String ATRIBUTO Tipo do interesse personalizado, CUSTOM_AFFINITY ou CUSTOM_INTENT. Por padrão, o tipo é definido como CUSTOM_AFFINITY. Os valores permitidos são CUSTOM_AFFINITY, CUSTOM_INTENT, UNKNOWN, UNSPECIFIED.
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Atributo Personalizador

Um atributo do personalizador. Use CustomerCustomizer, CampaignCustomizer, AdGroupCustomizer ou AdGroupCriterionCustomizer para associar um atributo personalizador e definir seu valor no cliente, campanha, grupo de anúncios ou nível de critério do grupo de anúncios, respectivamente.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
CustomizerAttributeId Long ATRIBUTO Somente saída. A ID do atributo do personalizador.
CustomizerAttributeName String ATRIBUTO Obrigatório. Imutável. Nome do atributo do personalizador. Obrigatório. Ele deve ter um comprimento mínimo de 1 e comprimento máximo de 40. O nome de um atributo do personalizador ativado deve ser exclusivo (sem distinção entre maiúsculas e minúsculas).
CustomizerAttributeResourceName String ATRIBUTO Imutável. O nome do recurso do atributo personalizador. Os nomes dos recursos do Atributo do Personalizador têm o formato: clientes/{customer_id}/customizerAttributes/{customizer_attribute_id}
CustomizerAttributeStatus String ATRIBUTO Somente saída. O status do atributo do personalizador. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
CustomizerAttributeType String ATRIBUTO Imutável. O tipo do atributo do personalizador. Os valores permitidos são NÚMERO, PORCENTO, PREÇO, TEXTO, DESCONHECIDO, NÃO ESPECIFICADO.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Demográfico Detalhado

Um grupo demográfico detalhado: uma indústria específica com base em interesses a ser segmentada para alcançar usuários com base em fatos da vida de longo prazo.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
DetailedDemographicAvailabilities String ATRIBUTO Somente saída. Informações de disponibilidade do demográfico detalhado.
DetailedDemographicId Long ATRIBUTO Somente saída. O ID do grupo demográfico detalhado.
DetailedDemographicLaunchedToAll Bool ATRIBUTO Somente saída. Verdadeiro se o grupo demográfico detalhado for lançado para todos os canais e localidades.
DetailedDemographicName String ATRIBUTO Somente saída. O nome do grupo demográfico detalhado. Por exemplo, "Nível mais alto de realização educacional"
DetailedDemographicParent String ATRIBUTO Somente saída. O pai de detail_demographic.
DetailedDemographicResourceName String ATRIBUTO Somente saída. O nome do recurso do grupo demográfico detalhado. Os nomes de recursos demográficos detalhados têm o formato: clientes/{customer_id}/detailedDemographics/{detailed_demographic_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
DetailPlacementView

Uma visualização com métricas agregadas por grupo de anúncios e URL ou vídeo do YouTube.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
DetailPlacementViewDisplayName String ATRIBUTO Somente saída. O nome de exibição é o nome do URL para sites, o nome do vídeo do YouTube para vídeos do YouTube e o nome do aplicativo móvel traduzido para aplicativos móveis.
DetailPlacementViewGroupPlacementTargetUrl String ATRIBUTO Somente saída. URL da veiculação do grupo, por exemplo, domínio, link para o aplicativo móvel na loja de aplicativos ou URL de um canal do YouTube.
DetailPlacementViewPlacement String ATRIBUTO Somente saída. A string de veiculação automática em nível de detalhe, por exemplo, URL do site, ID do aplicativo móvel ou ID de um vídeo do YouTube.
DetailPlacementViewPlacementType String ATRIBUTO Somente saída. Tipo de veiculação, por exemplo Site, vídeo do YouTube e aplicativo móvel. Os valores permitidos são MOBILE_APPLICATION, MOBILE_APP_CATEGORY, UNKNOWN, UNSPECIFIED, WEBSITE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO.
DetailPlacementViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição de posicionamento de detalhes. Os nomes dos recursos de exibição de veiculação de detalhes têm o formato: customers/{customer_id}/detailPlacementViews/{ad_group_id}~{base64_placement}
DetailPlacementViewTargetUrl String ATRIBUTO Somente saída. URL do canal, por exemplo, website, link para o aplicativo móvel na loja de aplicativos ou um URL de vídeo do YouTube.
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
DisplayKeywordView

Uma exibição de palavra-chave de exibição.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
DisplayKeywordViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição de palavras-chave de exibição. Os nomes dos recursos de exibição de palavras-chave da Rede de Display têm o formato: customers/{customer_id}/displayKeywordViews/{ad_group_id}~{criterion_id}
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
DistanceView

Uma exibição de distância com métricas agregadas pela distância do usuário às extensões de local de um anunciante. Cada DistanceBucket inclui todas as impressões que estão dentro de sua distância e uma única impressão contribuirá para as métricas de todos os DistanceBuckets que incluem a distância do usuário.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
DistanceViewDistanceBucket String ATRIBUTO Somente saída. Agrupamento da distância do usuário das extensões de local. Os valores permitidos são BEYOND_40MILES, BEYOND_65KM, UNKNOWN, UNSPECIFED, WITHIN_0_7MILES, WITHIN_10KM, WITHIN_10MILES, WITHIN_15KM, WITHIN_15MILES, WITHIN_1KM, WITHIN_1MILE, WITHIN_20KM, WITHIN_20MILES, WITHIN_25KM, WITHIN_25MI LES, WITHIN_30KM, WITHIN_30MILES, WITHIN_35KM, WITHIN_35MILES, WITHIN_40KM, WITHIN_40MILES, WITHIN_45KM, WITHIN_50KM, WITHIN_55KM, WITHIN_5KM, WITHIN_5MILES, WITHIN_60KM, WITHIN_65KM, WITHIN_700M.
DistanceViewMetricSystem Bool ATRIBUTO Somente saída. True se o DistanceBucket estiver usando o sistema métrico, false caso contrário.
DistanceViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição de distância. Os nomes dos recursos de exibição de distância têm o formato: clientes/{customer_id}/distanceViews/1~{distance_bucket}
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
DomainCategory

Uma categoria gerada automaticamente pelo rastreamento de um domínio. Se uma campanha usar o DynamicSearchAdsSetting, as categorias de domínio serão geradas para o domínio. As categorias podem ser segmentadas usando WebpageConditionInfo. Ver: https://support.google.com/google-ads/answer/2471185

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
DomainCategoryCampaign String ATRIBUTO Somente saída. A campanha para a qual esta categoria é recomendada.
DomainCategoryCategory String ATRIBUTO Somente saída. Categoria recomendada para o domínio do site. por exemplo. se você tiver um site sobre eletrônicos, as categorias podem ser "câmeras", "televisões" etc.
DomainCategoryCategoryRank Long ATRIBUTO Somente saída. A posição desta categoria no conjunto de categorias. Números mais baixos indicam uma correspondência melhor para o domínio. nulo indica não recomendado.
DomainCategoryCoverageFraction Double ATRIBUTO Somente saída. Fração de páginas em seu site que corresponde a esta categoria.
DomainCategoryDomain String ATRIBUTO Somente saída. O domínio do site. O domínio pode ser especificado no DynamicSearchAdsSetting necessário para anúncios de pesquisa dinâmicos.
DomainCategoryHasChildren Bool ATRIBUTO Somente saída. Indica se esta categoria possui subcategorias.
DomainCategoryLanguageCode String ATRIBUTO Somente saída. O código de idioma que especifica o idioma do site. por exemplo, "en" para inglês. O idioma pode ser especificado no DynamicSearchAdsSetting necessário para anúncios de pesquisa dinâmicos. Esse é o idioma das páginas de seu website que você deseja que o Google Ads encontre, crie anúncios e faça correspondências com as pesquisas.
DomainCategoryRecommendedCpcBidMicros Long ATRIBUTO Somente saída. O custo por clique recomendado para a categoria.
DomainCategoryResourceName String ATRIBUTO Somente saída. O nome do recurso da categoria de domínio. Os nomes de recursos de categoria de domínio têm o formato: clientes/{customer_id}/domainCategories/{campaign_id}~{category_base64}~{language_code}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
DynamicSearchAdsSearchTermView

Uma exibição de termos de pesquisa de anúncios de pesquisa dinâmicos.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
DynamicSearchAdsSearchTermViewHasMatchingKeyword Bool ATRIBUTO Somente saída. Verdadeiro se a consultar for adicionada às palavras-chave segmentadas. Este campo é só de leitura.
DynamicSearchAdsSearchTermViewHasNegativeKeyword Bool ATRIBUTO Somente saída. Verdadeiro se a consultar corresponder a uma palavra-chave negativa. Este campo é só de leitura.
DynamicSearchAdsSearchTermViewHasNegativeUrl Bool ATRIBUTO Somente saída. Verdadeiro se a consultar corresponder a um URL negativo. Este campo é só de leitura.
DynamicSearchAdsSearchTermViewHeadline String ATRIBUTO Somente saída. O título gerado dinamicamente do anúncio de pesquisa dinâmico. Este campo é só de leitura.
DynamicSearchAdsSearchTermViewLandingPage String ATRIBUTO Somente saída. O URL da página de aterrissagem selecionado dinamicamente da impressão. Este campo é só de leitura.
DynamicSearchAdsSearchTermViewPageUrl String ATRIBUTO Somente saída. O URL do item de feed de página exibido para a impressão. Este campo é só de leitura.
DynamicSearchAdsSearchTermViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição do termo de pesquisa dos anúncios dinâmicos da Rede de Pesquisa. Os nomes dos recursos de visualização dos termos de pesquisa dos anúncios dinâmicos da Rede de Pesquisa têm o seguinte formato: clientes/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
DynamicSearchAdsSearchTermViewSearchTerm String ATRIBUTO Somente saída. Termo de pesquisa Este campo é somente leitura.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Webpage String SEGMENTO Nome do recurso do critério do grupo de anúncios que representa o critério da página da web.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ExpandedLandingPageView

Uma visualização da página de aterrissagem com métricas agregadas no nível do URL final expandido.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ExpandedLandingPageViewExpandedFinalUrl String ATRIBUTO Somente saída. O URL final para o qual os cliques são direcionados.
ExpandedLandingPageViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização da página de aterrissagem expandida. Os nomes dos recursos de exibição da página de aterrissagem expandida têm o formato: clientes/{customer_id}/expandedLandingPageViews/{expanded_final_url_fingerprint}
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor das conversões de interações dividido pelo número de interações com anúncios. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValuePerCost Double MÉTRICA O valor das conversões dividido pelo custo das interações com o anúncio. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
MobileFriendlyClicksPercentage Double MÉTRICA A porcentagem de cliques móveis que levam a uma página otimizada para celular.
SpeedScore Long MÉTRICA Uma medida da rapidez com que sua página é carregada após cliques em seus anúncios para celular. A pontuação varia de 1 a 10, sendo 10 o mais rápido.
ValidAcceleratedMobilePagesClicksPercentage Double MÉTRICA A porcentagem de cliques em anúncios para páginas de destino Accelerated Mobile Pages (AMP) que chegam a uma página AMP válida.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Experimentar

Um experimento de anúncios do Google para que os usuários experimentem alterações em várias campanhas, comparem o desempenho e apliquem as alterações efetivas.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ExperimentDescription String ATRIBUTO A descrição do experimento. Ele deve ter um comprimento mínimo de 1 e comprimento máximo de 2048. Voltar para o início
ExperimentEndDate String ATRIBUTO Data em que o experimento termina. Por padrão, o experimento termina na data de término da campanha. Se esse campo for definido, o experimento terminará no final da data especificada no fuso horário do cliente. Formato: AAAA-MM-DD Exemplo: 2019-04-18
ExperimentExperimentId Long ATRIBUTO Somente saída. O ID do experimento. Somente leitura.
ExperimentGoals String ATRIBUTO Os objetivos deste experimento.
ExperimentLongRunningOperation String ATRIBUTO Somente saída. O nome do recurso da operação de longa duração que pode ser usada para pesquisar a conclusão do agendamento ou promoção do experimento. A operação de execução longa mais recente é retornada.
ExperimentName String ATRIBUTO Obrigatório. O nome do experimento. Ele deve ter um comprimento mínimo de 1 e comprimento máximo de 1024. Ele deve ser exclusivo para um cliente.
ExperimentPromoteStatus String ATRIBUTO Somente saída. O status do processo de promoção do experimento. Os valores permitidos são COMPLETED, COMPLETED_WITH_WARNING, FAILED, IN_PROGRESS, NOT_STARTED, UNKNOWN, UNSPECIFIED.
ExperimentResourceName String ATRIBUTO Imutável. O nome do recurso do experimento. Os nomes dos recursos da experiência têm o formato: clientes/{customer_id}/experiments/{experiment_id}
ExperimentStartDate String ATRIBUTO Data de início do experimento. Por padrão, o experimento começa agora ou na data de início da campanha, o que ocorrer depois. Se esse campo for definido, o experimento começará no início da data especificada no fuso horário do cliente. Formato: AAAA-MM-DD Exemplo: 2019-03-14
ExperimentStatus String ATRIBUTO O status desejado pelo anunciante para esta experiência. Os valores permitidos são ATIVADO, GRADUADO, INTERROMPIDO, INICIADO, PROMOVIDO, REMOVIDO, CONFIGURAÇÃO, DESCONHECIDO, NÃO ESPECIFICADO.
ExperimentSuffix String ATRIBUTO Para experimentos gerenciados pelo sistema, o anunciante deve fornecer um sufixo durante a construção, no estágio de configuração antes de passar para o iniciado. O sufixo será anexado aos nomes de campanha em design e experimental para que o nome seja o nome da campanha base + o sufixo.
ExperimentType String ATRIBUTO O produto/recurso que usa esta experiência. Os valores permitidos são AD_VARIATION, DISPLAY_AND_VIDEO_360, DISPLAY_AUTOMATED_BIDDING_STRATEGY, DISPLAY_CUSTOM, HOTEL_CUSTOM, SEARCH_AUTOMATED_BIDDING_STRATEGY, SEARCH_CUSTOM, SHOPPING_AUTOMATED_BIDDING_STRATEGY, SMART_DISPLAY, SMART_MATCHING, UNKNOWN, NÃO ESPECIFICADO, YOUTUBE_CUSTOM.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ExperimentArm

Um experimento de anúncios do Google para que os usuários experimentem alterações em várias campanhas, comparem o desempenho e apliquem as alterações efetivas.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ExperimentArmCampaigns String ATRIBUTO Lista de campanhas no braço de teste. O comprimento máximo é um.
ExperimentArmControl Bool ATRIBUTO Se este braço é um braço de controle. Um braço de controle é o braço contra o qual os outros braços são comparados.
ExperimentArmInDesignCampaigns String ATRIBUTO Somente saída. As campanhas em design no braço experimental de tratamento.
ExperimentArmName String ATRIBUTO Obrigatório. O nome do grupo experimental. Ele deve ter um comprimento mínimo de 1 e comprimento máximo de 1024. Ele deve ser único em um experimento.
ExperimentArmResourceName String ATRIBUTO Imutável. O nome do recurso do grupo experimental. Os nomes dos recursos do grupo de experimentos têm o formato: clientes/{customer_id}/experimentArms/{TrialArm.trial_id}~{TrialArm.trial_arm_id}
ExperimentArmTrial String ATRIBUTO Imutável. O experimento ao qual o ExperimentArm pertence.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ExtensionFeedItem

Um item de feed de extensão.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ExtensionFeedItemAdSchedules String ATRIBUTO Lista de programações não sobrepostas especificando todos os intervalos de tempo para os quais o item de feed pode ser veiculado. Pode haver no máximo 6 horários por dia.
ExtensionFeedItemAffiliateLocationFeedItemAddressLine1 String ATRIBUTO Linha 1 do endereço comercial.
ExtensionFeedItemAffiliateLocationFeedItemAddressLine2 String ATRIBUTO Linha 2 do endereço comercial.
ExtensionFeedItemAffiliateLocationFeedItemBusinessName String ATRIBUTO O nome do negócio.
ExtensionFeedItemAffiliateLocationFeedItemChainId Long ATRIBUTO ID da rede de varejo que é anunciada como vendedora do seu produto.
ExtensionFeedItemAffiliateLocationFeedItemChainName String ATRIBUTO Nome da cadeia.
ExtensionFeedItemAffiliateLocationFeedItemCity String ATRIBUTO Cidade do endereço comercial.
ExtensionFeedItemAffiliateLocationFeedItemCountryCode String ATRIBUTO Código do país do endereço comercial.
ExtensionFeedItemAffiliateLocationFeedItemPhoneNumber String ATRIBUTO Número de telefone da empresa.
ExtensionFeedItemAffiliateLocationFeedItemPostalCode String ATRIBUTO Código postal do endereço comercial.
ExtensionFeedItemAffiliateLocationFeedItemProvince String ATRIBUTO Província do endereço comercial.
ExtensionFeedItemAppFeedItemAppId String ATRIBUTO O ID específico da loja para o aplicativo de destino. Esta string não deve estar vazia.
ExtensionFeedItemAppFeedItemAppStore String ATRIBUTO O armazenamento de aplicativos ao qual o aplicativo de destino pertence. Este campo é obrigatório. Os valores permitidos são APPLE_ITUNES, GOOGLE_PLAY, UNKNOWN, UNSPECIFIED.
ExtensionFeedItemAppFeedItemFinalMobileUrls String ATRIBUTO Uma lista de possíveis URLs finais para dispositivos móveis após todos os redirecionamentos entre domínios.
ExtensionFeedItemAppFeedItemFinalUrlSuffix String ATRIBUTO Modelo de URL para anexar parâmetros a URLs de página de aterrissagem veiculados com rastreamento paralelo.
ExtensionFeedItemAppFeedItemFinalUrls String ATRIBUTO Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios. Esta lista não deve estar vazia.
ExtensionFeedItemAppFeedItemLinkText String ATRIBUTO O texto visível exibido quando o link é renderizado em um anúncio. Esta string não deve estar vazia e o comprimento desta string deve estar entre 1 e 25, inclusive.
ExtensionFeedItemAppFeedItemTrackingUrlTemplate String ATRIBUTO Modelo de URL para construir um URL de rastreamento. O valor padrão é "{lpurl}".
ExtensionFeedItemCallFeedItemCallConversionAction String ATRIBUTO A ação de conversão à qual atribuir uma conversão de chamada. Se não for definido, uma ação de conversão padrão será usada. Este campo só tem efeito se call_tracking_enabled for definido como verdadeiro. Caso contrário, este campo é ignorado.
ExtensionFeedItemCallFeedItemCallConversionReportingState String ATRIBUTO Valor de enumeração que indica se esta extensão de chamada usa sua própria configuração de conversão de chamada (ou apenas tem a conversão de chamada desativada) ou segue a configuração no nível da conta. Os valores permitidos são DISABLED, UNKNOWN, UNSPECIFIED, USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION, USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
ExtensionFeedItemCallFeedItemCallConversionTrackingDisabled Bool ATRIBUTO Se verdadeiro, desative o rastreamento de conversão de chamadas. call_conversion_action não deve ser definido se for verdadeiro. Opcional.
ExtensionFeedItemCallFeedItemCallTrackingEnabled Bool ATRIBUTO Indica se o rastreamento de chamadas está ativado. Por padrão, o rastreamento de chamadas não está ativado.
ExtensionFeedItemCallFeedItemCountryCode String ATRIBUTO Código do país com duas letras maiúsculas do número de telefone do anunciante. Esta string não deve estar vazia.
ExtensionFeedItemCallFeedItemPhoneNumber String ATRIBUTO O número de telefone do anunciante para anexar ao anúncio. Esta string não deve estar vazia.
ExtensionFeedItemCalloutFeedItemCalloutText String ATRIBUTO O texto explicativo. O comprimento desta string deve estar entre 1 e 25, inclusive.
ExtensionFeedItemDevice String ATRIBUTO O dispositivo visado. Os valores permitidos são CELULAR, DESCONHECIDO, NÃO ESPECIFICADO.
ExtensionFeedItemEndDateTime Date ATRIBUTO Hora de término em que este item de feed não é mais eficaz e deixará de ser veiculado. A hora está no fuso horário do cliente. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
ExtensionFeedItemExtensionType String ATRIBUTO Somente saída. O tipo de extensão do item de feed de extensão. Este campo é só de leitura. Os valores permitidos são AFFILIATE_LOCATION, APP, CALL, CALLOUT, HOTEL_CALLOUT, IMAGE, LOCATION, MESSAGE, NONE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
ExtensionFeedItemHotelCalloutFeedItemLanguageCode String ATRIBUTO O idioma do texto de chamada do hotel. Código de idioma compatível com IETF BCP 47.
ExtensionFeedItemHotelCalloutFeedItemText String ATRIBUTO O texto explicativo. O comprimento desta string deve estar entre 1 e 25, inclusive.
ExtensionFeedItemId Long ATRIBUTO Somente saída. O ID deste item de feed. Somente leitura.
ExtensionFeedItemImageFeedItemImageAsset String ATRIBUTO Obrigatório. Nome do recurso do recurso de imagem.
ExtensionFeedItemLocationFeedItemAddressLine1 String ATRIBUTO Linha 1 do endereço comercial.
ExtensionFeedItemLocationFeedItemAddressLine2 String ATRIBUTO Linha 2 do endereço comercial.
ExtensionFeedItemLocationFeedItemBusinessName String ATRIBUTO O nome do negócio.
ExtensionFeedItemLocationFeedItemCity String ATRIBUTO Cidade do endereço comercial.
ExtensionFeedItemLocationFeedItemCountryCode String ATRIBUTO Código do país do endereço comercial.
ExtensionFeedItemLocationFeedItemPhoneNumber String ATRIBUTO Número de telefone da empresa.
ExtensionFeedItemLocationFeedItemPostalCode String ATRIBUTO Código postal do endereço comercial.
ExtensionFeedItemLocationFeedItemProvince String ATRIBUTO Província do endereço comercial.
ExtensionFeedItemPriceFeedItemFinalUrlSuffix String ATRIBUTO Modelo de URL de rastreamento para todas as ofertas desta extensão de preço.
ExtensionFeedItemPriceFeedItemLanguageCode String ATRIBUTO O código do idioma usado para esta extensão de preço.
ExtensionFeedItemPriceFeedItemPriceOfferings String ATRIBUTO As ofertas de preço nesta extensão de preço.
ExtensionFeedItemPriceFeedItemPriceQualifier String ATRIBUTO Qualificador de preço para todas as ofertas desta extensão de preço. Os valores permitidos são AVERAGE, FROM, UNKNOWN, UNSPECIFIED, UP_TO.
ExtensionFeedItemPriceFeedItemTrackingUrlTemplate String ATRIBUTO Modelo de URL de rastreamento para todas as ofertas desta extensão de preço.
ExtensionFeedItemPriceFeedItemType String ATRIBUTO Tipo de extensão de preço desta extensão. Os valores permitidos são BRANDS, EVENTS, LOCATIONS, NEIGHBORHOODS, PRODUCT_CATEGORIES, PRODUCT_TIERS, SERVICES, SERVICE_CATEGORIES, SERVICE_TIERS, UNKNOWN, UNSPECIFED.
ExtensionFeedItemPromotionFeedItemDiscountModifier String ATRIBUTO Enum que modifica a qualificação do desconto. Os valores permitidos são UNKNOWN, UNSPECIFIED, UP_TO.
ExtensionFeedItemPromotionFeedItemFinalMobileUrls String ATRIBUTO Uma lista de possíveis URLs finais para dispositivos móveis após todos os redirecionamentos entre domínios.
ExtensionFeedItemPromotionFeedItemFinalUrlSuffix String ATRIBUTO Modelo de URL para anexar parâmetros a URLs de página de aterrissagem veiculados com rastreamento paralelo.
ExtensionFeedItemPromotionFeedItemFinalUrls String ATRIBUTO Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios. Este campo é obrigatório.
ExtensionFeedItemPromotionFeedItemLanguageCode String ATRIBUTO O idioma da promoção. Representado como tag de idioma BCP 47.
ExtensionFeedItemPromotionFeedItemMoneyAmountOffAmountMicros Long ATRIBUTO Quantidade em micros. Um milhão é equivalente a uma unidade.
ExtensionFeedItemPromotionFeedItemMoneyAmountOffCurrencyCode String ATRIBUTO Código de moeda ISO 4217 de três caracteres.
ExtensionFeedItemPromotionFeedItemOccasion String ATRIBUTO A ocasião a que se destinava a promoção. Se uma ocasião for definida, a janela de resgate precisará estar dentro do intervalo de datas associado à ocasião. Os valores permitidos são BACK_TO_SCHOOL, BLACK_FRIDAY, BOXING_DAY, CARNIVAL, CHINESE_NEW_YEAR, CHRISTMAS, CYBER_MONDAY, DIWALI, EASTER, EID_AL_ADHA, EID_AL_FITR, END_OF_SEASON, EPIPHANY, FALL_SALE, FATHERS_DAY, HALLOWEEN, HANUKKAH, HOLI, INDEP ENDENCE_DAY, LABOR_DAY, MOTHERS_DAY, NATIONAL_DAY, NAVRATRI, NEW_YEARS, PARENTS_DAY, PASSOVER, RAMADAN, ROSH_HASHANAH, SINGLES_DAY, SONGKRAN, SPRING_SALE, ST_NICHOLAS_DAY, SUMMER_SALE, UNKNOWN, UNSPECIFIED, VALENTINES_DAY, WINTER_SALE, WOMENS_DAY, YEAR_END_GIFT.
ExtensionFeedItemPromotionFeedItemOrdersOverAmountAmountMicros Long ATRIBUTO Quantidade em micros. Um milhão é equivalente a uma unidade.
ExtensionFeedItemPromotionFeedItemOrdersOverAmountCurrencyCode String ATRIBUTO Código de moeda ISO 4217 de três caracteres.
ExtensionFeedItemPromotionFeedItemPercentOff Long ATRIBUTO Percentual de desconto na promoção em micros. Um milhão é equivalente a um por cento. Isso ou money_off_amount é obrigatório.
ExtensionFeedItemPromotionFeedItemPromotionCode String ATRIBUTO Um código que o usuário deve usar para se qualificar para a promoção.
ExtensionFeedItemPromotionFeedItemPromotionEndDate Date ATRIBUTO Última data em que a promoção é elegível para ser resgatada.
ExtensionFeedItemPromotionFeedItemPromotionStartDate Date ATRIBUTO Data de início de quando a promoção é elegível para ser resgatada.
ExtensionFeedItemPromotionFeedItemPromotionTarget String ATRIBUTO Uma descrição de forma livre do alvo da promoção. Este campo é obrigatório.
ExtensionFeedItemPromotionFeedItemTrackingUrlTemplate String ATRIBUTO Modelo de URL para construir um URL de rastreamento.
ExtensionFeedItemResourceName String ATRIBUTO Imutável. O nome do recurso do item de feed de extensão. Os nomes dos recursos de item de feed de extensão têm o formato: clientes/{customer_id}/extensionFeedItems/{feed_item_id}
ExtensionFeedItemSitelinkFeedItemFinalMobileUrls String ATRIBUTO Uma lista de possíveis URLs finais para dispositivos móveis após todos os redirecionamentos entre domínios.
ExtensionFeedItemSitelinkFeedItemFinalUrlSuffix String ATRIBUTO Sufixo de URL final a ser anexado aos URLs da página de aterrissagem veiculados com rastreamento paralelo.
ExtensionFeedItemSitelinkFeedItemFinalUrls String ATRIBUTO Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios.
ExtensionFeedItemSitelinkFeedItemLine1 String ATRIBUTO Primeira linha da descrição do sitelink. Se este valor for definido, line2 também deve ser definido. O comprimento desta string deve estar entre 0 e 35, inclusive.
ExtensionFeedItemSitelinkFeedItemLine2 String ATRIBUTO Segunda linha da descrição do sitelink. Se esse valor for definido, line1 também deverá ser definido. O comprimento desta string deve estar entre 0 e 35, inclusive.
ExtensionFeedItemSitelinkFeedItemLinkText String ATRIBUTO Texto de exibição do URL para o sitelink. O comprimento desta string deve estar entre 1 e 25, inclusive.
ExtensionFeedItemSitelinkFeedItemTrackingUrlTemplate String ATRIBUTO Modelo de URL para construir um URL de rastreamento.
ExtensionFeedItemStartDateTime Date ATRIBUTO Hora de início em que este item de feed é efetivo e pode começar a ser veiculado. A hora está no fuso horário do cliente. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
ExtensionFeedItemStatus String ATRIBUTO Somente saída. Status do item de alimentação. Este campo é só de leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
ExtensionFeedItemStructuredSnippetFeedItemHeader String ATRIBUTO O cabeçalho do trecho. Esta string não deve estar vazia.
ExtensionFeedItemStructuredSnippetFeedItemValues String ATRIBUTO Os valores no snippet. O tamanho máximo desta coleção é 10. Voltar para o início
ExtensionFeedItemTargetedAdGroup String ATRIBUTO O grupo de anúncios segmentado.
ExtensionFeedItemTargetedCampaign String ATRIBUTO A campanha segmentada.
ExtensionFeedItemTargetedGeoTargetConstant String ATRIBUTO A constante de segmentação geográfica segmentada.
ExtensionFeedItemTargetedKeywordMatchType String ATRIBUTO O tipo de correspondência da palavra-chave. Os valores permitidos são BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
ExtensionFeedItemTargetedKeywordText String ATRIBUTO O texto da palavra-chave (no máximo 80 caracteres e 10 palavras).
ExtensionFeedItemTextMessageFeedItemBusinessName String ATRIBUTO O nome comercial a ser anexado ao texto da mensagem. Este campo é obrigatório.
ExtensionFeedItemTextMessageFeedItemCountryCode String ATRIBUTO Código do país com duas letras maiúsculas do número de telefone do anunciante. Este campo é obrigatório.
ExtensionFeedItemTextMessageFeedItemExtensionText String ATRIBUTO A mensagem extension_text preenchida no aplicativo de mensagens.
ExtensionFeedItemTextMessageFeedItemPhoneNumber String ATRIBUTO O número de telefone do anunciante para o qual a mensagem será enviada. Obrigatório.
ExtensionFeedItemTextMessageFeedItemText String ATRIBUTO O texto a ser exibido no anúncio. Este campo é obrigatório.
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromClickToCall Double MÉTRICA O número de vezes que as pessoas clicaram no botão "Ligar" para ligar para uma loja durante ou depois de clicar em um anúncio. Este número não inclui se as chamadas foram conectadas ou não, ou a duração de todas as chamadas. Essa métrica se aplica apenas a itens de feed.
AllConversionsFromDirections Double MÉTRICA O número de vezes que as pessoas clicaram no botão "Obter direções" para navegar até uma loja depois de clicar em um anúncio. Essa métrica se aplica apenas a itens de feed.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromMenu Double MÉTRICA O número de vezes que as pessoas clicaram em um link para visualizar o menu de uma loja depois de clicar em um anúncio. Essa métrica se aplica apenas a itens de feed.
AllConversionsFromOrder Double MÉTRICA O número de vezes que as pessoas fizeram um pedido em uma loja depois de clicar em um anúncio. Essa métrica se aplica apenas a itens de feed.
AllConversionsFromOtherEngagement Double MÉTRICA O número de outras conversões (por exemplo, postar uma avaliação ou salvar o local de uma loja) que ocorreram depois que as pessoas clicaram em um anúncio. Essa métrica se aplica apenas a itens de feed.
AllConversionsFromStoreVisit Double MÉTRICA Número estimado de vezes que as pessoas visitaram uma loja depois de clicar em um anúncio. Essa métrica se aplica apenas a itens de feed.
AllConversionsFromStoreWebsite Double MÉTRICA O número de vezes que as pessoas foram direcionadas ao URL de uma loja depois de clicar em um anúncio. Essa métrica se aplica apenas a itens de feed.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
MessageChatRate Double MÉTRICA Número de chats de mensagens iniciados (message_chats) dividido pelo número de impressões de mensagens (message_impressions). Taxa na qual um usuário inicia um bate-papo por mensagem a partir de uma impressão de anúncio com uma opção de mensagem e rastreamento de mensagem ativado. Observe que essa taxa pode ser superior a 1,0 para uma determinada impressão de mensagem.
MessageChats Long MÉTRICA Número de chats de mensagens iniciados para impressões Click To Message que eram qualificadas para rastreamento de mensagens.
MessageImpressions Long MÉTRICA Número de impressões Click To Message qualificadas para rastreamento de mensagens.
PhoneCalls Long MÉTRICA Número de chamadas telefônicas off-line.
PhoneImpressions Long MÉTRICA Número de impressões telefônicas off-line.
PhoneThroughRate Double MÉTRICA Número de chamadas telefônicas recebidas (phone_calls) dividido pelo número de vezes que seu número de telefone é exibido (phone_impressions).
TopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas em qualquer lugar acima dos resultados de pesquisa orgânica.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
InteractionOnThisExtension Bool SEGMENTO Usado apenas com métricas de itens de feed. Indica se as métricas de interação ocorreram no próprio item do feed ou em uma extensão ou bloco de anúncios diferente.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Alimentar

Uma alimentação.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
FeedAffiliateLocationFeedDataChainIds Long ATRIBUTO A lista de cadeias das quais o feed de localização de afiliados sincronizará os locais.
FeedAffiliateLocationFeedDataRelationshipType String ATRIBUTO A relação que as redes têm com o anunciante. Os valores permitidos são GENERAL_RETAILER, UNKNOWN, UNSPECIFIED.
FeedAttributes String ATRIBUTO Os atributos do Feed. Obrigatório em CREATE, a menos que system_feed_generation_data seja fornecido. Nesse caso, o Google Ads atualizará o feed com os atributos corretos. Não permitido em UPDATE. Use attribute_operations para adicionar novos atributos.
FeedId Long ATRIBUTO Somente saída. O ID do feed. Este campo é só de leitura.
FeedName String ATRIBUTO Imutável. Nome da alimentação. Obrigatório.
FeedOrigin String ATRIBUTO Imutável. Especifica quem gerencia os FeedAttributes para o Feed. Os valores permitidos são GOOGLE, DESCONHECIDO, NÃO ESPECIFICADO, USUÁRIO.
FeedPlacesLocationFeedDataBusinessNameFilter String ATRIBUTO Usado para filtrar as listagens do Perfil da empresa por nome da empresa. Se business_name_filter for definido, apenas listagens com um nome de empresa correspondente são candidatas a serem sincronizadas em FeedItems.
FeedPlacesLocationFeedDataCategoryFilters String ATRIBUTO Usado para filtrar as listagens do Perfil da empresa por categorias. Se existirem entradas em category_filters, apenas as listagens que pertencem a qualquer uma das categorias são candidatas a serem sincronizadas em FeedItems. Se não existirem entradas em category_filters, todas as listagens são candidatas para sincronização.
FeedPlacesLocationFeedDataEmailAddress String ATRIBUTO Endereço E-mail de um Perfil da empresa ou endereço e-mail de um gerente do Perfil da empresa. Obrigatório.
FeedPlacesLocationFeedDataLabelFilters String ATRIBUTO Usado para filtrar listagens do Perfil da empresa por rótulos. Se existirem entradas em label_filters, apenas listagens que tenham qualquer um dos rótulos definidos são candidatas a serem sincronizadas em FeedItems. Se não houver entradas em label_filters, todas as listagens serão candidatas à sincronização.
FeedResourceName String ATRIBUTO Imutável. O nome do recurso do feed. Os nomes dos recursos de feed têm o formato: clientes/{customer_id}/feeds/{feed_id}
FeedStatus String ATRIBUTO Somente saída. Status da alimentação. Este campo é só de leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
FeedItem

Um item de alimentação.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
FeedItemAttributeValues String ATRIBUTO Os valores de atributo do item de feed.
FeedItemEndDateTime Date ATRIBUTO Hora de término em que este item de feed não é mais eficaz e deixará de ser veiculado. A hora está no fuso horário do cliente. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
FeedItemFeed String ATRIBUTO Imutável. O feed ao qual este item de feed pertence.
FeedItemGeoTargetingRestriction String ATRIBUTO A restrição de segmentação geográfica especifica o tipo de local que pode ser usado para segmentação. Os valores permitidos são LOCATION_OF_PRESENCE, UNKNOWN, UNSPECIFIED.
FeedItemId Long ATRIBUTO Somente saída. O ID deste item de feed.
FeedItemPolicyInfos String ATRIBUTO Somente saída. Lista de informações sobre o estado de validação e aprovação de um item de feed para mapeamentos de feed ativos. Haverá uma entrada na lista para cada tipo de mapeamento de feed associado ao feed, por exemplo um feed com um sitelink e um mapeamento de feed de chamada faria com que cada item de feed associado a esse feed tivesse uma entrada nessa lista para sitelink e chamada. Este campo é só de leitura.
FeedItemResourceName String ATRIBUTO Imutável. O nome do recurso do item de feed. Os nomes dos recursos do item de feed têm o formato: customers/{customer_id}/feedItems/{feed_id}~{feed_item_id}
FeedItemStartDateTime Date ATRIBUTO Hora de início em que este item de feed é efetivo e pode começar a ser veiculado. A hora está no fuso horário do cliente. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
FeedItemStatus String ATRIBUTO Somente saída. Status do item de alimentação. Este campo é só de leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
FeedItemUrlCustomParameters String ATRIBUTO A lista de mapeamentos usados para substituir tags de parâmetro personalizado em um tracking_url_template, final_urls ou mobile_final_urls.
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
TopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas em qualquer lugar acima dos resultados de pesquisa orgânica.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
InteractionOnThisExtension Bool SEGMENTO Usado apenas com métricas de itens de feed. Indica se as métricas de interação ocorreram no próprio item do feed ou em uma extensão ou bloco de anúncios diferente.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
PlaceholderType String SEGMENTO Tipo de espaço reservado. Isso é usado apenas com métricas de itens de feed. Os valores permitidos são AD_CUSTOMIZER, AFFILIATE_LOCATION, APP, CALL, CALLOUT, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHT, DYNAMIC_HOTEL, DYNAMIC_JOB, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, IMAGE, LOCATION, MESSAGE, PRICE, PROMOÇÃO, SITELINK, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
FeedItemSet

Representa um conjunto de itens de feed. O conjunto pode ser usado e compartilhado entre certos recursos de itens de alimentação. Por exemplo, o conjunto pode ser referenciado nas funções correspondentes de CustomerFeed, CampaignFeed e AdGroupFeed.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
FeedItemSetDisplayName String ATRIBUTO Nome do conjunto. Deve ser exclusivo dentro da conta.
FeedItemSetDynamicAffiliateLocationSetFilterChainIds Long ATRIBUTO Usado para filtrar localizações afiliadas por IDs de cadeia. Somente os locais afiliados que pertencem à(s) cadeia(s) especificada(s) serão adicionados ao FeedItemSet.
FeedItemSetDynamicLocationSetFilterBusinessNameFilterBusinessName String ATRIBUTO String de nome comercial a ser usada para filtragem.
FeedItemSetDynamicLocationSetFilterBusinessNameFilterFilterType String ATRIBUTO O tipo de string correspondente a ser usado ao filtrar com business_name. Os valores permitidos são EXATO, DESCONHECIDO, NÃO ESPECIFICADO.
FeedItemSetDynamicLocationSetFilterLabels String ATRIBUTO Se vários rótulos forem definidos, apenas feeditems marcados com todos os rótulos serão adicionados ao FeedItemSet.
FeedItemSetFeed String ATRIBUTO Imutável. O nome do recurso do feed que contém os itens de feed no conjunto. Imutável. Obrigatório.
FeedItemSetFeedItemSetId Long ATRIBUTO Somente saída. ID do conjunto.
FeedItemSetResourceName String ATRIBUTO Imutável. O nome do recurso do conjunto de itens de feed. Os nomes dos recursos do conjunto de itens de feed têm o formato: customers/{customer_id}/feedItemSets/{feed_id}~{feed_item_set_id}
FeedItemSetStatus String ATRIBUTO Somente saída. Status do conjunto de itens de alimentação. Este campo é só de leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.

Representa um link entre um FeedItem e um FeedItemSet.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
FeedItemSetLinkFeedItem String ATRIBUTO Imutável. O FeedItem vinculado.
FeedItemSetLinkFeedItemSet String ATRIBUTO Imutável. O FeedItemSet vinculado.
FeedItemSetLinkResourceName String ATRIBUTO Imutável. O nome do recurso do link do conjunto de itens de feed. Os nomes dos recursos do link do conjunto de itens de feed têm o formato: customers/{customer_id}/feedItemSetLinks/{feed_id}~{feed_item_set_id}~{feed_item_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
FeedItemTarget

Um destino de item de feed.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
FeedItemTargetAdGroup String ATRIBUTO Imutável. O grupo de anúncios segmentado.
FeedItemTargetAdSchedule String ATRIBUTO Imutável. O cronograma de destino.
FeedItemTargetAdScheduleDayOfWeek String ATRIBUTO Dia da semana ao qual a programação se aplica. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
FeedItemTargetCampaign String ATRIBUTO Imutável. A campanha segmentada.
FeedItemTargetDevice String ATRIBUTO Imutável. O dispositivo visado. Os valores permitidos são CELULAR, DESCONHECIDO, NÃO ESPECIFICADO.
FeedItemTargetFeedItem String ATRIBUTO Imutável. O item de feed ao qual esse destino de item de feed pertence.
FeedItemTargetFeedItemTargetId Long ATRIBUTO Somente saída. O ID do recurso de destino. Este campo é só de leitura.
FeedItemTargetFeedItemTargetType String ATRIBUTO Somente saída. O tipo de destino deste destino de item de feed. Este campo é só de leitura. Os valores permitidos são AD_GROUP, CAMPAIGN, CRITERION, UNKNOWN, UNSPECIFIED.
FeedItemTargetGeoTargetConstant String ATRIBUTO Imutável. O nome do recurso constante da segmentação geográfica segmentada.
FeedItemTargetKeywordMatchType String ATRIBUTO O tipo de correspondência da palavra-chave. Os valores permitidos são BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
FeedItemTargetKeywordText String ATRIBUTO O texto da palavra-chave (no máximo 80 caracteres e 10 palavras).
FeedItemTargetResourceName String ATRIBUTO Imutável. O nome do recurso do destino do item de feed. Os nomes dos recursos de destino do item de feed têm o formato: clientes/{customer_id}/feedItemTargets/{feed_id}~{feed_item_id}~{feed_item_target_type}~{feed_item_target_id}
FeedItemTargetStatus String ATRIBUTO Somente saída. Status do destino do item de feed. Este campo é só de leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
FeedMapping

Um mapeamento de feed.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
FeedMappingAttributeFieldMappings String ATRIBUTO Imutável. Atributos de feed para mapeamentos de campo. Esses mapeamentos são um relacionamento um-para-muitos, o que significa que 1 atributo de feed pode ser usado para preencher vários campos de espaço reservado, mas 1 campo de espaço reservado só pode extrair dados de 1 atributo de feed. O Personalizador de anúncios é uma exceção. Um campo de espaço reservado pode ser mapeado para vários atributos de feed. Obrigatório.
FeedMappingCriterionType String ATRIBUTO Imutável. O tipo de critério deste mapeamento (ou seja, se o mapeamento mapear atributos de feed para campos de critério). Os valores permitidos são DSA_PAGE_FEED, LOCATION_EXTENSION_TARGETING, UNKNOWN, UNSPECIFIED.
FeedMappingFeed String ATRIBUTO Imutável. O feed deste mapeamento de feed.
FeedMappingPlaceholderType String ATRIBUTO Imutável. O tipo de espaço reservado deste mapeamento (ou seja, se o mapeamento mapear atributos de feed para campos de espaço reservado). Os valores permitidos são AD_CUSTOMIZER, AFFILIATE_LOCATION, APP, CALL, CALLOUT, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHT, DYNAMIC_HOTEL, DYNAMIC_JOB, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, IMAGE, LOCATION, MESSAGE, PRICE, PROMOÇÃO, SITELINK, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO.
FeedMappingResourceName String ATRIBUTO Imutável. O nome do recurso do mapeamento de feed. Os nomes dos recursos de mapeamento de feed têm o formato: customers/{customer_id}/feedMappings/{feed_id}~{feed_mapping_id}
FeedMappingStatus String ATRIBUTO Somente saída. Status do mapeamento de feed. Este campo é só de leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
FeedPlaceholderView

Uma exibição de marcador de posição de feed.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
FeedPlaceholderViewPlaceholderType String ATRIBUTO Somente saída. O tipo de espaço reservado da visualização de espaço reservado do feed. Os valores permitidos são AD_CUSTOMIZER, AFFILIATE_LOCATION, APP, CALL, CALLOUT, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHT, DYNAMIC_HOTEL, DYNAMIC_JOB, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, IMAGE, LOCATION, MESSAGE, PRICE, PROMOÇÃO, SITELINK, STRUCTURED_SNIPPET, DESCONHECIDO, NÃO ESPECIFICADO.
FeedPlaceholderViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização de espaço reservado do feed. Os nomes dos recursos de exibição de espaço reservado de feed têm o formato: clientes/{customer_id}/feedPlaceholderViews/{placeholder_type}
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
GenderView

Uma visão de gênero.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
GenderViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização de gênero. Os nomes dos recursos de exibição de gênero têm o formato: clientes/{customer_id}/genderViews/{ad_group_id}~{criterion_id}
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Visualização Geográfica

Uma visão geográfica. A visualização geográfica inclui todas as métricas agregadas no nível do país, uma linha por país. Ele relata métricas na localização física real do usuário ou em uma área de interesse. Se outros campos de segmento forem usados, você poderá obter mais de uma linha por país.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
GeographicViewCountryCriterionId Long ATRIBUTO Somente saída. ID do critério para o país.
GeographicViewLocationType String ATRIBUTO Somente saída. Tipo de segmentação geográfica da campanha. Os valores permitidos são AREA_OF_INTEREST, LOCATION_OF_PRESENCE, UNKNOWN, UNSPECIFIED.
GeographicViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização geográfica. Os nomes dos recursos de exibição geográfica têm o formato: clientes/{customer_id}/geographicViews/{country_criterion_id}~{location_type}
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
TopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas em qualquer lugar acima dos resultados de pesquisa orgânica.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
GeoTargetAirport String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um aeroporto.
GeoTargetCanton String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um cantão.
GeoTargetCity String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa uma cidade.
GeoTargetCounty String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um município.
GeoTargetDistrict String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um distrito.
GeoTargetMetro String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa uma área metropolitana.
GeoTargetMostSpecificLocation String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa o local mais específico.
GeoTargetPostalCode String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um código postal.
GeoTargetProvince String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa uma província.
GeoTargetRegion String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa uma região.
GeoTargetState String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um estado.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
GeoTargetConstant

Uma constante de segmentação geográfica.

Colunas
Nome Tipo Comportamento Descrição
GeoTargetConstantCanonicalName String ATRIBUTO Somente saída. O nome em inglês totalmente qualificado, consistindo no nome do destino e de seu pai e país.
GeoTargetConstantCountryCode String ATRIBUTO Somente saída. O código de país ISO-3166-1 alfa-2 associado ao destino.
GeoTargetConstantId Long ATRIBUTO Somente saída. O ID da constante de segmentação geográfica.
GeoTargetConstantName String ATRIBUTO Somente saída. Nome em inglês constante da segmentação geográfica.
GeoTargetConstantParentGeoTarget String ATRIBUTO Somente saída. O nome do recurso da constante de segmentação geográfica principal. Os nomes de recursos constantes de destino geográfico têm o formato: geoTargetConstants/{parent_geo_target_constant_id}
GeoTargetConstantResourceName String ATRIBUTO Somente saída. O nome do recurso da constante de segmentação geográfica. Os nomes de recursos constantes de destino geográfico têm o formato: geoTargetConstants/{geo_target_constant_id}
GeoTargetConstantStatus String ATRIBUTO Somente saída. Status constante da segmentação geográfica. Os valores permitidos são ENABLED, REMOVAL_PLANNED, UNKNOWN, UNSPECIFIED.
GeoTargetConstantTargetType String ATRIBUTO Somente saída. Tipo de alvo constante de segmentação geográfica.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
GroupPlacementView

Uma exibição de veiculação de grupo.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
GroupPlacementViewDisplayName String ATRIBUTO Somente saída. Nome de domínio para sites e nome de canal do YouTube para canais do YouTube.
GroupPlacementViewPlacement String ATRIBUTO Somente saída. A string de posicionamento automático no nível do grupo, por exemplo. g. domínio da Web, ID de aplicativo móvel ou um ID de canal do YouTube.
GroupPlacementViewPlacementType String ATRIBUTO Somente saída. Tipo de veiculação, por exemplo Site, canal do YouTube, aplicativo móvel. Os valores permitidos são MOBILE_APPLICATION, MOBILE_APP_CATEGORY, UNKNOWN, UNSPECIFIED, WEBSITE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO.
GroupPlacementViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização de veiculação de grupo. Os nomes dos recursos de exibição de veiculação de grupo têm o formato: customers/{customer_id}/groupPlacementViews/{ad_group_id}~{base64_placement}
GroupPlacementViewTargetUrl String ATRIBUTO Somente saída. URL da veiculação do grupo, por exemplo, domínio, link para o aplicativo móvel na loja de aplicativos ou URL de um canal do YouTube.
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
HotelGroupView

Uma visão do grupo de hotéis.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
HotelGroupViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição do grupo de hotéis. Os nomes dos recursos de exibição do Grupo de hotéis têm o formato: customers/{customer_id}/hotelGroupViews/{ad_group_id}~{criterion_id}
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor das conversões de interações dividido pelo número de interações com anúncios. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValuePerCost Double MÉTRICA O valor das conversões dividido pelo custo das interações com o anúncio. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
HotelAverageLeadValueMicros Double MÉTRICA Valor médio do lead com base em cliques.
HotelEligibleImpressions Long MÉTRICA O número de impressões que os hotéis parceiros poderiam ter dado ao desempenho do feed.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
SearchAbsoluteTopImpressionShare Double MÉTRICA A porcentagem de impressões de anúncios do Shopping ou de pesquisa do cliente que são exibidas na posição mais proeminente do Shopping. Ver https://support.google.com/google-ads/answer/7501826 para detalhes. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchBudgetLostAbsoluteTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi o primeiro anúncio acima dos resultados da pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões absolutas na parte superior perdida do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchBudgetLostImpressionShare Double MÉTRICA A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na Rede de Pesquisa, mas não porque seu orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchBudgetLostTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi exibido acima dos resultados de pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões na parte superior perdida do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchClickShare Double MÉTRICA O número de cliques que você recebeu na Rede de Pesquisa dividido pelo número estimado de cliques que você estava qualificado para receber. Observação: a parcela de cliques de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchImpressionShare Double MÉTRICA As impressões que você recebeu na Rede de Pesquisa divididas pelo número estimado de impressões que você estava qualificado para receber. Observação: a parcela de impressões de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchRankLostAbsoluteTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi o primeiro anúncio acima dos resultados da pesquisa orgânica devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões absolutas perdidas na classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchRankLostImpressionShare Double MÉTRICA A porcentagem estimada de impressões na rede de pesquisa que seus anúncios não receberam devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas da classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchRankLostTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi exibido em nenhum lugar acima dos resultados de pesquisa orgânica devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas na classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchTopImpressionShare Double MÉTRICA As impressões que você recebeu no local superior (em qualquer lugar acima dos resultados da pesquisa orgânica) em comparação com o número estimado de impressões que você estava qualificado para receber no local superior. Observação: a parcela de impressões na parte superior da pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Hour Int SEGMENTO Hora do dia como um número entre 0 e 23, inclusive.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
HotelPerformanceView

Uma visão do desempenho do hotel.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
HotelPerformanceViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição de desempenho do hotel. Os nomes dos recursos de exibição de desempenho do hotel têm o formato: customers/{customer_id}/hotelPerformanceView
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor das conversões de interações dividido pelo número de interações com anúncios. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValuePerCost Double MÉTRICA O valor das conversões dividido pelo custo das interações com o anúncio. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
HotelAverageLeadValueMicros Double MÉTRICA Valor médio do lead com base em cliques.
HotelEligibleImpressions Long MÉTRICA O número de impressões que os hotéis parceiros poderiam ter dado ao desempenho do feed.
HotelPriceDifferencePercentage Double MÉTRICA A diferença de preço médio entre o preço oferecido pelo anunciante do hotel informante e o preço mais barato oferecido pelo anunciante concorrente.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
SearchAbsoluteTopImpressionShare Double MÉTRICA A porcentagem de impressões de anúncios do Shopping ou de pesquisa do cliente que são exibidas na posição mais proeminente do Shopping. Ver https://support.google.com/google-ads/answer/7501826 para detalhes. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchBudgetLostAbsoluteTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi o primeiro anúncio acima dos resultados da pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões absolutas na parte superior perdida do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchBudgetLostImpressionShare Double MÉTRICA A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na Rede de Pesquisa, mas não porque seu orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchBudgetLostTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi exibido acima dos resultados de pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões na parte superior perdida do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchClickShare Double MÉTRICA O número de cliques que você recebeu na Rede de Pesquisa dividido pelo número estimado de cliques que você estava qualificado para receber. Observação: a parcela de cliques de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchImpressionShare Double MÉTRICA As impressões que você recebeu na Rede de Pesquisa divididas pelo número estimado de impressões que você estava qualificado para receber. Observação: a parcela de impressões de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchRankLostAbsoluteTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi o primeiro anúncio acima dos resultados da pesquisa orgânica devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões absolutas perdidas na classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchRankLostImpressionShare Double MÉTRICA A porcentagem estimada de impressões na rede de pesquisa que seus anúncios não receberam devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas da classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchRankLostTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi exibido em nenhum lugar acima dos resultados de pesquisa orgânica devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas na classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchTopImpressionShare Double MÉTRICA As impressões que você recebeu no local superior (em qualquer lugar acima dos resultados da pesquisa orgânica) em comparação com o número estimado de impressões que você estava qualificado para receber no local superior. Observação: a parcela de impressões na parte superior da pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
GeoTargetCountry String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um país.
HotelBookingWindowDays Long SEGMENTO Janela de reserva de hotel em dias.
HotelCenterId Long SEGMENTO ID do centro hoteleiro.
HotelCheckInDate Date SEGMENTO Data de entrada no hotel. Formatado como aaaa-MM-dd.
HotelCheckInDayOfWeek String SEGMENTO Check-in no hotel dia da semana. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
HotelCity String SEGMENTO Cidade hoteleira.
HotelClass Int SEGMENTO Classe hoteleira.
HotelCountry String SEGMENTO País hoteleiro.
HotelDateSelectionType String SEGMENTO Tipo de seleção de data do hotel. Os valores permitidos são DEFAULT_SELECTION, UNKNOWN, UNSPECIFIED, USER_SELECTED.
HotelLengthOfStay Int SEGMENTO Tempo de permanência no hotel.
HotelPriceBucket String SEGMENTO Balde de preço do hotel. Os valores permitidos são LOWEST_TIED, LOWEST_UNIQUE, NOT_LOWEST, ONLY_PARTNER_SHOWN, UNKNOWN, UNSPECIFIED.
HotelRateRuleId String SEGMENTO ID da regra de tarifa do hotel.
HotelRateType String SEGMENTO Tipo de tarifa do hotel. Os valores permitidos são PRIVATE_RATE, PUBLIC_RATE, QUALIFIED_RATE, UNAVAILABLE, UNKNOWN, UNSPECIFIED.
HotelState String SEGMENTO Estado hoteleiro.
Hour Int SEGMENTO Hora do dia como um número entre 0 e 23, inclusive.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
PartnerHotelId String SEGMENTO Identificação do hotel parceiro.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
HotelReconciliation

Uma reconciliação hoteleira. Ele contém informações de conversão de reservas de hotel para reconciliar com os registros do anunciante. Essas linhas podem ser atualizadas ou canceladas antes da cobrança por meio de uploads em massa.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
HotelReconciliationBilled Bool ATRIBUTO Somente saída. Se uma determinada reserva foi cobrada. Uma vez faturada, uma reserva não pode ser modificada.
HotelReconciliationCampaign String ATRIBUTO Somente saída. O nome do recurso para a campanha associada à conversão.
HotelReconciliationCheckInDate Date ATRIBUTO Somente saída. Data de check-in registrada no momento da reserva. Se a data de check-in for modificada na reconciliação, a data revisada substituirá a data original nesta coluna. O formato é AAAA-MM-DD.
HotelReconciliationCheckOutDate Date ATRIBUTO Somente saída. Data de check-out registrada no momento da reserva. Se a data de check-in for modificada na reconciliação, a data revisada substituirá a data original nesta coluna. O formato é AAAA-MM-DD.
HotelReconciliationCommissionId String ATRIBUTO Obrigatório. Somente saída. O ID da comissão é o ID do Google para esta reserva. Cada evento de reserva recebe um ID de comissão para ajudá-lo a combiná-lo com a estadia de um hóspede.
HotelReconciliationHotelCenterId Long ATRIBUTO Somente saída. Identificador da conta Hotel Center que fornece as tarifas da campanha Hotel.
HotelReconciliationHotelId String ATRIBUTO Somente saída. Identificador exclusivo da propriedade reservada, conforme fornecido no feed da Central para Hotéis. O ID do hotel vem do parâmetro 'ID' da tag de acompanhamento de conversões.
HotelReconciliationOrderId String ATRIBUTO Somente saída. O ID do pedido é o identificador dessa reserva, conforme fornecido no parâmetro 'transaction_id' da tag de acompanhamento de conversões.
HotelReconciliationReconciledValueMicros Long ATRIBUTO Obrigatório. Somente saída. O valor reconciliado é o valor final de uma reserva pago pelo hóspede. Se o valor original da reserva for alterado por qualquer motivo, como alterações de itinerário ou vendas adicionais de quartos, o valor reconciliado deve ser o valor final total coletado. Se uma reserva for cancelada, o valor reconciliado deve incluir o valor de quaisquer taxas de cancelamento ou noites não reembolsáveis cobradas. O valor está em milionésimos da moeda da unidade base. Por exemplo, US$ 12,35 seria representado como 12350000. A unidade monetária é a moeda padrão do cliente.
HotelReconciliationResourceName String ATRIBUTO Imutável. O nome do recurso da reconciliação do hotel. Os nomes dos recursos de reconciliação do hotel têm o formato: customers/{customer_id}/hotelReconciliations/{commission_id}
HotelReconciliationStatus String ATRIBUTO Obrigatório. Somente saída. Status atual de uma reserva com relação à reconciliação e cobrança. As reservas devem ser conciliadas no prazo de 45 dias após a data de check-out. Qualquer reserva não reconciliada dentro de 45 dias será cobrada em seu valor original. Os valores permitidos são CANCELED, RECONCILED, RECONCILIATION_NEEDED, RESERVATION_ENABLED, UNKNOWN, UNSPECIFIED.
HotelCommissionRateMicros Long MÉTRICA Taxa de lance de comissão em micros. Uma comissão de 20% é representada como 200.000.
HotelExpectedCommissionCost Double MÉTRICA Custo de comissão esperado. O resultado da multiplicação do valor da comissão pelo hotel_commission_rate na moeda do anunciante.
ValuePerConversionsByConversionDate Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
IncomeRangeView

Uma visão de faixa de renda.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
IncomeRangeViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição da faixa de renda. Os nomes dos recursos de exibição de faixa de renda têm o formato: customers/{customer_id}/incomeRangeViews/{ad_group_id}~{criterion_id}
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de exibição.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Plano de Palavras-chave

Um plano do Planejador de palavras-chave. Número máximo de planos de palavras-chave salvos: 10.000. É possível remover planos se o limite for atingido.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
KeywordPlanForecastPeriod String ATRIBUTO O período de datas usado para prever o plano.
KeywordPlanId Long ATRIBUTO Somente saída. O ID do plano de palavras-chave.
KeywordPlanName String ATRIBUTO O nome do plano de palavras-chave. Este campo é obrigatório e não deve ficar vazio ao criar novos planos de palavras-chave.
KeywordPlanResourceName String ATRIBUTO Imutável. O nome do recurso do plano do Planejador de palavras-chave. Os nomes dos recursos do KeywordPlan têm o formato: customers/{customer_id}/keywordPlans/{kp_plan_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
KeywordPlanAdGroup

Um grupo de anúncios do Planejador de palavras-chave. Número máximo de grupos de anúncios de planos de palavras-chave por plano: 200.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
KeywordPlanAdGroupCpcBidMicros Long ATRIBUTO Um lance de CPC máx. de grupo de anúncios padrão em micros na moeda da conta para todas as palavras-chave que recebem lances no grupo de anúncios do plano de palavras-chave. Se não for definido, herdará da campanha principal.
KeywordPlanAdGroupId Long ATRIBUTO Somente saída. O ID do grupo de anúncios do plano de palavras-chave.
KeywordPlanAdGroupKeywordPlanCampaign String ATRIBUTO A campanha do plano de palavras-chave à qual esse grupo de anúncios pertence.
KeywordPlanAdGroupName String ATRIBUTO O nome do grupo de anúncios do plano de palavras-chave. Este campo é obrigatório e não deve ficar vazio ao criar um grupo de anúncios de planos de palavras-chave.
KeywordPlanAdGroupResourceName String ATRIBUTO Imutável. O nome do recurso do grupo de anúncios do Planejador de palavras-chave. Os nomes dos recursos KeywordPlanAdGroup têm o formato: clientes/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
KeywordPlanAdGroupKeyword

Uma palavra-chave do grupo de anúncios do Plano de palavras-chave. Número máximo de palavras-chave do plano de palavras-chave por plano: 10.000.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
KeywordPlanAdGroupKeywordCpcBidMicros Long ATRIBUTO Um lance máximo de CPC no nível da palavra-chave em micros (por exemplo, US$ 1 = 1 mm). A moeda é a mesma do código de moeda da conta. Isso substituirá qualquer lance de CPC definido no nível do grupo de anúncios do plano de palavra-chave. Não aplicável a palavras-chave negativas. (negativo = verdadeiro) Este campo é opcional.
KeywordPlanAdGroupKeywordId Long ATRIBUTO Somente saída. O ID da palavra-chave do Plano de palavras-chave.
KeywordPlanAdGroupKeywordKeywordPlanAdGroup String ATRIBUTO O grupo de anúncios do Plano de palavras-chave ao qual essa palavra-chave pertence.
KeywordPlanAdGroupKeywordMatchType String ATRIBUTO O tipo de correspondência da palavra-chave. Os valores permitidos são BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
KeywordPlanAdGroupKeywordNegative Bool ATRIBUTO Imutável. Se verdadeiro, a palavra-chave é negativa.
KeywordPlanAdGroupKeywordResourceName String ATRIBUTO Imutável. O nome do recurso da palavra-chave do grupo de anúncios Plano de palavras-chave. Os nomes dos recursos KeywordPlanAdGroupKeyword têm o seguinte formato: clientes/{customer_id}/keywordPlanAdGroupKeywords/{kp_ad_group_keyword_id}
KeywordPlanAdGroupKeywordText String ATRIBUTO O texto da palavra-chave.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
KeywordPlanCampanha

Uma campanha de plano de palavra-chave. Número máximo permitido de campanhas de planos de palavras-chave por plano: 1.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
KeywordPlanCampaignCpcBidMicros Long ATRIBUTO Um lance máximo de CPC padrão em micros e na moeda da conta para todos os grupos de anúncios da campanha. Este campo é obrigatório e não deve ficar vazio ao criar campanhas de plano de palavra-chave.
KeywordPlanCampaignGeoTargets String ATRIBUTO As segmentações geográficas. Número máximo permitido: 20.
KeywordPlanCampaignId Long ATRIBUTO Somente saída. O ID da campanha do Plano de palavras-chave.
KeywordPlanCampaignKeywordPlan String ATRIBUTO O plano de palavras-chave ao qual esta campanha pertence.
KeywordPlanCampaignKeywordPlanNetwork String ATRIBUTO Rede de segmentação. Este campo é obrigatório e não deve ficar vazio ao criar campanhas de plano de palavra-chave. Os valores permitidos são GOOGLE_SEARCH, GOOGLE_SEARCH_AND_PARTNERS, UNKNOWN, UNSPECIFIED.
KeywordPlanCampaignLanguageConstants String ATRIBUTO Os idiomas segmentados para a campanha do Plano de palavras-chave. Máximo permitido: 1.
KeywordPlanCampaignName String ATRIBUTO O nome da campanha do Plano de palavras-chave. Este campo é obrigatório e não deve ficar vazio ao criar campanhas de plano de palavra-chave.
KeywordPlanCampaignResourceName String ATRIBUTO Imutável. O nome do recurso da campanha do Plano de palavras-chave. Os nomes dos recursos KeywordPlanCampaign têm o formato: clientes/{customer_id}/keywordPlanCampaigns/{kp_campaign_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Palavra-chavePlanoCampanhaPalavra-chave

Uma palavra-chave de campanha de plano de palavra-chave. Somente palavras-chave negativas são suportadas para a palavra-chave da campanha.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
KeywordPlanCampaignKeywordId Long ATRIBUTO Somente saída. O ID da palavra-chave negativa do Plano de palavras-chave.
KeywordPlanCampaignKeywordKeywordPlanCampaign String ATRIBUTO A campanha do Plano de palavras-chave à qual essa palavra-chave negativa pertence.
KeywordPlanCampaignKeywordMatchType String ATRIBUTO O tipo de correspondência da palavra-chave. Os valores permitidos são BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
KeywordPlanCampaignKeywordNegative Bool ATRIBUTO Imutável. Se verdadeiro, a palavra-chave é negativa. Deve ser definido como verdadeiro. Somente palavras-chave negativas de campanha são suportadas.
KeywordPlanCampaignKeywordResourceName String ATRIBUTO Imutável. O nome do recurso da palavra-chave Campanha do plano de palavra-chave. Os nomes dos recursos KeywordPlanCampaignKeyword têm o formato: clientes/{customer_id}/keywordPlanCampaignKeywords/{kp_campaign_keyword_id}
KeywordPlanCampaignKeywordText String ATRIBUTO O texto da palavra-chave.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
KeywordThemeConstant

Uma constante de tema de palavra-chave de campanha inteligente.

Colunas
Nome Tipo Comportamento Descrição
KeywordThemeConstantCountryCode String ATRIBUTO Somente saída. O código de país ISO-3166 Alpha-2 da constante, por exemplo. "NÓS". Para exibir e consultar a finalidade correspondente, o tema da palavra-chave precisa ser localizado.
KeywordThemeConstantDisplayName String ATRIBUTO Somente saída. O nome de exibição do tema de palavra-chave ou subtema de palavra-chave.
KeywordThemeConstantLanguageCode String ATRIBUTO Somente saída. O código de idioma ISO-639-1 com 2 letras da constante, por exemplo. "en". Para exibir e consultar a finalidade correspondente, o tema da palavra-chave precisa ser localizado.
KeywordThemeConstantResourceName String ATRIBUTO Somente saída. O nome do recurso da constante de tema de palavra-chave. Os nomes dos recursos constantes do tema da palavra-chave têm o formato: keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Visualização de Palavras-chave

Uma exibição de palavra-chave.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
KeywordViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição de palavra-chave. Os nomes dos recursos de exibição de palavra-chave têm o formato: clientes/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de exibição.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsByConversionDate Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValueByConversionDate Double MÉTRICA O valor de todas as conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
AveragePageViews Double MÉTRICA Número médio de páginas visualizadas por sessão.
AverageTimeOnSite Double MÉTRICA Duração total de todas as sessões (em segundos) / número de sessões. Importado do Google Analytics.
BounceRate Double MÉTRICA Porcentagem de cliques em que o usuário visitou apenas uma única página em seu site. Importado do Google Analytics.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsByConversionDate Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValueByConversionDate Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ConversionsValuePerCost Double MÉTRICA O valor das conversões dividido pelo custo das interações com o anúncio. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostPerCurrentModelAttributedConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões atribuídas ao modelo atual. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
CurrentModelAttributedConversions Double MÉTRICA Mostra como seus dados históricos de conversões ficariam no modelo de atribuição que você selecionou no momento. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CurrentModelAttributedConversionsValue Double MÉTRICA O valor das conversões atribuídas ao modelo atual. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
HistoricalCreativeQualityScore String MÉTRICA O índice de qualidade histórico do criativo. Os valores permitidos são UNSPECIFIED, UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
HistoricalLandingPageQualityScore String MÉTRICA A qualidade da experiência histórica da página de aterrissagem. Os valores permitidos são UNSPECIFIED, UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
HistoricalQualityScore Long MÉTRICA O índice de qualidade histórico.
HistoricalSearchPredictedCtr String MÉTRICA A pesquisa histórica previu a taxa de cliques (CTR). Os valores permitidos são UNSPECIFIED, UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
PercentNewVisitors Double MÉTRICA Porcentagem de sessões pela primeira vez (de pessoas que nunca visitaram seu site antes). Importado do Google Analytics.
SearchAbsoluteTopImpressionShare Double MÉTRICA A porcentagem de impressões de anúncios do Shopping ou de pesquisa do cliente que são exibidas na posição mais proeminente do Shopping. Ver https://support.google.com/google-ads/answer/7501826 para detalhes. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchBudgetLostAbsoluteTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi o primeiro anúncio acima dos resultados da pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões absolutas na parte superior perdida do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchBudgetLostTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi exibido acima dos resultados de pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões na parte superior perdida do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchClickShare Double MÉTRICA O número de cliques que você recebeu na Rede de Pesquisa dividido pelo número estimado de cliques que você estava qualificado para receber. Observação: a parcela de cliques de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchExactMatchImpressionShare Double MÉTRICA As impressões recebidas divididas pelo número estimado de impressões que você estava qualificado para receber na Rede de Pesquisa para termos de pesquisa que correspondiam exatamente às suas palavras-chave (ou eram variantes aproximadas de sua palavra-chave), independentemente dos tipos de correspondência de palavras-chave. Observação: a parcela de impressões de correspondência exata da pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchImpressionShare Double MÉTRICA As impressões que você recebeu na Rede de Pesquisa divididas pelo número estimado de impressões que você estava qualificado para receber. Observação: a parcela de impressões de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchRankLostAbsoluteTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi o primeiro anúncio acima dos resultados da pesquisa orgânica devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões absolutas perdidas na classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchRankLostImpressionShare Double MÉTRICA A porcentagem estimada de impressões na rede de pesquisa que seus anúncios não receberam devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas da classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchRankLostTopImpressionShare Double MÉTRICA O número que estima a frequência com que seu anúncio não foi exibido em nenhum lugar acima dos resultados de pesquisa orgânica devido à classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas na classificação de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é relatado como 0,9001.
SearchTopImpressionShare Double MÉTRICA As impressões que você recebeu no local superior (em qualquer lugar acima dos resultados da pesquisa orgânica) em comparação com o número estimado de impressões que você estava qualificado para receber no local superior. Observação: a parcela de impressões na parte superior da pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
TopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas em qualquer lugar acima dos resultados de pesquisa orgânica.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerAllConversionsByConversionDate Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ValuePerConversionsByConversionDate Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões. Quando esta coluna é selecionada com data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
ValuePerCurrentModelAttributedConversion Double MÉTRICA O valor das conversões atribuídas ao modelo atual dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
ConversionAdjustment Bool SEGMENTO Isso segmenta suas colunas de conversão pela conversão original e pelo valor da conversão em comparação com o delta se as conversões forem ajustadas. A linha falsa contém os dados conforme declarados originalmente; Embora a linha verdadeira tenha o delta entre os dados agora e os dados originalmente declarados. A soma dos dois resulta em dados pós-ajuste.
ConversionLagBucket String SEGMENTO Um valor de enumeração que representa o número de dias entre a impressão e a conversão. Os valores permitidos são EIGHT_TO_NINE_DAYS, ELEVEN_TO_TWELVE_DAYS, FIVE_TO_SIX_DAYS, FORTY_FIVE_TO_SIXTY_DAYS, FOURTEEN_TO_TWENTY_ONE_DAYS, FOUR_TO_FIVE_DAYS, LESS_THAN_ONE_DAY, NINE_TO_TEN_DAYS, ONE_TO_TWO_DAYS, SEVEN_TO_EIGHT_DAYS S, SEXTY_TO_NINETY_DAYS, SIX_TO_SEVEN_DAYS, TEN_TO_ELEVEN_DAYS, TREZE_TO_FOURTEEN_DAYS, TRINTA_TO_FORTY_FIVE_DAYS, TRÊS_TO_FOUR_DAYS, DOZE_TO_THIRTEEN_DAYS, TWENTY_ONE_TO_THIRTY_DAYS, DOIS_TO_THREE_DAYS, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionOrAdjustmentLagBucket String SEGMENTO Um valor de enumeração que representa o número de dias entre a impressão e a conversão ou entre a impressão e os ajustes na conversão. Os valores permitidos são ADJUSTMENT_EIGHT_TO_NINE_DAYS, ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS, ADJUSTMENT_FIVE_TO_SIX_DAYS, ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS, ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS, ADJUSTMENT_FOUR_TO_FIVE_DAYS, ADJUSTMENT_LESS_THAN_ONE_DAY, ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS, ADJUSTMENT_NINE_TO_TEN_DAYS, ADJUSTMENT_ONE_TO_TWO_DAYS, ADJUSTMENT_SEVEN_TO_EIGHT_DAYS, ADJUSTMENT_SIXTY_TO_NINETY_DAYS, ADJUSTMENT_SIX_TO_SEVEN_DAYS, ADJUSTMENT_TEN_TO_ELEVEN_DAYS, ADJUSTMENT_THIRTEEN_ TO_FOURTEEN_DAYS, ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS, ADJUSTMENT_THREE_TO_FOUR_DAYS, ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS, ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS, ADJUSTMENT_TWO_TO_THREE_DAYS, ADJUSTMENT_UNKNOWN, CONVERSION_EIGHT_TO_NINE_DAYS, CONVERSION_ELEVEN_TO_TWELVE_DAYS, CONVERSION_FIVE_TO_SIX_DAYS, CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS, CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS, CONVERSION_FOUR_TO_FIVE_DAYS, CONVERSION_LESS_THAN_ONE_DAY, CONVERSION_NINE_TO_TEN_DAYS, CONVERSION_ONE_TO_TWO_DAYS, CONVERSION_SEVEN_TO_ OITO_DIAS, CONVERSION_SIXTY_TO_NINETY_DAYS, CONVERSION_SIX_TO_SEVEN_DAYS, CONVERSION_TEN_TO_ELEVEN_DAYS, CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS, CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS, CONVERSION_THREE_TO_FOUR_DAYS, CONVERSION_TWELVE_TO_THIRTEEN_DAYS, CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS, CONVERSION_TWO_TO_THREE_DAYS, CONVERSION_UNKNOWN, DESCONHECIDO, NÃO ESPECIFICADO.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Rótulo

Um rótulo.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
LabelId Long ATRIBUTO Somente saída. ID do rótulo. Somente leitura.
LabelName String ATRIBUTO O nome do rótulo. Este campo é obrigatório e não deve estar vazio ao criar um novo rótulo. O comprimento desta string deve estar entre 1 e 80, inclusive.
LabelResourceName String ATRIBUTO Imutável. Nome do recurso. Os nomes dos recursos de rótulo têm o formato: customers/{customer_id}/labels/{label_id}
LabelStatus String ATRIBUTO Somente saída. Estado da etiqueta. Somente leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
LabelTextLabelBackgroundColor String ATRIBUTO Cor de fundo da etiqueta em formato RGB. Esta string deve corresponder à expressão regular '^\([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Observação: a cor de fundo pode não estar visível para contas de administrador.
LabelTextLabelDescription String ATRIBUTO Uma breve descrição do rótulo. O comprimento não deve ser superior a 200 caracteres.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
LandingPageView

Uma visualização da página de aterrissagem com métricas agregadas no nível do URL final não expandido.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
LandingPageViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização da página de aterrissagem. Os nomes dos recursos de exibição da página inicial têm o formato: customers/{customer_id}/landingPageViews/{unexpanded_final_url_fingerprint}
LandingPageViewUnexpandedFinalUrl String ATRIBUTO Somente saída. O URL final especificado pelo anunciante.
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de exibição.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor das conversões de interações dividido pelo número de interações com anúncios. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValuePerCost Double MÉTRICA O valor das conversões dividido pelo custo das interações com o anúncio. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
MobileFriendlyClicksPercentage Double MÉTRICA A porcentagem de cliques móveis que levam a uma página otimizada para celular.
SpeedScore Long MÉTRICA Uma medida da rapidez com que sua página é carregada após cliques em seus anúncios para celular. A pontuação varia de 1 a 10, sendo 10 o mais rápido.
ValidAcceleratedMobilePagesClicksPercentage Double MÉTRICA A porcentagem de cliques em anúncios para páginas de destino Accelerated Mobile Pages (AMP) que chegam a uma página AMP válida.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
LanguageConstant

Uma linguagem.

Colunas
Nome Tipo Comportamento Descrição
LanguageConstantCode String ATRIBUTO Somente saída. O código do idioma, por ex. "en_US", "en_AU", "es", "fr", etc.
LanguageConstantId Long ATRIBUTO Somente saída. O ID da constante de idioma.
LanguageConstantName String ATRIBUTO Somente saída. O nome completo do idioma em inglês, por exemplo, "English (US)", "Spanish" etc.
LanguageConstantResourceName String ATRIBUTO Somente saída. O nome do recurso da constante de idioma. Os nomes de recursos constantes de idioma têm o formato: languageConstants/{criterion_id}
LanguageConstantTargetable Bool ATRIBUTO Somente saída. Se o idioma é segmentável.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
LifeEvent

Um evento da vida: um determinado vertical baseado em interesse a ser direcionado para alcançar os usuários quando eles estão no meio de marcos importantes da vida.

Colunas
Nome Tipo Comportamento Descrição
LifeEventAvailabilities String ATRIBUTO Somente saída. Informações de disponibilidade do evento de vida.
LifeEventId Long ATRIBUTO Somente saída. O ID do evento de vida.
LifeEventLaunchedToAll Bool ATRIBUTO Somente saída. Verdadeiro se o evento de vida for iniciado em todos os canais e localidades.
LifeEventName String ATRIBUTO Somente saída. O nome do evento de vida. Por exemplo, "Recentemente movido"
LifeEventParent String ATRIBUTO Somente saída. O pai do life_event.
LifeEventResourceName String ATRIBUTO Somente saída. O nome do recurso do evento de vida. Os nomes de recursos de eventos de vida têm o formato: clientes/{customer_id}/lifeEvents/{life_event_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
LocationView

Uma exibição de localização resume o desempenho das campanhas por critérios de localização.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
LocationViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição de localização. Os nomes dos recursos de exibição de local têm o formato: clientes/{customer_id}/locationViews/{campaign_id}~{criterion_id}
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ManagedPlacementView

Uma exibição de canal gerenciado.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ManagedPlacementViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição Managed Placement. Os nomes dos recursos de exibição de veiculação gerenciada têm o formato: customers/{customer_id}/ managedPlacementViews/{ad_group_id}~{criterion_id}
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Arquivo de Mídia

Um arquivo de mídia.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
MediaFileAudioAdDurationMillis Long ATRIBUTO Somente saída. A duração do áudio em milissegundos.
MediaFileFileSize Long ATRIBUTO Somente saída. O tamanho do arquivo de mídia em bytes.
MediaFileId Long ATRIBUTO Somente saída. O ID do arquivo de mídia.
MediaFileImageFullSizeImageUrl String ATRIBUTO Somente saída. A URL para a versão em tamanho real da imagem.
MediaFileImagePreviewSizeImageUrl String ATRIBUTO Somente saída. A URL para a versão de tamanho de visualização da imagem.
MediaFileMediaBundleUrl String ATRIBUTO Somente saída. A URL para acessar os dados compactados carregados. Por exemplo https://tpc.googlesyndication.com/simgad/123 este campo é só de leitura.
MediaFileMimeType String ATRIBUTO Somente saída. O tipo mime do arquivo de mídia. Os valores permitidos são AUDIO_MP3, AUDIO_WAV, FLASH, HTML5_AD_ZIP, IMAGE_GIF, IMAGE_JPEG, IMAGE_PNG, MSEXCEL, MSWORD, PDF, RTF, TEXT_HTML, UNKNOWN, UNSPECIFIED.
MediaFileName String ATRIBUTO Imutável. O nome do arquivo de mídia. O nome pode ser usado por clientes para ajudar a identificar a mídia carregada anteriormente.
MediaFileResourceName String ATRIBUTO Imutável. O nome do recurso do arquivo de mídia. Os nomes de recursos de arquivo de mídia têm o formato: clientes/{customer_id}/mediaFiles/{media_file_id}
MediaFileSourceUrl String ATRIBUTO Imutável. A URL de onde o arquivo de mídia original foi baixado (ou um nome de arquivo). Usado apenas para mídia do tipo ÁUDIO e IMAGEM.
MediaFileType String ATRIBUTO Imutável. Tipo do arquivo de mídia. Os valores permitidos são AUDIO, DYNAMIC_IMAGE, ICON, IMAGE, MEDIA_BUNDLE, UNKNOWN, UNSPECIFIED, VIDEO.
MediaFileVideoAdDurationMillis Long ATRIBUTO Somente saída. A duração do vídeo em milissegundos.
MediaFileVideoAdvertisingIdCode String ATRIBUTO Somente saída. O código de identificação digital de publicidade para este vídeo, conforme definido pela Associação Americana de Agências de Publicidade, usado principalmente para comerciais de televisão.
MediaFileVideoIsciCode String ATRIBUTO Somente saída. O código identificador comercial padrão da indústria para este vídeo, usado principalmente para comerciais de televisão.
MediaFileVideoYouTubeVideoId String ATRIBUTO Imutável. O ID do vídeo do YouTube (conforme visto em URLs do YouTube). Adicionando prefixo "https://www.youtube.com/watch?v= para este ID obterá o URL de streaming do YouTube para este vídeo.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
MobileAppCategoryConstant

Uma constante de categoria de aplicativo móvel.

Colunas
Nome Tipo Comportamento Descrição
MobileAppCategoryConstantId Int ATRIBUTO Somente saída. O ID da constante da categoria do aplicativo móvel.
MobileAppCategoryConstantName String ATRIBUTO Somente saída. Nome da categoria do aplicativo móvel.
MobileAppCategoryConstantResourceName String ATRIBUTO Somente saída. O nome do recurso da constante da categoria do aplicativo móvel. Os nomes de recursos constantes da categoria de aplicativo móvel têm o formato: mobileAppCategoryConstants/{mobile_app_category_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
MobileDeviceConstant

Uma constante de dispositivo móvel.

Colunas
Nome Tipo Comportamento Descrição
MobileDeviceConstantId Long ATRIBUTO Somente saída. O ID da constante do dispositivo móvel.
MobileDeviceConstantManufacturerName String ATRIBUTO Somente saída. O fabricante do dispositivo móvel.
MobileDeviceConstantName String ATRIBUTO Somente saída. O nome do dispositivo móvel.
MobileDeviceConstantOperatingSystemName String ATRIBUTO Somente saída. O sistema operacional do dispositivo móvel.
MobileDeviceConstantResourceName String ATRIBUTO Somente saída. O nome do recurso da constante do dispositivo móvel. Os nomes dos recursos constantes do dispositivo móvel têm o formato: mobileDeviceConstants/{criterion_id}
MobileDeviceConstantType String ATRIBUTO Somente saída. O tipo de dispositivo móvel. Os valores permitidos são CELULAR, TABLET, DESCONHECIDO, NÃO ESPECIFICADO.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
OfflineUserDataJob

Um trabalho contendo dados de usuário offline de visitantes da loja ou membros da lista de usuários que serão processados de forma assíncrona. Os dados carregados não são legíveis e os resultados do processamento do trabalho só podem ser lidos usando GoogleAdsService.Search/SearchStream.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
OfflineUserDataJobCustomerMatchUserListMetadataUserList String ATRIBUTO O nome do recurso da lista de remarketing para atualizar os dados. Obrigatório para trabalho do tipo CUSTOMER_MATCH_USER_LIST.
OfflineUserDataJobExternalId Long ATRIBUTO Imutável. ID do trabalho especificado pelo usuário.
OfflineUserDataJobFailureReason String ATRIBUTO Somente saída. Motivo da falha no processamento, se o status for FAILED. Os valores permitidos são INSUFFICIENT_MATCHED_TRANSACTIONS, INSUFFICIENT_TRANSACTIONS, UNKNOWN, UNSPECIFIED.
OfflineUserDataJobId Long ATRIBUTO Somente saída. ID deste trabalho de dados do usuário off-line.
OfflineUserDataJobOperationMetadataMatchRateRange String ATRIBUTO Somente saída. Taxa de correspondência do upload da lista de usuários da Segmentação por lista de clientes. Descreve a taxa de correspondência estimada quando o status da tarefa é "RUNNING" e a taxa de correspondência final quando a taxa de correspondência final está disponível após o status da tarefa ser "SUCCESS/FAILED". Os valores permitidos são MATCH_RANGE_20_TO_30, MATCH_RANGE_31_TO_40, MATCH_RANGE_41_TO_50, MATCH_RANGE_51_TO_60, MATCH_RANGE_61_TO_70, MATCH_RANGE_71_TO_80, MATCH_RANGE_81_TO_90, MATCH_RANGE_91_TO_1 00, MATCH_RANGE_LESS_THAN_20, DESCONHECIDO, NÃO ESPECIFICADO.
OfflineUserDataJobResourceName String ATRIBUTO Imutável. O nome do recurso do trabalho de dados do usuário offline. Os nomes de recursos de trabalho de dados do usuário offline têm o formato: customers/{customer_id}/offlineUserDataJobs/{offline_user_data_job_id}
OfflineUserDataJobStatus String ATRIBUTO Somente saída. Estado do trabalho. Os valores permitidos são FAILED, PENDING, RUNNING, SUCCESS, UNKNOWN, UNSPECIFED.
OfflineUserDataJobStoreSalesMetadataLoyaltyFraction Double ATRIBUTO Esta é a fração de todas as transações que são identificáveis (ou seja, associadas a qualquer forma de informação do cliente). Obrigatório. A fração precisa estar entre 0 e 1 (excluindo 0).
OfflineUserDataJobStoreSalesMetadataThirdPartyMetadataAdvertiserUploadDateTime Date ATRIBUTO Horário em que o anunciante carregou os dados para o parceiro. Obrigatório. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
OfflineUserDataJobStoreSalesMetadataThirdPartyMetadataBridgeMapVersionId String ATRIBUTO Versão dos IDs de parceiros a serem usados para uploads. Obrigatório.
OfflineUserDataJobStoreSalesMetadataThirdPartyMetadataPartnerId Long ATRIBUTO ID do parceiro terceirizado que atualiza o feed da transação.
OfflineUserDataJobStoreSalesMetadataThirdPartyMetadataPartnerMatchFraction Double ATRIBUTO A fração de transações válidas que correspondem a um ID de usuário designado por terceiros no lado do parceiro. Obrigatório. A fração precisa estar entre 0 e 1 (excluindo 0).
OfflineUserDataJobStoreSalesMetadataThirdPartyMetadataPartnerUploadFraction Double ATRIBUTO A fração de transações válidas enviadas pelo parceiro para o Google. Obrigatório. A fração precisa estar entre 0 e 1 (excluindo 0).
OfflineUserDataJobStoreSalesMetadataThirdPartyMetadataValidTransactionFraction Double ATRIBUTO A fração de transações que são válidas. Transações inválidas podem incluir formatos ou valores inválidos. Obrigatório. A fração precisa estar entre 0 e 1 (excluindo 0).
OfflineUserDataJobStoreSalesMetadataTransactionUploadFraction Double ATRIBUTO Essa é a proporção de vendas sendo carregadas em comparação com as vendas gerais que podem ser associadas a um cliente. Obrigatório. A fração precisa estar entre 0 e 1 (excluindo 0). Por exemplo, se você carregar metade das vendas que pode associar a um cliente, isso seria 0,5.
OfflineUserDataJobType String ATRIBUTO Imutável. Tipo do trabalho. Os valores permitidos são CUSTOMER_MATCH_USER_LIST, CUSTOMER_MATCH_WITH_ATTRIBUTES, STORE_SALES_UPLOAD_FIRST_PARTY, STORE_SALES_UPLOAD_THIRD_PARTY, UNKNOWN, UNSPECIFIED.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
OperatingSystemVersionConstant

Uma versão do sistema operacional móvel ou um intervalo de versões, dependendo do operator_type. Lista de plataformas móveis disponíveis em https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms

Colunas
Nome Tipo Comportamento Descrição
OperatingSystemVersionConstantId Long ATRIBUTO Somente saída. O ID da versão do sistema operacional.
OperatingSystemVersionConstantName String ATRIBUTO Somente saída. Nome do sistema operacional.
OperatingSystemVersionConstantOperatorType String ATRIBUTO Somente saída. Determina se esta constante representa uma única versão ou um intervalo de versões. Os valores permitidos são EQUALS_TO, GREATER_THAN_EQUALS_TO, UNKNOWN, UNSPECIFIED.
OperatingSystemVersionConstantOsMajorVersion Int ATRIBUTO Somente saída. O número da versão principal do sistema operacional.
OperatingSystemVersionConstantOsMinorVersion Int ATRIBUTO Somente saída. O número da versão secundária do sistema operacional.
OperatingSystemVersionConstantResourceName String ATRIBUTO Somente saída. O nome do recurso da constante de versão do sistema operacional. Os nomes dos recursos constantes da versão do sistema operacional têm o formato: operatingSystemVersionConstants/{criterion_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
PaidOrganicSearchTermView

Uma visualização de termo de pesquisa orgânica paga que fornece uma visualização das estatísticas de pesquisa em anúncios e listagens orgânicas agregadas por termo de pesquisa no nível do grupo de anúncios.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
PaidOrganicSearchTermViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição do termo de pesquisa. Os nomes dos recursos de exibição do termo de pesquisa têm o formato: customers/{customer_id}/paidOrganicSearchTermViews/{campaign_id}~ {ad_group_id}~{URL-base64 search term}
PaidOrganicSearchTermViewSearchTerm String ATRIBUTO Somente saída. O termo de pesquisa.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
Clicks Long MÉTRICA O número de cliques.
CombinedClicks Long MÉTRICA O número de vezes que seu anúncio ou a listagem de seu site nos resultados não pagos foi clicado. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para detalhes.
CombinedClicksPerQuery Double MÉTRICA O número de vezes que seu anúncio ou a listagem de seu site nos resultados não pagos foi clicado (combined_clicks) dividido por combined_queries. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para detalhes.
CombinedQueries Long MÉTRICA O número de pesquisas que retornaram páginas de seu site nos resultados não pagos ou exibiram um de seus anúncios de texto. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para detalhes.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
OrganicClicks Long MÉTRICA O número de vezes que alguém clicou na listagem do seu site nos resultados não pagos de uma consultar específica. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para detalhes.
OrganicClicksPerQuery Double MÉTRICA O número de vezes que alguém clicou na listagem do seu site nos resultados não pagos (organic_clicks) dividido pelo número total de pesquisas que retornaram páginas do seu site (organic_queries). Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para detalhes.
OrganicImpressions Long MÉTRICA O número de listagens do seu site nos resultados de pesquisa não pagos. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para detalhes.
OrganicImpressionsPerQuery Double MÉTRICA O número de vezes que uma página de seu site foi listada nos resultados de pesquisa não paga (organic_impressions) dividido pelo número de pesquisas que retornaram a listagem de seu site nos resultados não pagos (organic_queries). Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para detalhes.
OrganicQueries Long MÉTRICA O número total de pesquisas que retornaram a listagem do seu site nos resultados não pagos. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para detalhes.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
KeywordAdGroupCriterion String SEGMENTO O nome do recurso AdGroupCriterion.
KeywordInfoMatchType String SEGMENTO O tipo de correspondência da palavra-chave. Os valores permitidos são BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
KeywordInfoText String SEGMENTO O texto da palavra-chave (no máximo 80 caracteres e 10 palavras).
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
SearchEngineResultsPageType String SEGMENTO Tipo da página de resultados do mecanismo de pesquisa. Os valores permitidos são ADS_AND_ORGANIC, ADS_ONLY, ORGANIC_ONLY, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ParentalStatusView

Uma visualização do status parental.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ParentalStatusViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização do status parental. Os nomes dos recursos de exibição do status parental têm o formato: customers/{customer_id}/parentalStatusViews/{ad_group_id}~{criterion_id}
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de exibição.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ProductBiddingCategoryConstant

Uma categoria de licitação de produtos.

Colunas
Nome Tipo Comportamento Descrição
ProductBiddingCategoryConstantCountryCode String ATRIBUTO Somente saída. Código do país com duas letras maiúsculas da categoria de licitação do produto.
ProductBiddingCategoryConstantId Long ATRIBUTO Somente saída. ID da categoria de lance do produto. Este ID é equivalente ao ID google_product_category conforme descrito neste artigo: https://support.google.com/merchants/answer/6324436.
ProductBiddingCategoryConstantLanguageCode String ATRIBUTO Somente saída. Código do idioma da categoria de licitação do produto.
ProductBiddingCategoryConstantLevel String ATRIBUTO Somente saída. Nível da categoria de licitação do produto. Os valores permitidos são LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5, UNKNOWN, UNSPECIFIED.
ProductBiddingCategoryConstantLocalizedName String ATRIBUTO Somente saída. Valor de exibição da categoria de lance do produto localizada de acordo com language_code.
ProductBiddingCategoryConstantProductBiddingCategoryConstantParent String ATRIBUTO Somente saída. Nome do recurso da categoria de lance do produto principal.
ProductBiddingCategoryConstantResourceName String ATRIBUTO Somente saída. O nome do recurso da categoria de lance do produto. Os nomes dos recursos da categoria de lances de produtos têm o formato: productBiddingCategoryConstants/{country_code}~{level}~{id}
ProductBiddingCategoryConstantStatus String ATRIBUTO Somente saída. Status da categoria de lance do produto. Os valores permitidos são ATIVO, OBSOLETO, DESCONHECIDO, NÃO ESPECIFICADO.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ProductGroupView

Uma exibição de grupo de produtos.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ProductGroupViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição do grupo de produtos. Os nomes dos recursos de exibição do grupo de produtos têm o formato: customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
BenchmarkAverageMaxCpc Double MÉTRICA Uma indicação de como outros anunciantes estão fazendo lances em produtos semelhantes.
BenchmarkCtr Double MÉTRICA Uma indicação do desempenho dos anúncios do Shopping de outros anunciantes para produtos semelhantes com base na frequência com que as pessoas que visualizam seus anúncios clicam neles.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
SearchAbsoluteTopImpressionShare Double MÉTRICA A porcentagem de impressões de anúncios do Shopping ou de pesquisa do cliente que são exibidas na posição mais proeminente do Shopping. Ver https://support.google.com/google-ads/answer/7501826 para detalhes. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchClickShare Double MÉTRICA O número de cliques que você recebeu na Rede de Pesquisa dividido pelo número estimado de cliques que você estava qualificado para receber. Observação: a parcela de cliques de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchImpressionShare Double MÉTRICA As impressões que você recebeu na Rede de Pesquisa divididas pelo número estimado de impressões que você estava qualificado para receber. Observação: a parcela de impressões de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Recomendação

Uma recomendação.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
RecommendationAdGroup String ATRIBUTO Somente saída. O grupo de anúncios segmentado por esta recomendação. Isso será definido somente quando a recomendação afetar um único grupo de anúncios. Este campo será definido para os seguintes tipos de recomendação: KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD
RecommendationCallExtensionRecommendation String ATRIBUTO Somente saída. A recomendação de extensão de chamada.
RecommendationCalloutExtensionRecommendation String ATRIBUTO Somente saída. A recomendação de extensão de frase de destaque.
RecommendationCampaign String ATRIBUTO Somente saída. A campanha segmentada por esta recomendação. Isso será definido somente quando a recomendação afetar uma única campanha. Este campo será definido para os seguintes tipos de recomendação: CALL_EXTENSION, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN, USE_BROAD_MATCH_KEYWORD, KEYWORD, KEYWORD_MATCH_TYPE, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPO NSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD
RecommendationCampaignBudget String ATRIBUTO Somente saída. O orçamento visado por esta recomendação. Isso será definido somente quando a recomendação afetar o orçamento de uma única campanha. Este campo será definido para os seguintes tipos de recomendação: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET
RecommendationCampaignBudgetRecommendation String ATRIBUTO Somente saída. A recomendação de orçamento da campanha.
RecommendationDismissed Bool ATRIBUTO Somente saída. Se a recomendação é rejeitada ou não.
RecommendationEnhancedCpcOptInRecommendation String ATRIBUTO Somente saída. A recomendação de aceitação de custo por clique aprimorado.
RecommendationForecastingCampaignBudgetRecommendation String ATRIBUTO Somente saída. A recomendação de orçamento de campanha de previsão.
RecommendationImpact String ATRIBUTO Somente saída. O impacto no desempenho da conta como resultado da aplicação da recomendação.
RecommendationKeywordMatchTypeRecommendation String ATRIBUTO Somente saída. A recomendação do tipo de correspondência de palavra-chave.
RecommendationKeywordRecommendation String ATRIBUTO Somente saída. A recomendação de palavra-chave.
RecommendationMarginalRoiCampaignBudgetRecommendation String ATRIBUTO Somente saída. A recomendação de orçamento de campanha de ROI marginal.
RecommendationMaximizeClicksOptInRecommendation String ATRIBUTO Somente saída. A recomendação MaximizeClicks Opt-In.
RecommendationMaximizeConversionsOptInRecommendation String ATRIBUTO Somente saída. A recomendação MaximizeConversions Opt-In.
RecommendationMoveUnusedBudgetRecommendation String ATRIBUTO Somente saída. A recomendação de orçamento não utilizado para mover.
RecommendationOptimizeAdRotationRecommendation String ATRIBUTO Somente saída. A recomendação Otimizar a rotação de anúncios.
RecommendationResourceName String ATRIBUTO Imutável. O nome do recurso da recomendação. clientes/{customer_id}/recomendações/{recomendação_id}
RecommendationResponsiveSearchAdAssetRecommendation String ATRIBUTO Somente saída. A recomendação de adicionar recurso de anúncio de pesquisa responsivo.
RecommendationResponsiveSearchAdRecommendation String ATRIBUTO Somente saída. A recomendação de adicionar anúncio de pesquisa responsivo.
RecommendationSearchPartnersOptInRecommendation String ATRIBUTO Somente saída. A recomendação de opt-in dos parceiros de pesquisa.
RecommendationSitelinkExtensionRecommendation String ATRIBUTO Somente saída. A recomendação de extensão de Sitelink.
RecommendationTargetCpaOptInRecommendation String ATRIBUTO Somente saída. A recomendação de inclusão do TargetCPA.
RecommendationTargetRoasOptInRecommendation String ATRIBUTO Somente saída. A recomendação de ativação do ROAS desejado.
RecommendationTextAdRecommendation String ATRIBUTO Somente saída. Adicionar recomendação de anúncio de texto expandido.
RecommendationType String ATRIBUTO Somente saída. O tipo de recomendação. Os valores permitidos são CALLOUT_EXTENSION, CALL_EXTENSION, CAMPAIGN_BUDGET, ENHANCED_CPC_OPT_IN, FORECASTING_CAMPAIGN_BUDGET, KEYWORD, KEYWORD_MATCH_TYPE, MARGINAL_ROI_CAMPAIGN_BUDGET, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MOVE_UNUSED_BUDGET, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UNKNOWN, UNSPECIFIED, USE_BROAD_MATCH_KEYWORD.
RecommendationUseBroadMatchKeywordRecommendation String ATRIBUTO Somente saída. Use a recomendação de palavras-chave de correspondência ampla.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Ação de Remarketing

Uma ação de remarketing. Um snippet de código JavaScript que coletará o ID do produto e o tipo de página que as pessoas visitaram (página do produto, página do carrinho de compras, página de compra, visita geral ao site) no site de um anunciante.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
RemarketingActionId Long ATRIBUTO Somente saída. ID da ação de remarketing.
RemarketingActionName String ATRIBUTO O nome da ação de remarketing. Este campo é obrigatório e não deve ficar vazio ao criar novas ações de remarketing.
RemarketingActionResourceName String ATRIBUTO Imutável. O nome do recurso da ação de remarketing. Os nomes dos recursos de ação de remarketing têm o formato: customers/{customer_id}/remarketingActions/{remarketing_action_id}
RemarketingActionTagSnippets String ATRIBUTO Somente saída. Os snippets usados para rastrear ações de remarketing.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Recursos

Lista de recursos que podem ser utilizados para gerar novos Relatórios ou gerar novamente os antigos.

Colunas
Nome Tipo Comportamento Descrição
ReportName String O nome do relatório gerado a partir deste recurso.
ResourceName String O nome do recurso.
AttributeResources String Uma lista separada por vírgulas dos recursos de atributo.
SegmentingResources String Uma lista separada por vírgulas dos recursos de segmentação.
Description String A descrição do relatório atual.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
SearchTermView

Uma visualização do termo de pesquisa com métricas agregadas por termo de pesquisa no nível do grupo de anúncios.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
SearchTermViewAdGroup String ATRIBUTO Somente saída. O grupo de anúncios no qual o termo de pesquisa foi exibido.
SearchTermViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição do termo de pesquisa. Os nomes dos recursos de exibição do termo de pesquisa têm o formato: clientes/{customer_id}/searchTermViews/{campaign_id}~{ad_group_id}~{URL-base64_search_term}
SearchTermViewSearchTerm String ATRIBUTO Somente saída. O termo de pesquisa.
SearchTermViewStatus String ATRIBUTO Somente saída. Indica se o termo de pesquisa é atualmente uma de suas palavras-chave segmentadas ou excluídas. Os valores permitidos são ADDED, ADDED_EXCLUDED, EXCLUDED, NONE, UNKNOWN, UNSPECIFIED.
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor das conversões de interações dividido pelo número de interações com anúncios. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValuePerCost Double MÉTRICA O valor das conversões dividido pelo custo das interações com o anúncio. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
TopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas em qualquer lugar acima dos resultados de pesquisa orgânica.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
KeywordAdGroupCriterion String SEGMENTO O nome do recurso AdGroupCriterion.
KeywordInfoMatchType String SEGMENTO O tipo de correspondência da palavra-chave. Os valores permitidos são BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
KeywordInfoText String SEGMENTO O texto da palavra-chave (no máximo 80 caracteres e 10 palavras).
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
SearchTermMatchType String SEGMENTO Tipo de correspondência da palavra-chave que acionou o anúncio, incluindo variantes. Os valores permitidos são BROAD, EXACT, NEAR_EXACT, NEAR_PHRASE, PHRASE, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
SharedCriterion

Um critério pertencente a um conjunto compartilhado.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
SharedCriterionCriterionId Long ATRIBUTO Somente saída. O ID do critério. Este campo é ignorado para mutações.
SharedCriterionKeywordMatchType String ATRIBUTO O tipo de correspondência da palavra-chave. Os valores permitidos são BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
SharedCriterionKeywordText String ATRIBUTO O texto da palavra-chave (no máximo 80 caracteres e 10 palavras).
SharedCriterionMobileAppCategoryMobileAppCategoryConstant String ATRIBUTO O nome do recurso constante da categoria do aplicativo móvel.
SharedCriterionMobileApplicationAppId String ATRIBUTO Uma string que identifica exclusivamente um aplicativo para celular para a Google Ads API. O formato dessa string é "{platform}-{platform_native_id}", onde platform é "1" para aplicativos iOS e "2" para aplicativos Android, e platform_native_id é o identificador de aplicativo móvel nativo da plataforma correspondente. Para iOS, esse identificador nativo é a sequência de 9 dígitos que aparece no final de um URL da App Store (por exemplo, "476943146" para "Flood-It! 2" cujo link da App Store é " http://itunes.apple.com/us/app/flood-it!-2/id476943146 "). Para Android, esse identificador nativo é o nome do pacote do aplicativo (por exemplo, "com.labpixies.colordrips" para "Color Drips" dado o link do Google Play " <a
href="https://play.google.com/store/apps/details?id=com.labpixies.colordrips">https://play.google.com/store/apps/details?id=com .labpixies.colordrips "). Um ID de aplicativo bem formado para a Google Ads API seria "1-476943146" para iOS e "2-com.labpixies.colordrips" para Android. Este campo é obrigatório e deve ser configurado nas operações CREATE.
SharedCriterionMobileApplicationName String ATRIBUTO Nome deste aplicativo móvel.
SharedCriterionPlacementUrl String ATRIBUTO URL da veiculação. Por exemplo, "http://www.domain.com.
SharedCriterionResourceName String ATRIBUTO Imutável. O nome do recurso do critério compartilhado. Os nomes de recursos do conjunto compartilhado têm o formato: customers/{customer_id}/sharedCriteria/{shared_set_id}~{criterion_id}
SharedCriterionSharedSet String ATRIBUTO Imutável. O conjunto compartilhado ao qual o critério compartilhado pertence.
SharedCriterionType String ATRIBUTO Somente saída. O tipo do critério. Os valores permitidos são AD_SCHEDULE, AGE_RANGE, APP_PAYMENT_MODEL, AUDIENCE, CARRIER, COMBINED_AUDIENCE, CONTENT_LABEL, CUSTOM_AFFINITY, CUSTOM_AUDIENCE, CUSTOM_INTENT, DEVICE, GENDER, INCOME_RANGE, IP_BLOCK, KEYWORD, KEYWORD_THEME, LANGUAGE, LISTING_GROUP, LIST ING_SCOPE, LOCATION, LOCATION_GROUP, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, MOBILE_DEVICE, OPERATING_SYSTEM_VERSION, PARENTAL_STATUS, PLACEMENT, PROXIMITY, TOPIC, UNKNOWN, UNSPECIFIED, USER_INTEREST, USER_LIST, WEBPAGE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO.
SharedCriterionYouTubeChannelChannelId String ATRIBUTO O ID do canal do uploader do YouTube ou o código do canal de um canal do YouTube.
SharedCriterionYouTubeVideoVideoId String ATRIBUTO ID do vídeo do YouTube conforme aparece na página de exibição do YouTube.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
SharedSet

SharedSets são usados para compartilhar exclusões de critérios em várias campanhas.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
SharedSetId Long ATRIBUTO Somente saída. O ID deste conjunto compartilhado. Somente leitura.
SharedSetMemberCount Long ATRIBUTO Somente saída. O número de critérios compartilhados dentro deste conjunto compartilhado. Somente leitura.
SharedSetName String ATRIBUTO O nome deste conjunto compartilhado. Obrigatório. Os Conjuntos Compartilhados devem ter nomes exclusivos entre os conjuntos compartilhados ativos do mesmo tipo. O comprimento desta string deve estar entre 1 e 255 bytes UTF-8, inclusive.
SharedSetReferenceCount Long ATRIBUTO Somente saída. O número de campanhas associadas a este conjunto compartilhado. Somente leitura.
SharedSetResourceName String ATRIBUTO Imutável. O nome do recurso do conjunto compartilhado. Os nomes de recursos do conjunto compartilhado têm o formato: customers/{customer_id}/sharedSets/{shared_set_id}
SharedSetStatus String ATRIBUTO Somente saída. O status deste conjunto compartilhado. Somente leitura. Os valores permitidos são ATIVADO, REMOVIDO, DESCONHECIDO, NÃO ESPECIFICADO.
SharedSetType String ATRIBUTO Imutável. O tipo deste conjunto compartilhado: cada conjunto compartilhado contém apenas um único tipo de recurso. Obrigatório. Imutável. Os valores permitidos são NEGATIVE_KEYWORDS, NEGATIVE_PLACEMENTS, UNKNOWN, UNSPECIFIED.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
ShoppingPerformanceView

Visão de desempenho de compras. Fornece estatísticas de campanha do Shopping agregadas em vários níveis de dimensão do produto. Os valores de dimensão do produto do Merchant Center, como marca, categoria, atributos personalizados, condição e tipo de produto, refletirão o estado de cada dimensão na data e hora em que o evento correspondente foi registrado.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ShoppingPerformanceViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição de desempenho do Shopping. Os nomes dos recursos de exibição de desempenho de compras têm o formato: customers/{customer_id}/shoppingPerformanceView
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
SearchAbsoluteTopImpressionShare Double MÉTRICA A porcentagem de impressões de anúncios do Shopping ou de pesquisa do cliente que são exibidas na posição mais proeminente do Shopping. Ver https://support.google.com/google-ads/answer/7501826 para detalhes. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchClickShare Double MÉTRICA O número de cliques que você recebeu na Rede de Pesquisa dividido pelo número estimado de cliques que você estava qualificado para receber. Observação: a parcela de cliques de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
SearchImpressionShare Double MÉTRICA As impressões que você recebeu na Rede de Pesquisa divididas pelo número estimado de impressões que você estava qualificado para receber. Observação: a parcela de impressões de pesquisa é relatada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é relatado como 0,0999.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
ProductAggregatorId Long SEGMENTO ID do agregador do produto.
ProductBiddingCategoryLevel1 String SEGMENTO Categoria de licitação (nível 1) do produto.
ProductBiddingCategoryLevel2 String SEGMENTO Categoria de licitação (nível 2) do produto.
ProductBiddingCategoryLevel3 String SEGMENTO Categoria de licitação (nível 3) do produto.
ProductBiddingCategoryLevel4 String SEGMENTO Categoria de licitação (nível 4) do produto.
ProductBiddingCategoryLevel5 String SEGMENTO Categoria de licitação (nível 5) do produto.
ProductBrand String SEGMENTO Marca do produto.
ProductChannel String SEGMENTO Canal do produto. Os valores permitidos são LOCAL, ONLINE, DESCONHECIDO, NÃO ESPECIFICADO.
ProductChannelExclusivity String SEGMENTO Exclusividade do canal do produto. Os valores permitidos são MULTI_CHANNEL, SINGLE_CHANNEL, UNKNOWN, UNSPECIFIED.
ProductCondition String SEGMENTO Condição do produto. Os valores permitidos são NOVO, RECONHECIDO, DESCONHECIDO, NÃO ESPECIFICADO, USADO.
ProductCountry String SEGMENTO Nome do recurso da constante de segmentação geográfica para o país de venda do produto.
ProductCustomAttribute0 String SEGMENTO Atributo personalizado 0 do produto.
ProductCustomAttribute1 String SEGMENTO Atributo personalizado 1 do produto.
ProductCustomAttribute2 String SEGMENTO Atributo personalizado 2 do produto.
ProductCustomAttribute3 String SEGMENTO Atributo personalizado 3 do produto.
ProductCustomAttribute4 String SEGMENTO Atributo personalizado 4 do produto.
ProductItemId String SEGMENTO ID do item do produto.
ProductLanguage String SEGMENTO Nome do recurso da constante de idioma para o idioma do produto.
ProductMerchantId Long SEGMENTO ID do comerciante do produto.
ProductStoreId String SEGMENTO ID da loja do produto.
ProductTitle String SEGMENTO Título do produto.
ProductTypeL1 String SEGMENTO Tipo (nível 1) do produto.
ProductTypeL2 String SEGMENTO Tipo (nível 2) do produto.
ProductTypeL3 String SEGMENTO Tipo (nível 3) do produto.
ProductTypeL4 String SEGMENTO Tipo (nível 4) do produto.
ProductTypeL5 String SEGMENTO Tipo (nível 5) do produto.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
SmartCampaignSearchTermView

Uma visualização do termo de pesquisa da campanha inteligente.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
SmartCampaignSearchTermViewCampaign String ATRIBUTO Somente saída. A campanha inteligente em que o termo de pesquisa foi exibido.
SmartCampaignSearchTermViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição do termo de pesquisa da campanha inteligente. Os nomes dos recursos de exibição do termo de pesquisa da campanha inteligente têm o formato: customers/{customer_id}/smartCampaignSearchTermViews/{campaign_id}~{URL-base64_search_term}
SmartCampaignSearchTermViewSearchTerm String ATRIBUTO Somente saída. O termo de pesquisa.
Clicks Long MÉTRICA O número de cliques.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
SmartCampaignSetting

Configurações para configuração de campanhas inteligentes.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
SmartCampaignSettingAdvertisingLanguageCode String ATRIBUTO O código de idioma ISO-639-1 para anunciar.
SmartCampaignSettingBusinessLocationId Long ATRIBUTO O código do local do Perfil da empresa. O ID do local pode ser obtido pela API do perfil de negócios com seu formulário: accounts/{accountId}/locations/{locationId}. O último componente {locationId} da API Business Profile representa o business_location_id. Consulte a API do perfil comercial
SmartCampaignSettingBusinessName String ATRIBUTO O nome do negócio.
SmartCampaignSettingCampaign String ATRIBUTO Somente saída. A campanha à qual essas configurações se aplicam.
SmartCampaignSettingFinalUrl String ATRIBUTO URL da página de destino fornecida pelo usuário para esta campanha.
SmartCampaignSettingPhoneNumberCountryCode String ATRIBUTO Código do país com duas letras maiúsculas, conforme definido pela ISO-3166.
SmartCampaignSettingPhoneNumberPhoneNumber String ATRIBUTO Número de telefone da campanha inteligente.
SmartCampaignSettingResourceName String ATRIBUTO Imutável. O nome do recurso da configuração da campanha inteligente. Os nomes dos recursos de configuração de campanha inteligente têm o formato: customers/{customer_id}/smartCampaignSettings/{campaign_id}
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.

Uma conexão de compartilhamento de dados, permitindo a importação de análises de aplicativos de terceiros para um cliente do Google Ads.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
ThirdPartyAppAnalyticsLinkResourceName String ATRIBUTO Imutável. O nome do recurso do link de análise do aplicativo de terceiros. Os nomes de recursos de links de análise de aplicativos de terceiros têm o seguinte formato: customers/{customer_id}/thirdPartyAppAnalyticsLinks/{account_link_id}
ThirdPartyAppAnalyticsLinkShareableLinkId String ATRIBUTO Somente saída. O ID do link compartilhável que deve ser fornecido ao terceiro ao configurar a análise do aplicativo. Isso pode ser regenerado usando o método regenerate no ThirdPartyAppAnalyticsLinkService.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
TópicoConstante

Use tópicos para segmentar ou excluir canais na Rede de Display do Google com base na categoria em que o canal se enquadra (por exemplo, "Animais de estimação & Animais/Animais de estimação/Cães").

Colunas
Nome Tipo Comportamento Descrição
TopicConstantId Long ATRIBUTO Somente saída. O ID do tópico.
TopicConstantPath String ATRIBUTO Somente saída. A categoria a segmentar ou excluir. Cada elemento subsequente na matriz descreve uma subcategoria mais específica. Por exemplo, {"Pets & Animals", "Pets", "Dogs"} representa a categoria "Pets & Animals/Pets/Cães". Lista de categorias de tópicos disponíveis em https://developers.google.com/adwords/api/docs/appendix/verticals
TopicConstantResourceName String ATRIBUTO Somente saída. O nome do recurso da constante do tópico. nomes de recursos constantes de tópico têm o formato: topicConstants/{topic_id}
TopicConstantTopicConstantParent String ATRIBUTO Somente saída. Nome do recurso do pai da constante do tópico.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
TopicView

Uma visão de tópico.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
TopicViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização do tópico. Os nomes dos recursos de exibição de tópicos têm o formato: clientes/{customer_id}/topicViews/{ad_group_id}~{criterion_id}
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor de todas as conversões de interações dividido pelo número total de interações.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AllConversionsValuePerCost Double MÉTRICA O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
GmailForwards Long MÉTRICA O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
GmailSaves Long MÉTRICA O número de vezes que alguém salvou seu anúncio do Gmail na caixa de entrada como uma mensagem.
GmailSecondaryClicks Long MÉTRICA O número de cliques na página de aterrissagem no estado expandido dos anúncios do Gmail.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Interesse do Usuário

Um interesse do usuário: um determinado vertical baseado em interesse a ser segmentado.

Colunas
Nome Tipo Comportamento Descrição
UserInterestAvailabilities String ATRIBUTO Somente saída. Informações de disponibilidade de interesse do usuário.
UserInterestLaunchedToAll Bool ATRIBUTO Somente saída. Verdadeiro se o interesse do usuário for lançado para todos os canais e localidades.
UserInterestName String ATRIBUTO Somente saída. O nome do interesse do usuário.
UserInterestResourceName String ATRIBUTO Somente saída. O nome do recurso do interesse do usuário. Os nomes de recursos de interesse do usuário têm o formato: customers/{customer_id}/userInterests/{user_interest_id}
UserInterestTaxonomyType String ATRIBUTO Somente saída. Tipo de taxonomia do interesse do usuário. Os valores permitidos são AFFINITY, IN_MARKET, MOBILE_APP_INSTALL_USER, NEW_SMART_PHONE_USER, UNKNOWN, UNSPECIFIED, VERTICAL_GEO.
UserInterestUserInterestId Long ATRIBUTO Somente saída. O ID do interesse do usuário.
UserInterestUserInterestParent String ATRIBUTO Somente saída. O pai do interesse do usuário.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Lista de Usuários

Uma lista de usuários. Esta é uma lista de usuários que um cliente pode segmentar.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
UserListAccessReason String ATRIBUTO Somente saída. Indica o motivo pelo qual esta conta recebeu acesso à lista. O motivo pode ser COMPARTILHADO, PRÓPRIO, LICENCIADO ou ASSINADO. Este campo é só de leitura. Os valores permitidos são AFFILIATED, LICENSED, OWNED, SHARED, SUBSCRIBED, UNKNOWN, UNSPECIFIED.
UserListAccountUserListStatus String ATRIBUTO Indica se este compartilhamento ainda está habilitado. Quando uma UserList é compartilhada com o usuário, este campo é definido como ENABLED. Posteriormente, o proprietário da userList pode decidir revogar o compartilhamento e torná-lo DESATIVADO. O valor padrão deste campo é definido como ENABLED. Os valores permitidos são DISABLED, ENABLED, UNKNOWN, UNSPECIFED.
UserListBasicUserListActions String ATRIBUTO Ações associadas a esta lista de usuários.
UserListClosingReason String ATRIBUTO Indicando o motivo pelo qual o status de membro da lista de usuários está fechado. Ele só é preenchido em listas que foram fechadas automaticamente devido à inatividade e será limpo assim que o status de membro da lista for aberto. Os valores permitidos são UNKNOWN, UNSPECIFIED, UNUSED.
UserListCrmBasedUserListAppId String ATRIBUTO Uma cadeia de caracteres que identifica exclusivamente um aplicativo móvel do qual os dados foram coletados. Para iOS, a string de ID é a string de 9 dígitos que aparece no final de um URL da App Store (por exemplo, "476943146" para "Flood-It! 2" cujo link da App Store é http://itunes.apple.com/us/app/flood-it!-2/id476943146). Para Android, a string de ID é o nome do pacote do aplicativo (por exemplo, "com.labpixies.colordrips" para "Color Drips" dado o link do Google Play https://play.google.com/store/apps/details?id=com.labpixies.colordrips). Obrigatório ao criar CrmBasedUserList para fazer upload de IDs de publicidade móvel.
UserListCrmBasedUserListDataSourceType String ATRIBUTO Fonte de dados da lista. O valor padrão é FIRST_PARTY. Somente clientes na lista de permissões podem criar listas de CRM de externo. Os valores permitidos são FIRST_PARTY, THIRD_PARTY_CREDIT_BUREAU, THIRD_PARTY_VOTER_FILE, UNKNOWN, UNSPECIFIED.
UserListCrmBasedUserListUploadKeyType String ATRIBUTO Tipo de chave correspondente da lista. Tipos de dados mistos não são permitidos na mesma lista. Este campo é obrigatório para uma operação ADD. Os valores permitidos são CONTACT_INFO, CRM_ID, MOBILE_ADVERTISING_ID, UNKNOWN, UNSPECIFIED.
UserListDescription String ATRIBUTO Descrição desta lista de usuários.
UserListEligibleForDisplay Bool ATRIBUTO Somente saída. Indica que esta lista de usuários está qualificada para a Rede de Display do Google. Este campo é só de leitura.
UserListEligibleForSearch Bool ATRIBUTO Indica se esta lista de usuários está qualificada para a Rede de Pesquisa do Google.
UserListId Long ATRIBUTO Somente saída. ID da lista de usuários.
UserListIntegrationCode String ATRIBUTO Um ID do sistema externo. Ele é usado por vendedores de listas de usuários para correlacionar IDs em seus sistemas.
UserListLogicalUserListRules String ATRIBUTO Regras de lista lógica que definem essa lista de usuários. As regras são definidas como um operador lógico (ALL/ANY/NONE) e uma lista de listas de usuários. Todas as regras passam por AND quando são avaliadas. Necessário para criar uma lista lógica de usuários.
UserListMatchRatePercentage Int ATRIBUTO Somente saída. Indica a taxa de correspondência para listas de Segmentação por lista de clientes. O intervalo deste campo é [0-100]. Isso será nulo para outros tipos de lista ou quando não for possível calcular a taxa de correspondência. Este campo é só de leitura.
UserListMembershipLifeSpan Long ATRIBUTO Número de dias que o cookie de um usuário permanece em sua lista desde sua adição mais recente à lista. Este campo deve estar entre 0 e 540 inclusive. No entanto, para listas de usuários baseadas em CRM, esse campo pode ser definido como 10.000, o que significa que não há expiração. Ele será ignorado para a lista_de_usuário_lógico.
UserListMembershipStatus String ATRIBUTO Status de associação desta lista de usuários. Indica se uma lista de usuários está aberta ou ativa. Somente listas de usuários abertas podem acumular mais usuários e podem ser direcionadas. Os valores permitidos são FECHADO, ABERTO, DESCONHECIDO, NÃO ESPECIFICADO.
UserListName String ATRIBUTO Nome desta lista de usuários. Dependendo de seu access_reason, o nome da lista de usuários pode não ser exclusivo (por exemplo, se access_reason=SHARED)
UserListReadOnly Bool ATRIBUTO Somente saída. Um sinalizador que indica se um usuário pode editar uma lista. Depende da propriedade da lista e do tipo de lista. Por exemplo, as listas externas de usuários de remarketing não são editáveis. Este campo é só de leitura.
UserListResourceName String ATRIBUTO Imutável. O nome do recurso da lista de usuários. Os nomes dos recursos da lista de usuários têm o formato: clientes/{customer_id}/userLists/{user_list_id}
UserListRuleBasedUserListCombinedRuleUserListLeftOperandRuleItemGroups String ATRIBUTO Lista de grupos de itens de regra que definem esta regra. Os grupos de itens de regras são agrupados com base em rule_type.
UserListRuleBasedUserListCombinedRuleUserListLeftOperandRuleType String ATRIBUTO O tipo de regra é usado para determinar como agrupar itens de regra. O padrão é OR de ANDs (forma normal disjuntiva). Ou seja, os itens de regra serão unidos por AND dentro dos grupos de itens de regra e os próprios grupos serão unidos por OU. Atualmente, AND de ORs (forma normal conjuntiva) só tem suporte para ExpressionRuleUserList. Os valores permitidos são AND_OF_ORS, OR_OF_ANDS, UNKNOWN, UNSPECIFIED.
UserListRuleBasedUserListCombinedRuleUserListRightOperandRuleItemGroups String ATRIBUTO Lista de grupos de itens de regra que definem esta regra. Os grupos de itens de regras são agrupados com base em rule_type.
UserListRuleBasedUserListCombinedRuleUserListRightOperandRuleType String ATRIBUTO O tipo de regra é usado para determinar como agrupar itens de regra. O padrão é OR de ANDs (forma normal disjuntiva). Ou seja, os itens de regra serão unidos por AND dentro dos grupos de itens de regra e os próprios grupos serão unidos por OU. Atualmente, AND de ORs (forma normal conjuntiva) só tem suporte para ExpressionRuleUserList. Os valores permitidos são AND_OF_ORS, OR_OF_ANDS, UNKNOWN, UNSPECIFIED.
UserListRuleBasedUserListCombinedRuleUserListRuleOperator String ATRIBUTO Operador para conectar os dois operandos. Necessário para criar uma lista de usuários de regras combinadas. Os valores permitidos são AND, AND_NOT, UNKNOWN, UNSPECIFIED.
UserListRuleBasedUserListDateSpecificRuleUserListEndDate Date ATRIBUTO Última data da visita dos usuários. Se definido como 2037-12-30, a lista incluirá todos os usuários após start_date. O formato da data deve ser AAAA-MM-DD. Necessário para criar uma lista de usuários de regras específicas de dados.
UserListRuleBasedUserListDateSpecificRuleUserListRuleRuleItemGroups String ATRIBUTO Lista de grupos de itens de regra que definem esta regra. Os grupos de itens de regras são agrupados com base em rule_type.
UserListRuleBasedUserListDateSpecificRuleUserListRuleRuleType String ATRIBUTO O tipo de regra é usado para determinar como agrupar itens de regra. O padrão é OR de ANDs (forma normal disjuntiva). Ou seja, os itens de regra serão unidos por AND dentro dos grupos de itens de regra e os próprios grupos serão unidos por OU. Atualmente, AND de ORs (forma normal conjuntiva) só tem suporte para ExpressionRuleUserList. Os valores permitidos são AND_OF_ORS, OR_OF_ANDS, UNKNOWN, UNSPECIFIED.
UserListRuleBasedUserListDateSpecificRuleUserListStartDate Date ATRIBUTO Data de início da visita dos usuários. Se definido como 2000-01-01, a lista incluirá todos os usuários antes de end_date. O formato da data deve ser AAAA-MM-DD. Necessário para criar uma lista de usuários de regras específicas de dados.
UserListRuleBasedUserListExpressionRuleUserListRuleRuleItemGroups String ATRIBUTO Lista de grupos de itens de regra que definem esta regra. Os grupos de itens de regras são agrupados com base em rule_type.
UserListRuleBasedUserListExpressionRuleUserListRuleRuleType String ATRIBUTO O tipo de regra é usado para determinar como agrupar itens de regra. O padrão é OR de ANDs (forma normal disjuntiva). Ou seja, os itens de regra serão unidos por AND dentro dos grupos de itens de regra e os próprios grupos serão unidos por OU. Atualmente, AND de ORs (forma normal conjuntiva) só tem suporte para ExpressionRuleUserList. Os valores permitidos são AND_OF_ORS, OR_OF_ANDS, UNKNOWN, UNSPECIFIED.
UserListRuleBasedUserListPrepopulationStatus String ATRIBUTO O status de pré-preenchimento. O campo é padrão para NENHUM se não for definido, o que significa que os usuários anteriores não serão considerados. Se definido como SOLICITADO, os visitantes anteriores do site ou usuários do aplicativo que corresponderem à definição da lista serão incluídos na lista (funciona apenas na Rede de Display). Isso só adicionará usuários anteriores dos últimos 30 dias, dependendo da duração da associação da lista e da data em que a tag de remarketing foi adicionada. O status será atualizado para FINISHED assim que a solicitação for processada ou FAILED se a solicitação falhar. Os valores permitidos são FAILED, FINISHED, REQUESTED, UNKNOWN, UNSPECIFED.
UserListSimilarUserListSeedUserList String ATRIBUTO Semente UserList da qual esta lista é derivada.
UserListSizeForDisplay Long ATRIBUTO Somente saída. Número estimado de usuários nesta lista de usuários, na Rede de Display do Google. Esse valor será nulo se o número de usuários ainda não tiver sido determinado. Este campo é só de leitura.
UserListSizeForSearch Long ATRIBUTO Somente saída. Número estimado de usuários nesta lista de usuários no domínio google.com. Esses são os usuários disponíveis para segmentação em campanhas de pesquisa. Esse valor será nulo se o número de usuários ainda não tiver sido determinado. Este campo é só de leitura.
UserListSizeRangeForDisplay String ATRIBUTO Somente saída. Faixa de tamanho em termos de número de usuários da UserList, na Rede de Display do Google. Este campo é só de leitura. Os valores permitidos são FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND, FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION, FIVE_MILLION_TO_TEN_MILLION, LESS_THAN_FIVE_HUNDRED, LESS_THAN_ONE_THOUSAND, ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND, UM_MILLION_TO_TWO_MILLION, ONE_THOUSAND_TO_TEN_THOUSAND, OVER_FIFTY_MILLION, TEN_MILLION_TO_TWENTY_MILLION, TEN_THOUSAND_TO_FIFTY_THOUSAND, TRINTA_MILLION_TO_FIFTY_MILLION, THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THO USAND, TRÊS_MILLION_TO_FIVE_MILLION, TWENTY_MILLION_TO_THIRTY_MILLION, DOIS_MILLION_TO_THREE_MILLION, DESCONHECIDO, NÃO ESPECIFICADO.
UserListSizeRangeForSearch String ATRIBUTO Somente saída. Intervalo de tamanho em termos de número de usuários da UserList, para anúncios de pesquisa. Este campo é só de leitura. Os valores permitidos são FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND, FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION, FIVE_MILLION_TO_TEN_MILLION, LESS_THAN_FIVE_HUNDRED, LESS_THAN_ONE_THOUSAND, ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND, UM_MILLION_TO_TWO_MILLION, ONE_THOUSAND_TO_TEN_THOUSAND, OVER_FIFTY_MILLION, TEN_MILLION_TO_TWENTY_MILLION, TEN_THOUSAND_TO_FIFTY_THOUSAND, TRINTA_MILLION_TO_FIFTY_MILLION, THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THO USAND, TRÊS_MILLION_TO_FIVE_MILLION, TWENTY_MILLION_TO_THIRTY_MILLION, DOIS_MILLION_TO_THREE_MILLION, DESCONHECIDO, NÃO ESPECIFICADO.
UserListType String ATRIBUTO Somente saída. Tipo desta lista. Este campo é só de leitura. Os valores permitidos são CRM_BASED, EXTERNAL_REMARKETING, LOGICAL, REMARKETING, RULE_BASED, SIMILAR, UNKNOWN, UNSPECIFIED.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
UserLocationView

Uma exibição de localização do usuário. A visualização da localização do usuário inclui todas as métricas agregadas no nível do país, uma linha por país. Ele relata métricas no local físico real do usuário por local segmentado ou não segmentado. Se outros campos de segmento forem usados, você poderá obter mais de uma linha por país.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
UserLocationViewCountryCriterionId Long ATRIBUTO Somente saída. ID do critério para o país.
UserLocationViewResourceName String ATRIBUTO Somente saída. O nome do recurso da exibição de localização do usuário. Os nomes dos recursos de exibição UserLocation têm o formato: customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}
UserLocationViewTargetingLocation Bool ATRIBUTO Somente saída. Indica se o local foi segmentado ou não.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
GeoTargetAirport String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um aeroporto.
GeoTargetCanton String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um cantão.
GeoTargetCity String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa uma cidade.
GeoTargetCounty String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um município.
GeoTargetDistrict String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um distrito.
GeoTargetMetro String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa uma área metropolitana.
GeoTargetMostSpecificLocation String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa o local mais específico.
GeoTargetPostalCode String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um código postal.
GeoTargetProvince String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa uma província.
GeoTargetRegion String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa uma região.
GeoTargetState String SEGMENTO Nome do recurso da constante de segmentação geográfica que representa um estado.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
Vídeo

Um vídeo.

Informações Específicas da Tabela

Selecione

O Google Ads não permite que todas as colunas sejam selecionadas em uma única consultar, pois alguns dados entrarão em conflito se forem selecionados juntos. Portanto, ao emitir uma consultar que selecione todas as colunas, apenas as métricas, segmentos e atributos padrão serão retornados. Em geral, esses padrões são os mesmos campos expostos por meio do console de anúncios.

Para usar os campos não padrão, selecione-os explicitamente em sua consultar.

Os filtros também podem ser usados na cláusula WHERE. Os operadores suportados são os operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN e NOT IN. Todos os filtros devem ser unidos pela palavra-chave AND, pois OR não é compatível com a API de anúncios.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
VideoChannelId String ATRIBUTO Somente saída. O ID do canal do proprietário do vídeo.
VideoDurationMillis Long ATRIBUTO Somente saída. A duração do vídeo em milissegundos.
VideoId String ATRIBUTO Somente saída. O ID do vídeo.
VideoResourceName String ATRIBUTO Somente saída. O nome do recurso do vídeo. Os nomes dos recursos de vídeo têm o formato: customers/{customer_id}/videos/{video_id}
VideoTitle String ATRIBUTO Somente saída. O título do vídeo.
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsValuePerInteraction Double MÉTRICA O valor das conversões de interações dividido pelo número de interações com anúncios. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValuePerCost Double MÉTRICA O valor das conversões dividido pelo custo das interações com o anúncio. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
VideoQuartileP100Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu todo o seu vídeo.
VideoQuartileP25Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 25% do seu vídeo.
VideoQuartileP50Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 50% do seu vídeo.
VideoQuartileP75Rate Double MÉTRICA Porcentagem de impressões em que o espectador assistiu a 75% do seu vídeo.
VideoViewRate Double MÉTRICA O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões, incluindo impressões de miniaturas para anúncios TrueView em display.
VideoViews Long MÉTRICA O número de vezes que seus anúncios em vídeo foram visualizados.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.
WebpageView

Uma exibição de página da web.

Colunas
Nome Tipo Comportamento Descrição
CustomerId Long ATRIBUTO Somente saída. A identificação do cliente.
WebpageViewResourceName String ATRIBUTO Somente saída. O nome do recurso da visualização da página da web. Os nomes dos recursos de exibição de página da web têm o formato: customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}
AbsoluteTopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas como o primeiro anúncio acima dos resultados de pesquisa orgânica.
ActiveViewCpm Double MÉTRICA Custo médio de impressões visíveis (active_view_impressions).
ActiveViewCtr Double MÉTRICA Cliques mensuráveis do Active View divididos por impressões visíveis do Active View. Essa métrica é informada apenas para a rede de display.
ActiveViewImpressions Long MÉTRICA Uma medição da frequência com que seu anúncio se tornou visível em um site da Rede de Display.
ActiveViewMeasurability Double MÉTRICA A proporção de impressões que podem ser medidas pelo Active View em relação ao número de impressões veiculadas.
ActiveViewMeasurableCostMicros Long MÉTRICA O custo das impressões recebidas que foram mensuráveis pelo Active View.
ActiveViewMeasurableImpressions Long MÉTRICA O número de vezes que seus anúncios são exibidos em veiculações em posições onde podem ser vistos.
ActiveViewViewability Double MÉTRICA A porcentagem de tempo em que seu anúncio apareceu em um site habilitado para Active View (impressões mensuráveis) e ficou visível (impressões visíveis).
AllConversions Double MÉTRICA O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
AllConversionsFromInteractionsRate Double MÉTRICA Todas as conversões de interações (ao contrário das conversões de visualização) divididas pelo número de interações com anúncios.
AllConversionsValue Double MÉTRICA O valor de todas as conversões.
AverageCost Double MÉTRICA O valor médio que você paga por interação. Esse valor é o custo total de seus anúncios dividido pelo número total de interações.
AverageCpc Double MÉTRICA O custo total de todos os cliques dividido pelo número total de cliques recebidos.
AverageCpe Double MÉTRICA O valor médio cobrado de você por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncio dividido pelo número total de engajamentos de anúncio.
AverageCpm Double MÉTRICA Custo médio por mil impressões (CPM).
AverageCpv Double MÉTRICA O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pelo custo total de todas as visualizações do anúncio dividido pelo número de visualizações.
Clicks Long MÉTRICA O número de cliques.
Conversions Double MÉTRICA O número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsFromInteractionsRate Double MÉTRICA Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ConversionsValue Double MÉTRICA O valor das conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostMicros Long MÉTRICA A soma dos custos de custo por clique (CPC) e custo por mil impressões (CPM) durante esse período.
CostPerAllConversions Double MÉTRICA O custo das interações com anúncios dividido por todas as conversões.
CostPerConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CostPerCurrentModelAttributedConversion Double MÉTRICA O custo das interações com o anúncio dividido pelas conversões atribuídas ao modelo atual. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CrossDeviceConversions Double MÉTRICA Conversões de quando um cliente clica em um anúncio do Google Ads em um dispositivo e converte em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Ctr Double MÉTRICA O número de cliques que seu anúncio recebe (Cliques) dividido pelo número de vezes que seu anúncio é exibido (Impressões).
CurrentModelAttributedConversions Double MÉTRICA Mostra como seus dados históricos de conversões ficariam no modelo de atribuição que você selecionou no momento. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
CurrentModelAttributedConversionsValue Double MÉTRICA O valor das conversões atribuídas ao modelo atual. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
EngagementRate Double MÉTRICA A frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Este é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
Engagements Long MÉTRICA O número de compromissos. Um engajamento ocorre quando um visualizador expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncios poderão oferecer suporte a métricas de engajamento.
Impressions Long MÉTRICA Conte quantas vezes seu anúncio apareceu em uma página de resultados de pesquisa ou website na Rede do Google.
InteractionEventTypes String MÉTRICA Os tipos de interações pagas e gratuitas. Os valores permitidos são UNSPECIFED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double MÉTRICA Com que frequência as pessoas interagem com seu anúncio depois que ele é exibido para elas. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Interactions Long MÉTRICA O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio: cliques para anúncios de texto e de compras, visualizações para anúncios em vídeo e assim por diante.
TopImpressionPercentage Double MÉTRICA A porcentagem de suas impressões de anúncios exibidas em qualquer lugar acima dos resultados de pesquisa orgânica.
ValuePerAllConversions Double MÉTRICA O valor de todas as conversões dividido pelo número de todas as conversões.
ValuePerConversion Double MÉTRICA O valor das conversões dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ValuePerCurrentModelAttributedConversion Double MÉTRICA O valor das conversões atribuídas ao modelo atual dividido pelo número de conversões. Isso inclui apenas ações de conversão cujo atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias de lances serão otimizadas para essas conversões.
ViewThroughConversions Long MÉTRICA O número total de conversões de visualização. Isso acontece quando um cliente vê um anúncio gráfico ou rich media e, posteriormente, conclui uma conversão em seu site sem interagir (por exemplo, clicar em) com outro anúncio.
AdNetworkType String SEGMENTO Tipo de rede de anúncios. Os valores permitidos são CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENTO Clique em tipo. Os valores permitidos são APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOC ATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SW IPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, DESCONHECIDO, NÃO ESPECIFICADO, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENTO Nome do recurso da ação de conversão.
ConversionActionCategory String SEGMENTO Categoria de ação de conversão. Os valores permitidos são ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_ SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionActionName String SEGMENTO Nome da ação de conversão.
ConversionLagBucket String SEGMENTO Um valor de enumeração que representa o número de dias entre a impressão e a conversão. Os valores permitidos são EIGHT_TO_NINE_DAYS, ELEVEN_TO_TWELVE_DAYS, FIVE_TO_SIX_DAYS, FORTY_FIVE_TO_SIXTY_DAYS, FOURTEEN_TO_TWENTY_ONE_DAYS, FOUR_TO_FIVE_DAYS, LESS_THAN_ONE_DAY, NINE_TO_TEN_DAYS, ONE_TO_TWO_DAYS, SEVEN_TO_EIGHT_DAYS S, SEXTY_TO_NINETY_DAYS, SIX_TO_SEVEN_DAYS, TEN_TO_ELEVEN_DAYS, TREZE_TO_FOURTEEN_DAYS, TRINTA_TO_FORTY_FIVE_DAYS, TRÊS_TO_FOUR_DAYS, DOZE_TO_THIRTEEN_DAYS, TWENTY_ONE_TO_THIRTY_DAYS, DOIS_TO_THREE_DAYS, DESCONHECIDO, NÃO ESPECIFICADO.
ConversionOrAdjustmentLagBucket String SEGMENTO Um valor de enumeração que representa o número de dias entre a impressão e a conversão ou entre a impressão e os ajustes na conversão. Os valores permitidos são ADJUSTMENT_EIGHT_TO_NINE_DAYS, ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS, ADJUSTMENT_FIVE_TO_SIX_DAYS, ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS, ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS, ADJUSTMENT_FOUR_TO_FIVE_DAYS, ADJUSTMENT_LESS_THAN_ONE_DAY, ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS, ADJUSTMENT_NINE_TO_TEN_DAYS, ADJUSTMENT_ONE_TO_TWO_DAYS, ADJUSTMENT_SEVEN_TO_EIGHT_DAYS, ADJUSTMENT_SIXTY_TO_NINETY_DAYS, ADJUSTMENT_SIX_TO_SEVEN_DAYS, ADJUSTMENT_TEN_TO_ELEVEN_DAYS, ADJUSTMENT_THIRTEEN_ TO_FOURTEEN_DAYS, ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS, ADJUSTMENT_THREE_TO_FOUR_DAYS, ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS, ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS, ADJUSTMENT_TWO_TO_THREE_DAYS, ADJUSTMENT_UNKNOWN, CONVERSION_EIGHT_TO_NINE_DAYS, CONVERSION_ELEVEN_TO_TWELVE_DAYS, CONVERSION_FIVE_TO_SIX_DAYS, CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS, CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS, CONVERSION_FOUR_TO_FIVE_DAYS, CONVERSION_LESS_THAN_ONE_DAY, CONVERSION_NINE_TO_TEN_DAYS, CONVERSION_ONE_TO_TWO_DAYS, CONVERSION_SEVEN_TO_ OITO_DIAS, CONVERSION_SIXTY_TO_NINETY_DAYS, CONVERSION_SIX_TO_SEVEN_DAYS, CONVERSION_TEN_TO_ELEVEN_DAYS, CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS, CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS, CONVERSION_THREE_TO_FOUR_DAYS, CONVERSION_TWELVE_TO_THIRTEEN_DAYS, CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS, CONVERSION_TWO_TO_THREE_DAYS, CONVERSION_UNKNOWN, DESCONHECIDO, NÃO ESPECIFICADO.
Date Date SEGMENTO Data à qual as métricas se aplicam. formato aaaa-MM-dd, por exemplo, 2018-04-17.
DayOfWeek String SEGMENTO Dia da semana, por exemplo, SEGUNDA-FEIRA. Os valores permitidos são SEXTA, SEGUNDA, SÁBADO, DOMINGO, QUINTA, TERÇA, DESCONHECIDO, NÃO ESPECIFICADO, QUARTA.
Device String SEGMENTO Dispositivo ao qual as métricas se aplicam. Os valores permitidos são CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENTO Fonte de conversão externa. Os valores permitidos são AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_AT TRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, DESCONHECIDO, NÃO ESPECIFICADO, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENTO Mês conforme representado pela data do primeiro dia de um mês. Formatado como aaaa-MM-dd.
MonthOfYear String SEGMENTO Mês do ano, por exemplo, janeiro. Os valores permitidos são ABRIL, AGOSTO, DEZEMBRO, FEVEREIRO, JANEIRO, JULHO, JUNHO, MARÇO, MAIO, NOVEMBRO, OUTUBRO, SETEMBRO, DESCONHECIDO, NÃO ESPECIFICADO.
Period String SEGMENTO Intervalo de datas predefinido. Os valores permitidos são TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENTO Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para os trimestres, por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. Formatado como aaaa-MM-dd.
Slot String SEGMENTO Posição do anúncio. Os valores permitidos são CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENTO Semana definida como segunda a domingo e representada pela data de segunda-feira. Formatado como aaaa-MM-dd.
Year Int SEGMENTO Ano, formatado como aaaa.
Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Nome Tipo Descrição
ManagerId Long ID da conta de administrador em nome da qual você está solicitando dados do cliente.

Procedimentos Armazenados

Procedimentos armazenados* estão disponíveis para complementar os dados disponíveis no Modelo de Dados. Pode ser necessário atualizar os dados disponíveis em uma exibição usando um procedimento armazenado* porque os dados não fornecem atualizações bidirecionais diretas, semelhantes a tabelas. Nessas situações, a recuperação dos dados é feita usando a visualização ou tabela apropriada, enquanto a atualização é feita chamando um procedimento armazenado. Procedimentos armazenados* pega uma lista de parâmetros e retorna um conjunto de dados que contém a coleção de tuplas que constituem a resposta.

Conector Jitterbit para Procedimentos Armazenados do Google Ads
Nome Descrição
CreateReportSchema Cria um arquivo de esquema com base no relatório especificado.
GetOAuthAccessToken Obtém o token de acesso OAuth para ser usado para autenticação com vários serviços do Google.
GetOAuthAuthorizationURL Obtém o URL de autorização OAuth usado para autenticação com vários serviços do Google.
RefreshOAuthAccessToken Obtém o token de acesso OAuth para ser usado para autenticação com vários serviços do Google.
CreateReportSchema

Cria um arquivo de esquema com base no relatório especificado.

Use este procedimento armazenado* para criar uma nova exibição, que incluirá todos os atributos, métricas e segmentos de recursos específicos. Essas colunas podem ser de atributos de recursos (ResourceName), de recursos sem segmentação (AttributeResources) ou de recursos de segmentação (SegmentingResources). Abaixo estão alguns exemplos:

EXEC CreateReportSchema ResourceName='distance_view', ReportName='Distance 1', SegmentingResources='campaign', OutputFolder='C:/Users/Public/Desktop'
EXEC CreateReportSchema ResourceName='distance_view', ReportName='Distance 2', Description='Sample description.'
EXEC CreateReportSchema ResourceName='distance_view', ReportName='Distance 3', AttributeResources='customer', Description='Sample description.'
EXEC CreateReportSchema ResourceName='distance_view', ReportName='Distance 4', SegmentingResources='campaign', AttributeResources='customer', Description='Sample description.'

Para o último exemplo, você não pode selecionar todas as colunas em uma consultar, porque algumas métricas não suportam alguns recursos. Em vez disso, você deve especificar um subconjunto, por exemplo:

SELECT DistanceViewResourceName, CustomerTimeZone, CampaignName, CampaignEndDate, Clicks, Impressions FROM [Distance 4]
Entrada
Nome Tipo Descrição
ReportName String O nome da nova exibição.
ResourceName String O nome da API do recurso que você deseja usar, por exemplo, campanha, ad_group etc.
AttributeResources String Uma lista separada por vírgulas de nomes de recursos de API a serem incluídos além do ResourceName. Os campos desses recursos podem ser selecionados junto com ResourceName em suas cláusulas SELECT e WHERE. Esses campos não segmentarão métricas em sua cláusula SELECT.
SegmentingResources String Uma lista separada por vírgulas de nomes de recursos de API a serem incluídos além do ResourceName. Os campos desses recursos, quando selecionados junto com ResourceName em suas cláusulas SELECT e WHERE, segmentarão as métricas.
Metrics String Uma lista separada por vírgulas de métricas a serem incluídas no arquivo de esquema.
Segments String Uma lista separada por vírgulas de segmentos a serem incluídos no arquivo de esquema.
Description String Uma descrição opcional para este relatório personalizado.
OutputFolder String O caminho para o qual enviar o novo arquivo de esquema. Defina a propriedade Location como um caminho preferencial. Uma pasta 'GoogleAds' contendo os arquivos de esquema gerados será criada dentro de OutputFolder, caso ainda não exista. Se já existir uma pasta 'GoogleAds' dentro de OutputFolder, os arquivos de esquema serão colocados lá.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
Success String Se o esquema foi criado com sucesso ou não.
SchemaFile String O arquivo de esquema gerado.
GetOAuthAccessToken

Obtém o token de acesso OAuth para ser usado para autenticação com vários serviços do Google.

Entrada
Nome Tipo Descrição
AuthMode String O tipo de modo de autenticação a ser usado. Os valores permitidos são APP, WEB. O valor padrão é WEB.
Scope String O escopo de acesso às APIs do Google. Por padrão, o acesso a todas as APIs usadas por esse provedor de dados será especificado. o valor padrão é https://www.googleapis.com/auth/adwords.
Verifier String O código do verificador retornado pelo Google depois que a permissão para o aplicativo se conectar foi concedida. WEB AuthMode apenas.
CallbackURL String Este campo determina para onde a resposta é enviada. O valor desse parâmetro deve corresponder exatamente a um dos valores registrados no Console de APIs, incluindo os esquemas HTTP ou HTTPS, capitalização e barra final ('/').
Prompt String Este campo indica o prompt para apresentar ao usuário. Ele aceita um dos seguintes valores: NONE, CONSENT, SELECT ACCOUNT. O padrão é SELECT_ACCOUNT, portanto, um determinado usuário será solicitado a selecionar a conta à qual se conectar. Se estiver definido como CONSENT, o usuário verá uma página de consentimento todas as vezes, mesmo que já tenha dado consentimento ao aplicativo para um determinado conjunto de escopos. Por fim, se for definido como NONE, nenhuma tela de autenticação ou consentimento será exibida ao usuário. O valor padrão é SELECT_ACCOUNT.
AccessType String Este campo indica se seu aplicativo precisa acessar uma API do Google quando o usuário não está presente no navegador. Este parâmetro é padronizado como OFFLINE. Se seu aplicativo precisar atualizar os tokens de acesso quando o usuário não estiver presente no navegador, use OFFLINE. Isso fará com que seu aplicativo obtenha um token de atualização na primeira vez que seu aplicativo trocar um código de autorização para um usuário. Os valores permitidos são ONLINE, OFFLINE. O valor padrão é OFFLINE.
State String Este campo indica qualquer estado que pode ser útil para sua aplicação após o recebimento da resposta. Seu aplicativo recebe o mesmo valor que enviou, pois esse parâmetro faz uma viagem de ida e volta ao servidor de autorização do Google. Os usos incluem redirecionar o usuário para o recurso correto em seu site, usar nonces e atenuar a falsificação de solicitação entre sites.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
OAuthAccessToken String O token de autenticação retornado do Google. Isso pode ser usado em chamadas subseqüentes para outras operações para este serviço específico.
OAuthRefreshToken String Um token que pode ser usado para obter um novo token de acesso.
ExpiresIn String O tempo de vida restante no token de acesso.
GetOAuthAuthorizationURL

Obtém o URL de autorização OAuth usado para autenticação com vários serviços do Google.

Entrada
Nome Tipo Descrição
AuthMode String O tipo de modo de autenticação a ser usado. Os valores permitidos são APP, WEB. O valor padrão é WEB.
Scope String O escopo de acesso às APIs do Google. Por padrão, o acesso a todas as APIs usadas por esse provedor de dados será especificado. o valor padrão é https://www.googleapis.com/auth/adwords.
CallbackURL String Este campo determina para onde a resposta é enviada. O valor desse parâmetro deve corresponder exatamente a um dos valores registrados no Console de APIs, incluindo os esquemas HTTP ou HTTPS, maiúsculas e minúsculas e barra final ('/').
Prompt String Este campo indica o prompt para apresentar ao usuário. Ele aceita um dos seguintes valores: NONE, CONSENT, SELECT ACCOUNT. O padrão é SELECT_ACCOUNT, portanto, um determinado usuário será solicitado a selecionar a conta à qual se conectar. Se estiver definido como CONSENT, o usuário verá uma página de consentimento todas as vezes, mesmo que já tenha dado consentimento ao aplicativo para um determinado conjunto de escopos. Por fim, se for definido como NENHUM, nenhuma tela de autenticação ou consentimento será exibida ao usuário. O valor padrão é SELECT_ACCOUNT.
AccessType String Este campo indica se seu aplicativo precisa acessar uma API do Google quando o usuário não está presente no navegador. Este parâmetro é padronizado como OFFLINE. Se seu aplicativo precisar atualizar os tokens de acesso quando o usuário não estiver presente no navegador, use OFFLINE. Isso fará com que seu aplicativo obtenha um token de atualização na primeira vez que seu aplicativo trocar um código de autorização para um usuário. Os valores permitidos são ONLINE, OFFLINE. O valor padrão é OFFLINE.
State String Este campo indica qualquer estado que pode ser útil para sua aplicação após o recebimento da resposta. Seu aplicativo recebe o mesmo valor que enviou, pois esse parâmetro faz uma viagem de ida e volta ao servidor de autorização do Google. Os usos possíveis incluem redirecionar o usuário para o recurso correto em seu site, usar nonces e atenuar a falsificação de solicitação entre sites.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
URL String A URL para concluir a autenticação do usuário.
RefreshOAuthAccessToken

Obtém o token de acesso OAuth para ser usado para autenticação com vários serviços do Google.

Entrada
Nome Tipo Descrição
OAuthRefreshToken String O token de atualização retornado da troca do código de autorização original.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
OAuthAccessToken String O token de autenticação retornado do Google. Isso pode ser usado em chamadas subseqüentes para outras operações para este serviço específico.
OAuthRefreshToken String O token de atualização retornado do Google. Isso pode ser usado para obter um novo token de acesso quando o token de acesso expirar.
ExpiresIn String O tempo de vida restante no token de acesso.

Tabelas do Sistema

Você pode consultar as tabelas do sistema descritas nesta seção para acessar informações de esquema, informações sobre a funcionalidade da fonte de dados e estatísticas de operação em lote.

Tabelas de Esquema

As tabelas a seguir retornam metadados do banco de dados do Google Ads:

Tabelas de Fonte de Dados

As tabelas a seguir retornam informações sobre como se conectar e consultar a fonte de dados:

  • sys_connection_props: Retorna informações sobre as propriedades de conexão disponíveis.
  • sys_sqlinfo: Descreve as consultas SELECT que o conector pode descarregar para a fonte de dados.

Consultar Tabelas de Informações

A tabela a seguir retorna estatísticas de consultar para consultas de modificação de dados:

  • sys_identity: Retorna informações sobre operações em lote ou atualizações únicas.

Sys_catalogs

Lista os bancos de dados disponíveis.

A consultar a seguir recupera todos os bancos de dados determinados pela string de conexão:

SELECT * FROM sys_catalogs
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados.

Sys_schemas

Lista os esquemas disponíveis.

A consultar a seguir recupera todos os esquemas disponíveis:

SELECT * FROM sys_schemas
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados.
SchemaName String O nome do esquema.

Sys_tables

Lista as tabelas disponíveis.

A consultar a seguir recupera as tabelas e exibições disponíveis:

SELECT * FROM sys_tables
Colunas
Nome Tipo Descrição
CatalogName String O banco de dados que contém a tabela ou exibição.
SchemaName String O esquema que contém a tabela ou exibição.
TableName String O nome da tabela ou exibição.
TableType String O tipo de tabela (tabela ou exibição).
Description String Uma descrição da tabela ou exibição.
IsUpdateable Boolean Se a tabela pode ser atualizada.

Sys_tablecolumns

Descreve as colunas das tabelas e exibições disponíveis.

A consultar a seguir retorna as colunas e tipos de dados para a tabela CampaignPerformance:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='CampaignPerformance' 
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados que contém a tabela ou exibição.
SchemaName String O esquema que contém a tabela ou exibição.
TableName String O nome da tabela ou exibição que contém a coluna.
ColumnName String O nome da coluna.
DataTypeName String O nome do tipo de dados.
DataType Int32 Um número inteiro indicando o tipo de dados. Esse valor é determinado no tempo de execução com base no ambiente.
Length Int32 O tamanho de armazenamento da coluna.
DisplaySize Int32 A largura máxima normal da coluna designada em caracteres.
NumericPrecision Int32 O número máximo de dígitos em dados numéricos. O comprimento da coluna em caracteres para caracteres e dados de data e hora.
NumericScale Int32 A escala da coluna ou o número de dígitos à direita do ponto decimal.
IsNullable Boolean Se a coluna pode conter null.
Description String Uma breve descrição da coluna.
Ordinal Int32 O número de sequência da coluna.
IsAutoIncrement String Se o valor da coluna é atribuído em incrementos fixos.
IsGeneratedColumn String Se a coluna é gerada.
IsHidden Boolean Se a coluna está oculta.
IsArray Boolean Se a coluna é uma matriz.

Sys_procedures

Lista os procedimentos armazenados disponíveis.

A consultar a seguir recupera os procedimentos armazenados disponíveis:

SELECT * FROM sys_procedures
Colunas
Nome Tipo Descrição
CatalogName String O banco de dados que contém o procedimento armazenado.
SchemaName String O esquema que contém o procedimento armazenado.
ProcedureName String O nome do procedimento armazenado.
Description String Uma descrição do procedimento armazenado.
ProcedureType String O tipo do procedimento, como PROCEDURE ou FUNCTION.

Sys_procedureparameters

Descreve procedimento armazenado* parâmetros.

A consultar a seguir retorna informações sobre todos os parâmetros de entrada para o procedimento armazenado GetOAuthAccessToken:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='GetOAuthAccessToken' AND Direction=1 OR Direction=2
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados que contém o procedimento armazenado.
SchemaName String O nome do esquema que contém o procedimento armazenado.
ProcedureName String O nome do procedimento armazenado* contendo o parâmetro.
ColumnName String O nome do procedimento armazenado* parâmetro.
Direction Int32 Um número inteiro correspondente ao tipo do parâmetro: entrada (1), entrada/saída (2) ou saída (4). parâmetros de tipo de entrada/saída podem ser parâmetros de entrada e saída.
DataTypeName String O nome do tipo de dados.
DataType Int32 Um número inteiro indicando o tipo de dados. Esse valor é determinado no tempo de execução com base no ambiente.
Length Int32 O número de caracteres permitido para dados de caractere. O número de dígitos permitidos para dados numéricos.
NumericPrecision Int32 A precisão máxima para dados numéricos. O comprimento da coluna em caracteres para caracteres e dados de data e hora.
NumericScale Int32 O número de dígitos à direita do ponto decimal em dados numéricos.
IsNullable Boolean Se o parâmetro pode conter null.
IsRequired Boolean Se o parâmetro é necessário para a execução do procedimento.
IsArray Boolean Se o parâmetro é uma matriz.
Description String A descrição do parâmetro.
Ordinal Int32 O índice do parâmetro.

Sys_keycolumns

Descreve as chaves primárias e estrangeiras. A consultar a seguir recupera a chave primária da tabela CampaignPerformance:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='CampaignPerformance'
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados que contém a chave.
SchemaName String O nome do esquema que contém a chave.
TableName String O nome da tabela que contém a chave.
ColumnName String O nome da coluna chave.
IsKey Boolean Se a coluna é uma chave primária na tabela referenciada no campo TableName.
IsForeignKey Boolean Se a coluna é uma chave estrangeira referenciada no campo TableName.
PrimaryKeyName String O nome da chave primária.
ForeignKeyName String O nome da chave estrangeira.
ReferencedCatalogName String O banco de dados que contém a chave primária.
ReferencedSchemaName String O esquema que contém a chave primária.
ReferencedTableName String A tabela que contém a chave primária.
ReferencedColumnName String O nome da coluna da chave primária.

Sys_foreignkeys

Descreve as chaves estrangeiras. A consultar a seguir recupera todas as chaves estrangeiras que se referem a outras tabelas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados que contém a chave.
SchemaName String O nome do esquema que contém a chave.
TableName String O nome da tabela que contém a chave.
ColumnName String O nome da coluna chave.
PrimaryKeyName String O nome da chave primária.
ForeignKeyName String O nome da chave estrangeira.
ReferencedCatalogName String O banco de dados que contém a chave primária.
ReferencedSchemaName String O esquema que contém a chave primária.
ReferencedTableName String A tabela que contém a chave primária.
ReferencedColumnName String O nome da coluna da chave primária.
ForeignKeyType String Designa se a chave estrangeira é uma chave de importação (aponta para outras tabelas) ou de exportação (referenciada de outras tabelas).

Sys_indexes

Descreve os índices disponíveis. Ao filtrar por índices, você pode escrever consultas mais seletivas com tempos de resposta de consultar mais rápidos.

A consultar a seguir recupera todos os índices que não são chaves primárias:

SELECT * FROM sys_indexes WHERE IsPrimary='false'
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados que contém o índice.
SchemaName String O nome do esquema que contém o índice.
TableName String O nome da tabela que contém o índice.
IndexName String O nome do índice.
ColumnName String O nome da coluna associada ao índice.
IsUnique Boolean True se o índice for exclusivo. Falso caso contrário.
IsPrimary Boolean Verdadeiro se o índice for uma chave primária. Falso caso contrário.
Type Int16 Um valor inteiro correspondente ao tipo de índice: estatística (0), agrupado (1), hash (2) ou outro (3).
SortOrder String A ordem de classificação: A para crescente ou D para decrescente.
OrdinalPosition Int16 O número de sequência da coluna no índice.

Sys_connection_props

Retorna informações sobre as propriedades de conexão disponíveis e as definidas na string de conexão.

Ao consultar esta tabela, a string de conexão de configuração deve ser usada:

jdbc:cdata:googleads:config:

Esta string de conexão permite que você consultar esta tabela sem uma conexão válida.

A consultar a seguir recupera todas as propriedades de conexão que foram definidas na string de conexão ou definidas por meio de um valor padrão:

SELECT * FROM sys_connection_props WHERE Value <> ''
Colunas
Nome Tipo Descrição
Name String O nome da propriedade de conexão.
ShortDescription String Uma breve descrição.
Type String O tipo de dados da propriedade de conexão.
Default String O valor padrão, se não houver um definido explicitamente.
Values String Uma lista separada por vírgulas de valores possíveis. Um erro de validação é lançado se outro valor for especificado.
Value String O valor que você definiu ou um padrão pré-configurado.
Required Boolean Se a propriedade é necessária para se conectar.
Category String A categoria da propriedade de conexão.
IsSessionProperty String Se a propriedade é uma propriedade de sessão, usada para salvar informações sobre a conexão atual.
Sensitivity String O nível de sensibilidade da propriedade. Isso informa se a propriedade está ofuscada nos formulários de registro e autenticação.
PropertyName String Uma forma truncada em camel case do nome da propriedade de conexão.
Ordinal Int32 O índice do parâmetro.
CatOrdinal Int32 O índice da categoria do parâmetro.
Hierarchy String Mostra as propriedades dependentes associadas que precisam ser definidas juntamente com esta.
Visible Boolean Informa se a propriedade está visível na UI da conexão.
ETC String Diversas informações diversas sobre o imóvel.

Sys_sqlinfo

Descreve o processamento da consultar SELECT que o conector pode transferir para a fonte de dados.

Processamento de Consultas Colaborativas

Ao trabalhar com fontes de dados que não suportam SQL-92, você pode consultar a exibição sys_sqlinfo para determinar os recursos de consultar das APIs subjacentes, expressas na sintaxe SQL. O conector transfere o máximo possível do processamento da instrução SELECT para o servidor e, em seguida, processa o restante da consultar na memória.

Descobrindo os Recursos SELECT da Fonte de Dados

Abaixo está um exemplo de conjunto de dados de recursos SQL. O conjunto de resultados a seguir indica a funcionalidade SELECT que o conector pode descarregar para a fonte de dados ou processar o lado do cliente. Sua fonte de dados pode suportar sintaxe SQL adicional. Alguns aspectos da funcionalidade SELECT são retornados em uma lista separada por vírgulas, se suportados; caso contrário, a coluna contém NO.

Nome Descrição Valores Possíveis
AGGREGATE_FUNCTIONS Funções de agregação suportadas. AVG, COUNT, MAX, MIN, SUM, DISTINCT
COUNT Se a função COUNT é suportada. YES, NO
IDENTIFIER_QUOTE_OPEN_CHAR O caractere de abertura usado para escapar de um identificador. [
IDENTIFIER_QUOTE_CLOSE_CHAR O caractere de fechamento usado para escapar de um identificador. ]
SUPPORTED_OPERATORS Uma lista de operadores SQL com suporte. =, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR
GROUP_BY Se GROUP BY é compatível e, em caso afirmativo, o grau de suporte. NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE
STRING_FUNCTIONS Funções de string suportadas. LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE
NUMERIC_FUNCTIONS Funções numéricas suportadas. ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE
TIMEDATE_FUNCTIONS Funções de data/hora suportadas. NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT
REPLICATION_SKIP_TABLES Indica tabelas ignoradas durante a replicação.
REPLICATION_TIMECHECK_COLUMNS Uma matriz de string contendo uma lista de colunas que serão usadas para verificar (na ordem especificada) para usar como uma coluna modificada durante a replicação.
IDENTIFIER_PATTERN Valor de string que indica qual string é válida para um identificador.
SUPPORT_TRANSACTION Indica se o provedor oferece suporte a transações como confirmação e reversão. YES, NO
DIALECT Indica o dialeto SQL a ser usado.
KEY_PROPERTIES Indica as propriedades que identificam o banco de dados uniforme.
SUPPORTS_MULTIPLE_SCHEMAS Indica se vários esquemas podem existir para o provedor. YES, NO
SUPPORTS_MULTIPLE_CATALOGS Indica se vários catálogos podem existir para o provedor. YES, NO
DATASYNCVERSION A versão do Data Sync necessária para acessar este driver. Standard, Starter, Professional, Enterprise
DATASYNCCATEGORY A categoria Data Sync deste driver. Source, Destination, Cloud Destination
SUPPORTSENHANCEDSQL Se a funcionalidade SQL aprimorada além do que é oferecido pela API é suportada. TRUE, FALSE
SUPPORTS_BATCH_OPERATIONS Se as operações em lote são suportadas. YES, NO
SQL_CAP Todos os recursos SQL suportados para este driver. SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX
PREFERRED_CACHE_OPTIONS Um valor de string especifica o cacheOptions preferencial.
ENABLE_EF_ADVANCED_QUERY Indica se o driver oferece suporte direto a consultas avançadas provenientes do Entity Framework. Caso contrário, as consultas serão tratadas no lado do cliente. YES, NO
PSEUDO_COLUMNS Uma matriz de cadeia de caracteres que indica as pseudocolunas disponíveis.
MERGE_ALWAYS Se o valor for verdadeiro, o modo de mesclagem será executado à força no Data Sync. TRUE, FALSE
REPLICATION_MIN_DATE_QUERY Uma consultar de seleção para retornar a data e hora de início da replicação.
REPLICATION_MIN_FUNCTION Permite que um provedor especifique o nome da fórmula a ser usado para executar um min do lado do servidor.
REPLICATION_START_DATE Permite que um provedor especifique uma data de início de replicação.
REPLICATION_MAX_DATE_QUERY Uma consultar de seleção para retornar a data e hora de término da replicação.
REPLICATION_MAX_FUNCTION Permite que um provedor especifique o nome da fórmula a ser usado para executar um máximo do lado do servidor.
IGNORE_INTERVALS_ON_INITIAL_REPLICATE Uma lista de tabelas que ignorará a divisão da replicação em blocos na replicação inicial.
CHECKCACHE_USE_PARENTID Indica se a instrução CheckCache deve ser executada na coluna de chave pai. TRUE, FALSE
CREATE_SCHEMA_PROCEDURES Indica procedimentos armazenados* que pode ser usado para gerar arquivos de esquema.

A consultar a seguir recupera os operadores que podem ser usados na cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Observe que tabelas individuais podem ter diferentes limitações ou requisitos na cláusula WHERE; consulte o Modelo de Dados para obter mais informações.

Colunas
Nome Tipo Descrição
NAME String Um componente da sintaxe SQL ou um recurso que pode ser processado no servidor.
VALUE String Detalhes sobre a sintaxe SQL ou SQL suportada.

Sys_identity

Retorna informações sobre tentativas de modificação.

A consultar a seguir recupera os IDs das linhas modificadas em uma operação em lote:

SELECT * FROM sys_identity
Colunas
Nome Tipo Descrição
Id String O ID gerado pelo banco de dados retornado de uma operação de modificação de dados.
Batch String Um identificador para o lote. 1 para uma única operação.
Operation String O resultado da operação no lote: INSERTED, UPDATED ou DELETED.
Message String SUCCESS ou uma mensagem de erro se a atualização no lote falhou.

Propriedades de Configurações Avançadas

As propriedades de configurações avançadas são as várias opções que podem ser usadas para estabelecer uma conexão. Esta seção fornece uma lista completa das opções que você pode configurar. Clique nos links para mais detalhes.

Autenticação

Propriedade Descrição
AuthScheme O tipo de autenticação a ser usado ao se conectar ao Google Ads.
DeveloperToken O token de desenvolvedor da conta do AdWords.
ClientCustomerId O ID de cliente da conta do AdWords.
ManagerId O ID da conta MCC.
Schema A versão do esquema a ser usada para obter dados do Google Ads.
APIVersion A versão mais recente da Google Ads API.

OAuth

Propriedade Descrição
InitiateOAuth Configure esta propriedade para iniciar o processo para obter ou atualizar o token de acesso OAuth ao se conectar.
OAuthClientId O ID do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.
OAuthClientSecret O segredo do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.
OAuthAccessToken O token de acesso para conexão usando OAuth.
OAuthVerifier O código do verificador retornado da URL de autorização OAuth.
OAuthRefreshToken O token de atualização OAuth para o token de acesso OAuth correspondente.
OAuthExpiresIn O tempo de vida em segundos do OAuth AccessToken.
OAuthTokenTimestamp O registro de data e hora da época do Unix em milissegundos quando o token de acesso atual foi criado.

JWT OAuth

Propriedade Descrição
OAuthJWTCert A loja de certificados JWT.
OAuthJWTCertType O tipo de armazenamento de chaves que contém o certificado JWT.
OAuthJWTCertPassword A senha para o certificado OAuth JWT.
OAuthJWTCertSubject O assunto do certificado OAuth JWT.
OAuthJWTIssuer O emissor do Java Web Token.
OAuthJWTSubject O assunto do usuário para o qual o aplicativo está solicitando acesso delegado.

SSL

Propriedade Descrição
SSLServerCert O certificado a ser aceito do servidor ao conectar usando TLS/SSL.

Esquema

Propriedade Descrição
Location Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados.
BrowsableSchemas Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC.
Tables Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tables=TableA, TableB, TableC.
Views Restringe as exibições relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA, ViewB, ViewC.

Diversos

Propriedade Descrição
IncludeZeroImpressions Se deve ou não incluir ou excluir zero impressões nos relatórios.
MaxRows Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.
Other Essas propriedades ocultas são usadas apenas em casos de uso específicos.
PseudoColumns Esta propriedade indica se deve ou não incluir pseudocolunas como colunas na tabela.
QueryPassthrough Essa opção passa a consultar para o servidor do Google Ads como está.
RecurseChildren Defina como falso se quiser evitar a recorrência de IDs de cliente para obter a hierarquia completa da tabela CustomerClientLink nos esquemas do googleads.
Timeout O valor em segundos até que o erro de timeout seja lançado, cancelando a operação.

Autenticação

Esta seção fornece uma lista completa de propriedades de autenticação que você pode configurar.

Propriedade Descrição
AuthScheme O tipo de autenticação a ser usado ao se conectar ao Google Ads.
DeveloperToken O token de desenvolvedor da conta do AdWords.
ClientCustomerId O ID de cliente da conta do AdWords.
ManagerId O ID da conta MCC.
Schema A versão do esquema a ser usada para obter dados do Google Ads.
APIVersion A versão mais recente da Google Ads API.

AuthScheme

O tipo de autenticação a ser usado ao se conectar ao Google Ads.

Valores Possíveis

Auto, OAuth, OAuthJWT, GCPInstanceAccount

Tipo de Dados

string

Valor Padrão

"Auto"

Observações
  • Auto: permite que o driver decida automaticamente com base nas outras propriedades de conexão que você definiu.
  • OAuth: Defina para executar a autenticação OAuth usando uma conta de usuário padrão.
  • OAuthJWT: defina para executar a autenticação OAuth usando uma conta de serviço OAuth.
  • GCPInstanceAccount: defina para obter o token de acesso da instância do Google Cloud Platform.

DeveloperToken

O token de desenvolvedor da conta do AdWords.

Tipo de Dados

string

Valor Padrão

""

Observações

Juntamente com ClientCustomerId, este campo é usado para autenticação nos servidores do Google AdWords e é obrigatório para uso com o Google AdWords.

Você pode obter um DeveloperToken inscrevendo-se na API do AdWords. Para fazer isso, faça login no site do AdWords com sua conta da MCC e navegue até Configurações -> Configurações da conta -> Centro de API do Google AdWords. Inscreva-se para acesso à API e aguarde o Google entrar em contato com você por e-mail com mais instruções. Você deve receber um token com status pendente. Este token é apenas para teste e não permite que você se conecte a dados ativos. O Google deve entrar em contato com você para preencher um questionário e, assim que for recebido e aprovado pelo Google, você receberá seu token de desenvolvedor ativo.

ClientCustomerId

O ID de cliente da conta do AdWords.

Tipo de Dados

string

Valor Padrão

""

Observações

Juntamente com DeveloperToken, este campo é usado para autenticação nos servidores do Google AdWords e é obrigatório para uso com o Google AdWords.

Você pode encontrar esse valor em sua conta do AdWords. Esse valor não é igual ao ID da conta MCC. Você precisa fornecer os IDs de nível mais baixo para recuperar dados.

Um uso comum para o driver é recuperar dados de vários IDs de clientes. Isso é útil quando você tem uma conta MCC do Google Ads que inclui várias contas/ClientCustomerIds. Você pode consultar e obter dados das contas que deseja especificando CustomerId na cláusula WHERE, por exemplo:

SELECT * FROM AdGroupAd WHERE CustomerId='3333333333'
SELECT * FROM AdGroupAd WHERE CustomerId IN ('1111111111', '2222222222')

O driver ignora o ClientCustomerId propriedade de conexão quando você especifica o CustomerId em cláusulas WHERE.

GerenteId

O ID da conta MCC.

Tipo de Dados

string

Valor Padrão

""

Observações

A ID da conta MCC (MyClientCenter).

Se o acesso a uma conta de cliente for herdado apenas por meio de uma conta de administrador, essa propriedade será obrigatória e deverá ser definida como o ID do cliente da conta de administrador. Se sua conta tiver acesso direto à conta do cliente cliente como Usuário, isso não é necessário. Em outras palavras, as Ferramentas e configurações do cliente --> Acesso à conta deve mostrar seu e-mail na aba Usuários para acessar a conta sem essa propriedade, caso contrário, o acesso foi concedido por meio da conta de administrador, na aba Gerentes.

Definir essa propriedade adicionará o cabeçalho de solicitação login-customer-id.

Esquema

A versão do esquema a ser usada para obter dados do Google Ads.

Valores Possíveis

GoogleAds, AdWords

Tipo de Dados

string

Valor Padrão

"GoogleAds"

Observações

O valor padrão para esta propriedade é GoogleAds.

  • Defina-o como 'GoogleAds' para se conectar aos dados do Google Ads.
  • Defina como 'AdWords' para se conectar aos dados do Google AdWords v201809.

A API do Google AdWords não está mais disponível para novos usuários. Os desenvolvedores que aceitarem os Termos e Condições ao solicitar um novo token de desenvolvedor após 28 de abril de 2021 terão acesso somente à Google Ads API. O uso do token para chamadas da API do AdWords resulta em um erro QuotaCheckError.INVALID_TOKEN_HEADER, com a mensagem de que novos desenvolvedores devem usar a API do Google Ads.

APIVersion

A versão mais recente da Google Ads API.

Tipo de Dados

string

Valor Padrão

"v10"

Observações

A versão mais recente da Google Ads API. Você pode encontrar isso na página de documentação da API.

OAuth

Esta seção fornece uma lista completa de propriedades OAuth que você pode configurar.

Propriedade Descrição
InitiateOAuth Configure esta propriedade para iniciar o processo para obter ou atualizar o token de acesso OAuth ao se conectar.
OAuthClientId O ID do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.
OAuthClientSecret O segredo do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.
OAuthAccessToken O token de acesso para conexão usando OAuth.
OAuthVerifier O código do verificador retornado da URL de autorização OAuth.
OAuthRefreshToken O token de atualização OAuth para o token de acesso OAuth correspondente.
OAuthExpiresIn O tempo de vida em segundos do OAuth AccessToken.
OAuthTokenTimestamp O registro de data e hora da época do Unix em milissegundos quando o token de acesso atual foi criado.

InitiateOAuth

Configure esta propriedade para iniciar o processo para obter ou atualizar o token de acesso OAuth ao se conectar.

Valores Possíveis

OFF, GETANDREFRESH, REFRESH

Tipo de Dados

string

Valor Padrão

"OFF"

Observações

As seguintes opções estão disponíveis:

  1. OFF: Indica que o fluxo OAuth será tratado inteiramente pelo usuário. Um OAuthAccessToken será necessário para autenticação.
  2. GETANDREFRESH: Indica que todo o fluxo OAuth será tratado pelo conector. Se nenhum token existir atualmente, ele será obtido solicitando ao usuário por meio do navegador. Se existir um token, ele será atualizado quando aplicável.
  3. REFRESH: Indica que o conector tratará apenas da atualização do OAuthAccessToken. O usuário nunca será solicitado pelo conector a autenticar por meio do navegador. O usuário deve lidar com a obtenção do OAuthAccessToken e OAuthRefreshToken inicialmente.

OAuthClientId

O ID do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.

Tipo de Dados

string

Valor Padrão

""

Observações

Como parte do registro de um aplicativo OAuth, você receberá o OAuthClientId valor, às vezes também chamado de chave do consumidor e segredo do cliente, o OAuthClientSecret.

OAuthClientSecret

O segredo do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.

Tipo de Dados

string

Valor Padrão

""

Observações

Como parte do registro de um aplicativo OAuth, você receberá o OAuthClientId, também chamada de chave do consumidor. Você também receberá um segredo do cliente, também chamado de segredo do consumidor. Defina o segredo do cliente no OAuthClientSecret propriedade.

OAuthAccessToken

O token de acesso para conexão usando OAuth.

Tipo de Dados

string

Valor Padrão

""

Observações

O OAuthAccessToken propriedade é usada para conectar usando OAuth. O OAuthAccessToken é recuperado do servidor OAuth como parte do processo de autenticação. Ele tem um tempo limite dependente do servidor e pode ser reutilizado entre as solicitações.

O token de acesso é usado no lugar do seu nome de usuário e senha. O token de acesso protege suas credenciais, mantendo-as no servidor.

OAuthVerifier

O código do verificador retornado da URL de autorização OAuth.

Tipo de Dados

string

Valor Padrão

""

Observações

O código do verificador retornado da URL de autorização OAuth. Isso pode ser usado em sistemas em que um navegador não pode ser iniciado, como sistemas headless.

Autenticação em Máquinas Sem Cabeça

Consulte para obter o OAuthVerifier valor.

Defina OAuthSettingsLocation juntamente com OAuthVerifier. Quando você conecta, o conector troca o OAuthVerifier para os tokens de autenticação OAuth e os salva, criptografados, no arquivo especificado. Definir InitiateOAuth para GETANDREFRESH automatizar a troca.

Depois que o arquivo de configurações OAuth for gerado, você poderá remover OAuthVerifier nas propriedades de conexão e conecte-se com OAuthSettingsLocation definir.

Para atualizar automaticamente os valores do token OAuth, defina OAuthSettingsLocation e adicionalmente defina InitiateOAuth para ATUALIZAR.

OAuthRefreshToken

O token de atualização OAuth para o token de acesso OAuth correspondente.

Tipo de Dados

string

Valor Padrão

""

Observações

O OAuthRefreshToken a propriedade é usada para atualizar o OAuthAccessToken ao usar a autenticação OAuth.

OAuthExpiresIn

O tempo de vida em segundos do OAuth AccessToken.

Tipo de Dados

string

Valor Padrão

""

Observações

Emparelhe com OAuthTokenTimestamp para determinar quando o AccessToken expirará.

OAuthTokenTimestamp

O registro de data e hora da época do Unix em milissegundos quando o token de acesso atual foi criado.

Tipo de Dados

string

Valor Padrão

""

Observações

Emparelhe com OAuthExpiresIn para determinar quando o AccessToken expirará.

JWT OAuth

Esta seção fornece uma lista completa das propriedades JWT OAuth que você pode configurar.

Propriedade Descrição
OAuthJWTCert A loja de certificados JWT.
OAuthJWTCertType O tipo de armazenamento de chaves que contém o certificado JWT.
OAuthJWTCertPassword A senha para o certificado OAuth JWT.
OAuthJWTCertSubject O assunto do certificado OAuth JWT.
OAuthJWTIssuer O emissor do Java Web Token.
OAuthJWTSubject O assunto do usuário para o qual o aplicativo está solicitando acesso delegado.

OAuthJWTCert

A loja de certificados JWT.

Tipo de Dados

string

Valor Padrão

""

Observações

O nome do armazenamento de certificados para o certificado do cliente.

O OAuthJWTCertType campo especifica o tipo de armazenamento de certificado especificado por OAuthJWTCert. Se o armazenamento estiver protegido por senha, especifique a senha em OAuthJWTCertPassword.

OAuthJWTCert é usado em conjunto com o OAuthJWTCertSubject para especificar os certificados do cliente. Se OAuthJWTCert tem um valor e OAuthJWTCertSubject for definido, uma pesquisa por um certificado será iniciada. Consulte OAuthJWTCertSubject para obter detalhes.

As designações de armazenamentos de certificados dependem da plataforma.

A seguir estão as designações dos armazenamentos de certificados de Usuário e Máquina mais comuns no Windows:

Propriedade Descrição
MY Um armazenamento de certificados que contém certificados pessoais com suas chaves privadas associadas.
CA Certificados de autoridade certificadora.
ROOT Certificados raiz.
SPC Certificados de editor de software.

Em Java, o armazenamento de certificados normalmente é um arquivo contendo certificados e chaves privadas opcionais.

Quando o tipo de armazenamento de certificado for PFXFile, essa propriedade deverá ser configurada para o nome do arquivo. Quando o tipo é PFXBlob, a propriedade deve ser configurada para o conteúdo binário de um arquivo PFX (ou seja, armazenamento de certificados PKCS12).

OAuthJWTCertType

O tipo de armazenamento de chave que contém o certificado JWT.

Valores Possíveis

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB, GOOGLEJSON, GOOGLEJSONBLOB

Tipo de Dados

string

Valor Padrão

"USER"

Observações

Esta propriedade pode assumir um dos seguintes valores:

Propriedade Descrição
USER Para Windows, isso especifica que o armazenamento de certificados é um armazenamento de certificados pertencente ao usuário atual. Nota: Este tipo de loja não está disponível em Java.
MACHINE Para Windows, isso especifica que o armazenamento de certificados é um armazenamento de máquina. Nota: este tipo de loja não está disponível em Java.
PFXFILE O armazenamento de certificados é o nome de um arquivo PFX (PKCS12) que contém certificados.
PFXBLOB O armazenamento de certificados é uma string (codificada em base 64) que representa um armazenamento de certificados no formato PFX (PKCS12).
JKSFILE O armazenamento de certificados é o nome de um arquivo de armazenamento de chaves Java (JKS) que contém certificados. Nota: este tipo de loja só está disponível em Java.
JKSBLOB O armazenamento de certificados é uma sequência (codificada em base 64) que representa um armazenamento de certificados no formato Java key store (JKS). Nota: este tipo de loja só está disponível em Java.
PEMKEY_FILE O armazenamento de certificados é o nome de um arquivo codificado por PEM que contém uma chave privada e um certificado opcional.
PEMKEY_BLOB O armazenamento de certificados é uma string (codificada em base64) que contém uma chave privada e um certificado opcional.
PUBLIC_KEY_FILE O armazenamento de certificados é o nome de um arquivo que contém um certificado de chave pública codificado por PEM ou DER.
PUBLIC_KEY_BLOB O armazenamento de certificados é uma string (codificada em base 64) que contém um certificado de chave pública codificado em PEM ou DER.
SSHPUBLIC_KEY_FILE O armazenamento de certificados é o nome de um arquivo que contém uma chave pública de estilo SSH.
SSHPUBLIC_KEY_BLOB O armazenamento de certificados é uma string (codificada em base 64) que contém uma chave pública de estilo SSH.
P7BFILE O armazenamento de certificados é o nome de um arquivo PKCS7 que contém certificados.
PPKFILE O armazenamento de certificados é o nome de um arquivo que contém um PPK (PuTTY Private Key).
XMLFILE O armazenamento de certificados é o nome de um arquivo que contém um certificado no formato XML.
XMLBLOB O armazenamento de certificados é uma string que contém um certificado no formato XML.
GOOGLEJSON O armazenamento de certificados é o nome de um arquivo JSON que contém as informações da conta de serviço. Válido apenas ao conectar-se a um serviço do Google.
GOOGLEJSONBLOB O armazenamento de certificados é uma string que contém o JSON da conta de serviço. Válido apenas ao conectar-se a um serviço do Google.

OAuthJWTCertPassword

A senha para o certificado OAuth JWT.

Tipo de Dados

string

Valor Padrão

""

Observações

Se o armazenamento de certificados for de um tipo que requer uma senha, essa propriedade será usada para especificar essa senha para abrir o armazenamento de certificados.

Isso não é necessário ao usar o GOOGLEJSON OAuthJWTCertType. As chaves JSON do Google não são criptografadas.

OAuthJWTCertSubject

O assunto do certificado OAuth JWT.

Tipo de Dados

string

Valor Padrão

"\*"

Observações

Ao carregar um certificado, o assunto é usado para localizar o certificado na loja.

Se uma correspondência exata não for encontrada, a loja é pesquisada em busca de assuntos que contenham o valor da propriedade.

Se uma correspondência ainda não for encontrada, a propriedade será definida como uma string vazia e nenhum certificado será selecionado.

O valor especial "*" seleciona o primeiro certificado no armazenamento de certificados.

O assunto do certificado é uma lista separada por vírgulas de campos e valores de nomes distintos. Por exemplo, "CN=www.server.com, OU=test, C=US, E=support@jitterbit.com". Os campos comuns e seus significados são exibidos abaixo.

Campo Significado
CN Nome comum. Geralmente, é um nome de hospedar como www.server.com.
O Organização
OU Unidade Organizacional
L Localidade
S Estado
C País
E Endereço E-mail

Se um valor de campo contiver uma vírgula, ela deverá ser colocada entre aspas.

OAuthJWTIssuer

O emissor do Java Web Token.

Tipo de Dados

string

Valor Padrão

""

Observações

O emissor do Java Web Token. Normalmente, é o ID do cliente ou o endereço E-mail do aplicativo OAuth.

Isso não é necessário ao usar o GOOGLEJSON OAuthJWTCertType. As chaves JSON do Google contêm uma cópia da conta do emissor.

OAuthJWTSubject

O assunto do usuário para o qual o aplicativo está solicitando acesso delegado.

Tipo de Dados

string

Valor Padrão

""

Observações

O assunto do usuário para o qual o aplicativo está solicitando acesso delegado. Normalmente, o nome da conta do usuário ou endereço de e-mail.

SSL

Esta seção fornece uma lista completa de propriedades SSL que você pode configurar.

Propriedade Descrição
SSLServerCert O certificado a ser aceito do servidor ao conectar usando TLS/SSL.

SSLServerCert

O certificado a ser aceito do servidor ao conectar usando TLS/SSL.

Tipo de Dados

string

Valor Padrão

""

Observações

Se estiver usando uma conexão TLS/SSL, esta propriedade pode ser usada para especificar o certificado TLS/SSL a ser aceito do servidor. Qualquer outro certificado que não seja confiável para a máquina é rejeitado.

Esta propriedade pode assumir as seguintes formas:

Descrição Exemplo
Um certificado PEM completo (exemplo abreviado para concisão) -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
Um caminho para um arquivo local contendo o certificado C:\cert.cer
A chave pública (exemplo abreviado para concisão) -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
O Thumbprint MD5 (os valores hexadecimais também podem ser separados por espaço ou dois-pontos) ecadbdda5a1529c58a1e9e09828d70e4
A impressão digital SHA1 (os valores hexadecimais também podem ser separados por espaço ou dois-pontos) 34a929226ae0819f2ec14b4a3d904f801cbb150d

Se não for especificado, qualquer certificado confiável pela máquina será aceito.

Os certificados são validados como confiáveis pela máquina com base no armazenamento confiável do sistema. O armazenamento confiável usado é o valor 'javax.net.ssl.trustStore' especificado para o sistema. Se nenhum valor for especificado para esta propriedade, o armazenamento confiável padrão do Java será usado (por exemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar a aceitação de todos os certificados. Observe que isso não é recomendado devido a questões de segurança.

Esquema

Esta seção fornece uma lista completa de propriedades de esquema que você pode configurar.

Propriedade Descrição
Location Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados.
BrowsableSchemas Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC.
Tables Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tables=TableA, TableB, TableC.
Views Restringe as exibições relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA, ViewB, ViewC.

Localização

Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados.

Tipo de Dados

string

Valor Padrão

"%APPDATA%\\\GoogleAds Data Provider\\Schema"

Observações

O caminho para um diretório que contém os arquivos de esquema para o conector (arquivos .rsd para tabelas e exibições, arquivos .rsb para procedimentos armazenados). A localização da pasta pode ser um caminho relativo a partir da localização do executável. O Location a propriedade só é necessária se você quiser personalizar definições (por exemplo, alterar um nome de coluna, ignorar uma coluna e assim por diante) ou estender o modelo de dados com novas tabelas, exibições ou procedimentos armazenados.

Observação: Como esse conector oferece suporte a vários esquemas, a estrutura dos arquivos de esquema personalizados do Google Ads é a seguinte:

  • Cada esquema recebe uma pasta correspondente a esse nome de esquema.
  • Essas pastas de esquema estão contidas em uma pasta pai.
  • O parent folder deve ser definido como Location, não a pasta de um esquema individual.

Se não for especificado, o local padrão é "%APPDATA%\\GoogleAds Data Provider\Schema" com %APPDATA% sendo definido para o diretório de configuração do usuário:

Plataforma %APPDATA%
Windows O valor da variável de ambiente APPDATA
Mac ~/Biblioteca/Suporte de aplicativos
Linux ~/.config

Esquemas Navegáveis

Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Dados

string

Valor Padrão

""

Observações

Listar os esquemas de bancos de dados pode ser caro. Fornecer uma lista de esquemas na string de conexão melhora o desempenho.

Tabelas

Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tabelas=TabelaA,TabelaB,TabelaC.

Tipo de Dados

string

Valor Padrão

""

Observações

Listar as tabelas de alguns bancos de dados pode ser caro. Fornecer uma lista de tabelas na string de conexão melhora o desempenho do conector.

Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitas para trabalhar.

Especifique as tabelas que deseja em uma lista separada por vírgulas. Cada tabela deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.

Visualizações

Restringe as visualizações relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA,ViewB,ViewC.

Tipo de Dados

string

Valor Padrão

""

Observações

Listar as exibições de alguns bancos de dados pode ser caro. Fornecer uma lista de exibições na string de conexão melhora o desempenho do conector.

Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitas para trabalhar.

Especifique as exibições desejadas em uma lista separada por vírgulas. Cada exibição deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.

Diversos

Esta seção fornece uma lista completa de diversas propriedades que você pode configurar.

Propriedade Descrição
IncludeZeroImpressions Se deve ou não incluir ou excluir zero impressões nos relatórios.
MaxRows Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.
Other Essas propriedades ocultas são usadas apenas em casos de uso específicos.
PseudoColumns Esta propriedade indica se deve ou não incluir pseudocolunas como colunas na tabela.
QueryPassthrough Essa opção passa a consultar para o servidor do Google Ads como está.
RecurseChildren Defina como falso se quiser evitar a recorrência de IDs de cliente para obter a hierarquia completa da tabela CustomerClientLink nos esquemas do googleads.
Timeout O valor em segundos até que o erro de timeout seja lançado, cancelando a operação.

IncluirZeroImpressões

Se deve ou não incluir ou excluir zero impressões nos relatórios.

Tipo de Dados

bool

Valor Padrão

false

Observações

Se deve ou não incluir ou excluir zero impressões nos relatórios.

MaxRows

Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.

Tipo de Dados

int

Valor Padrão

-1

Observações

Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.

Outro

Essas propriedades ocultas são usadas apenas em casos de uso específicos.

Tipo de Dados

string

Valor Padrão

""

Observações

As propriedades listadas abaixo estão disponíveis para casos de uso específicos. Os casos de uso e a funcionalidade normais do driver não devem exigir essas propriedades.

Especifique várias propriedades em uma lista separada por ponto e vírgula.

Integração e Formatação
Propriedade Descrição
DefaultColumnSize Define o comprimento padrão dos campos de string quando a fonte de dados não fornece o comprimento da coluna nos metadados. O valor padrão é 2000. Voltar para o início
ConvertDateTimeToGMT Determina se os valores de data e hora devem ser convertidos em GMT, em vez da hora local da máquina.
RecordToFile=filename Registra a transferência de dados do soquete subjacente para o arquivo especificado.

Pseudocolunas

Esta propriedade indica se deve ou não incluir pseudocolunas como colunas na tabela.

Tipo de Dados

string

Valor Padrão

""

Observações

Essa configuração é particularmente útil no Entity Framework, que não permite definir um valor para uma pseudocoluna, a menos que seja uma coluna de tabela. O valor dessa configuração de conexão está no formato "Table1=Column1, Table1=Column2, Table2=Column3". Você pode usar o caractere "*" para incluir todas as tabelas e todas as colunas; por exemplo, "*=*".

QueryPassthrough

Essa opção passa a consultar para o servidor do Google Ads como está.

Tipo de Dados

bool

Valor Padrão

false

Observações

Quando isso é definido, as consultas são transmitidas diretamente ao Google Ads.

RecurseChildren

Defina como falso se quiser evitar a recorrência de IDs de cliente para obter a hierarquia completa da tabela CustomerClientLink nos esquemas do googleads.

Tipo de Dados

bool

Valor Padrão

true

Observações

Defina como falso se quiser evitar a recorrência de IDs de cliente para obter a hierarquia completa da tabela CustomerClientLink nos esquemas do googleads.

Tempo Esgotado

O valor em segundos até que o erro de timeout seja lançado, cancelando a operação.

Tipo de Dados

int

Valor Padrão

60

Observações

Se Timeout = 0, as operações não expiram. As operações são executadas até serem concluídas com êxito ou até encontrarem uma condição de erro.

Se Timeout expira e a operação ainda não está concluída, o conector lança uma exceção.