Índice
AccessibleBiddingStrategy
(mensagem)AccessibleBiddingStrategy.MaximizeConversionValue
(mensagem)AccessibleBiddingStrategy.MaximizeConversions
(mensagem)AccessibleBiddingStrategy.TargetCpa
(mensagem)AccessibleBiddingStrategy.TargetImpressionShare
(mensagem)AccessibleBiddingStrategy.TargetRoas
(mensagem)AccessibleBiddingStrategy.TargetSpend
(mensagem)Ad
(mensagem)AdGroup
(mensagem)AdGroupAd
(mensagem)AdGroupAdLabel
(mensagem)AdGroupAsset
(mensagem)AdGroupAssetSet
(mensagem)AdGroupAudienceView
(mensagem)AdGroupBidModifier
(mensagem)AdGroupCriterion
(mensagem)AdGroupCriterion.PositionEstimates
(mensagem)AdGroupCriterion.QualityInfo
(mensagem)AdGroupCriterionLabel
(mensagem)AdGroupLabel
(mensagem)AgeRangeView
(mensagem)Asset
(mensagem)AssetGroup
(mensagem)AssetGroupAsset
(mensagem)AssetGroupAssetCombinationData
(mensagem)AssetGroupListingGroupFilter
(mensagem)AssetGroupSignal
(mensagem)AssetGroupTopCombinationView
(mensagem)AssetSet
(mensagem)AssetSetAsset
(mensagem)Audience
(mensagem)BiddingStrategy
(mensagem)Campaign
(mensagem)Campaign.DynamicSearchAdsSetting
(mensagem)Campaign.GeoTargetTypeSetting
(mensagem)Campaign.NetworkSettings
(mensagem)Campaign.OptimizationGoalSetting
(mensagem)Campaign.SelectiveOptimization
(mensagem)Campaign.ShoppingSetting
(mensagem)Campaign.TrackingSetting
(mensagem)CampaignAsset
(mensagem)CampaignAssetSet
(mensagem)CampaignAudienceView
(mensagem)CampaignBudget
(mensagem)CampaignCriterion
(mensagem)CampaignLabel
(mensagem)CartDataSalesView
(mensagem)Conversion
(mensagem)ConversionAction
(mensagem)ConversionAction.AttributionModelSettings
(mensagem)ConversionAction.FloodlightSettings
(mensagem)ConversionAction.ValueSettings
(mensagem)ConversionCustomVariable
(mensagem)ConversionCustomVariable.FloodlightConversionCustomVariableInfo
(mensagem)ConversionTrackingSetting
(mensagem)CustomColumn
(mensagem)Customer
(mensagem)CustomerAsset
(mensagem)CustomerAssetSet
(mensagem)CustomerClient
(mensagem)CustomerManagerLink
(mensagem)DoubleClickCampaignManagerSetting
(mensagem)DynamicSearchAdsSearchTermView
(mensagem)GenderView
(mensagem)GeoTargetConstant
(mensagem)KeywordView
(mensagem)Label
(mensagem)LanguageConstant
(mensagem)ListingGroupFilterDimension
(mensagem)ListingGroupFilterDimension.ProductBiddingCategory
(mensagem)ListingGroupFilterDimension.ProductBrand
(mensagem)ListingGroupFilterDimension.ProductChannel
(mensagem)ListingGroupFilterDimension.ProductCondition
(mensagem)ListingGroupFilterDimension.ProductCustomAttribute
(mensagem)ListingGroupFilterDimension.ProductItemId
(mensagem)ListingGroupFilterDimension.ProductType
(mensagem)ListingGroupFilterDimensionPath
(mensagem)LocationView
(mensagem)ProductBiddingCategoryConstant
(mensagem)ProductGroupView
(mensagem)SearchAds360Field
(mensagem)ShoppingPerformanceView
(mensagem)UserList
(mensagem)Visit
(mensagem)WebpageView
(mensagem)
AccessibleBiddingStrategy
Representa uma visualização de BiddingStrategies que pertencem e são compartilhadas com o cliente.
Em contraste com a BiddingStrategy, esse recurso inclui estratégias que pertencem aos gerentes do cliente e são compartilhadas com ele, além das estratégias que pertencem a ele. Esse recurso não fornece métricas e expõe apenas um subconjunto limitado dos atributos BiddingStrategy.
Campos | |
---|---|
resource_name |
O nome do recurso da estratégia de lances acessível. Os nomes dos recursos AccessibleBiddingStrategy têm o seguinte formato:
|
id |
O ID da estratégia de lances. |
name |
É o nome da estratégia de lances. |
type |
É o tipo de estratégia de lances. |
owner_customer_id |
O ID do cliente proprietário da estratégia de lances. |
owner_descriptive_name |
description_name do Cliente proprietário da estratégia de lances. |
Campo de união Somente um pode ser definido. |
|
maximize_conversion_value |
Uma estratégia de lances automática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível. |
maximize_conversions |
Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível. |
target_cpa |
Uma estratégia que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado estabelecido. |
target_impression_share |
Uma estratégia de lances que otimiza automaticamente para uma determinada porcentagem de impressões. |
target_roas |
Uma estratégia de lances que ajuda a maximizar a receita enquanto alcança uma média de retorno do investimento em publicidade (ROAS) desejado específico. |
target_spend |
Uma estratégia que define seus lances para conseguir o máximo de cliques possível dentro do orçamento. |
MaximizeConversionValue
Uma estratégia de lances automática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível.
Campos | |
---|---|
target_roas |
Opção de retorno do investimento em publicidade (ROAS) desejado Se definida, a estratégia de lances maximizará a receita ao calcular a média do retorno do investimento em publicidade desejado. Se o ROAS desejado for alto, talvez a estratégia de lances não gaste todo o orçamento. Se o ROAS desejado não estiver definido, a estratégia de lances tentará atingir o maior ROAS possível para o orçamento. |
MaximizeConversions
Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível.
Campos | |
---|---|
target_cpa |
A opção de custo por aquisição (CPA) desejado. Esse é o valor médio que você quer gastar por aquisição. |
target_cpa_micros |
A opção de custo por aquisição (CPA) desejado. Esse é o valor médio que você quer gastar por aquisição. |
TargetCpa
Uma estratégia de lances automática que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado estabelecido.
Campos | |
---|---|
target_cpa_micros |
Meta de CPA médio. Essa meta deve ser maior ou igual ao mínimo de unidades faturáveis baseadas na moeda da conta. |
TargetRoas
Uma estratégia de lances automáticos que ajuda a maximizar a receita enquanto alcança uma média de retorno do investimento em publicidade (ROAS) desejado específico.
Campos | |
---|---|
target_roas |
Receita escolhida (com base nos dados de conversão) por unidade de gasto. |
TargetSpend
Uma estratégia de lances automática que define seus lances para conseguir o máximo de cliques possível com o orçamento disponível.
Campos | |
---|---|
target_spend_micros |
A meta de gastos na qual maximizar os cliques. Um bidder TargetSpend tentará gastar o menor valor desse montante ou o valor de gasto de limitação natural. Se não for especificado, o orçamento será usado como a meta de gastos. Este campo foi descontinuado e não deve mais ser usado. Consulte https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html (link em inglês) para mais detalhes. |
cpc_bid_ceiling_micros |
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. |
Anúncio
Anúncio
Campos | |
---|---|
resource_name |
O nome do recurso do anúncio. Os nomes dos recursos de anúncios têm o seguinte formato:
|
final_urls[] |
A lista dos possíveis URLs finais após todos os redirecionamentos de vários domínios do anúncio. |
type |
O tipo de anúncio. |
id |
O ID do anúncio. |
display_url |
É o URL exibido na descrição de alguns formatos de anúncio. |
name |
É o nome do anúncio. Isso é usado apenas para identificar o anúncio. Ele não precisa ser único e não afeta o anúncio veiculado. No momento, o campo de nome só é compatível com DisplayUploadAd, ImageAd, ShoppingComparisonListingAd e VideoAd. |
Campo de união ad_data . Detalhes pertinentes ao tipo de anúncio. Exatamente um valor deve ser definido. ad_data só pode ser de um dos seguintes tipos: |
|
text_ad |
Detalhes relacionados a um anúncio de texto. |
expanded_text_ad |
Detalhes relacionados a um anúncio de texto expandido |
responsive_search_ad |
Detalhes relacionados a um anúncio responsivo de pesquisa |
product_ad |
Detalhes relacionados a um anúncio de produto. |
expanded_dynamic_search_ad |
Detalhes relacionados a um anúncio dinâmico expandido de pesquisa |
AdGroup
Um grupo de anúncios.
Campos | |
---|---|
resource_name |
O nome do recurso do grupo de anúncios. Os nomes dos recursos do grupo de anúncios têm o seguinte formato:
|
status |
O status do grupo de anúncios. |
type |
O tipo do grupo de anúncios. |
ad_rotation_mode |
Modo de rotação de anúncios do grupo de anúncios. |
creation_time |
O carimbo de data/hora em que o ad_group foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
targeting_setting |
Configuração para recursos relacionados à segmentação. |
labels[] |
Os nomes de recursos dos rótulos anexados a este grupo de anúncios. |
engine_id |
ID do grupo de anúncios na conta de mecanismo externo. Esse campo é somente para contas que não são do Google Ads (por exemplo, Yahoo Japan, Microsoft, Baidu etc.). Para a entidade do Google Ads, use "ad_group.id". |
start_date |
Data em que o grupo de anúncios começa a veicular anúncios. Por padrão, o grupo de anúncios começa agora ou na data de início do grupo de anúncios, o que for posterior. Se esse campo for definido, o grupo de anúncios começará no início da data especificada no fuso horário do cliente. Esse campo só está disponível para contas de gateway do Microsoft Advertising e do Facebook. Formato: AAAA-MM-DD Exemplo: 2019-03-14 |
end_date |
Data em que o grupo de anúncios termina de veicular anúncios. Por padrão, o grupo de anúncios termina na data de término do grupo de anúncios. Se esse campo for definido, o grupo de anúncios terminará no final da data especificada no fuso horário do cliente. Esse campo só está disponível para contas de gateway do Microsoft Advertising e do Facebook. Formato: AAAA-MM-DD Exemplo: 2019-03-14 |
language_code |
O idioma dos anúncios e das palavras-chave em um grupo de anúncios. Esse campo só está disponível para contas do Microsoft Advertising. Mais detalhes: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
last_modified_time |
A data e a hora em que esse grupo de anúncios foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
id |
O ID do grupo de anúncios. |
name |
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 precisa ter menos de 255 caracteres UTF-8 de largura total. 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). |
cpc_bid_micros |
É o lance máximo de CPC (custo por clique). |
engine_status |
O status do mecanismo para o grupo de anúncios. |
AdGroupAd
Um anúncio do grupo de anúncios.
Campos | |
---|---|
resource_name |
O nome do recurso do anúncio. Os nomes dos recursos de anúncios do grupo de anúncios têm o seguinte formato:
|
status |
O status do anúncio. |
ad |
O anúncio. |
creation_time |
O carimbo de data/hora em que o ad_group_ad foi criado. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
labels[] |
Os nomes dos recursos dos rótulos anexados ao anúncio do grupo de anúncios. |
engine_id |
É o ID do anúncio na conta de mecanismo externo. Esse campo é somente para contas do Search Ads 360, por exemplo, Yahoo Japan, Microsoft, Baidu etc. Para entidades que não são do Search Ads 360, use "ad_group_ad.ad.id". |
engine_status |
Status adicional do anúncio na conta de mecanismo externo. Os status possíveis (dependendo do tipo de conta externa) incluem ativa, qualificada, revisão pendente etc. |
last_modified_time |
A data e a hora em que o anúncio desse grupo de anúncios foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
AdGroupAdLabel
Uma relação entre um anúncio de grupo de anúncios e um rótulo.
Campos | |
---|---|
resource_name |
Nome do recurso do rótulo do anúncio do grupo de anúncios. Os nomes dos recursos do rótulo de anúncio do grupo de anúncios têm o seguinte formato: |
ad_group_ad |
O anúncio de grupo de anúncios ao qual o rótulo está anexado. |
label |
Rótulo atribuído ao anúncio do grupo de anúncios. |
AdGroupAsset
Um vínculo entre um grupo de anúncios e um recurso.
Campos | |
---|---|
resource_name |
O nome do recurso do grupo de anúncios. Os nomes dos recursos do grupo de anúncios têm o seguinte formato:
|
ad_group |
Obrigatório. O grupo de anúncios ao qual o recurso está vinculado. |
asset |
Obrigatório. O recurso que está vinculado ao grupo de anúncios. |
status |
Status do recurso do grupo de anúncios. |
AdGroupAssetSet
O grupo de anúncios do grupo de anúncios é o vínculo entre um grupo de anúncios e um conjunto de recursos. A criação de um adgroupAssetSet vincula um conjunto de recursos a um grupo de anúncios.
Campos | |
---|---|
resource_name |
O nome do recurso do conjunto de recursos do grupo de anúncios. Os nomes dos recursos do conjunto de recursos do grupo de anúncios têm o seguinte formato:
|
ad_group |
O grupo de anúncios ao qual esse conjunto de recursos está vinculado. |
asset_set |
O conjunto de recursos vinculado ao grupo de anúncios. |
status |
O status do conjunto de recursos do grupo de anúncios. Somente leitura. |
AdGroupAudienceView
Uma visualização do público-alvo do grupo de anúncios. Inclui dados de desempenho dos interesses e das listas de remarketing para anúncios das Redes de Display e do YouTube, além de listas de remarketing para anúncios da rede de pesquisa (RLSA), agregados no nível do público-alvo.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização do público-alvo do grupo de anúncios. Os nomes dos recursos de visualização de público-alvo do grupo de anúncios têm o seguinte formato:
|
AdGroupBidModifier
Representa um modificador de lance de grupo de anúncios.
Campos | |
---|---|
resource_name |
O nome do recurso do modificador de lance do grupo de anúncios. Os nomes dos recursos dos modificadores de lances do grupo de anúncios têm o seguinte formato:
|
bid_modifier |
O modificador do lance quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. O intervalo é de 1,0 a 6,0 para PreferredContent. Use 0 para desativar um tipo de dispositivo. |
Campo de união Obrigatório em operações de criação a partir da V5. |
|
device |
Um critério de dispositivo. |
AdGroupCriterion
Um critério de grupo de anúncios. O relatório "ad_group_criterio" retorna somente os critérios que foram explicitamente adicionados ao grupo de anúncios.
Campos | |
---|---|
resource_name |
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 seguinte formato:
|
creation_time |
A data e a hora em que esse critério do grupo de anúncios foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
status |
O status do critério. Este é o status da entidade do critério do grupo de anúncios, definido pelo cliente. Observação: os relatórios da interface do usuário 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 aparecer como ativado na IU. Por exemplo, as campanhas são exibidas por padrão para usuários de todas as faixas etárias, a menos que sejam excluídas. A interface vai mostrar cada faixa etária como "ativada", já que elas estão qualificadas para ver os anúncios. mas gclid.status mostrará "removido", já que nenhum critério positivo foi adicionado. |
quality_info |
Informações sobre a qualidade do critério. |
type |
Tipo do critério. |
labels[] |
Os nomes dos recursos dos rótulos anexados a este critério do grupo de anúncios. |
position_estimates |
Estimativas para lances de critério em várias posições. |
final_urls[] |
A lista dos possíveis URLs finais após todos os redirecionamentos de vários domínios do anúncio. |
engine_id |
ID do critério do grupo de anúncios na conta de mecanismo externo. Esse campo é somente para contas que não são do Google Ads, por exemplo, Yahoo Japan, Microsoft, Baidu etc. Para entidades do Google Ads, use "ad_group_criterion.criterion_id". |
last_modified_time |
A data e a hora em que esse critério do grupo de anúncios foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
criterion_id |
ID do critério. |
ad_group |
O grupo de anúncios ao qual o critério pertence. |
negative |
Define se o critério será segmentado ( Este campo não pode ser modificado. Para mudar um critério de positivo para negativo, remova-o e adicione-o novamente. |
bid_modifier |
O modificador do lance quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. A maioria dos tipos de critérios segmentáveis são compatíveis com modificadores. |
cpc_bid_micros |
Lance de CPC (custo por clique). |
effective_cpc_bid_micros |
O lance de CPC (custo por clique) efetivo. |
engine_status |
O status do mecanismo para o critério do grupo de anúncios. |
final_url_suffix |
Modelo de URL para anexar parâmetros ao URL final. |
tracking_url_template |
O modelo de URL para criar um URL de rastreamento. |
Campo de união Exatamente um deve ser definido. |
|
keyword |
Palavra-chave. |
listing_group |
Grupo de fichas. |
age_range |
Faixa etária. |
gender |
Sexo. |
user_list |
Lista de usuários. |
webpage |
Página da Web |
location |
Local. |
PositionEstimates
Estimativas para lances de critério em várias posições.
Campos | |
---|---|
top_of_page_cpc_micros |
A estimativa do lance de CPC necessário para que o anúncio seja exibido na parte superior da primeira página dos resultados de pesquisa. |
QualityInfo
Um contêiner para as informações de qualidade do critério do grupo de anúncios.
Campos | |
---|---|
quality_score |
Índice de qualidade. Esse campo não será preenchido se o Google não tiver informações suficientes para determinar um valor. |
AdGroupCriterionLabel
Uma relação entre um critério de grupo de anúncios e um rótulo.
Campos | |
---|---|
resource_name |
Nome do recurso do rótulo do critério do grupo de anúncios. Os nomes dos recursos do rótulo de critério do grupo de anúncios têm o seguinte formato: |
ad_group_criterion |
O critério do grupo de anúncios ao qual o rótulo está anexado. |
label |
Rótulo atribuído ao critério do grupo de anúncios. |
AdGroupLabel
Uma relação entre um grupo de anúncios e um rótulo.
Campos | |
---|---|
resource_name |
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 seguinte formato: |
ad_group |
O grupo de anúncios ao qual o rótulo está anexado. |
label |
Rótulo atribuído ao grupo de anúncios. |
AgeRangeView
Uma visualização por faixa etária.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização por faixa etária. Os nomes dos recursos de visualização de faixa etária têm o seguinte formato:
|
Recurso
O recurso é uma parte de um anúncio que pode ser compartilhado entre vários anúncios. Ele pode ser uma imagem (ImageAsset), um vídeo (YoutubeVideoAsset) etc. Os recursos são imutáveis e não podem ser removidos. Para interromper a veiculação de um recurso, remova-o da entidade que o utiliza.
Campos | |
---|---|
resource_name |
O nome do recurso. Os nomes dos recursos de recursos têm a seguinte forma:
|
type |
Tipo do recurso. |
final_urls[] |
Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios. |
status |
O status do recurso. |
creation_time |
O carimbo de data/hora em que o recurso foi criada. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
last_modified_time |
A data e a hora em que este recurso foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
id |
O ID do recurso. |
name |
Nome opcional do recurso. |
tracking_url_template |
Modelo de URL para criar um URL de rastreamento. |
engine_status |
O status do mecanismo de um recurso. |
Campo de união asset_data . O tipo específico do recurso. asset_data só pode ser de um dos seguintes tipos: |
|
youtube_video_asset |
Um recurso de vídeo do YouTube. |
image_asset |
Um recurso de imagem. |
text_asset |
Um recurso de texto. |
callout_asset |
Um recurso de frase de destaque unificado. |
sitelink_asset |
Um recurso de sitelink unificado. |
page_feed_asset |
Um recurso de feed de páginas unificado. |
mobile_app_asset |
Um recurso de link para app para dispositivos móveis. |
call_asset |
Um recurso de ligação unificado. |
call_to_action_asset |
Um recurso de call-to-action. |
location_asset |
Um recurso de local unificado. |
AssetGroup
Um grupo de recursos. AssetGroupAsset é usado para vincular um recurso ao grupo. AssetGroupSignal é usado para associar um indicador a um grupo de recursos.
Campos | |
---|---|
resource_name |
O nome do recurso do grupo. Os nomes dos recursos do grupo de recursos têm o seguinte formato:
|
id |
O ID do grupo de recursos. |
campaign |
A campanha a que esse grupo de recursos está associado. O recurso vinculado ao grupo de recursos. |
name |
Obrigatório. Nome do grupo de recursos. Obrigatório. Ele precisa ter um comprimento mínimo de 1 e máximo de 128. Ele precisa ser exclusivo em uma campanha. |
final_urls[] |
Uma lista de URLs finais após todos os redirecionamentos entre domínios. Nas campanhas Performance Max, por padrão, os URLs estão qualificados para expansão, a menos que estejam desativados. |
final_mobile_urls[] |
Uma lista de URLs finais para dispositivos móveis após todos os redirecionamentos entre domínios. Nas campanhas Performance Max, por padrão, os URLs estão qualificados para expansão, a menos que estejam desativados. |
status |
O status do grupo de recursos. |
path1 |
Primeira parte do texto que pode aparecer anexado ao URL exibido no anúncio. |
path2 |
Segunda parte do texto que pode aparecer anexada ao URL exibido no anúncio. Este campo só pode ser definido quando path1 está definido. |
ad_strength |
Qualidade geral do anúncio desse grupo de recursos. |
AssetGroupAsset
AssetGroupAsset é o vínculo entre um recurso e um grupo. Adicionar um AssetGroupAsset vincula um recurso a um grupo.
Campos | |
---|---|
resource_name |
O nome do recurso do grupo de recursos. O nome do recurso do grupo de recursos tem o seguinte formato:
|
asset_group |
O grupo de recursos a que este recurso do grupo está vinculando. |
asset |
O recurso que este recurso do grupo de recursos está vinculando. |
field_type |
A descrição da posição do recurso no grupo. Por exemplo: HEADLINE, YOUTUBE_VIDEO etc. |
status |
O status da vinculação entre um recurso e um grupo de recursos. |
AssetGroupAssetCombinationData
Dados de combinação de recursos do grupo de recursos
Campos | |
---|---|
asset_combination_served_assets[] |
Recursos veiculados. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter representa um nó da árvore de filtros do grupo de fichas em um grupo de recursos.
Campos | |
---|---|
resource_name |
O nome do recurso do filtro do grupo de produtos anunciados do grupo de recursos. O nome do recurso do filtro do grupo de produtos anunciados do grupo de recursos tem o seguinte formato:
|
asset_group |
O grupo de recursos de que esse filtro do grupo de produtos anunciados do grupo de recursos faz parte. |
id |
O ID do ListingGroupFilter. |
type |
Tipo de um nó de filtro do grupo de fichas. |
vertical |
A vertical que a árvore de nós atual representa. Todos os nós da mesma árvore precisam pertencer à mesma indústria. |
case_value |
É o valor de dimensão com que esse grupo de fichas está refinando o principal. Indefinido para o grupo raiz. |
parent_listing_group_filter |
Nome do recurso da subdivisão do grupo de fichas da empresa pai. Nulo para o nó de filtro do grupo de fichas da raiz. |
path |
O caminho das dimensões que definem o filtro do grupo de fichas. |
AssetGroupSignal
AssetGroupSignal representa um indicador em um grupo de recursos. A existência de um indicador informa à campanha Performance Max quem tem maior probabilidade de conversão. A campanha Performance Max usa o indicador para procurar novas pessoas com intenção semelhante ou maior de encontrar conversões nas redes de pesquisa, Display, vídeo e muito mais.
Campos | |
---|---|
resource_name |
O nome do recurso do indicador do grupo de recursos. O nome do recurso do indicador do grupo de recursos tem o seguinte formato:
|
asset_group |
O grupo de recursos a que esse indicador de grupo pertence. |
Campo de união signal . O indicador do grupo de recursos. signal só pode ser de um dos seguintes tipos: |
|
audience |
O indicador de público-alvo a ser usado pela campanha Performance Max. |
AssetGroupTopCombinationView
Uma visualização sobre o uso da combinação de recursos de anúncio do grupo de anúncios.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização de combinação superior do grupo de recursos. Os nomes dos recursos da visualização de principais combinações de recursos têm o seguinte formato: `"customers/{customer_id}/assetGroupTopCombineViews/{asset_group_id}~{asset_alternative_category}" |
asset_group_top_combinations[] |
As principais combinações de recursos que foram veiculados em conjunto. |
AssetSet
Um conjunto de recursos que representa uma coleção de recursos. Use AssetSetAsset para vincular um recurso ao conjunto.
Campos | |
---|---|
id |
O ID do conjunto de recursos. |
resource_name |
O nome do recurso do conjunto de recursos. Os nomes dos recursos do conjunto de recursos têm o seguinte formato:
|
AssetSetAsset
AssetSetAsset é o vínculo entre um recurso e um conjunto de recursos. Adicionar um AssetSetAsset vincula um recurso a um conjunto de recursos.
Campos | |
---|---|
resource_name |
O nome do recurso do conjunto de recursos. Os nomes dos recursos do conjunto de recursos têm o seguinte formato:
|
asset_set |
O conjunto a que o recurso está vinculado. |
asset |
O recurso a que o recurso do conjunto está vinculado. |
status |
O status do recurso do conjunto de recursos. Somente leitura. |
Público
O público-alvo é uma opção de segmentação eficiente que permite cruzar diferentes atributos de segmento, como afinidades e informações demográficas detalhadas, para criar públicos-alvo que representem seções dos segmentos.
Campos | |
---|---|
resource_name |
O nome do recurso do público-alvo. Os nomes de público-alvo têm o seguinte formato:
|
id |
ID do público-alvo. |
name |
Obrigatório. Nome do público-alvo. Ele precisa ser único para todos os públicos-alvo. Ele precisa ter comprimento mínimo de 1 e máximo de 255. |
description |
Descrição deste público-alvo. |
BiddingStrategy
Uma estratégia de lances.
Campos | |
---|---|
resource_name |
O nome do recurso da estratégia de lances. Os nomes dos recursos da estratégia de lances têm o seguinte formato:
|
status |
É o status da estratégia de lances. Este campo é somente leitura. |
type |
É o tipo de estratégia de lances. Cria uma estratégia de lances definindo o esquema de lance. Este campo é somente leitura. |
currency_code |
A moeda usada pela estratégia de lances (código ISO 4217 de três letras). No caso de estratégias de lances em clientes administradores, essa moeda pode ser definida na criação e o padrão é a moeda do cliente administrador. Para clientes de veiculação, este campo não pode ser definido. Todas as estratégias de um cliente de veiculação usam implicitamente a moeda desse cliente. Em todos os casos, o campoeffective_currency_code retorna a moeda usada pela estratégia. |
id |
O ID da estratégia de lances. |
name |
É o nome da estratégia de lances. Todas as estratégias de lances em uma conta devem ter nomes diferentes. A string precisa estar entre 1 e 255, inclusive, em bytes UTF-8 (cortados). |
effective_currency_code |
A moeda usada pela estratégia de lances (código ISO 4217 de três letras). Para estratégias de lances em clientes administradores, essa é a moeda definida pelo anunciante ao criar a estratégia. Para veiculação de clientes, este é o currency_code do cliente. As métricas da estratégia de lances são informadas nesta moeda. Este campo é somente leitura. |
campaign_count |
O número de campanhas vinculadas a essa estratégia de lances. Este campo é somente leitura. |
non_removed_campaign_count |
O número de campanhas não removidas anexadas a essa estratégia de lances. Este campo é somente leitura. |
Campo de união Somente um pode ser definido. |
|
enhanced_cpc |
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 a probabilidade é menor. |
maximize_conversion_value |
Uma estratégia de lances automática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível. |
maximize_conversions |
Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível. |
target_cpa |
Uma estratégia que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado estabelecido. |
target_impression_share |
Uma estratégia de lances que otimiza automaticamente para uma determinada porcentagem de impressões. |
target_outrank_share |
Uma estratégia que define lances com base na fração desejada de leilões em que o anunciante deve superar um concorrente específico. O uso desse campo foi descontinuado. Não será possível criar uma nova estratégia de lances com este campo ou anexar estratégias de lances com este campo a uma campanha. São permitidas modificações em estratégias que já têm esse esquema preenchido. |
target_roas |
Uma estratégia de lances que ajuda a maximizar a receita enquanto alcança uma média de retorno do investimento em publicidade (ROAS) desejado específico. |
target_spend |
Uma estratégia que define seus lances para conseguir o máximo de cliques possível dentro do orçamento. |
Campanha
Uma campanha.
Campos | |
---|---|
resource_name |
O nome do recurso da campanha. Os nomes dos recursos da campanha têm o seguinte formato:
|
status |
É o status da campanha. Quando uma nova campanha é adicionada, o status é ATIVADO. |
serving_status |
O status de veiculação de anúncios da campanha. |
bidding_strategy_system_status |
O status do sistema da estratégia de lances da campanha. |
ad_serving_optimization_status |
O status de otimização da veiculação de anúncios da campanha. |
advertising_channel_type |
É 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. |
advertising_channel_sub_type |
Refinamento opcional para Pode ser definido apenas ao criar campanhas. Depois que a campanha é criada, o campo não pode ser alterado. |
url_custom_parameters[] |
A lista de mapeamentos usados para substituir tags de parâmetros personalizados em um |
real_time_bidding_setting |
Configurações para lances em tempo real, um recurso disponível somente para campanhas que segmentam a rede do Ad Exchange. |
network_settings |
As configurações de rede da campanha. |
dynamic_search_ads_setting |
Configuração para controlar os anúncios dinâmicos de pesquisa (DSA). |
shopping_setting |
A configuração para controlar as campanhas do Shopping. |
geo_target_type_setting |
A configuração da segmentação geográfica dos anúncios. |
labels[] |
Os nomes dos recursos dos rótulos anexados a esta campanha. |
bidding_strategy_type |
É 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. |
accessible_bidding_strategy |
Nome do recurso de AccessibleBiddingStrategy, uma visualizaçã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 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. |
frequency_caps[] |
Uma lista que limita a frequência com que cada usuário verá os anúncios dessa campanha. |
selective_optimization |
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. |
optimization_goal_setting |
Configuração da meta de otimização para esta campanha, que inclui um conjunto de tipos de meta de otimização. |
tracking_setting |
Configurações no nível da campanha para informações de acompanhamento. |
engine_id |
ID da campanha na conta de mecanismo externo. Esse campo é somente para contas que não são do Google Ads, por exemplo, Yahoo Japan, Microsoft, Baidu etc. Para a entidade do Google Ads, use "campaign.id". |
excluded_parent_asset_field_types[] |
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. |
create_time |
O carimbo de data/hora em que a campanha foi criada. O carimbo de data/hora está no fuso horário do cliente e está no formato "aaaa-MM-dd HH:mm:ss". O uso de create_time será descontinuado na v1. Use create_time em vez disso. |
creation_time |
O carimbo de data/hora em que a campanha foi criada. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
last_modified_time |
A data e a hora em que essa campanha foi modificada pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
id |
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). |
tracking_url_template |
O modelo de URL para criar um URL de rastreamento. |
campaign_budget |
O orçamento da campanha. |
start_date |
A data em que a campanha começou a ser veiculada no fuso horário do cliente no formato AAAA-MM-DD. |
end_date |
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. |
final_url_suffix |
Sufixo usado para anexar parâmetros de consulta a páginas de destino veiculadas com acompanhamento paralelo. |
url_expansion_opt_out |
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". |
Campo de união Precisa ser um portfólio (criado por meio do serviço BiddingStrategy) ou padrão incorporado à campanha. |
|
bidding_strategy |
Estratégia de lances de portfólio usada pela campanha. |
manual_cpa |
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. |
manual_cpc |
Estratégia padrão de lances manuais de CPC. Lance manual baseado em clique, no qual o usuário paga por clique. |
manual_cpm |
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. |
maximize_conversions |
A estratégia de lances padrão "Maximizar conversões" que maximiza automaticamente o número de conversões dentro do seu orçamento. |
maximize_conversion_value |
A estratégia padrão "Maximizar o valor da conversão" define lances automaticamente para maximizar a receita gastando o orçamento automaticamente. |
target_cpa |
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. |
target_impression_share |
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. |
target_roas |
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. |
target_spend |
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. |
percent_cpc |
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. |
target_cpm |
Uma estratégia de lances que otimiza automaticamente o custo por mil impressões. |
DynamicSearchAdsSetting
Configuração para controlar os anúncios dinâmicos de pesquisa (DSA).
Campos | |
---|---|
domain_name |
Obrigatório. O nome de domínio da Internet que essa configuração representa, por exemplo, "google.com" ou "www.google.com". |
language_code |
Obrigatório. O código de idioma que especifica o idioma do domínio, por exemplo, "en". |
use_supplied_urls_only |
Se a campanha usa exclusivamente URLs fornecidos pelo anunciante. |
GeoTargetTypeSetting
Representa um conjunto de configurações relacionadas à segmentação geográfica dos anúncios.
Campos | |
---|---|
positive_geo_target_type |
A configuração usada para a segmentação geográfica positiva nessa campanha específica. |
negative_geo_target_type |
A configuração usada para a segmentação geográfica negativa nessa campanha específica. |
NetworkSettings
As configurações de rede da campanha.
Campos | |
---|---|
target_google_search |
Se os anúncios serão veiculados com os resultados da pesquisa do google.com.br. |
target_search_network |
Indica se os anúncios serão veiculados em sites parceiros na rede de pesquisa do Google (requer que |
target_content_network |
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. |
target_partner_search_network |
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. |
OptimizationGoalSetting
Configuração da meta de otimização para esta campanha, que inclui um conjunto de tipos de meta de otimização.
Campos | |
---|---|
optimization_goal_types[] |
A lista de tipos de meta de otimização. |
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.
Campos | |
---|---|
conversion_actions[] |
O conjunto selecionado de ações de conversão para otimizar esta campanha. |
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.
Campos | |
---|---|
feed_label |
Rótulo do feed dos produtos a serem incluídos na campanha. Somente um atributo feed_label ou sales_country pode ser definido. Se usado em vez de sales_country, o campo feed_label aceita 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. |
use_vehicle_inventory |
Indica se o inventário de informações de veículos será segmentado. |
merchant_id |
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. |
sales_country |
O país de venda dos produtos a serem incluídos na campanha. |
campaign_priority |
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. |
enable_local |
Indica se produtos disponíveis na loja física devem ser incluídos. |
TrackingSetting
Configurações no nível da campanha para informações de acompanhamento.
Campos | |
---|---|
tracking_url |
O URL usado para rastreamento dinâmico. |
CampaignAsset
Um vínculo entre uma campanha e um recurso.
Campos | |
---|---|
resource_name |
O nome do recurso da campanha. Os nomes dos recursos "CampaignAsset" têm o seguinte formato:
|
status |
Status do recurso da campanha. |
campaign |
A campanha à qual o recurso está vinculado. |
asset |
O recurso que está vinculado à campanha. |
CampaignAssetSet
CampaignAssetSet é o vínculo entre uma campanha e um conjunto de recursos. Adicionar um CampaignAssetSet vincula um conjunto de recursos a uma campanha.
Campos | |
---|---|
resource_name |
O nome do recurso do conjunto de recursos da campanha. Os nomes dos recursos do conjunto de recursos têm o seguinte formato:
|
campaign |
A campanha a que esse conjunto de recursos está vinculado. |
asset_set |
O conjunto de recursos vinculado à campanha. |
status |
O status do recurso do conjunto de recursos da campanha. Somente leitura. |
CampaignAudienceView
Visualização do público-alvo da campanha Inclui dados de desempenho dos interesses e das listas de remarketing para anúncios das Redes de Display e do YouTube, além de listas de remarketing para anúncios da rede de pesquisa (RLSA), agregadas por critério de campanha e público-alvo. Essa visualização só inclui públicos-alvo anexados no nível da campanha.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização do público-alvo da campanha. Os nomes dos recursos de visualização de público-alvo da campanha têm o seguinte formato:
|
CampaignBudget
Um orçamento de campanha.
Campos | |
---|---|
resource_name |
O nome do recurso do orçamento da campanha. Os nomes dos recursos de orçamento da campanha têm o seguinte formato:
|
delivery_method |
O método de exibição que determina a taxa em que o orçamento da campanha é gasto. O padrão será "STANDARD" se não for especificado em uma operação de criação. |
period |
Período em que o orçamento será usado. O padrão será DIÁRIO se não for especificado. |
amount_micros |
É o valor do orçamento, na moeda local da conta. O valor é especificado em micros, em que um milhão é equivalente a uma unidade monetária. O gasto mensal é limitado a 30,4 vezes esse valor. |
CampaignCriterion
Um critério de campanha.
Campos | |
---|---|
resource_name |
O nome do recurso do critério da campanha. Os nomes dos recursos de critério da campanha têm o seguinte formato:
|
display_name |
O nome de exibição do critério. Este campo é ignorado para mutações. |
type |
Tipo do critério. |
status |
O status do critério. |
last_modified_time |
A data e a hora em que esse critério de campanha foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
criterion_id |
ID do critério. Este campo é ignorado durante a modificação. |
bid_modifier |
O modificador dos lances quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. A maioria dos tipos de critérios segmentáveis são compatíveis com modificadores. Use 0 para desativar um tipo de dispositivo. |
negative |
Define se o critério será segmentado ( |
Campo de união Exatamente um deve ser definido. |
|
keyword |
Palavra-chave. |
location |
Local. |
device |
Dispositivo. |
age_range |
Faixa etária. |
gender |
Sexo. |
user_list |
Lista de usuários. |
language |
e linguagem Hashicorp. |
webpage |
Página da Web. |
location_group |
Grupo por locais |
CampaignLabel
Representa uma relação entre uma campanha e um rótulo.
Campos | |
---|---|
resource_name |
Nome do recurso. Os nomes dos recursos de rótulos de campanhas têm o seguinte formato: |
campaign |
A campanha a que o rótulo está anexado. |
label |
Rótulo atribuído à campanha. |
CartDataSalesView
Visualização de vendas de dados do carrinho.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização de vendas de dados do carrinho. Os nomes dos recursos de visualização de vendas de dados do carrinho têm o seguinte formato: |
Conversão
Uma conversão.
Campos | |
---|---|
resource_name |
O nome do recurso da conversão. Os nomes dos recursos de conversão têm o seguinte formato:
|
id |
O ID da conversão. |
criterion_id |
ID do critério do Search Ads 360. Um valor de 0 indica que o critério não foi atribuído. |
merchant_id |
O ID da conta de inventário do Search Ads 360 que contém o produto que recebeu o clique. O Search Ads 360 gera esse ID quando você vincula uma conta de inventário nele. |
ad_id |
ID do anúncio. Um valor de 0 indica que o anúncio não foi atribuído. |
click_id |
Uma string única para a visita à qual a conversão é atribuída, que é transmitida para a página de destino como o parâmetro de URL do ID de clique. |
visit_id |
O ID da visita do Search Ads 360 ao qual a conversão é atribuída. |
advertiser_conversion_id |
Em conversões off-line, esse é um ID fornecido pelos anunciantes. Se um anunciante não especificar um ID, o Search Ads 360 vai gerar um. Em conversões on-line, ele é igual à coluna "id" ou à coluna floodlight_order_id, dependendo das instruções do Floodlight fornecidas pelo anunciante. |
product_id |
O ID do produto clicado. |
product_channel |
O canal de vendas do produto que foi clicado: on-line ou local. |
product_language_code |
O idioma (ISO-639-1) definido para o feed do Merchant Center que contém dados sobre o produto. |
product_store_id |
A loja no anúncio de inventário local que foi clicada. Precisa corresponder aos IDs de loja usados no feed de produtos locais. |
product_country_code |
O país (formato ISO-3166) registrado no feed de inventário que contém o produto clicado. |
attribution_type |
A que a conversão é atribuída: visita ou palavra-chave + anúncio. |
conversion_date_time |
O carimbo de data/hora do evento de conversão. |
conversion_last_modified_date_time |
O carimbo de data/hora da última vez em que a conversão foi modificada. |
conversion_visit_date_time |
O carimbo de data/hora da visita à qual a conversão é atribuída. |
conversion_quantity |
A quantidade de itens registrados pela conversão, conforme determinado pelo parâmetro "qty url". O anunciante é responsável por preencher o parâmetro de modo dinâmico (como o número de itens vendidos na conversão). Caso contrário, o padrão será 1. |
conversion_revenue_micros |
A receita ajustada em micros para o evento de conversão. Estará sempre na moeda da conta de veiculação. |
floodlight_original_revenue |
A receita original e inalterada associada ao evento do Floodlight (na moeda do relatório atual), antes das modificações na instrução de moeda do Floodlight. |
floodlight_order_id |
O ID do pedido do Floodlight fornecido pelo anunciante para a conversão. |
status |
O status da conversão, ATIVADO ou REMOVIDO. |
asset_id |
ID do recurso com o qual houve interação durante o evento de conversão. |
asset_field_type |
Tipo de campo do recurso do evento de conversão. |
ConversionAction
Uma ação de conversão.
Campos | |
---|---|
resource_name |
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:
|
creation_time |
Carimbo de data/hora da criação da atividade do Floodlight, formatado em ISO 8601. |
status |
É o status desta ação de conversão para acúmulo de eventos de conversão. |
type |
O tipo dessa ação de conversão. |
category |
A categoria de conversões registrada para esta ação de conversão. |
value_settings |
Configurações relacionadas ao valor dos eventos de conversão associados a esta ação de conversão. |
attribution_model_settings |
Configurações relacionadas ao modelo de atribuição dessa ação de conversão. |
floodlight_settings |
Configurações do Floodlight para tipos de conversão do Floodlight. |
id |
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. |
primary_for_goal |
Se o bit primary_for_goal de uma ação de conversão for falso, a ação de conversão não poderá receber lances em todas as campanhas, independentemente da meta de conversão do cliente ou 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 primary_for_goal = ação de conversão falsa, essa ação ainda poderá receber lances. Por padrão, primary_for_goal será verdadeiro se não for definido. Na V9, primary_for_goal só pode ser definido como falso após a criação por uma operação "update", porque não é declarado como opcional. |
owner_customer |
O nome do recurso do cliente proprietário da ação de conversão ou "null" se for uma ação definida pelo sistema. |
include_in_client_account_conversions_metric |
Indica se essa ação de conversão deve ser incluída na métrica "client_account_conversions". |
include_in_conversions_metric |
Indica se essa ação de conversão deve ser incluída na métrica "conversões". |
click_through_lookback_window_days |
É o número máximo de dias decorridos entre uma interação (por exemplo, um clique) e um evento de conversão. |
app_id |
ID do aplicativo para uma ação de conversão de app. |
AttributionModelSettings
Configurações relacionadas ao modelo de atribuição dessa ação de conversão.
Campos | |
---|---|
attribution_model |
O tipo de modelo de atribuição dessa ação de conversão. |
data_driven_model_status |
O status do modelo de atribuição baseada em dados para a ação de conversão. |
FloodlightSettings
Configurações relacionadas a uma ação de conversão do Floodlight.
Campos | |
---|---|
activity_group_tag |
String usada para identificar um grupo de atividades do Floodlight ao registrar as conversões. |
activity_tag |
String usada para identificar uma atividade do Floodlight ao registrar conversões. |
activity_id |
ID da atividade do Floodlight no DoubleClick Campaign Manager (DCM). |
ValueSettings
Configurações relacionadas ao valor dos eventos de conversão associados a esta ação de conversão.
Campos | |
---|---|
default_value |
O valor a ser usado quando os eventos de conversão dessa 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. |
default_currency_code |
O código de 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 essa ação de conversão está configurada para usar sempre o valor padrão. |
always_use_default_value |
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 para esta ação de conversão. |
ConversionCustomVariable
Uma variável personalizada de conversão. Consulte "Sobre métricas e dimensões personalizadas do Floodlight no novo Search Ads 360" em https://support.google.com/sa360/answer/13567857
Campos | |
---|---|
resource_name |
O nome do recurso da variável personalizada de conversão. Os nomes dos recursos da variável personalizada de conversão têm o seguinte formato:
|
id |
O ID da variável personalizada de conversão. |
name |
Obrigatório. O nome da variável personalizada da conversão. O nome deve ser exclusivo. O nome pode ter, no máximo, 100 caracteres. Não deve haver espaços extras antes e depois. |
tag |
Obrigatório. A tag da variável personalizada de conversão. A tag deve ser única e consistir em um caractere "u" seguido diretamente por um número menor que ou igual a 100. Por exemplo: "u4". |
status |
É o status da variável personalizada de conversão para o acúmulo de eventos de conversão. |
owner_customer |
O nome do recurso do cliente que tem a variável personalizada de conversão. |
family |
Família da variável personalizada de conversão. |
cardinality |
Cardinalidade da variável personalizada de conversão. |
floodlight_conversion_custom_variable_info |
Campos para as variáveis personalizadas de conversão do Floodlight no Search Ads 360. |
custom_column_ids[] |
Os IDs das colunas personalizadas que usam essa variável personalizada de conversão. |
FloodlightConversionCustomVariableInfo
Informações sobre as variáveis personalizadas de conversão do Floodlight no Search Ads 360.
Campos | |
---|---|
floodlight_variable_type |
Tipo de variável do Floodlight definido no Search Ads 360. |
floodlight_variable_data_type |
Tipo de dados da variável do Floodlight definido no Search Ads 360. |
ConversionTrackingSetting
Uma coleção de configurações gerais do cliente relacionadas ao acompanhamento de conversões do Search Ads 360.
Campos | |
---|---|
accepted_customer_data_terms |
Se o cliente aceitou os termos de dados do cliente. Se você usa o acompanhamento de conversões de várias contas, esse valor é herdado do administrador. Este campo é somente leitura. Para mais informações, consulte https://support.google.com/adspolicy/answer/7475709. |
conversion_tracking_status |
Status do acompanhamento de conversões. Ela indica se o cliente está usando o acompanhamento de conversões e quem é o proprietário desse recurso. Se esse cliente estiver usando o acompanhamento de conversões de várias contas, o valor retornado vai ser diferente com base no |
enhanced_conversions_for_leads_enabled |
Indica se o cliente ativou as conversões otimizadas para leads. Se você usa o acompanhamento de conversões de várias contas, esse valor é herdado do administrador. Este campo é somente leitura. |
google_ads_conversion_customer |
O nome do recurso do cliente onde as conversões são criadas e gerenciadas. Este campo é somente leitura. |
conversion_tracking_id |
O ID de acompanhamento de conversões usado para esta conta. Esse ID não indica se o cliente usa o acompanhamento de conversões (o conversion_tracking_status usa). Este campo é somente leitura. |
google_ads_cross_account_conversion_tracking_id |
O ID de acompanhamento de conversões do gerente do cliente. Ele é definido quando o cliente usa o acompanhamento de conversões e substitui o campo conversion_tracking_id. Esse campo só pode ser gerenciado na interface do Google Ads. Este campo é somente leitura. |
cross_account_conversion_tracking_id |
O ID de acompanhamento de conversões do gerente do cliente. Ele é definido quando o cliente usa o acompanhamento de conversões de várias contas e substitui conversion_tracking_id. |
CustomColumn
Uma coluna personalizada. Consulte a coluna personalizada do Search Ads 360 em https://support.google.com/sa360/answer/9633916.
Campos | |
---|---|
resource_name |
O nome do recurso da coluna personalizada. Os nomes dos recursos das colunas personalizadas têm o seguinte formato:
|
id |
ID da coluna personalizada. |
name |
Nome da coluna personalizada definido pelo usuário. |
description |
Descrição da coluna personalizada definida pelo usuário. |
value_type |
O tipo do valor do resultado da coluna personalizada. |
references_attributes |
Verdadeiro quando a coluna personalizada se refere a um ou mais atributos. |
references_metrics |
Verdadeiro quando a coluna personalizada se refere a uma ou mais métricas. |
queryable |
Verdadeiro quando a coluna personalizada está disponível para ser usada na consulta do SearchAds360Service.Search e SearchAds360Service.SearchStream. |
referenced_system_columns[] |
A lista das colunas do sistema referenciadas desta coluna personalizada. Por exemplo, uma coluna personalizada "soma de impressões e cliques" faz referência a colunas do sistema de {"metrics.clicks", "metrics.impressions"}. |
Cliente
Um cliente.
Campos | |
---|---|
resource_name |
O nome do recurso do cliente. Os nomes dos recursos do cliente têm o seguinte formato:
|
conversion_tracking_setting |
Configuração do acompanhamento de conversões de um cliente. |
account_type |
Tipo de conta de mecanismo, por exemplo: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track etc. |
double_click_campaign_manager_setting |
Configuração do DoubleClick Campaign Manager (Campaign Manager) para um cliente administrador. |
account_status |
Status da conta, como "Ativada", "Pausada", "Removida" etc. |
last_modified_time |
A data e a hora em que o cliente foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
engine_id |
ID da conta na conta de mecanismo externo. |
status |
O status do cliente. |
creation_time |
O carimbo de data/hora em que o cliente foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
id |
O ID do cliente. |
descriptive_name |
Nome descritivo opcional e não exclusivo do cliente. |
currency_code |
A moeda em que a conta opera. É compatível com um subconjunto dos códigos de moeda do padrão ISO 4217. |
time_zone |
O ID de fuso horário local do cliente. |
tracking_url_template |
O modelo de URL para criar um URL de rastreamento sem parâmetros. |
final_url_suffix |
O modelo de URL para anexar parâmetros ao URL final. |
auto_tagging_enabled |
Indica se a codificação automática está ativada para o cliente. |
manager |
Se o cliente é um gerente. |
CustomerAsset
Um vínculo entre um cliente e um recurso.
Campos | |
---|---|
resource_name |
O nome do recurso do cliente. Os nomes dos recursos CustomerAsset têm o seguinte formato:
|
asset |
Obrigatório. O recurso vinculado ao cliente. |
status |
Status do recurso do cliente. |
CustomerAssetSet
CustomerAssetSet é o vínculo entre um cliente e um conjunto de recursos. Adicionar um CustomerAssetSet vincula um conjunto de recursos a um cliente.
Campos | |
---|---|
resource_name |
O nome do recurso do conjunto de recursos do cliente. Os nomes dos recursos do conjunto de recursos têm o seguinte formato:
|
asset_set |
O conjunto de recursos vinculado ao cliente. |
customer |
O cliente a que esse conjunto de recursos está vinculado. |
status |
O status do recurso do conjunto de recursos do cliente. Somente leitura. |
CustomerClient
Um link entre um determinado cliente e um cliente cliente. Os CustomerClients só existem para clientes administradores. Todos os clientes diretos e indiretos estão incluídos, além do próprio gerente.
Campos | |
---|---|
resource_name |
O nome do recurso do cliente do cliente. Os nomes dos recursos do CustomerClient têm o formato: |
applied_labels[] |
Os nomes dos recursos dos rótulos de propriedade do cliente solicitante que são aplicados ao cliente do cliente. Os nomes dos recursos de rótulo têm o seguinte formato:
|
status |
O status do cliente. Somente leitura. |
client_customer |
O nome do recurso cliente-cliente vinculado ao cliente em questão. Somente leitura. |
level |
A distância entre o cliente e o cliente. Para "self link", o valor do nível será 0. Somente leitura. |
time_zone |
Representação da string Common Locale Data Repository (CLDR) do fuso horário do cliente, por exemplo, America/Los_Angeles. Somente leitura. |
test_account |
Identifica se o cliente é uma conta de teste. Somente leitura. |
manager |
Identifica se o cliente é um gerente. Somente leitura. |
descriptive_name |
Nome descritivo para o cliente. Somente leitura. |
currency_code |
Código da moeda (por exemplo, "USD", "EUR") do cliente. Somente leitura. |
id |
O ID do cliente. Somente leitura. |
CustomerManagerLink
Representa a relação de vínculo cliente-gerente.
Campos | |
---|---|
resource_name |
Nome do recurso. Os nomes dos recursos do CustomerManagerLink têm o seguinte formato: |
status |
Status do vínculo entre o cliente e o gerente. |
manager_customer |
O cliente administrador vinculado ao cliente. |
manager_link_id |
ID do link entre clientes e gerentes. Este campo é somente leitura. |
DoubleClickCampaignManagerSetting
Configuração do DoubleClick Campaign Manager (Campaign Manager) para um cliente administrador.
Campos | |
---|---|
advertiser_id |
ID do anunciante do Campaign Manager associado a esse cliente. |
network_id |
ID da rede do Campaign Manager associada a esse cliente. |
time_zone |
Fuso horário da rede do Campaign Manager associado a esse cliente no formato do banco de dados de fuso horário IANA, como América/Nova_York. |
DynamicSearchAdsSearchTermView
Visualização do termo de pesquisa em anúncios dinâmicos de pesquisa.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização do termo de pesquisa dos anúncios dinâmicos de pesquisa. Os nomes dos recursos para visualização de termos de pesquisa nos anúncios dinâmicos de pesquisa têm a seguinte forma:
|
landing_page |
O URL da página de destino da impressão selecionado dinamicamente. Este campo é somente leitura. |
GenderView
Uma visualização de gênero. O recurso "gender_view" reflete o estado de veiculação efetivo, em vez dos critérios que foram adicionados. Por padrão, um grupo de anúncios sem critérios de sexo é exibido para todos os sexos. Assim, todos os sexos aparecem em gender_view com estatísticas.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização de gênero. Os nomes dos recursos de visualização de gênero têm o seguinte formato:
|
GeoTargetConstant
Uma constante de segmentação geográfica.
Campos | |
---|---|
resource_name |
O nome do recurso da constante de segmentação geográfica. Os nomes dos recursos constantes da segmentação geográfica têm o seguinte formato:
|
status |
Status constante da segmentação por área geográfica. |
id |
O ID da constante da segmentação por área geográfica. |
name |
Nome em inglês da constante de segmentação por área geográfica. |
country_code |
O código do país ISO-3166-1 alfa-2 associado à segmentação. |
target_type |
Tipo de segmentação constante da segmentação geográfica. |
canonical_name |
O nome em inglês totalmente qualificado, que consiste no nome da segmentação, do nome pai e do país. |
parent_geo_target |
O nome do recurso da constante mãe de segmentação geográfica. Os nomes dos recursos constantes da segmentação geográfica têm o seguinte formato:
|
KeywordView
Uma visualização de palavras-chave.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização da palavra-chave. Os nomes dos recursos de visualização de palavras-chave têm o seguinte formato:
|
Rótulo
Um marcador.
Campos | |
---|---|
resource_name |
Nome do recurso. Os nomes dos recursos de rótulo têm o seguinte formato: |
status |
Status do rótulo. Somente leitura. |
text_label |
Um tipo de rótulo que exibe texto em um plano de fundo colorido. |
id |
ID do rótulo. Somente leitura. |
name |
Nome do rótulo. Este campo é obrigatório e não deve ficar vazio ao criar um novo rótulo. Esta string conter entre 1 e 80 caracteres (valores inclusivos). |
LanguageConstant
Um idioma.
Campos | |
---|---|
resource_name |
O nome do recurso da constante de linguagem. Os nomes de recursos de constantes de linguagem têm o seguinte formato:
|
id |
O ID da constante de linguagem. |
code |
O código de idioma, por exemplo, "en_US", "en_AU", "es", "fr" etc. |
name |
O nome completo do idioma em inglês, por exemplo, "Inglês (EUA)", "Espanhol" etc. |
targetable |
Indica se o idioma pode ser segmentado. |
ListingGroupFilterDimension
Dimensões da ficha para o filtro do grupo de produtos anunciados do grupo de recursos.
Campos | |
---|---|
Campo de união dimension . A dimensão de um dos tipos abaixo está sempre presente. dimension só pode ser de um dos seguintes tipos: |
|
product_bidding_category |
Categoria de lances de uma oferta de produto. |
product_brand |
Marca de uma oferta de produto. |
product_channel |
Localidade de uma oferta de produto. |
product_condition |
Condição de uma oferta de produto. |
product_custom_attribute |
Atributo personalizado de uma oferta de produto. |
product_item_id |
Código do item de uma oferta de produto. |
product_type |
Tipo de uma oferta de produto. |
ProductBiddingCategory
Um elemento de uma categoria de lances em um determinado nível. As categorias de nível superior estão no nível 1, as filhas no nível 2 e assim por diante. No momento, oferecemos suporte a até cinco níveis. O usuário precisa especificar um tipo de dimensão que indique o nível da categoria. Todos os casos da mesma subdivisão precisam ter o mesmo tipo de dimensão (nível de categoria).
Campos | |
---|---|
level |
Indica o nível da categoria na taxonomia. |
id |
ID da categoria de lances do produto. Esse ID é equivalente ao ID google_product_category, conforme descrito neste artigo: https://support.google.com/merchants/answer/6324436 |
ProductBrand
Marca do produto.
Campos | |
---|---|
value |
Valor de string da marca do produto. |
ProductChannel
Localidade de uma oferta de produto.
Campos | |
---|---|
channel |
Valor da localidade. |
ProductCondition
Condição de uma oferta de produto.
Campos | |
---|---|
condition |
Valor da condição. |
ProductCustomAttribute
Atributo personalizado de uma oferta de produto.
Campos | |
---|---|
index |
Indica o índice do atributo personalizado. |
value |
Valor de string do atributo personalizado do produto. |
ProductItemId
Código do item de uma oferta de produto.
Campos | |
---|---|
value |
Valor do ID. |
ProductType
Tipo de uma oferta de produto.
Campos | |
---|---|
level |
Nível do tipo. |
value |
Valor do tipo. |
ListingGroupFilterDimensionPath
O caminho que define as dimensões que definem um filtro do grupo de fichas.
Campos | |
---|---|
dimensions[] |
O caminho completo das dimensões na hierarquia de filtros do grupo de fichas (excluindo o nó raiz) para este filtro do grupo de fichas. |
LocationView
Uma visualização de local resume a performance das campanhas por um critério de local.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização do local. Os nomes dos recursos de visualização de local têm o seguinte formato:
|
ProductBiddingCategoryConstant
Uma categoria de lances de produtos.
Campos | |
---|---|
resource_name |
O nome do recurso da categoria de lances do produto. Os nomes dos recursos da categoria de lances de produtos têm o seguinte formato:
|
level |
Nível da categoria de lances do produto. |
status |
Status da categoria de lances do produto. |
id |
ID da categoria de lances do produto. Ele é equivalente ao ID google_product_category, conforme descrito neste artigo: https://support.google.com/merchants/answer/6324436. |
country_code |
Código do país com duas letras maiúsculas da categoria de lances do produto. |
product_bidding_category_constant_parent |
Nome do recurso da categoria de lances do produto pai. |
language_code |
Código do idioma da categoria de lances do produto. |
localized_name |
Valor de exibição da categoria de lances do produto localizado de acordo com language_code. |
ProductGroupView
Uma visualização do grupo de produtos.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização do grupo de produtos. Os nomes dos recursos da visualização de grupo de produtos têm o seguinte formato:
|
SearchAds360Field
Um campo ou recurso (artefato) usado pelo SearchAds360Service.
Campos | |
---|---|
resource_name |
O nome do recurso do artefato. Os nomes dos recursos de artefato têm o seguinte formato:
|
category |
A categoria do artefato. |
selectable_with[] |
Os nomes de todos os recursos, segmentos e métricas que podem ser selecionados com o artefato descrito. |
attribute_resources[] |
Os nomes de todos os recursos selecionáveis com o artefato descrito. Os campos desses recursos não segmentam métricas quando incluídos nas consultas de pesquisa. Este campo é definido apenas para artefatos cuja categoria é RESOURCE. |
metrics[] |
Esse campo lista os nomes de todas as métricas que podem ser selecionadas com o artefato descrito quando é usado na cláusula FROM. Ele é definido apenas para artefatos cuja categoria é RESOURCE. |
segments[] |
Esse campo lista os nomes de todos os artefatos, sejam um segmento ou outro recurso, que tenham métricas de segmento quando incluídos nas consultas de pesquisa e quando o artefato descrito é usado na cláusula FROM. Ele é definido apenas para artefatos cuja categoria é RESOURCE. |
enum_values[] |
Valores que o artefato pode assumir se for um campo do tipo ENUM. Esse campo só é definido para artefatos da categoria SEGMENT ou ATTRIBUTE. |
data_type |
Esse campo determina os operadores que podem ser usados com o artefato nas cláusulas WHERE. |
name |
O nome do artefato. |
selectable |
Define se o artefato pode ser usado em uma cláusula SELECT em consultas de pesquisa. |
filterable |
Define se o artefato pode ser usado em uma cláusula WHERE em consultas de pesquisa. |
sortable |
Define se o artefato pode ser usado em uma cláusula ORDER BY em consultas de pesquisa. |
type_url |
O URL do proto que descreve o tipo de dados do artefato. |
is_repeated |
Define se o artefato de campo é repetido. |
ShoppingPerformanceView
Visualização de desempenho do Google Shopping. Oferece estatísticas da campanha do Shopping agregadas em vários níveis de dimensão do produto. Os valores das dimensões de produto do Merchant Center, como marca, categoria, atributos personalizados, condição e tipo de produto, vão refletir o estado de cada dimensão a partir da data e hora em que o evento correspondente foi registrado.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização de desempenho do Google Shopping. Os nomes dos recursos de visualização de desempenho do Shopping têm o seguinte formato: |
UserList
Uma lista de usuários. Esta é uma lista de usuários que um cliente pode segmentar.
Campos | |
---|---|
resource_name |
O nome do recurso da lista de usuários. Os nomes dos recursos da lista de usuários têm o seguinte formato:
|
type |
Tipo dessa lista. Este campo é somente leitura. |
id |
ID da lista de usuários. |
name |
Nome dessa lista de usuários. Dependendo de access_reason, o nome da lista de usuários talvez não seja exclusivo (por exemplo, se access_reason=SHARED) |
Acesse
Uma visita.
Campos | |
---|---|
resource_name |
O nome do recurso da visita. Os nomes dos recursos de visita têm o seguinte formato:
|
id |
O ID da visita. |
criterion_id |
ID de palavra-chave do Search Ads 360. Um valor de 0 indica que a palavra-chave não foi atribuída. |
merchant_id |
O ID da conta de inventário do Search Ads 360 que contém o produto que recebeu o clique. O Search Ads 360 gera esse ID quando você vincula uma conta de inventário nele. |
ad_id |
ID do anúncio. Um valor de 0 indica que o anúncio não foi atribuído. |
click_id |
Uma string exclusiva para cada visita transmitida à página de destino como o parâmetro de URL de ID de clique. |
visit_date_time |
O carimbo de data/hora do evento da visita. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
product_id |
O ID do produto clicado. |
product_channel |
O canal de vendas do produto que foi clicado: on-line ou local. |
product_language_code |
O idioma (ISO-639-1) definido para o feed do Merchant Center que contém dados sobre o produto. |
product_store_id |
A loja no anúncio de inventário local que foi clicada. Precisa corresponder aos IDs de loja usados no feed de produtos locais. |
product_country_code |
O país (formato ISO-3166) registrado no feed de inventário que contém o produto clicado. |
asset_id |
Código do recurso com o qual houve interação durante o evento da visita. |
asset_field_type |
Tipo de campo do recurso do evento de visita. |
WebpageView
Uma visualização de página da Web.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização da página da Web. Os nomes dos recursos de visualização de página da Web têm o seguinte formato:
|