Notas da versão

v17.1.0 (07/08/2024)

Os novos recursos e atualizações a seguir foram adicionados na v17_1.

Recursos

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() permite remover recursos automáticos especificados vinculados a anúncios responsivos de pesquisa.

Públicos-alvo

• Novos valores de tipo enumerado em UserListCustomerTypeCategory:
  • LOYALTY_TIER_1_MEMBERS
  • LOYALTY_TIER_2_MEMBERS
  • LOYALTY_TIER_3_MEMBERS
  • LOYALTY_TIER_4_MEMBERS
  • LOYALTY_TIER_5_MEMBERS
  • LOYALTY_TIER_6_MEMBERS
  • LOYALTY_TIER_7_MEMBERS

Campanhas

• ShareablePreviewService.GenerateShareablePreviews() gera os URLs (shareable_preview_url na resposta) das visualizações de anúncios compartilháveis de grupos de recursos ativados e pausados.
  • O campo expiration_date_time indica a data de validade dos URLs na resposta.
  • Se ocorrer um erro, o método retornará partial_failure_error em vez dos URLs.

Histórico de alterações

• Novo tipo de recurso de status de mudança: ASSET_GROUP.

Conversões

• Novo campo de segmento para a versão SKAdNetwork: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary, que exibe os diagnósticos do upload de conversões no nível da ação de conversão.
• As métricas a seguir são adicionadas aos relatórios de diagnóstico off-line para transmitir o número de conversões enviadas que ainda estão sendo processadas:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary
    • pending_count

Planejamento

• AudienceInsights.GenerateAudienceOverlapInsights(), que aceita um atributo principal de entrada e uma coleção de atributos de público-alvo, além de retornar as estimativas de sobreposição do alcance em potencial do YouTube entre o atributo principal e os atributos de público-alvo.

Relatórios

• Suporte à segmentação de per_store_view com base em segments.date

Vídeos

• Suporte para recuperar informações relacionadas às seguintes estratégias de lances padrão para campanhas de vídeo usando relatórios, como ad_group e campaign:
  • Campaign.fixed_cpm (CPM fixo (custo por mil impressões))
  • Campaign.target_cpv (CPV (custo por visualização) desejado)
• Campaign.video_campaign_settings, que permite determinar em quais inventários os anúncios em vídeo podem ser exibidos usando os seguintes campos do relatório:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type, que permite segmentar os seguintes relatórios com base no tipo de formato do anúncio em vídeo:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

v17 (05/06/2024)

Os recursos e alterações a seguir foram adicionados na v17.

Anúncios

• AdService.getAd foi removido. Isso traz AdService de acordo com outros serviços da API Google Ads. Consulte Como recuperar objetos para a maneira recomendada de buscar anúncios e outros tipos de recursos.
• Adicionadas mais validações para ImageAdInfo.image_asset referente a as dimensões e o formato. Os seguintes erros podem ser gerados se a imagem for inválido:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Recursos

• Um novo tipo enumerado foi adicionado: ClickType.AD_IMAGE
• Os seguintes novos relatórios foram adicionados com novas métricas para campanhas Performance Max e de pesquisa:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Públicos-alvo

• OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED adicionado

Jobs em lote

• Adicionada BatchJobError.REQUEST_TOO_LARGE, que será gerada quando o AddBatchJobOperationsRequest enviado tiver mais de 10484504 bytes.
• Foi adicionado suporte à configuração MutateOperation.asset_group_operation. ao usar BatchJobService. Isso permite que você usar o processamento em lote para criar e gerenciar campanhas Performance Max inteiras. Confira nosso novo guia dedicado.

Campanhas

• Discovery renomeado para Geração de demanda em todos os campos, tipos enumerados e erros recursos da API Google Ads, como campanhas, anúncios e recursos. Para exemplo, AdvertisingChannelType.DISCOVERY agora está AdvertisingChannelType.DEMAND_GEN.
• Adicionada Campaign.keyword_match_type para permitir que você defina o tipo de correspondência de palavra-chave para todas as palavras-chave em uma campanha.

Conversões

• Para SKAdNetwork conversões
  • segments.sk_ad_network_conversion_value foi renomeado como segments.sk_ad_network_fine_conversion_value.
  • segments.sk_ad_network_redistributed_fine_conversion_value foi adicionado.
• As métricas a seguir agora são retornadas com a resposta, mesmo quando eles são zero. Isso as torna consistentes com outras métricas.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

