ConversionAction

Uma ação de conversão.

Representação JSON 
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
Campos
resourceName

string

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 seguinte formato:

customers/{customerId}/conversionActions/{conversionActionId}
status

enum (ConversionActionStatus)

É o status desta ação de conversão para acúmulo de eventos de conversão.
type

enum (ConversionActionType)

Imutável. O tipo dessa ação de conversão.
origin

enum (ConversionOrigin)

Apenas saída. A origem da conversão desta ação.
category

enum (ConversionActionCategory)

A categoria de conversões informada para essa ação.
valueSettings

object (ValueSettings)

Configurações relacionadas ao valor dos eventos de conversão associados a essa ação de conversão.
countingType

enum (ConversionActionCountingType)

Como contar eventos de conversão para a ação de conversão.
attributionModelSettings

object (AttributionModelSettings)

Configurações relacionadas ao modelo de atribuição da ação de conversão.
tagSnippets[]

object (TagSnippet)

Apenas saída. Os snippets usados para acompanhar conversões.
mobileAppVendor

enum (MobileAppVendor)

Apenas saída. Fornecedor de apps para dispositivos móveis de uma ação de conversão de app.
firebaseSettings

object (FirebaseSettings)

Apenas saída. Configurações do Firebase para tipos de conversão do Firebase.
thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

Apenas saída. Configurações da Análise de apps de terceiros para tipos de conversão de terceiros.
googleAnalytics4Settings

object (GoogleAnalytics4Settings)

Apenas saída. Configurações do Google Analytics 4 para tipos de conversão do Google Analytics 4.
id

string (int64 format)

Apenas saída. O ID da ação de conversão.
name

string

Nome da ação de conversão.

Este campo é obrigatório e não deve ficar em branco ao criar novas ações de conversão.
primaryForGoal

boolean

Se o bit primaryForGoal de uma ação de conversão for falso, ela não poderá ser usada em lances para todas as campanhas, independente da meta de conversão do cliente ou da campanha. No entanto, as metas de conversão personalizadas não respeitam a primaryForGoal. Portanto, se uma campanha tiver uma meta de conversão personalizada configurada com uma ação de conversão primaryForGoal = false, essa ação de conversão ainda poderá receber lances. Por padrão, primaryForGoal será "true" se não for definido. Na V9, o atributo primaryForGoal só pode ser definido como "false" após a criação por uma operação de "update" porque ele não é declarado como opcional.
ownerCustomer

string

Apenas saída. O nome do recurso do cliente proprietário da ação de conversão ou nulo se for uma ação de conversão definida pelo sistema.
includeInConversionsMetric

boolean

Se essa ação de conversão precisa ser incluída na métrica "conversões".
clickThroughLookbackWindowDays

string (int64 format)

É o número máximo de dias que pode transcorrer entre uma interação (por exemplo, um clique) e um evento de conversão.
viewThroughLookbackWindowDays

string (int64 format)

O número máximo de dias que pode decorrer entre uma impressão e uma conversão sem interação.
phoneCallDurationSeconds

string (int64 format)

A duração da chamada em segundos após a qual uma conversão precisa ser informada para essa ação de conversão.

O valor precisa estar entre 0 e 10.000, inclusive.
appId

string

ID do app para uma ação de conversão de app.

ConversionActionStatus

Status possíveis de uma ação de conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED As conversões serão registradas.
REMOVED As conversões não serão registradas.
HIDDEN As conversões não serão registradas, e a ação de conversão não vai aparecer na interface.

ConversionActionType

