Regístrese hoy mismo en el taller de campañas de máximo rendimiento y API de Google Ads que se llevará a cabo el 17 de julio

Se usó la API de Cloud Translation para traducir esta página.

Notas de la versión

v17 (5/6/2024)

Los siguientes cambios y funciones se agregaron en la versión v17.

Se quitó AdService.getAd. Esto alinea la AdService 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:
- ImageError.UNEXPECTED_SIZE
- ImageError.FORMAT_NOT_ALLOWED

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:
- campaign_aggregate_asset_view
- channel_aggregate_asset_view

Públicos

Se agregó OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

Trabajos por lotes

Se agregó BatchJobError.REQUEST_TOO_LARGE, que se arrojará cuando el AddBatchJobOperationsRequest enviado supere los 10484504 bytes.
Se agregó compatibilidad para la configuración de MutateOperation.asset_group_operation cuando se usa BatchJobService. 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 es AdvertisingChannelType.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 a segments.sk_ad_network_fine_conversion_value.
- Se agregó segments.sk_ad_network_redistributed_fine_conversion_value.
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 para gender_view.
Se agregó compatibilidad con metrics.phone_calls para keyword_view.

Servicios locales

Se agregó LocalServicesLeadService.AppendLeadConversation(), que se usa para agregar un LocalServicesLeadConversation nuevo a LocalServicesLead, 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 con lead_type configurado como LeadType.MESSAGE en Conversation.local_services_lead.
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étodo LocalServicesLeadService.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

Se agregaron valores nuevos a QuotaError, que se usan para demasiadas solicitudes costosas durante un período. Para obtener más detalles, consulta la Actualización de la política de uso de recursos de la API de Google Ads.
- EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
- EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
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á una QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Por ejemplo, no se pueden seleccionar product_link.advertising_partner.customer y product_link.data_partner.data_partner_id en la misma consulta.
Si pasas un page_size a GoogleAdsService.Search, se generará un error RequestError.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 con segments.date cuando uses GoogleAdsService.Search o GoogleAdsService.SearchStream. No se permite la segmentación por fecha y se mostrará un error ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

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, usa UserListCustomerTypeService.MutateUserListCustomerTypes() en su lugar.
- Para adjuntar o desvincular una lista de usuarios, configura UserListCustomerType.customer_type_category como UserListCustomerTypeCategory.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.

Videos