Critérios

• Adicionado aos seguintes campos em AdGroupCriterion para mostrar se o critério do grupo de anúncios está sendo veiculado ou por que ele não está do modelo:
  • primary_status
  • primary_status_reasons
• Foi adicionado suporte para metrics.search_impression_share. para gender_view
• Foi adicionado suporte para metrics.phone_calls. para keyword_view

Serviços locais

• LocalServicesLeadService.AppendLeadConversation() adicionado usada para anexar um novo LocalServicesLeadConversation para LocalServicesLead, que envia a mensagens aos usuários por meio de canais apropriados, como SMS, dependendo de como lead foi criado.
  • O tamanho de AppendLeadConversationRequest.conversations é limitado a 1.000.
  • Apenas LocalServicesLead com lead_type definido como LeadType.MESSAGE pode ser especificado Conversation.local_services_lead.
• Novos valores de tipo enumerado foram adicionados ConversationType
  • WHATSAPP para representar uma conversa iniciada pelo WhatsApp.
  • ADS_API para representar uma conversa iniciada usando o novo LocalServicesLeadService.AppendLeadConversation() .
• Estes novos campos foram adicionados a local_services_verification_artifact:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

Relatórios

• Agora é possível selecionar apenas campos relacionados a um produto vinculado ao consultar product_link. Seleção de vários campos de vários produtos vinculados gerará QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Por exemplo: product_link.advertising_partner.customer e product_link.data_partner.data_partner_id não podem ser selecionados na mesma consulta.
• Como transmitir um page_size para GoogleAdsService.Search vai resultar em uma RequestError.PAGE_SIZE_NOT_SUPPORTED erro.

Compras

• Adicionamos um novo relatório shopping_product, que corresponde à página Produtos da interface do Google Ads. Ele é compatível com o retorno dados relacionados ao estado atual dos produtos do Google Merchant Center contas vinculadas a uma conta do Google Ads.
  • É possível filtrar métricas shopping_product gera um relatório usando segments.date ao usar GoogleAdsService.Search ou GoogleAdsService.SearchStream A segmentação por data não é permitida e retornará um ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION erro.

Metas unificadas

• UserListCustomerTypeService.MutateUserListCustomerTypes() adicionado para configurar o público-alvo tipos.
• CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings foi removido. Para definir as configurações de público-alvo das metas de ciclo de vida do cliente, use UserListCustomerTypeService.MutateUserListCustomerTypes().
  • Anexar ou remover uma lista de usuários por configuração UserListCustomerType.customer_type_category para UserListCustomerTypeCategory.PURCHASERS para incluí-la ou excluí-la de uma definição de cliente existente. para as metas de ciclo de vida do cliente, respectivamente. Acesse segmente sua públicos-alvo para mais detalhes.

Vídeos

• Os seguintes valores foram adicionados ao ContentLabelType Você pode excluir estes ContentLabelTypes no nível do cliente:
  • BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
  • BRAND_SUITABILITY_GAMES_FIGHTING
  • BRAND_SUITABILITY_GAMES_MATURE
  • BRAND_SUITABILITY_HEALTH_SENSITIVE
  • BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
  • BRAND_SUITABILITY_NEWS_RECENT
  • BRAND_SUITABILITY_NEWS_SENSITIVE
  • BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
  • BRAND_SUITABILITY_POLITICS
  • BRAND_SUITABILITY_RELIGION
• AdVideoAsset.ad_video_asset_info adicionado oferecer suporte às preferências de inventário para recursos de vídeo ao criar DemandGenVideoResponsiveAdInfo
• (Somente contas da lista de permissões) Criado Campaign.video_brand_safety_suitability mutável.

v16.1.0 (24/04/2024)

Os seguintes recursos e mudanças foram adicionados na v16.1.

Gerenciamento da conta

• CustomerNegativeCriterion.ip_block que permite adicionar um IP como critério negativo no nível do cliente.
• Novo valor de tipo enumerado: ProductLinkError.LINK_EXISTS
• Novo valor de tipo enumerado: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION

Recursos

• Suporte a recursos relacionados a Geração de demanda para ad_group_ad_asset_view e asset_field_type_view
• Novo valor de tipo enumerado: AssetFieldType.DISCOVERY_CAROUSEL_CARD

Públicos-alvo

