- Representação JSON
- CampaignPrimaryStatus
- CampaignPrimaryStatusReason
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- LocalServicesCampaignSettings
- CategoryBid
- TravelCampaignSettings
- DiscoveryCampaignSettings
- RealTimeBiddingSetting
- NetworkSettings
- HotelSettingInfo
- DynamicSearchAdsSetting
- ShoppingSetting
- AudienceSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- LocalCampaignSetting
- LocationSourceType
- AppCampaignSetting
- AppCampaignBiddingStrategyGoalType
- AppCampaignAppStore
- CampaignExperimentType
- FrequencyCapEntry
- FrequencyCapKey
- FrequencyCapLevel
- FrequencyCapEventType
- VanityPharma (link em inglês)
- VanityPharmaDisplayUrlMode
- VanityPharmaText
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- PaymentMode
- PerformanceMaxUpgrade
- PerformanceMaxUpgradeStatus
- ListingType
- AssetAutomationSetting
- AssetAutomationType
- AssetAutomationStatus
- Comissão
- ManualCpa
- ManualCpc
- ManualCpm
- ManualCpv
- PercentCpc
- TargetCpm
- TargetCpmTargetFrequencyGoal
Uma campanha.
Representação JSON |
---|
{ "resourceName": string, "primaryStatus": enum ( |
Campos | |
---|---|
resourceName |
Imutável. O nome do recurso da campanha. Os nomes dos recursos da campanha têm o seguinte formato:
|
primaryStatus |
Apenas saída. O status principal da campanha. Fornece insights sobre por que uma campanha não está sendo veiculada ou não está sendo veiculada de maneira ideal. A modificação na campanha e nas entidades relacionadas pode levar algum tempo para ser refletida nesse status. |
primaryStatusReasons[] |
Apenas saída. Os principais motivos do status da campanha. Fornece insights sobre por que uma campanha não está sendo veiculada ou não está sendo veiculada de maneira ideal. Esses motivos são agregados para determinar um CampaignPrimaryStatus geral. |
status |
É o status da campanha. Quando uma nova campanha é adicionada, o status é ATIVADO. |
servingStatus |
Apenas saída. O status de veiculação de anúncios da campanha. |
biddingStrategySystemStatus |
Apenas saída. O status do sistema da estratégia de lances da campanha. |
adServingOptimizationStatus |
O status de otimização da veiculação de anúncios da campanha. |
advertisingChannelType |
Imutável. É a principal meta de veiculação de anúncios na campanha. As opções de segmentação podem ser refinadas em Este campo é obrigatório e não deve ficar vazio ao criar novas campanhas. Pode ser definido apenas ao criar campanhas. Depois que a campanha é criada, o campo não pode ser alterado. |
advertisingChannelSubType |
Imutável. Refinamento opcional para Pode ser definido apenas ao criar campanhas. Depois que a campanha é criada, o campo não pode ser alterado. |
urlCustomParameters[] |
A lista de mapeamentos usados para substituir tags de parâmetros personalizados em um |
localServicesCampaignSettings |
As configurações relacionadas à campanha dos Serviços Locais. |
travelCampaignSettings |
Configurações da campanha de viagens. |
discoveryCampaignSettings |
Configurações da campanha Discovery. |
realTimeBiddingSetting |
Configurações para lances em tempo real, um recurso disponível somente para campanhas que segmentam a rede do Ad Exchange. |
networkSettings |
As configurações de rede da campanha. |
hotelSetting |
Imutável. A configuração do hotel para a campanha. |
dynamicSearchAdsSetting |
Configuração para controlar os anúncios dinâmicos de pesquisa (DSA). |
shoppingSetting |
A configuração para controlar as campanhas do Shopping. |
targetingSetting |
Configuração para recursos relacionados à segmentação. |
geoTargetTypeSetting |
A configuração da segmentação geográfica dos anúncios. |
localCampaignSetting |
A configuração da campanha local. |
appCampaignSetting |
A configuração relacionada à campanha para apps. |
labels[] |
Apenas saída. Os nomes dos recursos dos rótulos anexados a esta campanha. |
experimentType |
Apenas saída. Tipo de campanha: normal, rascunho ou experimental. |
biddingStrategyType |
Apenas saída. É o tipo de estratégia de lances. Para criar uma estratégia de lances, defina o esquema de lances para criar uma estratégia de lances padrão ou o campo Este campo é somente leitura. |
accessibleBiddingStrategy |
Apenas saída. Nome do recurso de AccessibleBiddingStrategy, uma visualização somente leitura dos atributos irrestritos da estratégia de lances de portfólio anexada, identificada por "biddingStrategy". Vazio se a campanha não usa uma estratégia de portfólio. Os atributos de estratégia irrestritos ficam disponíveis para todos os clientes com quem a estratégia é compartilhada e são lidos no recurso AccessibleBiddingStrategy. Por outro lado, os atributos restritos só estão disponíveis para o cliente proprietário da estratégia e os gerentes dele. Os atributos restritos só podem ser lidos no recurso BiddingStrategy. |
frequencyCaps[] |
Uma lista que limita a frequência com que cada usuário verá os anúncios dessa campanha. |
videoBrandSafetySuitability |
Apenas saída. Configuração de brand safety no nível da campanha individual. Permite selecionar um tipo de inventário para mostrar os anúncios em conteúdo adequado à sua marca. Consulte https://support.google.com/google-ads/answer/7515513. |
vanityPharma |
Descreve como os anúncios de produtos farmacêuticos sem marca serão exibidos. |
selectiveOptimization |
Configuração de otimização seletiva para esta campanha, que inclui um conjunto de ações de conversão para otimização dela. Esse recurso só se aplica a campanhas para apps que usam MULTI_CHANNEL como AdvertisingChannelType e APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType. |
optimizationGoalSetting |
Configuração da meta de otimização para esta campanha, que inclui um conjunto de tipos de meta de otimização. |
trackingSetting |
Apenas saída. Configurações no nível da campanha para informações de acompanhamento. |
paymentMode |
Forma de pagamento da campanha. |
excludedParentAssetFieldTypes[] |
Os tipos de campo de recurso que devem ser excluídos dessa campanha. As vinculações de recursos com esses tipos de campo não serão herdadas do nível superior por essa campanha. |
excludedParentAssetSetTypes[] |
Os tipos de conjunto de recursos que devem ser excluídos dessa campanha. As vinculações de grupos de recursos com esses tipos não serão herdadas do nível superior por essa campanha. Os tipos de grupos por locais (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP e STATIC_LOCATION_GROUP) são tipos secundários de LOCATION_SYNC. Portanto, se LOCATION_SYNC estiver definido para esse campo, nenhum conjunto de recursos do grupo de locais poderá ser vinculado a essa campanha, e as extensões de local (LE) e as extensões de local de afiliado (ALE, na sigla em inglês) não serão veiculadas nessa campanha. No momento, apenas LOCATION_SYNC é compatível. |
performanceMaxUpgrade |
Apenas saída. Informações sobre as campanhas que estão sendo atualizadas para Performance Max. |
assetAutomationSettings[] |
Contém o status de ativação/desativação de cada AssetAutomationType. Consulte a documentação de cada tipo enumerado de automação de recursos para conferir o comportamento padrão de ativação/desativação. |
id |
Apenas saída. O ID da campanha. |
name |
O nome da campanha. Este campo é obrigatório e não deve ficar vazio ao criar novas campanhas. Ele não pode conter nenhum caractere nulo (ponto de código 0x0), feed de linha NL (ponto de código 0xA) nem retorno de carro (ponto de código 0xD). |
trackingUrlTemplate |
O modelo de URL para criar um URL de rastreamento. |
audienceSetting |
Imutável. Configuração para recursos relacionados ao público-alvo. |
baseCampaign |
Apenas saída. O nome do recurso da campanha base de uma campanha de rascunho ou experimental. Para campanhas de base, ele é igual a Este campo é somente leitura. |
campaignBudget |
O orçamento da campanha. |
startDate |
A data em que a campanha começou a ser veiculada no fuso horário do cliente no formato AAAA-MM-DD. |
campaignGroup |
O grupo a que esta campanha pertence. |
endDate |
O último dia da campanha no fuso horário da veiculação no formato AAAA-MM-DD. Na criação, o padrão é 2037-12-30, ou seja, a campanha será exibida indefinidamente. Para definir que uma campanha existente seja exibida indefinidamente, defina esse campo para 2037-12-30. |
finalUrlSuffix |
Sufixo usado para anexar parâmetros de consulta a páginas de destino veiculadas com acompanhamento paralelo. |
optimizationScore |
Apenas saída. Pontuação de otimização da campanha. A pontuação de otimização é uma estimativa da performance de uma campanha. Ela varia de 0% (0,0) a 100% (1,0), e 100% indica que a campanha apresenta o potencial máximo. Esse 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 é somente leitura. |
urlExpansionOptOut |
Representa a desativação da expansão de URL para URLs mais segmentados. Se a opção estiver desativada (verdadeiro), somente os URLs finais no grupo de recursos ou os URLs especificados no Google Merchant Center ou nos feeds de dados da empresa do anunciante serão segmentados. Se a opção estiver ativada (falso), todo o domínio será segmentado. Esse campo só pode ser definido para campanhas Performance Max, em que o valor padrão é "falso". |
hotelPropertyAssetSet |
Imutável. O conjunto de propriedades do hotel para campanhas Performance Max para metas de turismo. |
listingType |
Imutável. Tipo de listagem dos anúncios veiculados para essa campanha. Esse campo é restrito para uso com campanhas Performance Max. |
Campo de união Precisa ser um portfólio (criado por meio do serviço BiddingStrategy) ou padrão incorporado à campanha. |
|
biddingStrategy |
Estratégia de lances de portfólio usada pela campanha. |
commission |
A comissão é uma estratégia de lances automática em que o anunciante paga uma determinada parte do valor da conversão. |
manualCpa |
Estratégia padrão de lances manuais de CPA. Estratégia de lances manuais que permite ao anunciante definir o lance por ação especificada pelo anunciante. Compatível apenas com campanhas dos Serviços Locais. |
manualCpc |
Estratégia padrão de lances manuais de CPC. Lance manual baseado em clique, no qual o usuário paga por clique. |
manualCpm |
Estratégia padrão de lances manuais de CPM. Lance manual baseado em impressão, no qual o usuário paga por mil impressões. |
manualCpv |
Uma estratégia de lances que paga um valor configurável por exibição de vídeo. |
maximizeConversions |
A estratégia de lances padrão "Maximizar conversões" que maximiza automaticamente o número de conversões dentro do seu orçamento. |
maximizeConversionValue |
A estratégia padrão "Maximizar o valor da conversão" define lances automaticamente para maximizar a receita gastando o orçamento automaticamente. |
targetCpa |
Estratégia de lances de CPA desejado padrão que define automaticamente os lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado que você definiu. |
targetImpressionShare |
Estratégia de lances de parcela de impressões desejada. Uma estratégia de lances automática que define lances para atingir uma determinada porcentagem de impressões. |
targetRoas |
A estratégia de lances de ROAS desejado padrão que maximiza automaticamente a receita, encontrando uma média de retorno do investimento em publicidade (ROAS) desejado específico. |
targetSpend |
Estratégia de lances de gasto desejado padrão que define automaticamente seus lances para conseguir o máximo de cliques possível dentro do seu orçamento. |
percentCpc |
Estratégia de lances de CPC de porcentagem padrão em que os lances são uma fração do preço anunciado para algum produto ou serviço. |
targetCpm |
Uma estratégia de lances que otimiza automaticamente o custo por mil impressões. |
CampaignPrimaryStatus
Enumeração que descreve o possível status principal da campanha. Fornece insights sobre por que uma campanha não está sendo veiculada ou não está sendo veiculada de maneira ideal. A modificação na campanha e nas entidades relacionadas pode levar algum tempo para ser refletida nesse status.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
ELIGIBLE |
A campanha está qualificada para veiculação. |
PAUSED |
O status da campanha especificado pelo usuário está pausado. |
REMOVED |
O status da campanha especificado pelo usuário é removido. |
ENDED |
O horário de término especificado pelo usuário para essa campanha já passou. |
PENDING |
A campanha pode ser veiculada no futuro. |
MISCONFIGURED |
A campanha ou as entidades associadas têm configurações incorretas definidas pelo usuário. |
LIMITED |
A campanha ou as entidades associadas são limitadas pelas configurações especificadas pelo usuário. |
LEARNING |
O sistema de lances automáticos está se ajustando de acordo com as mudanças especificadas pelo usuário na campanha ou nas entidades associadas. |
NOT_ELIGIBLE |
A campanha não está qualificada para veiculação. |
CampaignPrimaryStatusReason
Enumeração que descreve os possíveis motivos do status principal da campanha. Fornece insights sobre por que uma campanha não está sendo veiculada ou não está sendo veiculada de maneira ideal. Esses motivos são agregados para determinar o status geral principal da campanha.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
CAMPAIGN_REMOVED |
O status da campanha especificado pelo usuário é removido. |
CAMPAIGN_PAUSED |
O status da campanha especificado pelo usuário está pausado. |
CAMPAIGN_PENDING |
O horário de início especificado pelo usuário para o início desta campanha está no futuro. |
CAMPAIGN_ENDED |
O horário de término especificado pelo usuário para essa campanha já passou. |
CAMPAIGN_DRAFT |
A campanha é um rascunho. |
BIDDING_STRATEGY_MISCONFIGURED |
A estratégia de lances tem configurações incorretas pelo usuário. |
BIDDING_STRATEGY_LIMITED |
A estratégia de lances é limitada por configurações especificadas pelo usuário, como falta de dados ou algo semelhante. |
BIDDING_STRATEGY_LEARNING |
O sistema de lances automáticos está se ajustando às mudanças especificadas pelo usuário na estratégia de lances. |
BIDDING_STRATEGY_CONSTRAINED |
A campanha pode gerar um valor de conversão maior se ajustar as metas de CPA/ROAS. |
BUDGET_CONSTRAINED |
O orçamento está limitando a capacidade de veiculação da campanha. |
BUDGET_MISCONFIGURED |
O orçamento tem configurações incorretas definidas pelo usuário. |
SEARCH_VOLUME_LIMITED |
A campanha não está segmentando todas as consultas relevantes. |
AD_GROUPS_PAUSED |
Todos os status do grupo de anúncios especificados pelo usuário são pausados. |
NO_AD_GROUPS |
Não há grupos de anúncios qualificados nesta campanha. |
KEYWORDS_PAUSED |
Todos os status de palavra-chave especificados pelo usuário são pausados. |
NO_KEYWORDS |
Não há palavras-chave qualificadas nesta campanha. |
AD_GROUP_ADS_PAUSED |
Todos os status de anúncio do grupo de anúncios especificados pelo usuário estão pausados. |
NO_AD_GROUP_ADS |
Não há anúncios do grupo de anúncios qualificados nesta campanha. |
HAS_ADS_LIMITED_BY_POLICY |
Pelo menos um anúncio desta campanha está limitado pela política. |
HAS_ADS_DISAPPROVED |
Pelo menos um anúncio desta campanha foi reprovado. |
MOST_ADS_UNDER_REVIEW |
A maioria dos anúncios desta campanha está com revisão pendente. |
MISSING_LEAD_FORM_EXTENSION |
A campanha tem uma meta de formulário de lead, mas não há extensão de formulário de lead. |
MISSING_CALL_EXTENSION |
A campanha tem uma meta de chamada, e a extensão de chamada não foi incluída. |
LEAD_FORM_EXTENSION_UNDER_REVIEW |
A extensão de formulário de lead está em revisão. |
LEAD_FORM_EXTENSION_DISAPPROVED |
A extensão de lead foi reprovada. |
CALL_EXTENSION_UNDER_REVIEW |
A extensão de chamada está em análise. |
CALL_EXTENSION_DISAPPROVED |
A extensão de chamada foi reprovada. |
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA |
Não existem critérios de grupos de anúncios de aplicativos para dispositivos móveis qualificados nesta campanha. |
CAMPAIGN_GROUP_PAUSED |
O status do grupo de campanhas especificado pelo usuário é pausado. |
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED |
Os horários especificados pelo usuário para todos os orçamentos de grupo associados ao grupo de campanhas principal já passaram. |
APP_NOT_RELEASED |
O app associado a essa campanha ACi não foi lançado nos países de destino da campanha. |
APP_PARTIALLY_RELEASED |
O app associado a essa campanha ACi foi lançado parcialmente nos países de destino da campanha. |
HAS_ASSET_GROUPS_DISAPPROVED |
Pelo menos um grupo de recursos nesta campanha foi reprovado. |
HAS_ASSET_GROUPS_LIMITED_BY_POLICY |
Pelo menos um grupo de recursos nesta campanha está limitado pela política. |
MOST_ASSET_GROUPS_UNDER_REVIEW |
A maioria dos grupos de recursos desta campanha está com revisão pendente. |
NO_ASSET_GROUPS |
Não há grupos de recursos qualificados nesta campanha. |
ASSET_GROUPS_PAUSED |
Todos os grupos de recursos desta campanha estão pausados. |
CampaignStatus
Possíveis status de uma campanha.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
ENABLED |
A campanha está ativa e pode exibir anúncios. |
PAUSED |
A campanha foi pausada pelo usuário. |
REMOVED |
A campanha foi removida. |
CampaignServingStatus
Possíveis status de veiculação de uma campanha.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
SERVING |
Disponibilização. |
NONE |
Nenhum. |
ENDED |
Finalizada. |
PENDING |
Pendente. |
SUSPENDED |
Suspenso. |
BiddingStrategySystemStatus
Os possíveis status do sistema de uma BiddingStrategy.
Enums | |
---|---|
UNSPECIFIED |
Indica que um erro inesperado ocorreu, por exemplo, nenhum tipo de estratégia de lances foi encontrado ou nenhuma informação de status foi encontrada. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
ENABLED |
A estratégia de lances está ativa, e o Google AdWords não encontrou nenhum problema específico com a estratégia. |
LEARNING_NEW |
A estratégia de lances está em aprendizado porque foi criada ou reativada recentemente. |
LEARNING_SETTING_CHANGE |
A estratégia de lances está aprendendo devido a uma alteração recente na configuração. |
LEARNING_BUDGET_CHANGE |
A estratégia de lances está aprendendo devido a uma alteração recente no orçamento. |
LEARNING_COMPOSITION_CHANGE |
A estratégia de lances está aprendendo devido a uma alteração recente no número de campanhas, grupos de anúncios ou palavras-chave anexadas a ela. |
LEARNING_CONVERSION_TYPE_CHANGE |
A estratégia de lances depende dos relatórios de conversão e dos tipos de conversão que o cliente modificou recentemente e que eram relevantes para a estratégia de lances. |
LEARNING_CONVERSION_SETTING_CHANGE |
A estratégia de lances depende dos relatórios de conversão, e o cliente mudou as configurações de conversão recentemente. |
LIMITED_BY_CPC_BID_CEILING |
A estratégia de lances está limitada pelo lance máximo. |
LIMITED_BY_CPC_BID_FLOOR |
A estratégia de lances está limitada pelo lance mínimo. |
LIMITED_BY_DATA |
A estratégia de lances está limitada porque não houve tráfego de conversão suficiente nas últimas semanas. |
LIMITED_BY_BUDGET |
Uma fração significativa das palavras-chave nesta estratégia de lances está limitada pelo orçamento. |
LIMITED_BY_LOW_PRIORITY_SPEND |
A estratégia de lances não pode alcançar o gasto desejado porque a prioridade do gasto foi removida. |
LIMITED_BY_LOW_QUALITY |
Uma fração significativa das palavras-chave nesta estratégia de lances tem um Índice de qualidade baixo. |
LIMITED_BY_INVENTORY |
A estratégia de lances não pode gastar todo o orçamento devido à segmentação restrita. |
MISCONFIGURED_ZERO_ELIGIBILITY |
Não há acompanhamento de conversões (não há pings) e/ou listas de remarketing para as CISs. |
MISCONFIGURED_CONVERSION_TYPES |
A estratégia de lances depende dos relatórios de conversão, e o cliente não tem tipos de conversão que possam ser informados sobre essa estratégia. |
MISCONFIGURED_CONVERSION_SETTINGS |
A estratégia de lances depende dos relatórios de conversão, e as configurações de conversão do cliente estão configuradas incorretamente. |
MISCONFIGURED_SHARED_BUDGET |
Há campanhas fora da estratégia de lances que compartilham orçamentos com as campanhas incluídas na estratégia. |
MISCONFIGURED_STRATEGY_TYPE |
A campanha tem um tipo de estratégia inválido e não está sendo veiculada. |
PAUSED |
A estratégia de lances não está ativa. Não há campanhas, palavras-chave ou grupos de anúncios ativos vinculados à estratégia de lances. ou não há orçamentos ativos associados à estratégia de lances. |
UNAVAILABLE |
No momento, essa estratégia de lances não é compatível com relatórios de status. |
MULTIPLE_LEARNING |
Havia vários status de sistema LEARNING_* para essa estratégia de lances no período em questão. |
MULTIPLE_LIMITED |
Havia vários status de sistema LIMITED_* para essa estratégia de lances durante o período em questão. |
MULTIPLE_MISCONFIGURED |
Havia vários status de sistema MISCONFIGURED_* para essa estratégia de lances durante o período em questão. |
MULTIPLE |
Havia vários status de sistema para essa estratégia de lances durante o período em questão. |
AdServingOptimizationStatus
Enumeração que descreve possíveis status de exibição.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
OPTIMIZE |
A veiculação do anúncio é otimizada com base na CTR da campanha. |
CONVERSION_OPTIMIZE |
A veiculação do anúncio é otimizada com base na CTR * conversão da campanha. Se a campanha não estiver na estratégia de lances do otimizador de conversões, o padrão será OTIMIZADO. |
ROTATE |
Os anúncios são alternados de maneira uniforme por 90 dias e depois otimizados para cliques. |
ROTATE_INDEFINITELY |
Exiba anúncios de menor desempenho de forma mais uniforme com anúncios de melhor desempenho e não otimize. |
UNAVAILABLE |
O status de otimização do serviço de anúncios não está disponível. |
LocalServicesCampaignSettings
Configurações do sub-recurso LocalServicesCampaign.
Representação JSON |
---|
{
"categoryBids": [
{
object ( |
Campos | |
---|---|
categoryBids[] |
Lances no nível categórico associados à estratégia de lances MANUAL_CPA. |
CategoryBid
Lances de categoria em LocalServicesReportingCampaignSettings.
Representação JSON |
---|
{ "categoryId": string, "manualCpaBidMicros": string } |
Campos | |
---|---|
categoryId |
Categoria à qual o lance será associado. Por exemplo, "xcat:service_area_business_encanador". |
manualCpaBidMicros |
Lance de CPA manual para a categoria. O lance precisa ser maior que o preço de reserva associado à categoria em questão. O valor está em micros e na moeda do anunciante. |
TravelCampaignSettings
Configurações da campanha de viagens.
Representação JSON |
---|
{ "travelAccountId": string } |
Campos | |
---|---|
travelAccountId |
Imutável. O ID da conta de viagens associado à campanha de viagens. |
DiscoveryCampaignSettings
Configurações da campanha Discovery.
Representação JSON |
---|
{ "upgradedTargeting": boolean } |
Campos | |
---|---|
upgradedTargeting |
Imutável. Especifica se esta campanha usa opções de segmentação atualizadas. Quando esse campo é definido como |
RealTimeBiddingSetting
Configurações para lances em tempo real, um recurso disponível somente para campanhas que segmentam a rede do Ad Exchange.
Representação JSON |
---|
{ "optIn": boolean } |
Campos | |
---|---|
optIn |
Indica se os lances em tempo real estão ativados na campanha. |
NetworkSettings
As configurações de rede da campanha.
Representação JSON |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean, "targetYoutube": boolean, "targetGoogleTvNetwork": boolean } |
Campos | |
---|---|
targetGoogleSearch |
Se os anúncios serão veiculados com os resultados da pesquisa do google.com.br. |
targetSearchNetwork |
Indica se os anúncios serão veiculados em sites parceiros na rede de pesquisa do Google (requer que |
targetContentNetwork |
Indica se os anúncios serão veiculados em canais específicos na Rede de Display do Google. Os canais são especificados usando o critério Canal. |
targetPartnerSearchNetwork |
Indica se os anúncios serão veiculados na rede de parceiros do Google. Esse recurso está disponível apenas para algumas contas de parceiros do Google selecionadas. |
targetYoutube |
Indica se os anúncios serão veiculados no YouTube. |
targetGoogleTvNetwork |
Indica se os anúncios serão veiculados na rede do Google TV. |
HotelSettingInfo
Configurações no nível da campanha para anúncios de hotel.
Representação JSON |
---|
{ "hotelCenterId": string } |
Campos | |
---|---|
hotelCenterId |
Imutável. A conta da Central para Hotéis vinculada. |
DynamicSearchAdsSetting
Configuração para controlar os anúncios dinâmicos de pesquisa (DSA).
Representação JSON |
---|
{ "domainName": string, "languageCode": string, "feeds": [ string ], "useSuppliedUrlsOnly": boolean } |
Campos | |
---|---|
domainName |
Obrigatório. O nome de domínio da Internet que essa configuração representa, por exemplo, "google.com" ou "www.google.com". |
languageCode |
Obrigatório. O código de idioma que especifica o idioma do domínio, por exemplo, "en". |
feeds[] |
A lista de feeds de páginas associados à campanha. |
useSuppliedUrlsOnly |
Se a campanha usa exclusivamente URLs fornecidos pelo anunciante. |
ShoppingSetting
A configuração das campanhas do Shopping. Define o universo de produtos que podem ser anunciados pela campanha e como ela interage com outras campanhas do Shopping.
Representação JSON |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "advertisingPartnerIds": [ string ], "merchantId": string, "campaignPriority": integer, "enableLocal": boolean, "disableProductFeed": boolean } |
Campos | |
---|---|
feedLabel |
Rótulo do feed dos produtos a serem incluídos na campanha. Somente um dos atributos "feedLabel" ou "salesCountry" pode ser definido. Se usado em vez de salesCountry, o campo feedLabel aceitará códigos de país no mesmo formato, por exemplo: "XX". Caso contrário, pode ser qualquer string usada para o rótulo do feed no Google Merchant Center. |
useVehicleInventory |
Imutável. Indica se o inventário de informações de veículos será segmentado. Esse campo só é compatível com campanhas inteligentes do Shopping. Para definir o inventário de informações de veículos nas campanhas Performance Max, use |
advertisingPartnerIds[] |
Imutável. Os IDs das contas de anúncios dos parceiros que cooperam na campanha. |
merchantId |
ID da conta do Merchant Center. Este campo é obrigatório para operações de criação. Esse campo não pode ser modificado nas campanhas do Shopping. |
campaignPriority |
Prioridade da campanha. As campanhas com prioridades numericamente mais altas têm precedência sobre aquelas com prioridades mais baixas. Esse campo é obrigatório para campanhas do Shopping, com valores entre 0 e 2. Esse campo é opcional para campanhas inteligentes do Shopping, mas precisa ser igual a 3, se definido. |
enableLocal |
Indica se produtos disponíveis na loja física devem ser incluídos. |
disableProductFeed |
Desative o feed de produtos opcional. No momento, esse campo só é compatível com campanhas Geração de demanda. Acesse https://support.google.com/google-ads/answer/13721750 para saber mais sobre esse recurso. |
AudienceSetting
Configurações da segmentação por público-alvo.
Representação JSON |
---|
{ "useAudienceGrouped": boolean } |
Campos | |
---|---|
useAudienceGrouped |
Imutável. Se verdadeiro, a campanha usa um recurso de público-alvo para a segmentação por público-alvo. Se for falso, a campanha poderá usar critérios de segmento de público-alvo. |
GeoTargetTypeSetting
Representa um conjunto de configurações relacionadas à segmentação geográfica dos anúncios.
Representação JSON |
---|
{ "positiveGeoTargetType": enum ( |
Campos | |
---|---|
positiveGeoTargetType |
A configuração usada para a segmentação geográfica positiva nessa campanha específica. |
negativeGeoTargetType |
A configuração usada para a segmentação geográfica negativa nessa campanha específica. |
PositiveGeoTargetType
Os possíveis tipos positivos de segmentação geográfica.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nesta versão. |
PRESENCE_OR_INTEREST |
Especifica que um anúncio será acionado se o usuário estiver nas regiões de segmentação do anunciante ou se ele demonstrar interesse nelas. |
SEARCH_INTEREST |
Especifica que um anúncio será acionado se o usuário pesquisar as regiões de segmentação do anunciante. Essa opção só pode ser usada em campanhas padrão do Shopping e de pesquisa. |
PRESENCE |
Especifica que um anúncio será acionado se o usuário estiver nas regiões de segmentação do anunciante ou regularmente. |
NegativeGeoTargetType
Os possíveis tipos de segmentação geográfica negativa.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nesta versão. |
PRESENCE_OR_INTEREST |
Especifica que um usuário não poderá ver o anúncio se estiver nos locais excluídos do anunciante ou tiver interesse neles. |
PRESENCE |
Especifica que um usuário não poderá ver o anúncio se estiver nos locais excluídos do anunciante. |
LocalCampaignSetting
Configuração para campanhas locais.
Representação JSON |
---|
{
"locationSourceType": enum ( |
Campos | |
---|---|
locationSourceType |
O tipo de origem do local para essa campanha local. |
LocationSourceType
Os tipos possíveis de uma origem de local.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
GOOGLE_MY_BUSINESS |
Locais associados ao Perfil da Empresa vinculado ao cliente. |
AFFILIATE |
Locais das lojas dos afiliados (rede). Por exemplo, locais da loja Best Buy. |
AppCampaignSetting
Configurações no nível da campanha em campanhas para apps.
Representação JSON |
---|
{ "biddingStrategyGoalType": enum ( |
Campos | |
---|---|
biddingStrategyGoalType |
Representa a meta que a estratégia de lances dessa campanha para apps precisa otimizar. |
appStore |
Imutável. A loja de aplicativos que distribui o aplicativo específico. |
appId |
Imutável. Uma string que identifica exclusivamente um aplicativo para dispositivos móveis. |
AppCampaignBiddingStrategyGoalType
Tipo de meta da campanha para apps BiddingStrategy.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST |
Tente maximizar o número de instalações de apps. O lance de CPA é o custo por instalação desejado. |
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST |
Busque maximizar o número de longo prazo de conversões no aplicativo selecionadas a partir de instalações de aplicativos. O lance de CPA é o custo por instalação desejado. |
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST |
Busque maximizar o número de longo prazo de conversões no aplicativo selecionadas a partir de instalações de aplicativos. O lance de CPA é o custo desejado por conversão no app. O CPA real pode parecer maior do que o CPA desejado a princípio, já que as conversões de longo prazo ainda não ocorreram. |
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND |
Tente maximizar o valor de todas as conversões, por exemplo, instalações + conversões no app selecionadas, atingindo ou excedendo o retorno do investimento em publicidade desejado. |
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME |
Busque maximizar o pré-registro do app. |
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST |
Tente maximizar o número de instalações do app sem o custo por instalação desejado. |
AppCampaignAppStore
Enumeração que descreve a app store da campanha para apps.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
APPLE_APP_STORE |
App Store da Apple. |
GOOGLE_APP_STORE |
Google Play |
CampaignExperimentType
Indica se essa campanha é normal, de rascunho ou experimental.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
BASE |
Esta é uma campanha comum. |
DRAFT |
Esta é uma versão de rascunho de uma campanha. Ela tem algumas modificações de uma campanha de base, mas não veicula nem acumula métricas. |
EXPERIMENT |
Esta é uma versão experimental de uma campanha. Ela tem algumas modificações de uma campanha de base, e uma porcentagem do tráfego está sendo desviada da campanha BASE para esta campanha experimental. |
FrequencyCapEntry
Uma regra que especifica o número máximo de vezes que um anúncio (ou algum conjunto de anúncios) pode ser exibido a um usuário em determinado período.
Representação JSON |
---|
{
"key": {
object ( |
Campos | |
---|---|
key |
A chave de um limite de frequência específico. Não pode haver mais de um limite de frequência com a mesma chave. |
cap |
Número máximo de eventos permitidos para esse limite durante o período. |
FrequencyCapKey
Um grupo de campos usados como chaves para um limite de frequência. Não pode haver mais de um limite de frequência com a mesma chave.
Representação JSON |
---|
{ "level": enum ( |
Campos | |
---|---|
level |
O nível no qual o limite deve ser aplicado (por exemplo, anúncio do grupo de anúncios, grupo de anúncios). O limite é aplicado a todas as entidades desse nível. |
eventType |
É o tipo de evento a que o limite se aplica (por exemplo, impressão). |
timeUnit |
Unidade de tempo em que o limite é definido (por exemplo, dia, semana). |
timeLength |
Número de unidades de tempo que o limite dura. |
FrequencyCapLevel
O nível no qual o limite deve ser aplicado (por exemplo, anúncio do grupo de anúncios, grupo de anúncios). O limite é aplicado a todos os recursos desse nível.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
AD_GROUP_AD |
O limite é aplicado no nível do anúncio do grupo de anúncios. |
AD_GROUP |
O limite é aplicado no nível do grupo de anúncios. |
CAMPAIGN |
O limite é aplicado no nível da campanha. |
FrequencyCapEventType
É o tipo de evento a que o limite se aplica (por exemplo, impressão).
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
IMPRESSION |
O limite se aplica às impressões de anúncios. |
VIDEO_VIEW |
O limite se aplica às exibições de anúncios em vídeo. |
VanityPharma
Descreve como os anúncios de produtos farmacêuticos sem marca serão exibidos.
Representação JSON |
---|
{ "vanityPharmaDisplayUrlMode": enum ( |
Campos | |
---|---|
vanityPharmaDisplayUrlMode |
O modo de exibição para URLs de produtos farmacêuticos curtos. |
vanityPharmaText |
O texto que será exibido no URL de visualização do anúncio de texto quando a descrição do website for o modo de exibição selecionado para URLs de produtos farmacêuticos. |
VanityPharmaDisplayUrlMode
Enumeração que descreve possíveis modos de exibição para URLs de produtos farmacêuticos curtos.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
MANUFACTURER_WEBSITE_URL |
Substitua o URL de produtos farmacêuticos pelo URL do site do fabricante. |
WEBSITE_DESCRIPTION |
Substitua o URL de produtos farmacêuticos pela descrição do site. |
VanityPharmaText
Enumeração que descreve o texto possível.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
PRESCRIPTION_TREATMENT_WEBSITE_EN |
Site sobre tratamentos controlados com conteúdo em inglês. |
PRESCRIPTION_TREATMENT_WEBSITE_ES |
Site sobre tratamentos controlados com conteúdo em espanhol (Sitio de tratamientos con receta). |
PRESCRIPTION_DEVICE_WEBSITE_EN |
Site sobre dispositivos controlados com conteúdo em inglês. |
PRESCRIPTION_DEVICE_WEBSITE_ES |
Site sobre dispositivos controlados com conteúdo de site em espanhol (Sitio de dispositivos con receta). |
MEDICAL_DEVICE_WEBSITE_EN |
Site sobre dispositivos médicos com conteúdo em inglês. |
MEDICAL_DEVICE_WEBSITE_ES |
Site sobre dispositivos médicos com conteúdo em espanhol (Sitio de dispositivos médicos). |
PREVENTATIVE_TREATMENT_WEBSITE_EN |
Site sobre tratamentos preventivos com conteúdo em inglês. |
PREVENTATIVE_TREATMENT_WEBSITE_ES |
Site sobre tratamentos preventivos com conteúdo em espanhol (Sitio de tratamientos preventivos). |
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN |
Site sobre contraceptivos controlados com conteúdo em inglês. |
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES |
Site sobre contraceptivos controlados com conteúdo em espanhol (Sitio de anticonceptivos con receta). |
PRESCRIPTION_VACCINE_WEBSITE_EN |
Site sobre vacinas controladas com conteúdo em inglês. |
PRESCRIPTION_VACCINE_WEBSITE_ES |
Site sobre vacinas controladas com conteúdo em espanhol (Sitio de vacunas con receta). |
SelectiveOptimization
Configuração de otimização seletiva para esta campanha, que inclui um conjunto de ações de conversão para otimização dela. Esse recurso só se aplica a campanhas para apps que usam MULTI_CHANNEL como AdvertisingChannelType e APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType.
Representação JSON |
---|
{ "conversionActions": [ string ] } |
Campos | |
---|---|
conversionActions[] |
O conjunto selecionado de ações de conversão para otimizar esta campanha. |
OptimizationGoalSetting
Configuração da meta de otimização para esta campanha, que inclui um conjunto de tipos de meta de otimização.
Representação JSON |
---|
{
"optimizationGoalTypes": [
enum ( |
Campos | |
---|---|
optimizationGoalTypes[] |
A lista de tipos de meta de otimização. |
OptimizationGoalType
O tipo de meta de otimização
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas como valor de retorno. Representa um valor desconhecido nesta versão. |
CALL_CLICKS |
Otimizar para cliques de chamada. As conversões de cliques de chamada são vezes em que as pessoas selecionaram "Ligar" para entrar em contato com uma loja depois de ver um anúncio. |
DRIVING_DIRECTIONS |
Otimizar para rotas de carro. As conversões de rotas de carro são os momentos em que as pessoas selecionaram "Como chegar" para ir a uma loja depois de visualizar um anúncio. |
APP_PRE_REGISTRATION |
Otimizar para pré-registro. As conversões de pré-registro são o número de inscrições de pré-registro para receber uma notificação quando o app for lançado. |
TrackingSetting
Configurações no nível da campanha para informações de acompanhamento.
Representação JSON |
---|
{ "trackingUrl": string } |
Campos | |
---|---|
trackingUrl |
Apenas saída. O URL usado para rastreamento dinâmico. |
PaymentMode
Enumeração que descreve possíveis modos de pagamento.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
CLICKS |
Pagamento por interação. |
CONVERSION_VALUE |
Pagamento por valor de conversão. Esse modo só é compatível com campanhas com AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION e BudgetType.DEFAULT. |
CONVERSIONS |
Pagamento por conversão. Esse modo só é compatível com campanhas com AdvertisingChannelType.DISPLAY (exceto AdvertisingChannelSubType.DISPLAY_ histórico), BiddingStrategyType.TARGET_CPA e orçamentoType.FIXED_CPA. O cliente também precisa estar qualificado para esse modo. Consulte Customer.eligibility_fail_reasons para conferir mais detalhes. |
GUEST_STAY |
Valor de pagamento por estadia do hóspede. Esse modo só é compatível com campanhas com AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION e BudgetType.DEFAULT. |
PerformanceMaxUpgrade
Informações sobre uma campanha que está sendo atualizada para Performance Max.
Representação JSON |
---|
{
"performanceMaxCampaign": string,
"preUpgradeCampaign": string,
"status": enum ( |
Campos | |
---|---|
performanceMaxCampaign |
Apenas saída. Indica para qual campanha Performance Max a campanha será atualizada. |
preUpgradeCampaign |
Apenas saída. Indica que a campanha legada foi atualizada para Performance Max. |
status |
Apenas saída. O status do upgrade de uma campanha que precisa ser atualizada para Performance Max. |
PerformanceMaxUpgradeStatus
Enumeração do status do upgrade das campanhas Performance Max para a campanha.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
UPGRADE_IN_PROGRESS |
O upgrade para uma campanha Performance Max está em andamento. |
UPGRADE_COMPLETE |
O upgrade para uma campanha Performance Max foi concluído. |
UPGRADE_FAILED |
Falha no upgrade para uma campanha Performance Max. A campanha ainda será veiculada como estava antes da tentativa de upgrade. |
UPGRADE_ELIGIBLE |
A campanha pode ser atualizada para Performance Max. |
ListingType
Possíveis tipos de listagens.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
VEHICLES |
Esta campanha veicula anúncios de veículos. |
AssetAutomationSetting
A configuração de automação de recursos contém um par de AssetAutomationType e o status de ativação/desativação da automação de recursos.
Representação JSON |
---|
{ "assetAutomationType": enum ( |
Campos | |
---|---|
assetAutomationType |
O tipo de automação de recursos que o anunciante quer ativar/desativar. |
assetAutomationStatus |
O status de ativação/desativação do tipo de automação de recursos. |
AssetAutomationType
O tipo de automação de recursos.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas como valor de retorno. Representa um valor desconhecido nesta versão. |
TEXT_ASSET_AUTOMATION |
A automação de recursos de texto inclui títulos e descrições. Por padrão, os anunciantes ativam as campanhas Performance Max e desativam a pesquisa. |
AssetAutomationStatus
O status da automação de recursos.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas como valor de retorno. Representa um valor desconhecido nesta versão. |
OPTED_IN |
Se você ativar essa opção, vai poder gerar e veicular um tipo de automação de recursos. |
OPTED_OUT |
A desativação vai interromper a geração e a veiculação de um tipo de automação de recursos. |
Comissão
A comissão é uma estratégia de lances automática em que o anunciante paga uma determinada parte do valor da conversão.
Representação JSON |
---|
{ "commissionRateMicros": string } |
Campos | |
---|---|
commissionRateMicros |
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 a esse campo como (x * 1.000.000). Por exemplo, 106.000 representa uma taxa de comissão de 0,106 (10,6%). |
ManualCpa
Esse tipo não tem campos.
Estratégia de lances manuais que permite ao anunciante definir o lance por ação especificada pelo anunciante.
ManualCpc
Lance manual baseado em clique, no qual o usuário paga por clique.
Representação JSON |
---|
{ "enhancedCpcEnabled": boolean } |
Campos | |
---|---|
enhancedCpcEnabled |
Indica se os lances devem ser otimizados com base nos dados do otimizador de conversões. |
ManualCpm
Esse tipo não tem campos.
Lance manual baseado em impressão, no qual o usuário paga por mil impressões.
ManualCpv
Esse tipo não tem campos.
Lances com base em visualizações em que o usuário paga por exibição de vídeo.
PercentCpc
Estratégia de lances em que os lances são uma fração do preço anunciado para algum produto ou serviço.
Representação JSON |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
Campos | |
---|---|
cpcBidCeilingMicros |
Limite de lance máximo que pode ser definido pela estratégia de lances. Este é um campo opcional inserido pelo anunciante e especificado em micros locais. Observação: um valor zero é interpretado da mesma maneira que ter bid_threshold indefinido. |
enhancedCpcEnabled |
Ajusta o lance para cada leilão para cima ou para baixo, dependendo da probabilidade de uma conversão. Os lances individuais podem exceder cpcBidCeilingMicros, mas o valor do lance médio de uma campanha não deve. |
TargetCpm
O CPM (custo por mil impressões) desejado é uma estratégia de lances automáticos que define lances para otimizar a performance de acordo com o CPM desejado que você definiu.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união goal . Outras informações relacionadas à meta de lances. goal pode ser apenas de um dos tipos a seguir: |
|
targetFrequencyGoal |
Detalhes da meta de lances de frequência desejada |
TargetCpmTargetFrequencyGoal
Detalhes da meta de lances de frequência desejada
Representação JSON |
---|
{
"targetCount": string,
"timeUnit": enum ( |
Campos | |
---|---|
targetCount |
A contagem de frequência desejada representa quantas vezes você quer alcançar um único usuário. |
timeUnit |
Janela de tempo que expressa o período em que você quer atingir a targetCount especificada. |