Se agregaron los siguientes valores a ContentLabelType. Puedes excluir estos ContentLabelTypes 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 crea DemandGenVideoResponsiveAdInfo.
(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 y asset_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 como MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings. Cuando se configura en true, cualquier error sin bloqueo relacionado con fallas de operación se mostrará como MutateCustomerSkAdNetworkConversionValueSchemaResponse.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 y local_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 y BrandSafetySuitability, 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 de AccountLink a ProductLink y ProductLinkInvitation.
Se quitaron data_partner y google_ads de AccountLink.
Se agregó IdentityVerificationService para administrar la verificación del anunciante.
- StartIdentityVerification() se usa para iniciar una sesión de verificación con el objeto verification_program proporcionado. Crea una sesión de verificación nueva y muestra una respuesta vacía para una verificación creada de forma correcta.
  - Se agregó IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION.
- GetIdentityVerification() se puede usar para recuperar información de verificación, lo que muestra varios objetos de IdentityVerification. Cada IdentityVerification incluye lo siguiente:
  - verification_program, que es el tipo de programa de verificación de identidad
  - identity_verification_requirement, que contiene detalles relacionados con la fecha límite en la que el anunciante debe finalizar la verificación
  - verification_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 de action_url.
- Enumeraciones:
  - IdentityVerificationProgram
  - IdentityVerificationProgramStatus
- Errores:
  - IdentityVerificationError
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 y segments.month.
- campaign se convirtió en un recurso atribuido en lugar de segmentarlo.

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 el DemandGenProductAdInfo correspondiente, disponibles para las campañas de generación de demanda con un valor de Campaign.shopping_setting no nulo.
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:
- activity_state
- activity_city
Se agregó compatibilidad con los siguientes segmentos a travel_activity_performance_view:

Servicios locales

Se agregaron LocalServicesVerificationArtifact.business_registration_check_verification_artifact y BusinessRegistrationCheckArtifact 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 de AudienceInsightsAttributeMetadata.

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 en UNSPECIFIED en lugar de UNKNOWN.
Se agregaron los siguientes tipos de recomendaciones:
- MAXIMIZE_CONVERSION_VALUE_OPT_IN, que recomienda habilitar la estrategia de ofertas Maximizar valor de conversión
- IMPROVE_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ías
- CUSTOM_AUDIENCE_OPT_IN, que recomienda crear un público personalizado
- LEAD_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 y CampaignError.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 a CustomerLifecycleGoalOperation y CampaignLifecycleGoalOperation 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 y customer_client.status ahora se muestran como SUSPENDED. Anteriormente, se mostraban como ENABLED.
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 y MerchantCenterIdentifier.
- Se agregó LinkedProductType.MERCHANT_CENTER.
Se agregaron ProductLinkInvitationService y ProductLinkInvitation 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 y ProductLinkService.
Se quitó AccountLink.hotel_center y se agregó compatibilidad para actualizar invitaciones de vinculación desde cuentas de Hotel Center con AccountLinkService.
- Para actualizar una invitación de vinculación desde una cuenta de Hotel Center, usa ProductLinkInvitationService.

Recursos

Se reemplazó ImageAdInfo.media_file por ImageAdInfo.image_asset para admitir la adición y eliminación de imágenes con los recursos. Como resultado, también quitamos MediaFileService, 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 por AssetGroupListingGroupFilter.listing_source y ListingGroupFilterListingSource
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 y Audience.asset_group para limitar el uso del público a un grupo de recursos específico. Audience.asset_group se debe configurar solo si Audience.scope es ASSET_GROUP.
  - 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 un AssetGroupSignal propagando AssetGroupSignal.search_theme con un criterio SearchThemeInfo.
- 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 de UPGRADE_ELIGIBLE a UPGRADE_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 muestran TargetCpaSimulationPoint.interactions en lugar de TargetCpaSimulationPoint.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 criterio BRAND, agregarse a un conjunto compartido de BRANDS y, luego, adjuntarse a una campaña creando un CampaignCriterion con brand_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:
  - SharedCriterion.brand
  - CampaignCriterion.brand_list
- Enumeraciones:
  - SharedSetType.BRANDS
  - CriterionType.BRAND_LIST
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 y ClickConversion.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 o campaign:
- Segmentos:
- Métricas:
  - metrics.sk_ad_network_total_conversions
  - metrics.sk_ad_network_installs
Se reemplazó metrics.sk_ad_network_conversions por metrics.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 recurso customer 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 como OfflineConversionAlert.
- 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:
  - UploadConversionAdjustmentsRequest
  - UploadClickConversionsRequest
- Se agregó INVALID_JOB_ID a los siguientes errores:
  - ConversionAdjustmentUploadError
  - ConversionUploadError
- Se reemplazó INVALID_CONVERSION_ACTION por NO_CONVERSION_ACTION_FOUND y INVALID_CONVERSION_ACTION_TYPE en los siguientes errores:
  - ConversionAdjustmentUploadError
  - ConversionUploadError
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 contiene shared_campaign_key y algunos campos que ayudan a codificar la clave.
- android_privacy_shared_key_google_ad_group, que contiene shared_ad_group_key y algunos campos que ayudan a codificar la clave.
- android_privacy_shared_key_google_network_type, que contiene shared_network_type_key y algunos campos que ayudan a codificar la clave.
Se agregó ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Una ConversionActionOperation 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 error UNKNOWN.

Hoteles y viajes

Se agregó compatibilidad para los siguientes campos en travel_activity_group_view y travel_activity_performance_view:
- Segmentos:
- Métricas:

Anuncios de Servicios Locales

Se agregó LocalServicesSettings y sus campos al informe customer 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, como lead_charged, lead_type y lead_status.
  - Enumeraciones:
    - LeadStatus
    - LeadType
- local_services_lead_conversation contiene detalles de los mensajes y las conversaciones telefónicas, como conversation_channel, call_duration_millis y call_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.
  - Enumeraciones:

Planificación

Se agregó compatibilidad para mostrar Forecast.views y PlannedProductForecast.views para ReachPlanService.ListPlannableProducts para los tipos de productos aplicables.
Se agregó compatibilidad para mostrar PlannableTargeting.surface_targeting para ReachPlanService.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 muestra PlannedProductForecast.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:
- Recurso: RecommendationSubscription
- Campo: MutateOperation.recommendation_subscription_operation
- Enum: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
- Errores:
  - RecommendationSubscriptionError
  - RecommendationSubscriptionStatus
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) y segments.device:
- metrics.unique_users
- metrics.average_impression_frequency_per_user

Shopping