• Novo valor de enumeração: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER o que limita o número de listas de usuários parecidos que um cliente pode ter a 1.000.

Campanhas

• Suporte para retornar Target de ROAS desejado para As campanhas para apps que usam Relatório campaign_simulation.
• Novo valor de tipo enumerado: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
• Novo valor de tipo enumerado: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
• Novo valor de tipo enumerado: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS

Conversões

• SkAdNetworkConversionValueSchema.postback_mappings que oferece suporte à SKAdNetwork 4,0 atributos de machine learning.
• Adicionado suporte para avisos para CustomerSkAdNetworkConversionValueSchemaService quando MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings Quando definido como true, todos os erros sem bloqueio relacionados a falhas de operação será retornado como MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning.
• Novos valores de tipo enumerado em CustomerSkAdNetworkConversionValueSchemaError:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

Critérios

• Novos campos no BrandInfo:
  • display_name
  • primary_url
  • rejection_reason
  • status
• Novo tipo enumerado: BrandRequestRejectionReason
• Novo valor de tipo enumerado: CriterionType.LIFE_EVENT

Experimentos

• Novo valor de enumeração: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT.

Serviços locais

• local_services_lead.credit_details.credit_state e local_services_lead.credit_details.credit_state_last_update_date_time que retorna o estado do crédito e o carimbo de data/hora em que o estado foi atualizada, respectivamente.
• local_services_lead_conversation.message_details.attachment_urls que retorna os URLs que podem ser usados para fazer o download do conteúdo do anexo.

Vídeos

• customer.video_brand_safety_suitability e BrandSafetySuitability que ajudam a recuperar a adequação de brand safety do vídeo para o cliente nível
• Novo valor de enumeração: VideoCampaignError.MUTATE_REQUIRES_RESERVATION.

v16 (21/02/2024)

Os seguintes recursos e alterações foram adicionados na v16.

Gerenciamento da conta

• advertising_partner migrado de AccountLink para ProductLink e ProductLinkInvitation.
• data_partner e google_ads foram removidos de AccountLink.
• Adicionada IdentityVerificationService para gerenciar a verificação do anunciante.
  • StartIdentityVerification() é usada para iniciar uma sessão de verificação usando o verification_program Ele cria uma nova sessão de verificação e retorna uma resposta vazia para um verificação criada com sucesso.
    • Adicionada IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION
  • GetIdentityVerification() pode ser usada para recuperar informações de verificação, que retorna vários objetos de IdentityVerification. Cada IdentityVerification inclui:
    • verification_program que é o tipo de programa de verificação de identidade
    • identity_verification_requirement que contém detalhes relacionados ao prazo em que o o anunciante deve concluir a verificação
    • verification_progress que contém detalhes relacionados à sessão de verificação, incluindo:
      • program_status representa o status atual do item. sessão de verificação
      • action_url direciona o cliente a um URL para concluir o verificação.
      • invitation_link_expiration_time representa a data de validade. para o action_url
  • Enumerados:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Erros:
    • IdentityVerificationError
• Adicionada AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT

Recursos

• Mudanças no asset_group:
  • Adição de suporte para segmentos relacionados ao tempo, como segments.year e segments.month
  • Transformou campaign em um recurso atribuído em vez de de segmentação de recursos.

Campanhas

• Mudanças nas campanhas Geração de demanda:
  • Agora é possível usar a configuração Campaign.shopping_setting para uma campanha Geração de demanda.
  • Adicionada ShoppingSetting.disable_product_feed para desativar o feed de produtos opcional das campanhas Geração de demanda.
  • Ad.demand_gen_product_ad adicionado e as respostas DemandGenProductAdInfo, disponível para Campanhas Geração de demanda com valor não nulo Campaign.shopping_setting.
• Adicionado aos campos a seguir a AdGroup para mostrar se o grupo de anúncios está sendo veiculado ou os motivos para isso não acontecer:
  • primary_status
  • primary_status_reasons
• Adicionado aos campos a seguir a AdGroupAd para mostrar se o anúncio do grupo de anúncios está sendo veiculado ou por que ele não está sendo veiculado:
  • primary_status
  • primary_status_reasons
• Os seguintes valores foram adicionados ao AdGroupError
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

Experimento

• Experiment.sync_enabled foi adicionado a especificar se a sincronização deve ser ativada no experimento. Com sincronização ativado, as alterações feitas para a campanha original enquanto a experiência está sendo realizada, são automaticamente copiado para a campanha experimental.
• Adicionada ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
• Adicionada CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL

