v17 (5/6/2024)
Los siguientes cambios y funciones se agregaron en la versión v17.
Ads
- Se quitó
AdService.getAd
. Esto alinea laAdService
con otros servicios de la API de Google Ads. Consulta Recupera objetos para conocer la forma recomendada de recuperar anuncios y otros tipos de recursos. - Se agregaron más validaciones de
ImageAdInfo.image_asset
en relación con las dimensiones y el formato. Se pueden generar los siguientes errores si la imagen no es válida:
Recursos
- Se agregó una nueva enumeración:
ClickType.AD_IMAGE
- Se agregaron los siguientes informes nuevos con métricas nuevas para las campañas de máximo rendimiento y de Búsqueda:
Públicos
Trabajos por lotes
- Se agregó
BatchJobError.REQUEST_TOO_LARGE
, que se arrojará cuando elAddBatchJobOperationsRequest
enviado supere los 10484504 bytes. - Se agregó compatibilidad para la configuración de
MutateOperation.asset_group_operation
cuando se usaBatchJobService
. Esto te permite usar el procesamiento por lotes para crear y administrar campañas de máximo rendimiento completas. Consulta nuestra nueva guía exclusiva.
Campañas
- Se cambió el nombre del tipo Discovery a Generación de demanda en todos los campos, enumeraciones y errores de todos
los recursos de la API de Google Ads, como las campañas, los anuncios y los recursos. Por ejemplo,
AdvertisingChannelType.DISCOVERY
ahora esAdvertisingChannelType.DEMAND_GEN
. - Se agregó
Campaign.keyword_match_type
a fin de que puedas establecer el tipo de concordancia de palabras clave para todas las palabras clave de una campaña.
Conversiones
- Para las conversiones de SKAdNetwork,
- Se cambió el nombre de
segments.sk_ad_network_conversion_value
asegments.sk_ad_network_fine_conversion_value
. - Se agregó
segments.sk_ad_network_redistributed_fine_conversion_value
.
- Se cambió el nombre de
- Las siguientes métricas ahora se muestran con la respuesta, incluso cuando son cero. Esto los hace coherentes con otras métricas.
Criterios
- Se agregó a los siguientes campos de
AdGroupCriterion
para mostrar si el criterio del grupo de anuncios se publica o los motivos por los que no:primary_status
primary_status_reasons
- Se agregó compatibilidad con
metrics.search_impression_share
paragender_view
. - Se agregó compatibilidad con
metrics.phone_calls
parakeyword_view
.
Servicios locales
- Se agregó
LocalServicesLeadService.AppendLeadConversation()
, que se usa para agregar unLocalServicesLeadConversation
nuevo aLocalServicesLead
, lo que envía los mensajes a los usuarios a través de canales apropiados, como SMS, según cómo se haya creado el cliente potencial.- El tamaño de
AppendLeadConversationRequest.conversations
se limita a 1,000. - Solo se puede especificar
LocalServicesLead
conlead_type
configurado comoLeadType.MESSAGE
enConversation.local_services_lead
.
- El tamaño de
- Se agregaron nuevos valores de enumeración a
ConversationType
:WHATSAPP
para representar una conversación que se presentó a través de WhatsApp.ADS_API
para representar una conversación presentada con el nuevo métodoLocalServicesLeadService.AppendLeadConversation()
- Se agregaron los siguientes campos nuevos 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
Reporte
- Ahora puedes seleccionar solo campos relacionados con un producto vinculado cuando realices consultas en
product_link
. Si seleccionas varios campos de varios productos vinculados, se arrojará unaQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
. Por ejemplo, no se pueden seleccionarproduct_link.advertising_partner.customer
yproduct_link.data_partner.data_partner_id
en la misma consulta. - Si pasas un
page_size
aGoogleAdsService.Search
, se generará un errorRequestError.PAGE_SIZE_NOT_SUPPORTED
.
Shopping
- Se agregó un nuevo informe
shopping_product
, que corresponde a la página Productos de la IU de Google Ads. Permite mostrar datos relacionados con el estado actual de los productos de cuentas de Google Merchant Center vinculadas a una cuenta de Google Ads.- Puedes filtrar las métricas del informe
shopping_product
consegments.date
cuando usesGoogleAdsService.Search
oGoogleAdsService.SearchStream
. No se permite la segmentación por fecha y se mostrará un errorShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
.
- Puedes filtrar las métricas del informe
Objetivos unificados
- Se agregó
UserListCustomerTypeService.MutateUserListCustomerTypes()
para configurar los tipos de clientes de público. - Se quitó
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
. Para establecer la configuración del público de los objetivos del ciclo de vida del cliente, usaUserListCustomerTypeService.MutateUserListCustomerTypes()
en su lugar.- Para adjuntar o desvincular una lista de usuarios, configura
UserListCustomerType.customer_type_category
comoUserListCustomerTypeCategory.PURCHASERS
para incluirla o excluirla de una definición de cliente existente para los objetivos de ciclo de vida del cliente, respectivamente. Consulta cómo segmentar tus públicos para obtener más detalles.
- Para adjuntar o desvincular una lista de usuarios, configura
Videos
- Se agregaron los siguientes valores a
ContentLabelType
. Puedes excluir estosContentLabelTypes
a nivel del 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
- Se agregó
AdVideoAsset.ad_video_asset_info
para admitir preferencias de inventario para elementos de video cuando se creaDemandGenVideoResponsiveAdInfo
. - (Solo para cuentas incluidas en la lista de entidades permitidas) Se estableció
Campaign.video_brand_safety_suitability
mutable.
v16.1.0 (24/4/2024)
Los siguientes cambios y funciones se agregaron en la versión v16.1.
Administración de cuentas
CustomerNegativeCriterion.ip_block
, que admite agregar una IP como criterio negativo a nivel del cliente.- Nuevo valor de enumeración:
ProductLinkError.LINK_EXISTS
. - Nuevo valor de enumeración:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
.
Recursos
- Compatibilidad con recursos relacionados con la generación de demanda para
ad_group_ad_asset_view
yasset_field_type_view
. - Nuevo valor de enumeración:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
.
Públicos
- Nuevo valor de enumeración:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
, que limita la cantidad de listas de usuarios similares que un cliente puede tener a 1,000.
Campañas
- Se admiten las simulaciones de ofertas de campaña de ROAS objetivo para las campañas de aplicaciones con el informe
campaign_simulation
. - Nuevo valor de enumeración:
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
. - Nuevo valor de enumeración:
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
. - Nuevo valor de enumeración:
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
.
Conversiones
SkAdNetworkConversionValueSchema.postback_mappings
, que admite las funciones de SKAdNetwork 4.0.- Se agregó compatibilidad con advertencias para
CustomerSkAdNetworkConversionValueSchemaService
comoMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
. Cuando se configura entrue
, cualquier error sin bloqueo relacionado con fallas de operación se mostrará comoMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
. - Nuevos valores de enumeración en
CustomerSkAdNetworkConversionValueSchemaError
:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
Criterios
- Nuevos campos en
BrandInfo
:display_name
primary_url
rejection_reason
status
- Enumeración nueva:
BrandRequestRejectionReason
. - Nuevo valor de enumeración:
CriterionType.LIFE_EVENT
.
Experimentos
- Nuevo valor de enumeración:
ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT
.
Servicios locales
local_services_lead.credit_details.credit_state
ylocal_services_lead.credit_details.credit_state_last_update_date_time
, que muestran el estado del crédito y la marca de tiempo cuando se actualizó el estado de crédito, respectivamente.local_services_lead_conversation.message_details.attachment_urls
, que muestra las URLs que se pueden usar para descargar el contenido del adjunto.
Videos
customer.video_brand_safety_suitability
yBrandSafetySuitability
, que admiten la recuperación de idoneidad para la seguridad de la marca de video a nivel del cliente.- Nuevo valor de enumeración:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
v16 (21/2/2024)
Los siguientes cambios y funciones se agregaron en la versión v16.
Administración de cuentas
- Se migró
advertising_partner
deAccountLink
aProductLink
yProductLinkInvitation
. - Se quitaron
data_partner
ygoogle_ads
deAccountLink
. - Se agregó
IdentityVerificationService
para administrar la verificación del anunciante.StartIdentityVerification()
se usa para iniciar una sesión de verificación con el objetoverification_program
proporcionado. Crea una sesión de verificación nueva y muestra una respuesta vacía para una verificación creada de forma correcta.GetIdentityVerification()
se puede usar para recuperar información de verificación, lo que muestra varios objetos deIdentityVerification
. CadaIdentityVerification
incluye lo siguiente:verification_program
, que es el tipo de programa de verificación de identidadidentity_verification_requirement
, que contiene detalles relacionados con la fecha límite en la que el anunciante debe finalizar la verificaciónverification_progress
, que contiene detalles relacionados con la sesión de verificación, incluidos los siguientes:program_status
representa el estado actual de esta sesión de verificación.action_url
dirige al cliente a una URL para completar la verificación.invitation_link_expiration_time
representa la fecha de vencimiento deaction_url
.
- Enumeraciones:
- Errores:
- Se agregó
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
.
Recursos
- Cambios en
asset_group
:- Se agregó compatibilidad con segmentos relacionados con el tiempo, como
segments.year
ysegments.month
. campaign
se convirtió en un recurso atribuido en lugar de segmentarlo.
- Se agregó compatibilidad con segmentos relacionados con el tiempo, como
Campañas
- Cambios en las campañas de generación de demanda:
- Se agregó compatibilidad para configurar
Campaign.shopping_setting
a una campaña de generación de demanda existente. - Se agregó
ShoppingSetting.disable_product_feed
para inhabilitar el feed de productos opcional de las campañas de generación de demanda. - Se agregó
Ad.demand_gen_product_ad
y elDemandGenProductAdInfo
correspondiente, disponibles para las campañas de generación de demanda con un valor deCampaign.shopping_setting
no nulo.
- Se agregó compatibilidad para configurar
- Se agregó a los siguientes campos de
AdGroup
para mostrar si el grupo de anuncios se publica o los motivos por los que no:primary_status
primary_status_reasons
- Se agregó a los siguientes campos de
AdGroupAd
para mostrar si el anuncio del grupo de anuncios se publica o los motivos por los que no:primary_status
primary_status_reasons
- Se agregaron los siguientes valores a
AdGroupError
:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
Experimentar
- Se agregó
Experiment.sync_enabled
para especificar si se debe habilitar la sincronización en el experimento. Con la sincronización habilitada, los cambios realizados en la campaña original mientras se ejecuta el experimento se copian automáticamente en la campaña experimental. - Se agregó
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
. - Se agregó
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
.
Hoteles y viajes
- Se agregaron los siguientes campos a
ListingDimensionInfo
para un anuncio de Cosas que hacer para habilitar la creación de grupos de fichas basados en el estado y la ciudad donde está disponible la actividad de viajes: - Se agregó compatibilidad con los siguientes segmentos a
travel_activity_performance_view
:
Servicios locales
- Se agregaron
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
yBusinessRegistrationCheckArtifact
para permitir que los anunciantes supervisen el progreso del proceso de verificación del registro comercial. - Se agregó un nuevo recurso
local_services_employee
para permitir que los anunciantes recuperen la información de los empleados que agregaron.
Planificación
- Se quitó
score
deAudienceInsightsAttributeMetadata
.
Recomendaciones
- Se agregó
RecommendationService.GenerateRecommendations()
, que muestra recomendaciones basadas en la configuración especificada, como tipos de recomendaciones y tipos de canales publicitarios. Esto es particularmente útil durante la creación de campañas. - Se agregó
RecommendationMetrics.conversions_value
. - Las palabras clave recomendadas con un tipo de concordancia de palabra clave no establecido ahora tienen
recommended_match_type
establecido enUNSPECIFIED
en lugar deUNKNOWN
. - Se agregaron los siguientes tipos de recomendaciones:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
, que recomienda habilitar la estrategia de ofertas Maximizar valor de conversiónIMPROVE_GOOGLE_TAG_COVERAGE
, que recomienda implementar la etiqueta de Google en más páginas.PERFORMANCE_MAX_FINAL_URL_OPT_IN
, que recomienda activar la expansión de la URL final para tus campañas de máximo rendimiento.REFRESH_CUSTOMER_MATCH_LIST
, que recomienda actualizar una lista de clientes que no se actualizó en los últimos 90 díasCUSTOM_AUDIENCE_OPT_IN
, que recomienda crear un público personalizadoLEAD_FORM_ASSET
, que recomienda agregar recursos de formulario de clientes potenciales a nivel de la campaña o del cliente.IMPROVE_DEMAND_GEN_AD_STRENGTH
, que recomienda mejorar la calidad de los anuncios en las campañas de generación de demanda.
Shopping
- Se agregaron
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
yCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
para proporcionar errores más detallados en las campañas de Shopping vinculadas a una cuenta de Comparison Shopping Service Center. - Se agregaron los siguientes valores 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
Objetivos del ciclo de vida
- Se agregó
update
aCustomerLifecycleGoalOperation
yCampaignLifecycleGoalOperation
para que estos tipos de operaciones sean coherentes con otros tipos de operaciones de la API.
v15 (18/10/2023)
Las siguientes funciones y actualizaciones nuevas se introdujeron en la versión v15.
Administración de cuentas
- Si tu cuenta está suspendida debido a una actividad no autorizada de la cuenta,
customer.status
ycustomer_client.status
ahora se muestran comoSUSPENDED
. Anteriormente, se mostraban comoENABLED
. - Se agregó compatibilidad para agregar y quitar una vinculación entre una cuenta de Google Ads y una cuenta de Merchant Center:
- Se agregaron
ProductLink.merchant_center
yMerchantCenterIdentifier
. - Se agregó
LinkedProductType.MERCHANT_CENTER
.
- Se agregaron
- Se agregaron
ProductLinkInvitationService
yProductLinkInvitation
para admitir la actualización de una invitación de vínculo enviada desde otros productos, disponible para cuentas de Hotel Center y Merchant Center. - Se quitó
MerchantCenterLinkService
.- Para vincular cuentas de Google Ads con cuentas de Merchant Center, usa
ProductLinkInvitationService
yProductLinkService
.
- Para vincular cuentas de Google Ads con cuentas de Merchant Center, usa
- Se quitó
AccountLink.hotel_center
y se agregó compatibilidad para actualizar invitaciones de vinculación desde cuentas de Hotel Center conAccountLinkService
.- Para actualizar una invitación de vinculación desde una cuenta de Hotel Center, usa
ProductLinkInvitationService
.
- Para actualizar una invitación de vinculación desde una cuenta de Hotel Center, usa
Recursos
- Se reemplazó
ImageAdInfo.media_file
porImageAdInfo.image_asset
para admitir la adición y eliminación de imágenes con los recursos. Como resultado, también quitamosMediaFileService
, que ya no es necesario. - Se agregó
ListingGroupFilterDimension.webpage
para admitir la creación de un filtro de grupo de fichas basado en etiquetas personalizadas y substrings de URL.- También se reemplazó
AssetGroupListingGroupFilter.vertical
porAssetGroupListingGroupFilter.listing_source
yListingGroupFilterListingSource
- También se reemplazó
- Se agregó
asset_group_asset.source
para mostrar la fuente del recurso del grupo de recursos. - Se agregó
ad_group_ad_asset_view.source
para mostrar la fuente del recurso del anuncio del grupo de anuncios.
Públicos
- Para la Segmentación por clientes, se agregó
CustomerMatchUserListMetadata.consent
para poder brindar un consentimiento. A partir del 6 de marzo de 2024, si los usuarios del EEE no obtienen consentimiento, el valor correspondiente se determinará como sin consentimiento. Los datos de los usuarios del EEE que no den su consentimiento no se procesarán ni se podrán usar para la personalización de anuncios mediante la Segmentación por clientes. Consulta nuestra guía de Segmentación por clientes para obtener más información. - Para las ventas en la tienda, se agregó
UserData.consent
para admitir la entrega de un consentimiento. Consulta nuestra guía de ventas en la tienda para obtener más detalles. Si usas la Segmentación por clientes con las ventas en la tienda, revisa las Preguntas frecuentes para obtener información adicional. - Se agregó
UserList.lookalike_user_list
para admitir la creación de un segmento similar, un público creado en función del público de origen existente proporcionado. Los segmentos similares solo se pueden usar en una campaña de generación de demanda.
Campañas
Actualizaciones de las campañas de máximo rendimiento:
AssetGroupSignal
ahora admite dos tipos de indicadores que se pueden adjuntar a un grupo de recursos para mejorar la segmentación:AssetGroupSignal.audience
- Se agregaron
Audience.scope
yAudience.asset_group
para limitar el uso del público a un grupo de recursos específico.Audience.asset_group
se debe configurar solo siAudience.scope
esASSET_GROUP
.
- Se agregaron
AssetGroupSignal.search_theme
- Se agregó
CriterionType.SEARCH_THEME
para admitir este tipo de criterio nuevo. Este tipo de criterio nuevo solo se puede usar en campañas de máximo rendimiento para crear unAssetGroupSignal
propagandoAssetGroupSignal.search_theme
con un criterioSearchThemeInfo
.
- Se agregó
- Se agregó
AssetGroupSignalOperation.exempt_policy_violation_keys
para admitir la solicitud de exención cuando se agregan indicadores de grupos de recursos. - Se agregó un
asset_group_top_combination_view
nuevo para informar los recursos con mejor rendimiento a nivel del grupo de recursos. - Ahora se puede consultar
asset_group
con campos de métricas para admitir la recuperación del rendimiento de una campaña de máximo rendimiento. - En
PerformanceMaxUpgradeStatus
, se cambió el nombre deUPGRADE_ELIGIBLE
aUPGRADE_ELIGIBLE
.
En el caso de las campañas de CPA objetivo de generación de demanda y discovery, las simulaciones de ofertas de CPA objetivo a nivel de la campaña (
campaign_simulation.target_cpa_point_list.points
) ahora muestranTargetCpaSimulationPoint.interactions
en lugar deTargetCpaSimulationPoint.clicks
.Se agregó
BrandSuggestionService
que puede sugerir marcas según el prefijo de marca proporcionado y la lista de marcas excluidas. Estas marcas se pueden usar para crear un criterioBRAND
, agregarse a un conjunto compartido deBRANDS
y, luego, adjuntarse a una campaña creando unCampaignCriterion
conbrand_list
establecido en el conjunto compartido. Los criterios de campaña se pueden segmentar en las campañas de Búsqueda y excluirse en las campañas de máximo rendimiento, respectivamente.- Campos:
- Enumeraciones:
Se agregó
Campaign.asset_automation_settings[]
para mostrar el estado de automatización de cada tipo de recurso.Se agregaron los siguientes valores a la enum
CampaignPrimaryStatusReason
:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversiones
- Se agregaron
CallConversion.consent
yClickConversion.consent
para admitir la provisión de un consentimiento. Consulte nuestra guía de conversiones de llamada y la guía de conversiones de clics para obtener más detalles. - Se agregaron los siguientes campos relacionados con las conversiones de SKAdNetwork, disponibles cuando se consultan con
customer
ocampaign
: - Se reemplazó
metrics.sk_ad_network_conversions
pormetrics.sk_ad_network_installs
. - Se agregó compatibilidad para diagnosticar la carga de conversiones sin conexión.
- Se movió el
offline_conversion_upload_client_summary
de un campo en el recursocustomer
a un informe de nivel superior. Usa este informe para obtener detalles útiles del estado de la carga de conversiones, como el recuento de eventos correctos, la tasa de éxito y el porcentaje de errores.- Aclaración: Una conversión que se sube, pero que genera un error
ConversionUploadError.CLICK_NOT_FOUND
se registra como exitosa, pero también se marca comoOfflineConversionAlert
.
- Aclaración: Una conversión que se sube, pero que genera un error
- Se agregó
job_id
como parámetro opcional para los siguientes tipos de solicitud, de modo que puedas agrupar de forma lógica varias solicitudes de carga en un solo trabajo conceptual: - Se agregó
INVALID_JOB_ID
a los siguientes errores: - Se reemplazó
INVALID_CONVERSION_ACTION
porNO_CONVERSION_ACTION_FOUND
yINVALID_CONVERSION_ACTION_TYPE
en los siguientes errores:
- Se movió el
- Se agregaron tres informes para admitir la atribución entre varias redes de Privacy Sandbox de Android sin redireccionamientos:
android_privacy_shared_key_google_campaign
, que contieneshared_campaign_key
y algunos campos que ayudan a codificar la clave.android_privacy_shared_key_google_ad_group
, que contieneshared_ad_group_key
y algunos campos que ayudan a codificar la clave.android_privacy_shared_key_google_network_type
, que contieneshared_network_type_key
y algunos campos que ayudan a codificar la clave.
- Se agregó
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
. UnaConversionActionOperation
que intenta usar uno de los modelos de atribución basados en reglas obsoletos ahora falla con este error. Antes, la operación fallaba con un errorUNKNOWN
.
Hoteles y viajes
- Se agregó compatibilidad para los siguientes campos en
travel_activity_group_view
ytravel_activity_performance_view
:- Segmentos:
- 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
Anuncios de Servicios Locales
- Se agregó
LocalServicesSettings
y sus campos al informecustomer
para mostrar los estados del seguro y la licencia detallada de un anunciante de Servicios Locales. - Se agregaron los siguientes informes nuevos para Servicios locales:
local_services_lead
contiene todos los detalles relacionados con los clientes potenciales de Anuncios de Servicios Locales, comolead_charged
,lead_type
ylead_status
.- Enumeraciones:
local_services_lead_conversation
contiene detalles de los mensajes y las conversaciones telefónicas, comoconversation_channel
,call_duration_millis
ycall_recording_url
.- La URL de grabación de llamadas telefónicas se autentica en la cuenta del cliente objetivo y sus cuentas de administrador.
local_services_verification_artifact
muestra los artefactos de un anunciante de Servicios Locales, como la verificación de antecedentes, las licencias comerciales y los datos de seguros comerciales. Se puede acceder a todos los documentos asociados con la licencia y el seguro a través de una URL.
Planificación
- Se agregó compatibilidad para mostrar
Forecast.views
yPlannedProductForecast.views
paraReachPlanService.ListPlannableProducts
para los tipos de productos aplicables. - Se agregó compatibilidad para mostrar
PlannableTargeting.surface_targeting
paraReachPlanService.ListPlannableProducts
, que describe las plataformas disponibles para un producto. - Se agregó una nueva enum
ReachPlanSurface
. - Se agregó compatibilidad para la segmentación a Frecuencia objetivo mediante
AdvancedProductTargeting.target_frequency_settings
, que muestraPlannedProductForecast.average_frequency
. - Se agregó
AudienceInsightsService.GenerateSuggestedTargetingInsights
para mostrar los públicos de segmentación sugeridos. - Se agregaron los siguientes valores a
ReachPlanError
:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
Recomendaciones
- Se agregó
RecommendationSubscriptionService
, que administra las suscripciones de recomendaciones: - Se agregaron los siguientes tipos de recomendaciones:
FORECASTING_SET_TARGET_CPA
, que recomienda establecer un CPA objetivo para las campañas que no tienen uno especificado, antes de un evento de temporada en el que se prevea que aumentará el tráfico.SET_TARGET_CPA
, que recomienda configurar un CPA objetivo para las campañas que no tienen uno especificado.SET_TARGET_ROAS
, que recomienda establecer un ROAS objetivo para las campañas que no tienen uno especificado.
Reporte
- Se agregaron las siguientes métricas nuevas, que se pueden consultar con
campaign
(disponible para las campañas de Display, video, discovery y de aplicaciones) ysegments.device
:
Shopping
- Se quitó
ShoppingSetting.sales_country
, cuyos valores ahora se muestran comoShoppingSetting.feed_label
.- Puedes seguir usando un feed de Merchant Center específico para una campaña mediante el campo
ShoppingSetting.feed_label
. Debe establecerse en el valor de la etiqueta de feed o en el código de país de dos letras que se usaba anteriormente paraShoppingSetting.sales_country
. Para obtener más información, consulta el artículo de asistencia sobre las etiquetas de feed.
- Puedes seguir usando un feed de Merchant Center específico para una campaña mediante el campo
- Se quitó la dependencia de las categorías de productos con respecto a un código de país en los informes.
El conjunto de IDs de categorías admitidos no ha cambiado.
- Se reemplazaron los siguientes campos que se usan en
shopping_performance_view
:segments.product_bidding_category_level1
consegments.product_category_level1
segments.product_bidding_category_level2
consegments.product_category_level2
segments.product_bidding_category_level3
consegments.product_category_level3
segments.product_bidding_category_level4
consegments.product_category_level4
segments.product_bidding_category_level5
consegments.product_category_level5
- Se reemplazó
product_bidding_category_constant
porproduct_category_constant
, que muestra todas las localizaciones disponibles de una categoría en un campo repetido. - Se reemplazó
ListingDimensionInfo.product_bidding_category
porListingDimensionInfo.product_category
. - Se reemplazó
ListingGroupFilterDimension.product_bidding_category
porListingGroupFilterDimension.product_category
.
- Se reemplazaron los siguientes campos que se usan en
- Se quitó la compatibilidad para agregar
Campaign.shopping_setting
a las campañas de Búsqueda. Ahora, si intentas crear una campaña de Búsqueda conCampaign.shopping_setting
o agregarCampaign.shopping_setting
a una campaña de Búsqueda existente, el resultado seráOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Se quitó la compatibilidad para agregar
CampaignCriterion.listing_scope
a las campañas de Búsqueda. Ahora, cuando intentas agregarCampaignCriterion.listing_scope
a una campaña de Búsqueda existente, se genera un errorOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Se agregaron las siguientes métricas de conversiones con datos del carrito:
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 estas métricas se pueden seleccionar con los siguientes informes:
Objetivos unificados
- Se agregó
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
para configurar los objetivos de adquisición de clientes a nivel del cliente.- Informe:
customer_lifecycle_goal
- Informe:
- Se agregó
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
para configurar los objetivos de adquisición de clientes a nivel de la campaña.- Informe:
campaign_lifecycle_goal
- Informe:
- Se agregó
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
. - Se agregaron los siguientes valores a
ConversionGoalCampaignConfigError
:EMPTY_CONVERSION_GOALS
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
Videos
- Se agregó compatibilidad para la segmentación a Google TV a nivel de la campaña:
- Se agregó
NetworkSettings.target_google_tv_network
- Se agregó
AdNetworkType.GOOGLE_TV
.
- Se agregó
- Se agregó compatibilidad para la segmentación a YouTube a nivel de la campaña:
- Se agregó
NetworkSettings.target_youtube
- En
AdNetworkType
, se combinaronYOUTUBE_WATCH
yYOUTUBE_SEARCH
enYOUTUBE
. - Se agregó
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
.
- Se agregó
Notas de la versión archivadas
Consulta el artículo Versiones obsoletas para ver las notas de la versión archivadas.