Í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 das estratégias de lances que pertencem ao cliente e foram compartilhadas com ele.
Em contraste com a BiddingStrategy, esse recurso inclui estratégias de propriedade dos gerentes do cliente e compartilhadas com ele, além das estratégias dele. Esse recurso não oferece 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áticos para ajudar a gerar o maior valor de conversão para suas campanhas sem exceder o orçamento. |
maximize_conversions |
Uma estratégia de lances automáticos para ajudar a gerar o maior número de conversões para suas campanhas sem exceder o orçamento. |
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 que você definiu. |
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 calcula a média de um retorno do investimento em publicidade (ROAS) desejado específico. |
target_spend |
Uma estratégia de lances que define seus lances para conseguir o máximo de cliques possível com o orçamento disponível. |
MaximizeConversionValue
Uma estratégia de lances automáticos para ajudar a gerar o maior valor de conversão para suas campanhas sem exceder o orçamento.
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áticos para ajudar a gerar o maior número de conversões para suas campanhas sem exceder o orçamento.
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áticos que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado que você definiu.
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 calcula a média de um 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áticos 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 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 de recurso do anúncio. Os nomes de recursos de anúncio 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 precisa ser definido. ad_data pode ser apenas de um dos tipos a seguir: |
|
text_ad |
Detalhes relacionados a um anúncio de texto. |
expanded_text_ad |
Detalhes relacionados a anúncios de texto expandidos. |
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. |
Grupo de anúncios
Um grupo de anúncios.
Campos | |
---|---|
resource_name |
O nome de recurso do grupo de anúncios. Os nomes de 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 este 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 de grupo de anúncios.
Campos | |
---|---|
resource_name |
O nome de 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 |
A data e a hora em que este 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. Este 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" como alternativa. |
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 do anúncio do grupo de anúncios têm o 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 de GroupAsset 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
"Grupo de recursos de anúncios" é o vínculo entre um grupo de anúncios e um conjunto de recursos. A criação de um GroupAssetSet 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 que está 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 de interesses e listas de remarketing para anúncios das Redes de Display e do YouTube, além de listas de remarketing para anúncios 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 do 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 de recursos do modificador de lances de 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 nas 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_criterion 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 de 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 de 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 é apenas 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_criterion.criterion_id" como alternativa. |
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 produtos anunciados. |
age_range |
Faixa etária. |
gender |
Gênero. |
user_list |
Lista de usuários. |
webpage |
Página da Web |
location |
Local. |
PositionEstimates
Estimativas de 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 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 do 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 do rótulo do grupo de anúncios têm o 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 de faixa etária.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização de faixa etária. Os nomes dos recursos de visualização de faixa etária têm o seguinte formato:
|
Recurso
O recurso faz parte de um anúncio que pode ser compartilhado entre vários anúncios. 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 usa.
Campos | |
---|---|
resource_name |
O nome do recurso. Os nomes dos recursos de recursos têm o seguinte formato:
|
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 . Tipo específico do recurso. asset_data pode ser apenas de um dos tipos a seguir: |
|
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 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 de recursos. Os nomes dos recursos dos grupos de recursos têm o seguinte formato:
|
id |
O ID do grupo de recursos. |
campaign |
A campanha à qual esse grupo de recursos está associado. O recurso que está vinculado ao grupo de recursos. |
name |
Obrigatório. Nome do grupo de recursos. Obrigatório. Ele deve ter comprimento mínimo de 1 e comprimento 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 são qualificados para expansão, a menos que sejam 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 são qualificados para expansão, a menos que sejam 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. Esse 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 de recursos. 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 a que este recurso está sendo vinculado. |
asset |
O recurso que está sendo vinculado a este grupo de recursos. |
field_type |
A descrição da posição do recurso no grupo de recursos. 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 do qual este filtro do grupo de produtos anunciados do grupo de recursos faz parte. |
id |
O ID do ListingGroupFilter. |
type |
Tipo de nó de filtro do grupo de fichas. |
vertical |
A vertical que a árvore de nós atual representa. Todos os nós na mesma árvore precisam pertencer à mesma indústria. |
case_value |
Valor da dimensão com que esse grupo de produtos anunciados está refinando o pai/mãe. Indefinido para o grupo raiz. |
parent_listing_group_filter |
Nome do recurso da subdivisão do grupo de fichas da empresa principal. Nulo para o nó do filtro do grupo de fichas da empresa 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 está mais propenso a fazer uma 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 este indicador pertence. |
Campo de união signal . O indicador do grupo de recursos. signal pode ser apenas de um dos tipos a seguir: |
|
audience |
O indicador de público-alvo a ser usado pela campanha Performance Max. |
AssetGroupTopCombinationView
Uma visão do 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 da parte superior do grupo de recursos. Os nomes dos recursos da Visualização de combinação principal de AssetGroup têm o formato: `"customers/{customer_id}/assetGroupTopCombineViews/{asset_group_id}~{asset_ callout_category}" |
asset_group_top_combinations[] |
As principais combinações de recursos que foram veiculados juntos. |
AssetSet
Um conjunto de recursos que representa uma coleção de recursos. Use AssetSetAsset para vincular um recurso ao conjunto de recursos.
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-alvo
O público-alvo é uma opção de segmentação eficaz que permite cruzar diferentes atributos de segmentos, como informações demográficas e afinidades detalhadas, para criar públicos-alvo que representam seções dos seus segmentos.
Campos | |
---|---|
resource_name |
O nome de recurso do público. 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 deve ser único para todos os públicos-alvo. Ele deve ter comprimento mínimo de 1 e comprimento máximo de 255. |
description |
Descrição desse 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 de três letras do ISO 4217). Para 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 atendidos, este campo não pode ser definido; Todas as estratégias em um cliente de veiculação usam implicitamente a moeda desse cliente. Em todos os casos, o campo effective_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 de três letras do ISO 4217). Para estratégias de lances para clientes administradores, essa é a moeda definida pelo anunciante ao criar a estratégia. Para clientes atendidos, este é o currency_code do cliente. As métricas da estratégia de lances são informadas nessa 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 áreas com menor probabilidade. |
maximize_conversion_value |
Uma estratégia de lances automáticos para ajudar a gerar o maior valor de conversão para suas campanhas sem exceder o orçamento. |
maximize_conversions |
Uma estratégia de lances automáticos para ajudar a gerar o maior número de conversões para suas campanhas sem exceder o orçamento. |
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 que você definiu. |
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. Este campo está obsoleto. Não será possível criar uma nova estratégia de lances com esse campo ou anexar estratégias de lances com ele a uma campanha. As mutações em estratégias que já têm esse esquema preenchido são permitidas. |
target_roas |
Uma estratégia de lances que ajuda a maximizar a receita enquanto calcula a média de um retorno do investimento em publicidade (ROAS) desejado específico. |
target_spend |
Uma estratégia de lances que define seus lances para conseguir o máximo de cliques possível com o orçamento disponível. |
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 |
A 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 de 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 "bid_strategy". Deixar em branco se a campanha não usar uma estratégia de portfólio. Os atributos irrestritos de estratégia estão 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 estão disponíveis apenas para o cliente proprietário da estratégia e seus gerentes. 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 desta campanha. |
selective_optimization |
Configuração de otimização seletiva desta campanha, que inclui um conjunto de ações de conversão que serão otimizadas. 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 desta 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 esta 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 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 o acompanhamento paralelo. |
url_expansion_opt_out |
Representa a desativação da expansão de URL para URLs mais segmentados. Se desativado (verdadeiro), somente os URLs finais do grupo de recursos ou os URLs especificados nos feeds de dados da empresa ou do Google Merchant Center do anunciante serão segmentados. Se a opção for ativada (falso), todo o domínio será segmentado. Esse campo só pode ser definido para campanhas Performance Max, em que o valor padrão é "false". |
Campo de união Precisa ser um portfólio (criado por meio do serviço BiddingStrategy) ou um padrão incorporado à campanha. |
|
bidding_strategy |
Estratégia de lances de portfólio usada pela campanha. |
manual_cpa |
Estratégia de lances de CPA manual padrão. 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 de lances manuais padrão de CPC. Lance baseado em clique manual, no qual o usuário paga por clique. |
manual_cpm |
Estratégia de lances de CPM manual padrão. Lance baseado em impressão manual, 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 sem exceder o orçamento. |
maximize_conversion_value |
A estratégia de lances padrão "Maximizar o valor da conversão" que define automaticamente os lances para maximizar a receita gastando o orçamento. |
target_cpa |
Estratégia de lances de CPA desejado padrão que define lances automaticamente 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áticos 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 enquanto faz a média de um retorno do investimento em publicidade desejado (ROAS) específico. |
target_spend |
A estratégia de lances de gasto desejado padrão que define automaticamente seus lances para conseguir o máximo de cliques possível com o orçamento disponível. |
percent_cpc |
Estratégia de lances de porcentagem padrão de CPC em que os lances são uma fração do preço anunciado de um produto ou serviço. |
target_cpm |
Uma estratégia de lances que otimiza automaticamente o custo por mil impressões. |
DynamicSearchAdsSetting
A 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 |
Indica se a campanha usa exclusivamente URLs fornecidos pelo anunciante. |
GeoTargetTypeSetting
Representa um conjunto de configurações relacionadas à segmentação geográfica de anúncios.
Campos | |
---|---|
positive_geo_target_type |
A configuração usada para a segmentação geográfica positiva nesta campanha específica. |
negative_geo_target_type |
A configuração usada para segmentação geográfica negativa nesta 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 (exige 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 desta 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 desta campanha, que inclui um conjunto de ações de conversão que serão otimizadas. 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 feed_label ou sales_country pode ser definido. Se for usado em vez de sales_country, o campo feed_label aceitará códigos de países 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 |
Define 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 |
País de vendas dos produtos a serem incluídos na campanha. |
campaign_priority |
Prioridade da campanha. As campanhas com prioridades numericamente maiores têm precedência sobre as com prioridades mais baixas. Este 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 serão incluídos. |
TrackingSetting
Configurações no nível da campanha para informações de acompanhamento.
Campos | |
---|---|
tracking_url |
O URL usado para acompanhamento 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 de 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 à qual esse conjunto de recursos está vinculado. |
asset_set |
O conjunto de recursos que está vinculado à campanha. |
status |
O status do recurso do conjunto de recursos da campanha. Somente leitura. |
CampaignAudienceView
Uma visualização do público-alvo da campanha. Inclui dados de desempenho de interesses e listas de remarketing para anúncios das Redes de Display e do YouTube, além de listas de remarketing para anúncios de pesquisa (RLSA), agregados por critério de público-alvo e campanha. Essa visualização inclui apenas os 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 do 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 |
Gênero. |
user_list |
Lista de usuários. |
language |
e linguagem Hashicorp. |
webpage |
página da Web. |
location_group |
Grupo por locais |
CampaignLabel
Representa um relacionamento entre uma campanha e um rótulo.
Campos | |
---|---|
resource_name |
Nome do recurso. Os nomes dos recursos do rótulo da campanha têm o 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 vista de vendas de dados do carrinho. Os nomes dos recursos da visualização de vendas dos dados do carrinho têm o seguinte formato: |
Conversão
Uma conversão.
Campos | |
---|---|
resource_name |
O nome de 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 de visita do Search Ads 360 a que 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 que recebeu uma 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 |
Categoria de conversões registradas para essa ação de conversão. |
value_settings |
Configurações relacionadas ao valor dos eventos de conversão associados a essa ação de conversão. |
attribution_model_settings |
Configurações relacionadas ao modelo de atribuição desta ação de conversão. |
floodlight_settings |
Configurações do Floodlight para os 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, ela não poderá receber lances para todas as campanhas, independentemente da meta de conversão de cliente ou da campanha. No entanto, as metas de conversão personalizadas não respeitam a primary_for_goal. Portanto, se uma campanha tiver uma meta de conversão personalizada configurada com uma ação de conversão "primary_for_goal = 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 meio de uma "atualização" porque ela não foi declarada como opcional. |
owner_customer |
O nome do recurso do cliente proprietário da ação de conversão ou nulo se essa for uma ação de conversão definida pelo sistema. |
include_in_client_account_conversions_metric |
Se essa ação de conversão deve ser incluída na coluna "client_account_conversions" métrica. |
include_in_conversions_metric |
Se essa ação de conversão deve ser incluída na coluna "conversões" métrica. |
click_through_lookback_window_days |
O número máximo de dias entre uma interação (por exemplo, um clique) e um evento de conversão. |
app_id |
ID do app para uma ação de conversão de app. |
AttributionModelSettings
Configurações relacionadas ao modelo de atribuição desta 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 essa ação de conversão.
Campos | |
---|---|
default_value |
O valor a ser usado quando os eventos 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 da moeda a ser usado quando os eventos de conversão dessa ação de conversão forem enviados com um código de moeda inválido ou ausente ou quando essa ação de conversão estiver configurada para usar sempre o valor padrão. |
always_use_default_value |
Controla se o valor e o código da moeda padrão são usados no lugar do valor e do código da moeda especificados nos eventos de conversão dessa ação de conversão. |
ConversionCustomVariable
Uma variável personalizada de conversão. Consulte "Sobre dimensões e métricas 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 de variáveis personalizadas 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 de conversão. O nome deve ser exclusivo. O tamanho máximo do nome é de 100 caracteres. Não deve haver espaços adicionais antes e depois. |
tag |
Obrigatório. A tag da variável personalizada de conversão. A tag deve ser única e consistir em um "u" caractere diretamente seguido por um número menor que ormigual 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 proprietário da 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 das 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 definida no Search Ads 360. |
floodlight_variable_data_type |
Tipo de dados da variável do Floodlight definido no Search Ads 360. |
ConversionTrackingSetting
Um conjunto de configurações de todo o 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ê estiver usando o acompanhamento de conversões de várias contas, esse valor será 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 do acompanhamento de conversões do cliente. Se esse cliente estiver usando o acompanhamento de conversões de várias contas, o valor retornado será diferente com base no |
enhanced_conversions_for_leads_enabled |
Se o cliente ativou as conversões otimizadas para leads. Se você estiver usando o acompanhamento de conversões de várias contas, esse valor será 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 essa conta. Esse ID não indica se o cliente usa o acompanhamento de conversões (conversion_tracking_status faz). Este campo é somente leitura. |
google_ads_cross_account_conversion_tracking_id |
O ID de acompanhamento de conversões do gerente do cliente. É definido quando o cliente ativa o acompanhamento de conversões e substitui "conversion_tracking_id". Só é possível gerenciar esse campo 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. Isso é definido quando o cliente ativa 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 de recurso da coluna personalizada. Os nomes de recursos das colunas personalizadas têm o seguinte formato:
|
id |
ID da coluna personalizada. |
name |
Nome definido pelo usuário da coluna personalizada. |
description |
Descrição definida pelo usuário da coluna personalizada. |
value_type |
O tipo de valor de 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" fez referência a colunas do sistema de {"metrics.clicks", "metrics.impressions"}. |
Cliente
Um cliente.
Campos | |
---|---|
resource_name |
O nome de recurso do cliente. Os nomes de recursos dos clientes 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 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 com base em 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 de 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 que está vinculado ao cliente. |
customer |
O cliente ao qual este conjunto de recursos está vinculado. |
status |
O status do recurso do conjunto de recursos do cliente. Somente leitura. |
CustomerClient
Um link entre o cliente em questão e um cliente cliente. Os CustomerClients existem apenas para clientes administradores. Todos os clientes de clientes diretos e indiretos estão incluídos, bem como o próprio gerente.
Campos | |
---|---|
resource_name |
O nome do recurso do cliente do cliente. Os nomes dos recursos do CustomerClient têm o seguinte 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 de recurso do cliente-cliente que está vinculado ao cliente em questão. Somente leitura. |
level |
Distância entre determinado cliente e cliente. Para o self link, o valor do nível será 0. Somente leitura. |
time_zone |
Representação de string do 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 do cliente. Somente leitura. |
currency_code |
Código de moeda (por exemplo, "USD", "EUR") do cliente. Somente leitura. |
id |
O ID do cliente. Somente leitura. |
CustomerManagerLink
Representa a relação de vínculo entre cliente e gerente.
Campos | |
---|---|
resource_name |
Nome do recurso. Os nomes dos recursos 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 de gerente de clientes. Este campo é somente leitura. |
start_time |
O carimbo de data/hora em que o CustomerManagerLink foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
DoubleClickCampaignManagerSetting
configuração do DoubleClick 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 associada ao cliente no formato do banco de dados de fuso horário IANA, como America/New_York. |
DynamicSearchAdsSearchTermView
Uma visualização dos termos de pesquisa dos anúncios dinâmicos de pesquisa.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização dos termos de pesquisa dos anúncios dinâmicos de pesquisa. Os nomes dos recursos de visualização dos termos de pesquisa dos anúncios dinâmicos de pesquisa têm o seguinte formato:
|
landing_page |
O URL da página de destino selecionado dinamicamente da impressão. Este campo é somente leitura. |
GenderView
Uma visualização de gênero. O recurso "gender_view" reflete o estado de veiculação efetiva, em vez dos critérios adicionados. Um grupo de anúncios sem critérios de gênero por padrão é exibido para todos os sexos, portanto, 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 da 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 das constantes de recursos de segmentação geográfica têm o seguinte formato:
|
status |
Status da constante da segmentação geográfica. |
id |
O ID da constante de segmentação geográfica. |
name |
Nome em inglês constante da segmentação 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, da segmentação pai e do país. |
parent_geo_target |
O nome do recurso da constante mãe de segmentação geográfica. Os nomes das constantes de recursos de 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 de 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 formato: |
status |
Status do rótulo. Somente leitura. |
text_label |
Um tipo de rótulo que exibe texto em um 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 dos recursos de constantes de linguagem têm o seguinte formato:
|
id |
O ID da constante de idioma. |
code |
O código do idioma, por exemplo, "en_US", "en_AU", "es", "fr" etc. |
name |
O nome completo do idioma em inglês, por exemplo, "English (US)", "Spanish" etc. |
targetable |
Indica se o idioma pode ser segmentado. |
ListingGroupFilterDimension
Listando dimensões 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 pode ser apenas de um dos tipos a seguir: |
|
product_bidding_category |
Categoria de lance 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 |
ID do item de uma oferta de produto. |
product_type |
Tipo de oferta de um 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, suas 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 lance do produto. Ele é 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
ID do item de uma oferta de produto.
Campos | |
---|---|
value |
Valor do ID. |
ProductType
Tipo de oferta de um 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 do filtro do grupo de fichas (excluindo o nó raiz) até o filtro desse grupo. |
LocationView
Uma visualização de local resume o desempenho das campanhas por critério de local.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização do local. Os nomes dos recursos de visualização do local têm o seguinte formato:
|
ProductBiddingCategoryConstant
Uma categoria de lances do produto.
Campos | |
---|---|
resource_name |
O nome do recurso da categoria de lances do produto. Os nomes dos recursos das categorias de lances de produtos têm o seguinte formato:
|
level |
Nível da categoria de lances do produto. |
status |
Status da categoria de lance do produto. |
id |
ID da categoria de lance 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 lance do produto. |
product_bidding_category_constant_parent |
Nome do recurso da categoria de lances do produto principal. |
language_code |
Código do idioma da categoria de lances do produto. |
localized_name |
Valor de exibição da categoria de lances do produto localizada de acordo com o 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 de visualização do grupo de produtos têm o seguinte formato:
|
SearchAds360Field
Um campo ou recurso (artefato) usado pelo SearchAds360Service.
Campos | |
---|---|
resource_name |
O nome de recurso do artefato. Os nomes dos recursos do 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 que podem ser selecionados com o artefato descrito. Os campos desses recursos não segmentam métricas quando incluídas em consultas de pesquisa. Esse campo é definido apenas para artefatos com categoria RESOURCE. |
metrics[] |
Esse campo lista os nomes de todas as métricas que podem ser selecionadas com o artefato descrito quando ele é usado na cláusula FROM. É definido apenas para artefatos com categoria RESOURCE. |
segments[] |
Esse campo lista os nomes de todos os artefatos, seja um segmento ou outro recurso, que segmentam métricas quando incluídas em consultas de pesquisa e quando o artefato descrito é usado na cláusula FROM. É definido apenas para artefatos com categoria RESOURCE. |
enum_values[] |
Valores que o artefato pode assumir se for um campo do tipo ENUM. Este campo só é definido para artefatos da categoria SEGMENT ou ATTRIBUTE. |
data_type |
Esse campo determina os operadores que podem ser usados com o artefato em cláusulas WHERE. |
name |
O nome do artefato. |
selectable |
Se o artefato pode ser usado em uma cláusula SELECT em consultas de pesquisa. |
filterable |
Se o artefato pode ser usado em uma cláusula WHERE em consultas de pesquisa. |
sortable |
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 do campo é repetido. |
ShoppingPerformanceView
Visualização do desempenho do Shopping. Fornece estatísticas da campanha do Shopping agregadas em vários níveis de dimensão do produto. Os valores de dimensão de produto do Merchant Center, como marca, categoria, atributos personalizados, condição e tipo de produto, refletem o estado de cada dimensão na data e hora em que o evento correspondente foi registrado.
Campos | |
---|---|
resource_name |
O nome do recurso da visualização de desempenho do Shopping. Os nomes dos recursos da 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 pode não ser exclusivo (por exemplo, se access_reason=SHARED) |
Acessar
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 está 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 |
ID do recurso com o qual houve interação durante o evento de visita. |
asset_field_type |
Tipo de campo do recurso do evento da 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:
|