Hotel e Viagens

• Os seguintes campos foram adicionados ao ListingDimensionInfo em uma seção de Coisas legais para fazer para permitir a criação de grupos de produtos anunciados com base no estado e na cidade em que o atividades de viagem disponíveis:
  • activity_state
  • activity_city
• Adicionado suporte para os seguintes segmentos a travel_activity_performance_view
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Serviços locais

• Adicionada LocalServicesVerificationArtifact.business_registration_check_verification_artifact e BusinessRegistrationCheckArtifact para permitir que os anunciantes monitorem o andamento do registro da empresa o processo de verificação.
• Novo recurso adicionado local_services_employee para permitir anunciantes recuperem as informações de funcionários que eles adicionaram.

Planejamento

• score removido de AudienceInsightsAttributeMetadata.

Recomendações

• Adicionada RecommendationService.GenerateRecommendations() que retorna recomendações com base nas configurações especificadas, como recomendações e tipos de canais de publicidade. Isso é especialmente útil durante a criação da campanha.
• Adicionada RecommendationMetrics.conversions_value
• As palavras-chave recomendadas com tipo de correspondência não definido agora têm recommended_match_type Defina como UNSPECIFIED em vez de UNKNOWN.
• Os seguintes tipos de recomendações foram adicionados:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN que recomenda ativar a estratégia de lances "Maximizar o valor da conversão". estratégia
  • IMPROVE_GOOGLE_TAG_COVERAGE que recomenda a implantação da tag do Google em mais páginas
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN que recomenda ativar a expansão de URL final nas campanhas Performance Max campanhas
  • REFRESH_CUSTOMER_MATCH_LIST que recomenda atualizar uma lista de clientes que não foi atualizada em nos últimos 90 dias
  • CUSTOM_AUDIENCE_OPT_IN que recomenda criar um público-alvo personalizado
  • LEAD_FORM_ASSET que recomenda adicionar recursos de formulário de lead à campanha ou ao cliente nível
  • IMPROVE_DEMAND_GEN_AD_STRENGTH que recomenda melhorar a qualidade do anúncio em campanhas Geração de demanda

Compras

• Adicionada CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT e CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS para fornecer erros mais detalhados às campanhas do Shopping vinculadas a uma Central de serviços de comparação de preços padrão.
• Os seguintes valores foram adicionados ao AssetGroupListingGroupFilterError
  • DIMENSION_TYPE_NOT_ALLOWED
  • DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
  • FILTER_EXCLUSION_NOT_ALLOWED
  • LISTING_SOURCE_NOT_ALLOWED
  • MULTIPLE_LISTING_SOURCES
  • MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
  • MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
  • PAGE_FEED_FILTER_HAS_PARENT

Metas de ciclo de vida

• update foi adicionado a CustomerLifecycleGoalOperation e CampaignLifecycleGoalOperation para deixar esses tipos de operação consistentes com outros na API.

v15 (18-10-2023)

Os novos recursos e atualizações a seguir foram introduzidos na v15.

Gerenciamento da conta

• Se sua conta for suspensa devido a uma conta não autorizada, atividade, customer.status e customer_client.status agora são retornados como SUSPENDED. Antes, elas eram retornadas como ENABLED
• Agora é possível adicionar e remover um vínculo entre uma conta do Google Ads e uma conta do Merchant Center:
  • Adicionada ProductLink.merchant_center e MerchantCenterIdentifier
  • Adicionada LinkedProductType.MERCHANT_CENTER
• Adicionada ProductLinkInvitationService e ProductLinkInvitation para oferecer suporte atualizando um convite de vinculação enviado por outros produtos, disponível para Hotel Merchant Center e Merchant do Google.
• MerchantCenterLinkService foi removido.
  • Para vincular contas do Google Ads com contas do Merchant Center, use ProductLinkInvitationService e ProductLinkService.
• Remoção de AccountLink.hotel_center e suporte para atualização de convites de links das contas da Central para Hotéis usando AccountLinkService.
  • Para atualizar um convite de vinculação de uma conta da Central para Hotéis, use ProductLinkInvitationService

Recursos