Se quitó ShoppingSetting.sales_country, cuyos valores ahora se muestran como ShoppingSetting.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 para ShoppingSetting.sales_country. Para obtener más información, consulta el artículo de asistencia sobre las etiquetas de feed.
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 con segments.product_category_level1
  - segments.product_bidding_category_level2 con segments.product_category_level2
  - segments.product_bidding_category_level3 con segments.product_category_level3
  - segments.product_bidding_category_level4 con segments.product_category_level4
  - segments.product_bidding_category_level5 con segments.product_category_level5
- Se reemplazó product_bidding_category_constant por product_category_constant, que muestra todas las localizaciones disponibles de una categoría en un campo repetido.
- Se reemplazó ListingDimensionInfo.product_bidding_category por ListingDimensionInfo.product_category.
- Se reemplazó ListingGroupFilterDimension.product_bidding_category por ListingGroupFilterDimension.product_category.
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 con Campaign.shopping_setting o agregar Campaign.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 agregar CampaignCriterion.listing_scope a una campaña de Búsqueda existente, se genera un error OPERATION_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
Se agregó CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals para configurar los objetivos de adquisición de clientes a nivel de la campaña.
- Informe: campaign_lifecycle_goal
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ó compatibilidad para la segmentación a YouTube a nivel de la campaña:
- Se agregó NetworkSettings.target_youtube
- En AdNetworkType, se combinaron YOUTUBE_WATCH y YOUTUBE_SEARCH en YOUTUBE.
- Se agregó CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE.

v14.1.0 (9/8/2023)

Las siguientes funciones y actualizaciones nuevas se introdujeron en la versión v14.1.

Administración de cuentas

Customer.customer_agreement_setting, que muestra si el cliente aceptó las Condiciones del Servicio del formulario de clientes potenciales

Recursos

Nuevos campos en AssetGroup para mostrar si el grupo de recursos está publicando anuncios o los motivos por los que no:
- primary_status
- primary_status_reasons
Nuevos campos en AssetGroupAsset para mostrar si el recurso del grupo de recursos se publica o los motivos por los que no:
- primary_status
- primary_status_details
- primary_status_reasons
Valores nuevos de la enum CallToActionType:
- BUY_NOW
- DONATE_NOW
- ORDER_NOW
- PLAY_NOW
- SEE_MORE
- START_NOW
- VISIT_SITE
- WATCH_NOW
Valores nuevos de la enum AssetLinkError:
- CUSTOMER_NOT_VERIFIED
- UNSUPPORTED_CALL_TO_ACTION
- PAGE_FEED_INVALID_LABEL_TEXT

Facturación

Nuevos campos en Invoice y AccountSummary:
- export_charge_subtotal_amount_micros
- export_charge_tax_amount_micros
- export_charge_total_amount_micros

Campañas

Valores nuevos de la enum CampaignPrimaryStatusReason:
- HAS_ASSET_GROUPS_DISAPPROVED
- HAS_ASSET_GROUPS_LIMITED_BY_POLICY
- MOST_ASSET_GROUPS_UNDER_REVIEW
(Solo para cuentas incluidas en la lista de entidades permitidas) DiscoveryCampaignSettings con upgraded_targeting:
- Cuando upgraded_targeting se establece en true, puedes agregar una ubicación y un idioma como criterio del grupo de anuncios

Criterios

Nuevo valor de enumeración: CriterionError.INVALID_DETAILED_DEMOGRAPHIC
(Solo para cuentas incluidas en la lista de entidades permitidas) Compatibilidad para agregar LanguageInfo y LocationInfo como AdGroupCriterion:
- Esta opción solo está disponible para las campañas discovery con la segmentación actualizada habilitada

Experimentos

Valores nuevos de la enum ExperimentError:
- DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
- CANNOT_REMOVE_IN_CREATION_EXPERIMENT
- CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES

Recomendaciones

Nuevos tipos de recomendaciones:
- PerformanceMaxOptInRecommendation, que recomienda crear la primera campaña de máximo rendimiento de la cuenta
- ImprovePerformanceMaxAdStrengthRecommendation, que recomienda mejorar la eficacia del grupo de recursos de una campaña de máximo rendimiento.
- MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation que recomienda migrar una campaña de anuncios dinámicos de búsqueda a una de máximo rendimiento

Reporte

Métricas y segmentos nuevos sobre los clientes nuevos en comparación con los recurrentes:
Nuevas vistas customer_search_term_insight y campaign_search_term_insight:
- metrics.search_volume muestra el rango de volumen de una categoría de estadísticas del término de búsqueda

Shopping