Possíveis tipos de uma ação de conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
AD_CALL Conversões que ocorrem quando um usuário clica na extensão de chamada de um anúncio.
CLICK_TO_CALL Conversões que ocorrem quando um usuário em um dispositivo móvel clica em um número de telefone.
GOOGLE_PLAY_DOWNLOAD Conversões que ocorrem quando um usuário faz o download de um app para dispositivos móveis na Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Conversões que ocorrem quando um usuário faz uma compra em um app usando o faturamento do Android.
UPLOAD_CALLS As conversões de chamada que são acompanhadas pelo anunciante e enviadas.
UPLOAD_CLICKS Conversões que são acompanhadas pelo anunciante e enviadas com cliques atribuídos.
WEBPAGE Conversões que ocorrem em uma página da Web.
WEBSITE_CALL Conversões que ocorrem quando um usuário liga para um número de telefone gerado dinamicamente no site de um anunciante.
STORE_SALES_DIRECT_UPLOAD Conversão de vendas na loja com base em uploads de dados próprios ou de terceiros. Somente os clientes na lista de permissões podem usar os tipos de upload direto de vendas na loja.
STORE_SALES Conversão de vendas na loja com base em uploads de dados próprios ou de terceiros e/ou em compras na loja usando cartões de redes de pagamento. Somente os clientes na lista de permissões podem usar os tipos de vendas na loja. Somente leitura.
FIREBASE_ANDROID_FIRST_OPEN Conversões de primeiro acesso do app Android rastreadas pelo Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Conversões de compras no app de apps Android acompanhadas pelo Firebase.
FIREBASE_ANDROID_CUSTOM Conversões personalizadas de apps Android acompanhadas pelo Firebase.
FIREBASE_IOS_FIRST_OPEN Conversões de primeiro acesso do app iOS acompanhadas pelo Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Conversões de compras no app de iOS rastreadas pelo Firebase.
FIREBASE_IOS_CUSTOM Conversões personalizadas de apps para iOS acompanhadas pelo Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversões de primeiro acesso de apps Android acompanhadas pela análise de apps de terceiros.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversões de compras no app Android acompanhadas pela análise de apps de terceiros.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Conversões personalizadas de apps Android rastreadas pela análise de apps de terceiros.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversões de primeiro acesso de apps iOS rastreadas pela análise de apps de terceiros.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversões de compras no app iOS rastreadas pela análise de apps de terceiros.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Conversões personalizadas de apps para iOS rastreadas pela análise de apps de terceiros.
ANDROID_APP_PRE_REGISTRATION Conversões que ocorrem quando um usuário faz o pré-registro de um app para dispositivos móveis na Google Play Store. Somente leitura.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversões que acompanham todos os downloads do Google Play que não são acompanhados por um tipo específico do app. Somente leitura.
FLOODLIGHT_ACTION Atividade do Floodlight que conta o número de vezes que os usuários visitaram uma página da Web específica após ver ou clicar em um dos anúncios de um anunciante. Somente leitura.
FLOODLIGHT_TRANSACTION Atividade do Floodlight que rastreia o número de vendas realizadas ou o número de itens comprados. Também é possível capturar o valor total de cada venda. Somente leitura.
GOOGLE_HOSTED Conversões que rastreiam ações locais dos produtos e serviços do Google depois de interagir com um anúncio. Somente leitura.
LEAD_FORM_SUBMIT Conversões informadas quando um usuário envia um formulário de lead. Somente leitura.
SALESFORCE

Descontinuado: a integração do Salesforce vai ser desativada e substituída por uma maneira melhor de importar suas conversões do Salesforce. - Consulte https://support.google.com/google-ads/answer/14728349
SEARCH_ADS_360 Conversões importadas dos dados do Floodlight do Search Ads 360. Somente leitura.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL As conversões de chamada que ocorrem em anúncios de campanhas inteligentes sem a configuração do acompanhamento de chamadas usando critérios personalizados. Somente leitura.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL O usuário clica em um elemento de chamada no Google Maps. Apenas para campanhas inteligentes. Somente leitura.
SMART_CAMPAIGN_MAP_DIRECTIONS O usuário solicita rotas para um local da empresa no Google Maps. Apenas para campanhas inteligentes. Somente leitura.
SMART_CAMPAIGN_TRACKED_CALLS As conversões de chamada que ocorrem em anúncios de campanhas inteligentes com configuração de acompanhamento de chamadas usando critérios personalizados. Somente leitura.
STORE_VISITS Conversões que ocorrem quando um usuário visita a loja de varejo de um anunciante. Somente leitura.
WEBPAGE_CODELESS Conversões criadas a partir de eventos do site (como envios de formulários ou carregamentos de página) que não usam snippets de eventos codificados individualmente. Somente leitura.
UNIVERSAL_ANALYTICS_GOAL Conversões provenientes de metas vinculadas do Universal Analytics.
UNIVERSAL_ANALYTICS_TRANSACTION Conversões que vêm de transações vinculadas do Universal Analytics.
GOOGLE_ANALYTICS_4_CUSTOM Conversões que vêm de eventos personalizados vinculados do Google Analytics 4.
GOOGLE_ANALYTICS_4_PURCHASE Conversões que vêm das conversões de compra vinculadas do Google Analytics 4.

