Notas da versão

v17 (05/06/2024)

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

Anúncios

• AdService.getAd foi removido. Assim, o AdService fica alinhado a outros serviços da API Google Ads. Consulte Como recuperar objetos para conferir a maneira recomendada de buscar anúncios e outros tipos de recursos.
• Adicionamos mais validações para ImageAdInfo.image_asset relacionadas a dimensões e formato. Os erros a seguir podem ser gerados se a imagem for inválida:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Recursos

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

Públicos-alvos

• OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED adicionado

Jobs em lote

• Adição de BatchJobError.REQUEST_TOO_LARGE, que será gerado quando o AddBatchJobOperationsRequest enviado for maior que 10484504 bytes.
• Foi adicionado suporte à configuração MutateOperation.asset_group_operation ao usar BatchJobService. Assim, é possível usar o processamento em lote para criar e gerenciar campanhas Performance Max inteiras. Confira nosso novo guia dedicado.

Campanhas

• O Discovery foi renomeado como Geração de demanda em todos os campos, tipos enumerados e erros em todos os recursos na API Google Ads, como campanhas, anúncios e recursos. Por exemplo, AdvertisingChannelType.DISCOVERY agora é AdvertisingChannelType.DEMAND_GEN.
• Adicionamos 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 conversões da SKAdNetwork,
  • 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 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 campos a seguir a AdGroupCriterion para mostrar se o critério do grupo de anúncios está sendo veiculado ou os motivos para isso:
  • primary_status
  • primary_status_reasons
• Foi adicionado suporte a metrics.search_impression_share para gender_view.
• Foi adicionado suporte a metrics.phone_calls para keyword_view.

Serviços locais

• Adicionamos LocalServicesLeadService.AppendLeadConversation(), usado para anexar um novo LocalServicesLeadConversation a LocalServicesLead, que envia as mensagens aos usuários por canais adequados, como SMS, dependendo de como o lead foi criado.
  • O tamanho de AppendLeadConversationRequest.conversations é limitado a 1.000.
  • Somente LocalServicesLead com lead_type definido como LeadType.MESSAGE pode ser especificado em Conversation.local_services_lead.
• Novos valores de tipo enumerado foram adicionados a ConversationType:
  • WHATSAPP para representar uma conversa iniciada pelo WhatsApp.
  • ADS_API para representar uma conversa introduzida usando o novo método 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ório

• Agora é possível selecionar apenas campos relacionados a um produto vinculado ao consultar product_link. A seleção de vários campos de vários produtos vinculados gera 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.
• Transmitir um page_size para GoogleAdsService.Search vai resultar em um erro RequestError.PAGE_SIZE_NOT_SUPPORTED.

Compras

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

Metas unificadas

• Adicionamos UserListCustomerTypeService.MutateUserListCustomerTypes() para configurar tipos de clientes de público-alvo.
• 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().
  • Anexe ou remova uma lista de usuários definindo UserListCustomerType.customer_type_category como UserListCustomerTypeCategory.PURCHASERS para incluí-la ou excluí-la de uma definição de cliente atual para metas de ciclo de vida do cliente, respectivamente. Acesse segmentar seus públicos-alvo para mais detalhes.

Vídeos

• Os valores abaixo foram adicionados a ContentLabelType. Você pode excluir esses 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 foi adicionado para oferecer suporte às preferências de inventário para recursos de vídeo ao criar DemandGenVideoResponsiveAdInfo.
• (Apenas contas na lista de permissões) Agora o 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 oferece suporte à adição de um IP como um critério negativo no nível do cliente.
• Novo valor de enumeração: ProductLinkError.LINK_EXISTS.
• Novo valor de enumeração: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION.

Recursos

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

Públicos-alvos

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

Campanhas

• Suporte para retornar simulações de lances de campanhas de ROAS desejado em campanhas para apps usando o relatório campaign_simulation.
• Novo valor de enumeração: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN.
• Novo valor de enumeração: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY.
• Novo valor de enumeração: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS.

Conversões

