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/{conversion_action_id}
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 dessa ação de conversão.
category

enum (ConversionActionCategory)

A categoria de conversões informada para essa ação de conversã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 desta ação de conversão.
tagSnippets[]

object (TagSnippet)

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

enum (MobileAppVendor)

Apenas saída. Fornecedor de app para dispositivos móveis para uma ação de conversão.
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 aplicativos de terceiros para tipos de conversão de terceiros.
googleAnalytics4Settings

object (GoogleAnalytics4Settings)

Apenas saída. Configurações do Google Analytics 4 para os 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, a ação de conversão não poderá receber lances para todas as campanhas, independentemente da meta de conversão do cliente ou da meta de conversão da campanha. No entanto, as metas de conversão personalizadas não respeitam primaryForGoal. Portanto, se uma campanha tiver uma meta de conversão personalizada configurada com uma ação de conversão primaryForGoal = "false", ela ainda poderá receber lances. Por padrão, primaryForGoal será verdadeiro se não definido. Na V9, o primaryForGoal só pode ser definido como falso após a criação por uma operação de "atualização", pois 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

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

string (int64 format)

É o número máximo de dias decorridos 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 decorridos entre uma impressão e uma conversão sem uma interação.
phoneCallDurationSeconds

string (int64 format)

É a duração da chamada em segundos após a qual uma conversão deve ser registrada para essa ação de conversão.

O valor precisa estar entre 0 e 10.000.
appId

string

ID do aplicativo 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 valor de retorno. Representa o 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 aparecerá na interface.

ConversionActionType

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o 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 Conversões de chamada que são rastreadas pelo anunciante e enviadas.
UPLOAD_CLICKS Conversões rastreadas pelo anunciante e enviadas com cliques atribuídos.
WEBPAGE Conversões que ocorrem em uma página da Web.
WEBSITE_CALL As conversões que ocorrem quando um usuário liga para um número de telefone gerado dinamicamente a partir do site de um anunciante.
STORE_SALES_DIRECT_UPLOAD Conversão de vendas na loja com base nos 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 nos uploads de dados próprios ou de terceiros de comerciantes e/ou de compras na loja com cartões de redes de pagamentos. 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 acompanhadas com o Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Conversões de compra no app Android acompanhadas com o Firebase.
FIREBASE_ANDROID_CUSTOM Conversões personalizadas de apps Android acompanhadas com o Firebase.
FIREBASE_IOS_FIRST_OPEN Conversões de primeiro acesso do app iOS acompanhadas com o Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Conversões de compra no aplicativo iOS acompanhadas pelo Firebase.
FIREBASE_IOS_CUSTOM Conversões personalizadas do app iOS acompanhadas com o Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversões de primeiro acesso do app Android acompanhadas com a análise de aplicativos de terceiros.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversões de compra no aplicativo Android acompanhadas pela análise de aplicativos de terceiros.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Conversões personalizadas de apps Android acompanhadas com a análise de aplicativos de terceiros.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversões de primeiro acesso de aplicativos iOS acompanhadas com a análise de aplicativos de terceiros.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversões de compra no aplicativo iOS acompanhadas pela análise de aplicativos de terceiros.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Conversões personalizadas do app iOS acompanhadas com a análise de aplicativos 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 feitas ou de itens comprados. Também é possível capturar o valor total de cada venda. Somente leitura.
GOOGLE_HOSTED Conversões que acompanham ações locais de produtos e serviços do Google após a interação 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 Conversões provenientes do Salesforce. Somente leitura.
SEARCH_ADS_360 Conversões importadas dos dados do Floodlight do Search Ads 360. Somente leitura.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Conversões de chamada que ocorrem em anúncios de campanhas inteligentes sem a configuração do acompanhamento de chamadas e usam critérios personalizados da campanha inteligente. Somente leitura.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL O usuário clica em um elemento de chamada no Google Maps. Apenas campanhas inteligentes. Somente leitura.
SMART_CAMPAIGN_MAP_DIRECTIONS O usuário solicita rotas até o local de uma empresa no Google Maps. Apenas campanhas inteligentes. Somente leitura.
SMART_CAMPAIGN_TRACKED_CALLS Conversões de chamada que ocorrem em anúncios da campanha inteligente com configuração de acompanhamento de chamadas usando critérios personalizados da campanha inteligente. 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 com base em eventos do site (como envios de formulário ou carregamentos de página) que não usam snippets de evento codificados individualmente. Somente leitura.
UNIVERSAL_ANALYTICS_GOAL Conversões que vêm 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 conversões de eventos personalizados do Google Analytics 4 vinculadas.
GOOGLE_ANALYTICS_4_PURCHASE Conversões que vêm de 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 para essa ação de conversão forem enviados com um valor inválido, não permitido ou ausente, ou quando essa ação de conversão estiver configurada para usar sempre o valor padrão.
defaultCurrencyCode

string

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

boolean

Controla se o valor padrão e o código da moeda padrão são usados no lugar daqueles especificados nos eventos de conversão desta ação de conversão.

ConversionActionCountingType

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o 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 desta 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 da ação de conversão.

AttributionModel

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o 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 crédito de uma conversão igualmente a todos os cliques dela usando a Atribuição da Pesquisa Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Atribui exponencialmente mais crédito para uma conversão aos cliques mais recentes usando a atribuição da Pesquisa Google (a meia-vida é de uma semana).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Atribui 40% do crédito de uma conversão aos primeiros e últimos cliques. Os 20% restantes são distribuídos uniformemente entre todos os outros cliques. Isso usa a atribuição da Pesquisa Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Modelo flexível que usa aprendizado de máquina para determinar a distribuição adequada de crédito entre 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 valor de retorno. Representa o valor desconhecido nesta versão.
AVAILABLE O modelo baseado em dados está disponível.
STALE O modelo baseado em dados está desatualizado. Ela não é atualizada há pelo menos sete dias. Ele ainda está sendo usado, mas vai expirar se não for atualizado em 30 dias.
EXPIRED O modelo baseado em dados expirou. Ela não é atualizada há pelo menos 30 dias e não pode ser usada. Geralmente, isso ocorre porque não houve o número necessário de eventos em um período recente de 30 dias.
NEVER_GENERATED O modelo baseado em dados nunca foi gerado. Geralmente, isso ocorre 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 GA 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 da análise de aplicativos de terceiros.

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

string

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

string

Apenas saída. O nome do evento de uma conversão de análise de aplicativos 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. 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.