• ImageAdInfo.media_file substituído por ImageAdInfo.image_asset para oferecer suporte adicionar e remover imagens usando os recursos. Como resultado, também removemos MediaFileService, que não é mais necessário.
• Adicionada ListingGroupFilterDimension.webpage oferecer suporte à criação de um filtro de grupo de fichas com base em rótulos e URLs personalizados substrings codificadas.
  • AssetGroupListingGroupFilter.vertical também foi substituído por AssetGroupListingGroupFilter.listing_source e ListingGroupFilterListingSource
• asset_group_asset.source foi adicionado para mostrar a origem do recurso do grupo de recursos.
• Adicionada ad_group_ad_asset_view.source para mostrar a origem do recurso de anúncio do grupo de anúncios.

Públicos-alvo

• Para Segmentação por lista de clientes, adicionada CustomerMatchUserListMetadata.consent suporte ao consentimento. A partir de 6 de março de 2024, se o consentimento for ausente para usuários do EEE, o valor do consentimento será determinado como não consentido. Os dados de usuários do EEE sem consentimento de cookies não serão processados e não poderão ser usados para anúncios personalização usando a Segmentação por lista de clientes. Confira nossa Guia da Segmentação por lista de clientes para mais detalhes.
• Para vendas na loja, adicionado UserData.consent a suporte para fornecer um consentimento. Confira nossa Guia de vendas na loja para mais detalhes. Se você usa a Segmentação por lista de clientes com vendas na loja, consulte Perguntas frequentes para informações imprecisas ou inadequadas.
• Adicionada UserList.lookalike_user_list para oferecem suporte à criação de um parecido segmento, um público-alvo criado com base no público-alvo de origem informado. É possível usar segmentos semelhantes em uma campanha Geração de demanda .

Campanhas

• Atualizações nas campanhas Performance Max:

  • O AssetGroupSignal agora oferece suporte a duas que podem ser anexados a um grupo de recursos para aprimorar a segmentação:
    • AssetGroupSignal.audience
      • Adicionados Audience.scope e Audience.asset_group para limitar uso do público-alvo a um grupo de recursos específico. Audience.asset_group precisa ser definido somente se Audience.scope for ASSET_GROUP.
    • AssetGroupSignal.search_theme
      • Adicionada CriterionType.SEARCH_THEME para oferecer suporte a esse novo tipo de critério. Esse novo tipo de critério só pode ser usados em campanhas Performance Max para criar uma AssetGroupSignal preenchendo o AssetGroupSignal.search_theme com um critério SearchThemeInfo.
  • Adicionada AssetGroupSignalOperation.exempt_policy_violation_keys para oferecer suporte à solicitação de isenção ao adicionar indicadores do grupo de recursos.
  • Um novo item foi adicionado asset_group_top_combination_view para informar os recursos com melhor performance no nível do grupo.
  • Agora é possível consultar asset_group com campos de métricas. para ajudar na recuperação da performance de uma campanha Performance Max.
  • Em PerformanceMaxUpgradeStatus, UPGRADE_ELIGIBLE foi renomeado como UPGRADE_ELIGIBLE.

• Para Geração de demanda e Descoberta campanhas de CPA desejado, simulações de lances de CPA desejado no nível da campanha (campaign_simulation.target_cpa_point_list.points) agora retorna TargetCpaSimulationPoint.interactions em vez de TargetCpaSimulationPoint.clicks.

• Adição de BrandSuggestionService, que pode Sugerir marcas com base no prefixo de marca fornecido e na lista excluída de marcas. Essas marcas podem ser usadas para criar Critério BRAND adicionado a um conjunto compartilhado de BRANDS, e anexados a uma campanha criando um CampaignCriterion com brand_list definido como o conjunto compartilhado. Os critérios da campanha podem ser segmentados em campanhas de pesquisa e excluídos em e Performance Max, respectivamente.

  • Campos:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Enumerados:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• Adicionada Campaign.asset_automation_settings[] para mostrar o status da automação de cada tipo de recurso.

• Adicionados os seguintes valores ao CampaignPrimaryStatusReason enumeração:

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

Conversões