Campos nuevos para los grupos de fichas:
- ListingGroupInfo.path
- AssetGroupListingGroupFilter.path
Nuevo campo: ShoppingSetting.advertising_partner_ids
Valores nuevos de la enum CampaignError:
- NOT_LINKED_ADVERTISING_PARTNER
- INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS

Videos

(Solo para cuentas incluidas en la lista de entidades permitidas) AdType.DISCOVERY_VIDEO_RESPONSIVE_AD y su DiscoveryVideoResponsiveAdInfo correspondiente

v14 (7/6/2023)

Las siguientes funciones y actualizaciones nuevas se introdujeron en la versión v14.

Campañas

Se agregó CampaignBudgetError.BUDGET_AMOUNT_MUST_BE_UNSET_FOR_CUSTOM_BUDGET_PERIOD

Conversiones

Se agregó compatibilidad para identificar conversiones de Google Analytics y determinar si una conversión se importa desde una propiedad Universal Analytics o una propiedad GA4:
- Se agregaron los siguientes valores a ConversionActionType:
  - UNIVERSAL_ANALYTICS_GOAL
  - UNIVERSAL_ANALYTICS_TRANSACTION
  - GOOGLE_ANALYTICS_4_CUSTOM
  - GOOGLE_ANALYTICS_4_PURCHASE
- Se agregó ConversionAction.google_analytics_4_settings
Se agregó Customer.offline_conversion_client_summaries, que resume el estado y la información de diagnóstico de las cargas y los ajustes de conversiones sin conexión del cliente.
- Enumeraciones
  - OfflineEventUploadClient:
    - GOOGLE_ADS_API
    - GOOGLE_ADS_WEB_CLIENT
    - ADS_DATA_CONNECTOR
  - OfflineConversionDiagnosticStatus:
    - EXCELLENT
    - GOOD
    - NEEDS_ATTENTION
    - NO_RECENT_UPLOAD
Se agregó job_id a las respuestas que muestran ConversionAdjustmentUploadService.UploadConversionAdjustments y ConversionUploadService.UploadClickConversions para asociar una respuesta a OfflineConversionUploadSummary.job_id.

Criterios

Se agregó compatibilidad para recuperar, crear y actualizar palabras clave negativas a nivel de la cuenta:
- Campos:
  - CustomerNegativeCriterion.negative_keyword_list
- Enumeraciones:
  - CriterionType.NEGATIVE_KEYWORD_LIST
  - SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
  - ResourceLimitType
    - SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
    - ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
- Errores:
  - CriterionError
    - NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
    - CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
    - CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
    - CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE
Se agregó CriterionError.CANNOT_TARGET_SIMILAR_USER_LIST

Anuncios de hoteles

Se cambió el nombre de SuggestTravelAssetsRequest.place_id a SuggestTravelAssetsRequest.place_ids

Planificación

Se quitaron los siguientes métodos de KeywordPlanService:
- GenerateForecastCurve
- GenerateForecastMetrics
- GenerateForecastTimeSeries
- GenerateHistoricalMetrics
Se agregó KeywordPlanIdeaService.GenerateKeywordForecastMetrics para admitir la generación de métricas de previsión de campañas de palabras clave sin necesidad de crear primero un plan de palabras clave.
Se quitó la compatibilidad para recuperar el informe campaign_criterion_simulation
Se agregó compatibilidad con YOUTUBE_DYNAMIC_LINEUP como una dimensión en AudienceInsightsService.ListAudienceInsightsAttributes.
Se agregó DynamicLineupAttributeMetadata.sample_channels, que se usa en las respuestas de GenerateAudienceCompositionInsights para proporcionar canales de muestra dentro de las selecciones de contenido.

Recomendaciones

Se agregó DynamicImageExtensionOptInRecommendation, que recomienda habilitar las extensiones de imagen dinámicas en la cuenta.
Se agregó LowerTargetRoasRecommendation, que recomienda disminuir el ROAS objetivo.
Se agregó RaiseTargetCpaRecommendation, que recomienda aumentar el CPA objetivo
Se agregó ResponsiveSearchAdAssetRecommendation.current_ad

Reporte

Se agregaron los siguientes valores a ServedAssetFieldType, que están disponibles en ad_group_ad_asset_view.pinned_field:
- SITELINK
- CALL
- MOBILE_APP
- CALLOUT
- STRUCTURED_SNIPPET
- PRICE
- PROMOTION
- AD_IMAGE
- LEAD_FORM
- BUSINESS_LOGO

Notas de la versión archivadas

Consulta el artículo Versiones obsoletas para ver las notas de la versión archivadas.