ValueSettings

Configurações relacionadas ao valor dos eventos de conversão associados a essa ação de conversão.

Representação JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Campos
defaultValue

number

O valor a ser usado quando os eventos de conversão dessa ação forem enviados com um valor inválido, não permitido ou ausente ou quando essa ação de conversão estiver configurada para sempre usar o valor padrão.
defaultCurrencyCode

string

O código da moeda a ser usado quando os eventos de conversão dessa ação forem enviados com um código de moeda inválido ou ausente ou quando essa ação de conversão estiver configurada para sempre usar o valor padrão.
alwaysUseDefaultValue

boolean

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 nos eventos de conversão para essa ação de conversão.

ConversionActionCountingType

Indica como as conversões dessa ação vão ser contabilizadas. Para mais informações, acesse https://support.google.com/google-ads/answer/3438531.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ONE_PER_CLICK Contabilize apenas uma conversão por clique.
MANY_PER_CLICK Contabilize todas as conversões por clique.

AttributionModelSettings

Configurações relacionadas ao modelo de atribuição da ação de conversão.

Representação JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Campos
attributionModel

enum (AttributionModel)

O tipo de modelo de atribuição dessa ação de conversão.
dataDrivenModelStatus

enum (DataDrivenModelStatus)

Apenas saída. O status do modelo de atribuição baseada em dados para a ação de conversão.

AttributionModel

O modelo de atribuição que descreve como distribuir o crédito de uma conversão específica entre muitas interações anteriores.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
EXTERNAL Usa atribuição externa.
GOOGLE_ADS_LAST_CLICK Atribui todo o crédito de uma conversão ao último clique.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Atribui todo o crédito de uma conversão ao primeiro clique usando a atribuição da Pesquisa Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Atribui o crédito de uma conversão igualmente a todos os cliques usando a atribuição da Pesquisa Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Atribui mais crédito exponencialmente para uma conversão aos cliques mais recentes usando a atribuição da Pesquisa Google (metade da vida útil é de uma semana).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Atribui 40% do crédito de uma conversão ao primeiro e ao último clique. Os 20% restantes são distribuídos de maneira uniforme entre todos os outros cliques. Essa opção usa a atribuição da Pesquisa Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Modelo flexível que usa o aprendizado de máquina para determinar a distribuição adequada de crédito entre os cliques usando a atribuição da Pesquisa Google.

DataDrivenModelStatus

Enumera os status do modelo baseado em dados.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
AVAILABLE O modelo baseado em dados está disponível.
STALE O modelo baseado em dados está desatualizado. Ele não foi atualizado há pelo menos sete dias. Ele ainda está em uso, mas vai expirar se não for atualizado em 30 dias.
EXPIRED O modelo baseado em dados expirou. Ele não foi atualizado há pelo menos 30 dias e não pode ser usado. Na maioria das vezes, isso acontece porque não houve o número necessário de eventos em um período recente de 30 dias.
NEVER_GENERATED O modelo orientado a dados nunca foi gerado. Isso geralmente acontece porque nunca houve o número necessário de eventos em um período de 30 dias.

FirebaseSettings

Configurações relacionadas a uma ação de conversão do Firebase.

Representação JSON 
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
Campos
propertyId

string (int64 format)

Apenas saída. O ID da propriedade do GA da conversão.
propertyName

string

Apenas saída. O nome da propriedade do Google Analytics da conversão.
eventName

string

Apenas saída. O nome do evento de uma conversão do Firebase.
projectId

string

Apenas saída. O ID do projeto do Firebase da conversão.

ThirdPartyAppAnalyticsSettings

Configurações relacionadas a uma ação de conversão de análise de apps de terceiros.

Representação JSON 
{
  "providerName": string,
  "eventName": string
}
Campos
providerName

string

Apenas saída. Nome do provedor de análise de apps de terceiros.
eventName

string

Apenas saída. O nome do evento de uma conversão de análise de apps de terceiros.

GoogleAnalytics4Settings

Configurações relacionadas a uma ação de conversão do Google Analytics 4.

Representação JSON 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
Campos
eventName

string

Apenas saída. O nome do evento do GA4.
propertyName

string

Apenas saída. O nome da propriedade do GA4.
propertyId

string (int64 format)

Apenas saída. O ID da propriedade do GA4.