• SkAdNetworkConversionValueSchema.postback_mappings, que é compatível com recursos da SKAdNetwork 4.0.
• Foi adicionado suporte a avisos para CustomerSkAdNetworkConversionValueSchemaService como MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings. Quando definido como true, todos os erros sem bloqueio relativos a falhas de operação serão retornados como MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning.
• Novos valores de tipo enumerado em CustomerSkAdNetworkConversionValueSchemaError:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

Critérios

• Novos campos em BrandInfo:
  • display_name
  • primary_url
  • rejection_reason
  • status
• Novo tipo enumerado: BrandRequestRejectionReason.
• Novo valor de enumeração: 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 retornam o estado do crédito e o carimbo de data/hora em que o estado de crédito foi atualizado, 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 são compatíveis com a recuperação de adequação de brand safety de vídeo no nível do cliente.
• 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

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

Recursos

• Mudanças no asset_group:
  • Foi adicionado suporte a segmentos relacionados ao tempo, como segments.year e segments.month.
  • A classe campaign passou a ser um recurso atribuído em vez de segmentar o recurso.

Campanhas

• Mudanças nas campanhas Geração de demanda:
  • Foi adicionado suporte à configuração de Campaign.shopping_setting em uma campanha Geração de demanda.
  • ShoppingSetting.disable_product_feed foi adicionado para desativar o feed de produtos opcional das campanhas Geração de demanda.
  • Ad.demand_gen_product_ad e o DemandGenProductAdInfo correspondente, disponível para campanhas Geração de demanda com um Campaign.shopping_setting não nulo, foram adicionados.
• Adicionado aos campos a seguir a AdGroup para mostrar se o grupo de anúncios está sendo veiculado ou os motivos para isso:
  • 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 os motivos para isso:
  • primary_status
  • primary_status_reasons
• Os seguintes valores foram adicionados a AdGroupError:
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

Testar

• Experiment.sync_enabled foi adicionado para especificar se a sincronização precisa ser ativada no experimento. Com a sincronização ativada, as alterações feitas na campanha original enquanto o experimento está em execução são automaticamente copiadas para a campanha experimental.
• ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE foi adicionado.
• CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL foi adicionado.

Hotel e viagens

• Adicionamos os seguintes campos a ListingDimensionInfo em um anúncio da seção "Coisas legais para fazer" para permitir a criação de grupos de produtos anunciados com base no estado e na cidade em que a atividade de viagem está disponível:
  • activity_state
  • activity_city
• Foi adicionado suporte aos seguintes segmentos a travel_activity_performance_view:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Serviços locais

• LocalServicesVerificationArtifact.business_registration_check_verification_artifact e BusinessRegistrationCheckArtifact foram adicionados para permitir que os anunciantes monitorem o andamento do processo de verificação do registro da empresa.
• Foi adicionado um novo recurso local_services_employee para permitir que os anunciantes recuperem as informações de funcionários adicionadas.

planejamento

• score foi removido de AudienceInsightsAttributeMetadata.

Recomendações

• RecommendationService.GenerateRecommendations() foi adicionado, que retorna recomendações com base nas configurações especificadas, como tipos de recomendações e tipos de canais de publicidade. Isso é especialmente útil durante a criação da campanha.
• RecommendationMetrics.conversions_value foi adicionado.
• As palavras-chave recomendadas sem tipo definido agora têm recommended_match_type definido como UNSPECIFIED em vez de UNKNOWN.
• Os seguintes tipos de recomendações foram adicionados:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN que recomenda a ativação da estratégia de lances "Maximizar o valor da conversão".
  • 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 suas campanhas Performance Max
  • REFRESH_CUSTOMER_MATCH_LIST que recomenda atualizar uma lista de clientes que não foi atualizada nos últimos 90 dias.
  • CUSTOM_AUDIENCE_OPT_IN que recomenda a criação de um público-alvo personalizado
  • LEAD_FORM_ASSET, que recomenda adicionar recursos de formulário de lead no nível da campanha ou do cliente.
  • IMPROVE_DEMAND_GEN_AD_STRENGTH que recomenda melhorar a qualidade do anúncio em campanhas Geração de demanda.

Compras