• Adicionados CallConversion.consent e ClickConversion.consent para oferecer suporte dar consentimento. Confira nossa guia de conversões de chamada e no guia de conversões de clique para mais detalhes.
• Adicionados os seguintes campos relacionados a SKAdNetwork disponíveis ao fazer consultas com customer ou campaign:
  • Segmentos:
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • Métricas:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• metrics.sk_ad_network_conversions substituído por metrics.sk_ad_network_installs.
• Agora é possível diagnosticar o upload de conversões off-line
  • Moveu a offline_conversion_upload_client_summary de um campo no recurso customer para um relatório de nível superior. Usar para obter detalhes úteis do status de upload da conversão, como o contagem de eventos bem-sucedidos, taxa de sucesso e porcentagem de erros.
    • Advertência: uma conversão que é enviada, mas resulta em um ConversionUploadError.CLICK_NOT_FOUND ainda é contado como bem-sucedido, mas também é sinalizado como um OfflineConversionAlert
  • job_id foi adicionado como um parâmetro opcional para os seguintes tipos de solicitação para que é possível agrupar logicamente várias solicitações de upload em uma única trabalho:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • INVALID_JOB_ID foi adicionado aos seguintes erros:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • INVALID_CONVERSION_ACTION substituído por NO_CONVERSION_ACTION_FOUND e INVALID_CONVERSION_ACTION_TYPE nos seguintes erros:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• Adicionamos três relatórios para dar suporte a várias redes do Sandbox de privacidade do Android. atribuição sem redirecionamentos:
  • android_privacy_shared_key_google_campaign, que contém shared_campaign_key e alguns campos que ajudam a codificar a chave.
  • android_privacy_shared_key_google_ad_group, que contém shared_ad_group_key e alguns campos que ajudam a codificar a chave.
  • android_privacy_shared_key_google_network_type, que contém shared_network_type_key e alguns campos que ajudam a codificar a chave.
• Adicionada ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS Um ConversionActionOperation que tenta usar um dos recursos de atribuição baseada em regras descontinuados modelos agora falha com este erro. Anteriormente, a operação falhava com uma UNKNOWN erro.

Hotel e Viagens

• Foi adicionado suporte para os seguintes campos em travel_activity_group_view e travel_activity_performance_view:
  • Segmentos:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • Métricas:
    • metrics.search_absolute_top_impression_share
    • metrics.search_budget_lost_absolute_top_impression_share
    • metrics.search_budget_lost_impression_share
    • metrics.search_budget_lost_top_impression_share
    • metrics.search_impression_share
    • metrics.search_rank_lost_absolute_top_impression_share
    • metrics.search_rank_lost_impression_share
    • metrics.search_rank_lost_top_impression_share
    • metrics.search_top_impression_share

Anúncios dos Serviços Locais

• LocalServicesSettings e os respectivos ao relatório customer para retornar um erro Local Status granular de licença e seguro do anunciante de serviços.
• Adicionamos os novos relatórios a seguir para Relatórios locais Serviços:
  • local_services_lead contém todos os detalhes sobre os Serviços locais Leads do Google Ads, como lead_charged, lead_type, lead_status.
    • Enumerados:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation contém detalhes da mensagem e da conversa telefônica, como conversation_channel, call_duration_millis, call_recording_url.
    • O URL de gravação de chamada telefônica é autenticado no cliente de destino e suas contas de administrador.
  • local_services_verification_artifact retorna artefatos de um anunciante dos Serviços Locais, como investigação de histórico para contratação, licenças comerciais e dados de seguros corporativos. Todos os documentos associados com licença e seguro podem ser acessados por um URL.
    • Enumerados:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

Planejamento

• Foi adicionado suporte para retornar Forecast.views e PlannedProductForecast.views para ReachPlanService.ListPlannableProducts para os tipos de produto aplicáveis.
• Agora é possível devolver o dispositivo PlannableTargeting.surface_targeting para ReachPlanService.ListPlannableProducts, que descreve as superfícies disponíveis para um produto.
• Um novo item foi adicionado Enumeração ReachPlanSurface.
• Adicionado suporte para segmentação Target frequência usando AdvancedProductTargeting.target_frequency_settings, que retorna PlannedProductForecast.average_frequency
• Adicionada AudienceInsightsService.GenerateSuggestedTargetingInsights para retornar públicos-alvo segmentáveis sugeridos.
• Os seguintes valores foram adicionados ao ReachPlanError
  • NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
  • NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

Recomendações

