- Representação JSON
- ConversionActionStatus
- ConversionActionType
- ValueSettings
- ConversionActionCountingType
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FirebaseSettings
- ThirdPartyAppAnalyticsSettings
- GoogleAnalytics4Settings
Uma ação de conversão.
Representação JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resourceName |
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:
|
status |
É o status desta ação de conversão para acúmulo de eventos de conversão. |
type |
Imutável. O tipo dessa ação de conversão. |
origin |
Apenas saída. A origem da conversão dessa ação de conversão. |
category |
A categoria de conversões informada para essa ação de conversão. |
valueSettings |
Configurações relacionadas ao valor dos eventos de conversão associados a essa ação de conversão. |
countingType |
Como contar eventos de conversão para a ação de conversão. |
attributionModelSettings |
Configurações relacionadas ao modelo de atribuição desta ação de conversão. |
tagSnippets[] |
Apenas saída. Os snippets usados para rastrear conversões. |
mobileAppVendor |
Apenas saída. Fornecedor de app para dispositivos móveis para uma ação de conversão. |
firebaseSettings |
Apenas saída. Configurações do Firebase para tipos de conversão do Firebase. |
thirdPartyAppAnalyticsSettings |
Apenas saída. Configurações da análise de aplicativos de terceiros para tipos de conversão de terceiros. |
googleAnalytics4Settings |
Apenas saída. Configurações do Google Analytics 4 para os tipos de conversão do Google Analytics 4. |
id |
Apenas saída. O ID da ação de conversão. |
name |
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 |
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 |
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 |
Indica se essa ação de conversão deve ser incluída na métrica "conversões". |
clickThroughLookbackWindowDays |
É o número máximo de dias decorridos entre uma interação (por exemplo, um clique) e um evento de conversão. |
viewThroughLookbackWindowDays |
É o número máximo de dias decorridos entre uma impressão e uma conversão sem uma interação. |
phoneCallDurationSeconds |
É 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 |
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 |
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 |
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 |
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 ( |
Campos | |
---|---|
attributionModel |
O tipo de modelo de atribuição dessa ação de conversão. |
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 |
Apenas saída. O ID da propriedade do GA da conversão. |
propertyName |
Apenas saída. O nome da propriedade do GA da conversão. |
eventName |
Apenas saída. O nome do evento de uma conversão do Firebase. |
projectId |
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 |
Apenas saída. Nome do provedor de análise de aplicativos de terceiros. |
eventName |
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 |
Apenas saída. Nome do evento do GA4. |
propertyName |
Apenas saída. O nome da propriedade do GA4. |
propertyId |
Apenas saída. O ID da propriedade do GA4. |