• Adicionamos CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT e CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS para fornecer erros mais detalhados a campanhas do Shopping vinculadas a uma conta do Comparison Shopping Service Center.
• Os seguintes valores foram adicionados a 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 tornar esses tipos de operação consistentes com outros tipos 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 atividade não autorizada, customer.status e customer_client.status agora serã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:
  • Foram adicionados ProductLink.merchant_center e MerchantCenterIdentifier.
  • LinkedProductType.MERCHANT_CENTER foi adicionado.
• Adicionamos ProductLinkInvitationService e ProductLinkInvitation para oferecer suporte à atualização de um convite de link enviado de outros produtos, disponível para contas do Hotel Center e do Merchant Center.
• MerchantCenterLinkService foi removido.
  • Para vincular contas do Google Ads e do Merchant Center, use ProductLinkInvitationService e ProductLinkService.
• Remoção de AccountLink.hotel_center e suporte à atualização de convites de vinculação 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 foi substituído por ImageAdInfo.image_asset para oferecer suporte à adição e remoção de imagens usando os recursos. Como resultado, também removemos MediaFileService, que não é mais necessário.
• ListingGroupFilterDimension.webpage foi adicionado para oferecer suporte à criação de um filtro de grupo de fichas com base em rótulos personalizados e substrings de URL.
  • 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.
• ad_group_ad_asset_view.source foi adicionado para mostrar a origem do recurso de anúncio do grupo de anúncios.

Públicos-alvos

• Para a Segmentação por lista de clientes, adicionada CustomerMatchUserListMetadata.consent para aceitar o consentimento. A partir de 6 de março de 2024, se não houver consentimento para os usuários do EEE, o valor de consentimento será considerado "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 personalização de anúncios pela Segmentação por lista de clientes. Confira nosso guia de Segmentação por lista de clientes para mais detalhes.
• Para vendas na loja, foi adicionado UserData.consent para aceitar o consentimento. Confira nosso Guia de vendas na loja para mais detalhes. Se você usa a Segmentação por lista de clientes com vendas na loja, consulte as Perguntas frequentes para mais informações.
• UserList.lookalike_user_list foi adicionado para oferecer suporte à criação de um segmento semelhante, um público-alvo criado com base no público-alvo de origem fornecido. Eles só podem ser usados em uma campanha Geração de demanda.

Campanhas

• Atualizações nas campanhas Performance Max:

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

• Para campanhas de geração de demanda e Discovery, as simulações de lance de CPA desejado no nível da campanha (campaign_simulation.target_cpa_point_list.points) agora retornam TargetCpaSimulationPoint.interactions em vez de TargetCpaSimulationPoint.clicks.

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

  • Campos:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Enumerações:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

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

• Os seguintes valores foram adicionados ao enum CampaignPrimaryStatusReason:

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

Conversões

• CallConversion.consent e ClickConversion.consent foram adicionados para oferecer suporte ao consentimento. Confira os guias de conversões de chamada e de cliques para mais detalhes.
• Foram adicionados os seguintes campos relacionados às conversões da SKAdNetwork, disponíveis na consulta 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 foi substituído por metrics.sk_ad_network_installs.
• Foi adicionado suporte para diagnóstico de upload de conversões off-line.
  • offline_conversion_upload_client_summary foi movido de um campo no recurso customer para um relatório de nível superior. Use esse relatório para ver detalhes úteis do status de upload de conversões, como a contagem de eventos bem-sucedidos, a taxa de sucesso e a porcentagem de erros.
    • Advertência: uma conversão que é enviada, mas resulta em um erro ConversionUploadError.CLICK_NOT_FOUND, ainda é contada como bem-sucedida, mas também é sinalizada como um OfflineConversionAlert.
  • job_id foi adicionado como um parâmetro opcional para os tipos de solicitação a seguir. Assim, é possível agrupar logicamente várias solicitações de upload em um único job conceitual:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • INVALID_JOB_ID foi adicionado aos seguintes erros:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • INVALID_CONVERSION_ACTION foi substituído por NO_CONVERSION_ACTION_FOUND e INVALID_CONVERSION_ACTION_TYPE nos seguintes erros:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• Adicionamos três relatórios para oferecer suporte à atribuição de várias redes do Sandbox de privacidade do Android 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.
• ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS foi adicionado. Uma ConversionActionOperation que tenta usar um dos modelos de atribuição baseados em regras descontinuados agora falha com esse erro. Anteriormente, a operação falharia com um erro UNKNOWN.