• Adicionada RecommendationSubscriptionService que gerencia as inscrições das recomendações:
  • Recurso: RecommendationSubscription
  • Campo: MutateOperation.recommendation_subscription_operation
  • Enumeração: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • Erros:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• Os seguintes tipos de recomendações foram adicionados:
  • FORECASTING_SET_TARGET_CPA que recomenda definir um CPA desejado para campanhas que não têm esse especificado, antes de um evento sazonal com previsão de aumento do tráfego de entrada.
  • SET_TARGET_CPA que recomenda definir um CPA desejado para campanhas que não têm esse especificado.
  • SET_TARGET_ROAS que recomenda definir um ROAS desejado para as campanhas que não têm um especificado.

Relatórios

• Foram adicionadas as novas métricas a seguir, que podem ser consultadas com campaign (disponível para campanhas Discovery, de display, de vídeo e campanhas para apps) e segments.device:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

Compras

• Remoção de ShoppingSetting.sales_country, cujos valores agora são retornados como ShoppingSetting.feed_label.
  • Você pode continuar usando uma conta do Merchant Center feed para uma campanha usando as ShoppingSetting.feed_label . Ele precisa ser definido como o valor do rótulo do feed ou o país de duas letras código usado anteriormente para ShoppingSetting.sales_country. Para mais detalhes, consulte o artigo de suporte para feed rótulos.
• Removida a dependência de categorias de produto em um código de país nos relatórios. O conjunto de IDs de categoria com suporte não mudou.
  • Os seguintes campos usados em shopping_performance_view
    • segments.product_bidding_category_level1 com segments.product_category_level1
    • segments.product_bidding_category_level2 com segments.product_category_level2
    • segments.product_bidding_category_level3 com segments.product_category_level3
    • segments.product_bidding_category_level4 com segments.product_category_level4
    • segments.product_bidding_category_level5 com segments.product_category_level5
  • product_bidding_category_constant substituído por product_category_constant, que retorna todas as localizações disponíveis de uma categoria em um campo repetido.
  • ListingDimensionInfo.product_bidding_category substituído por ListingDimensionInfo.product_category.
  • ListingGroupFilterDimension.product_bidding_category substituído por ListingGroupFilterDimension.product_category.
• Remoção do suporte para adição Campaign.shopping_setting para pesquisar campanhas. Tentar criar uma campanha de pesquisa com Campaign.shopping_setting ou adicionar Campaign.shopping_setting para um campanha da Rede de Pesquisa atual resulta em OPERATION_NOT_PERMITTED_FOR_CONTEXT
• Remoção do suporte para adição CampaignCriterion.listing_scope às campanhas de pesquisa. Tentando adicionar CampaignCriterion.listing_scope a uma campanha da Rede de Pesquisa existente agora resulta em OPERATION_NOT_PERMITTED_FOR_CONTEXT
• As seguintes conversões com o carrinho foram adicionadas data:
  • metrics.orders
  • metrics.average_order_value_micros
  • metrics.average_cart_size
  • metrics.cost_of_goods_sold_micros
  • metrics.gross_profit_micros
  • metrics.gross_profit_margin
  • metrics.revenue_micros
  • metrics.units_sold
  • metrics.cross_sell_cost_of_goods_sold_micros
  • metrics.cross_sell_gross_profit_micros
  • metrics.cross_sell_revenue_micros
  • metrics.cross_sell_units_sold
  • metrics.lead_cost_of_goods_sold_micros
  • metrics.lead_gross_profit_micros
  • metrics.lead_revenue_micros
  • metrics.lead_units_sold
  • Todas essas métricas podem ser selecionadas com os seguintes relatórios:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

Metas unificadas

• Adicionada CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals para configurar as metas de aquisição no nível do cliente.
  • Relatório: customer_lifecycle_goal
• Adicionada CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals para configurar as metas de aquisição de clientes no nível da campanha.
  • Relatório: campaign_lifecycle_goal
• Adicionada CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
• Os seguintes valores foram adicionados ao ConversionGoalCampaignConfigError
  • EMPTY_CONVERSION_GOALS
  • STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
  • PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES

Vídeos

• Suporte adicional para a segmentação do Google TV no nível da campanha:
  • Adicionada NetworkSettings.target_google_tv_network
  • Adicionada AdNetworkType.GOOGLE_TV
• Agora é possível segmentar o YouTube no nível da campanha:
  • Adicionada NetworkSettings.target_youtube
  • Em AdNetworkType, mesclado YOUTUBE_WATCH e YOUTUBE_SEARCH em YOUTUBE.
  • Adicionada CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE

Notas de lançamento arquivadas

Acesse Versões desativadas para conferir as notas arquivadas.