Hotel e viagens

• Foi adicionado suporte aos 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

• Adicionamos LocalServicesSettings e os campos relacionados ao relatório customer para retornar os status granulares de licença e seguro de um anunciante dos Serviços Locais.
• Os seguintes novos relatórios foram adicionados para Serviços locais:
  • local_services_lead contém todos os detalhes relacionados aos leads dos anúncios dos Serviços Locais, como lead_charged, lead_type e lead_status.
    • Enumerações:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation contém detalhes de mensagem e conversa telefônica, como conversation_channel, call_duration_millis e call_recording_url.
    • O URL de gravação de chamadas telefônicas é autenticado na conta do cliente de destino e nas respectivas contas de administrador.
  • local_services_verification_artifact retorna os artefatos de um anunciante dos Serviços Locais, como investigação de histórico para contratação, licenças comerciais e dados de seguro empresarial. Todos os documentos associados à licença e ao seguro podem ser acessados por um URL.
    • Enumerações:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

planejamento

• Foi adicionado suporte ao retorno de Forecast.views e PlannedProductForecast.views para ReachPlanService.ListPlannableProducts nos tipos de produto aplicáveis.
• Foi adicionado suporte ao retorno de PlannableTargeting.surface_targeting para ReachPlanService.ListPlannableProducts, que descreve as plataformas disponíveis para um produto.
• Um novo tipo enumerado ReachPlanSurface foi adicionado
• Foi adicionado suporte à segmentação da frequência desejada usando AdvancedProductTargeting.target_frequency_settings, que retorna PlannedProductForecast.average_frequency.
• O método AudienceInsightsService.GenerateSuggestedTargetingInsights foi adicionado para retornar públicos-alvo segmentáveis sugeridos.
• Os seguintes valores foram adicionados a ReachPlanError:
  • NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
  • NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

Recomendações

• Adicionamos RecommendationSubscriptionService, que gerencia assinaturas de 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 um especificado, antes de um evento sazonal com previsão de aumento do tráfego.
  • SET_TARGET_CPA que recomenda definir um CPA desejado para campanhas que não têm um especificado.
  • SET_TARGET_ROAS que recomenda definir um ROAS desejado para as campanhas que não têm um especificado.

Relatório

• Adicionamos as novas métricas a seguir, que podem ser consultadas com campaign (disponível para campanhas de display, vídeo, Discovery e 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.
  • É possível continuar usando um feed do Merchant Center específico para uma campanha com o campo ShoppingSetting.feed_label. Ele precisa ser definido como o valor do rótulo do feed ou o código do país de duas letras usado anteriormente para ShoppingSetting.sales_country. Para mais detalhes, consulte o artigo de suporte para rótulos de feed.
• 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 foram substituídos:
    • 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 foi 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 foi substituído por ListingDimensionInfo.product_category.
  • ListingGroupFilterDimension.product_bidding_category foi substituído por ListingGroupFilterDimension.product_category.
• Removemos o suporte para adicionar Campaign.shopping_setting às campanhas de pesquisa. Tentar criar uma campanha de pesquisa com Campaign.shopping_setting ou adicionar Campaign.shopping_setting a uma campanha de pesquisa atual agora resulta em OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• Removemos o suporte para adicionar CampaignCriterion.listing_scope às campanhas de pesquisa. A tentativa de adicionar CampaignCriterion.listing_scope a uma campanha de pesquisa atual agora resulta em OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• Adicionamos as seguintes métricas de conversões com dados do carrinho:
  • 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

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

Vídeos

• Agora é possível segmentar o Google TV no nível da campanha:
  • NetworkSettings.target_google_tv_network foi adicionado
  • AdNetworkType.GOOGLE_TV foi adicionado.
• Agora é possível segmentar o YouTube no nível da campanha:
  • NetworkSettings.target_youtube foi adicionado
  • Em AdNetworkType, YOUTUBE_WATCH e YOUTUBE_SEARCH foram mesclados em YOUTUBE.
  • CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE foi adicionado.

Notas de lançamento arquivadas

Acesse Versões desativadas para conferir as notas arquivadas.