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

Notas de la versión

v17.1.0 (7/8/2024)

Las siguientes funciones y actualizaciones nuevas se agregaron en la versión v17_1.

Recursos

AdGroupAdService.RemoveAutomaticallyCreatedAssets() te permite quitar recursos creados automáticamente específicos vinculados a anuncios de búsqueda responsivos.

Públicos

Nuevos valores de enumeración en UserListCustomerTypeCategory:
- LOYALTY_TIER_1_MEMBERS
- LOYALTY_TIER_2_MEMBERS
- LOYALTY_TIER_3_MEMBERS
- LOYALTY_TIER_4_MEMBERS
- LOYALTY_TIER_5_MEMBERS
- LOYALTY_TIER_6_MEMBERS
- LOYALTY_TIER_7_MEMBERS

Campañas

ShareablePreviewService.GenerateShareablePreviews() genera las URLs (shareable_preview_url en la respuesta) para vistas previas de anuncios que se pueden compartir para grupos de recursos habilitados y detenidos.
- El campo expiration_date_time indica la fecha de vencimiento de las URLs en la respuesta.
- Si se produce un error, el método mostrará partial_failure_error en lugar de las URLs.

Historial de cambios

Nuevo tipo de recurso de estado de cambio: ASSET_GROUP.

Conversiones

Nuevo campo de segmento para la versión de SKAdNetwork: segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary, que expone el diagnóstico de la carga de conversiones a nivel de la acción de conversión.
Las siguientes métricas se agregan a los informes de diagnóstico sin conexión para transmitir la cantidad de conversiones subidas que aún se están procesando:
- offline_conversion_upload_client_summary
  - pending_event_count
  - pending_rate
- offline_conversion_upload_conversion_action_summary
  - pending_count

Planificación

AudienceInsights.GenerateAudienceOverlapInsights(), que acepta un atributo principal de entrada y una colección de atributos de público, y muestra las estimaciones de la superposición del alcance potencial de YouTube entre el atributo principal y los atributos de público.

Informes

Compatibilidad para segmentar per_store_view según segments.date

Videos

Compatibilidad para recuperar información relacionada con las siguientes estrategias de ofertas estándar para campañas de video mediante informes, como ad_group y campaign:
- Campaign.fixed_cpm (CPM (costo por cada mil impresiones) fijo)
- Campaign.target_cpv (CPV objetivo [costo por vista])
Campaign.video_campaign_settings, que te permite determinar en qué inventarios se pueden mostrar los anuncios de video mediante los siguientes campos de informe:
segments.ad_format_type, que te permite segmentar los siguientes informes en función del tipo de formato del anuncio de video:

v17 (5/6/2024)

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

Anuncios

Se quitó AdService.getAd. Esto lleva al AdService en línea con otros servicios de API de Google Ads. Consulta Recupera objetos para la forma recomendada de recuperar anuncios y otros tipos de recursos.
Se agregaron más validaciones para ImageAdInfo.image_asset sobre dimensiones y formato. Se pueden generar los siguientes errores si la imagen se no válido:
- 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

Agregado BatchJobError.REQUEST_TOO_LARGE, que se arrojará cuando el AddBatchJobOperationsRequest enviado supere los 10484504 bytes.
Se agregó compatibilidad con la configuración MutateOperation.asset_group_operation. cuando uses BatchJobService. Esto te permite usar el procesamiento por lotes para crear y todas las campañas de máximo rendimiento. Consulta nuestra nueva guía exclusiva.

Campañas

Se cambió el nombre de Discovery a Generación de demanda en todos los campos, enumeraciones y errores de todos. en toda la API de Google Ads, como campañas, anuncios y recursos. Para ejemplo, AdvertisingChannelType.DISCOVERY ahora es AdvertisingChannelType.DEMAND_GEN
Agregado Campaign.keyword_match_type que te permite establecer el tipo de concordancia de palabras clave para todas las palabras clave de una campaña.

Conversiones

Para SKAdNetwork conversiones,
- 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 devuelven con la respuesta, incluso cuando son cero. Esto los hace coherentes con otras métricas.

Criterios

Se agregó a los siguientes campos a AdGroupCriterion para mostrar si el criterio del grupo de anuncios se publica o los motivos por los que no lo hace publicación:
- 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 nuevo LocalServicesLeadConversation a LocalServicesLead, que envía el mensajes a los usuarios a través de canales apropiados como SMS, según cómo se se creó el cliente potencial.
- El tamaño de AppendLeadConversationRequest.conversations es limitado a 1,000.
- Solo LocalServicesLead con lead_type se estableció en LeadType.MESSAGE puede especificarse 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 iniciada con el nuevo 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

Informes

Ahora puedes seleccionar solo campos relacionados con un producto vinculado cuando se consulta product_link. Seleccionar varios elementos campos de varios productos vinculados arrojarán QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Por ejemplo: product_link.advertising_partner.customer y product_link.data_partner.data_partner_id no se puede seleccionar en la misma consulta.
Pasa un page_size a GoogleAdsService.Search generará una RequestError.PAGE_SIZE_NOT_SUPPORTED .

Compras

Se agregó un nuevo informe shopping_product, que corresponde a la página Productos de la IU de Google Ads. Admite mostrar Datos relacionados con el estado actual de los productos de Google Merchant Center vinculadas a una cuenta de Google Ads.
- Puedes filtrar las métricas Informe shopping_product con segments.date cuando uses GoogleAdsService.Search o GoogleAdsService.SearchStream. No se permite la segmentación por fecha; se mostrará un ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION .

Objetivos unificados

Se agregó UserListCustomerTypeService.MutateUserListCustomerTypes() para configurar el público de clientes de palabras clave.
Se quitó CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. Para definir la configuración del público de los objetivos del ciclo de vida del cliente, utiliza UserListCustomerTypeService.MutateUserListCustomerTypes() en su lugar.
- Adjuntar o desvincular una lista de usuarios mediante el parámetro de configuración UserListCustomerType.customer_type_category a UserListCustomerTypeCategory.PURCHASERS para incluirlos o excluirlos de la definición de un cliente existente para los objetivos del ciclo de vida del cliente, respectivamente. Visite Cómo segmentar públicos para obtener más información.

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 recursos de video al crear DemandGenVideoResponsiveAdInfo
(Solo para cuentas incluidas en la lista de entidades permitidas) Hecha 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 permite agregar una IP como criterio negativo a nivel del cliente.
Nuevo valor enum: ProductLinkError.LINK_EXISTS
Nuevo valor enum: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION

Recursos

Compatibilidad con los recursos relacionados con las generaciones de demanda para ad_group_ad_asset_view y asset_field_type_view.
Nuevo valor enum: AssetFieldType.DISCOVERY_CAROUSEL_CARD

Públicos

Nuevo valor de enumeración: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER lo que limita a 1,000 la cantidad de listas de usuarios similares que puede tener un cliente.

Campañas

Compatibilidad para devolver Target de ofertas de la campaña de ROAS las campañas de aplicaciones con el Informe campaign_simulation.
Nuevo valor enum: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
Nuevo valor enum: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
Nuevo valor enum: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS

Conversiones

SkAdNetworkConversionValueSchema.postback_mappings que admite SKAdNetwork 4.0 atributos.
Se agregó compatibilidad con advertencias para CustomerSkAdNetworkConversionValueSchemaService como MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings Cuando se establece en true, cualquier error sin bloqueo relacionado con fallas de operación se devolverán 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
Nueva enumeración: BrandRequestRejectionReason
Nuevo valor enum: 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 devuelve el estado de crédito y la marca de tiempo cuando ese estado se actualizó, respectivamente.
local_services_lead_conversation.message_details.attachment_urls que devuelve las URLs que se pueden usar para descargar el contenido de la adjunto.

Videos

customer.video_brand_safety_suitability y BrandSafetySuitability que permiten recuperar la idoneidad para la seguridad de la marca de los videos a nivel de organización.
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 desde AccountLink a ProductLink y ProductLinkInvitation
Se quitaron data_partner y google_ads de AccountLink
Agregado IdentityVerificationService a administrar la verificación del anunciante
- StartIdentityVerification() se usa para iniciar una sesión de verificación con el verification_program Crea una nueva sesión de verificación y muestra una respuesta vacía para una la verificación se creó correctamente.
  - Agregado IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION
- GetIdentityVerification() se puede usar para recuperar información de verificación, que devuelve 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 contenga detalles relacionados con la fecha límite para el anunciante debe completar la verificación
  - verification_progress que contenga detalles relacionados con la sesión de verificación, como los siguientes:
    - program_status representa el estado actual de este 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. durante action_url
- Enumeraciones:
  - IdentityVerificationProgram
  - IdentityVerificationProgramStatus
- Errores:
  - IdentityVerificationError
Agregado 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
- Se convirtió campaign en un recurso atribuido en lugar de un recurso de segmentación.

Campañas

Cambios en las campañas de generación de demanda:
- Se agregó compatibilidad con la configuración Campaign.shopping_setting a una campaña de generación de demanda existente.
- Agregado 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 la correspondiente DemandGenProductAdInfo, disponible para de generación de demanda con un valor Campaign.shopping_setting
Se agregó a los siguientes campos a 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 a AdGroupAd para mostrarlos 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

Experimento

Se agregó Experiment.sync_enabled a Especifica si se debe habilitar la sincronización en el experimento. Con sincronización habilitado, los cambios realizados en mientras se ejecuta el experimento, se publican se copió en la campaña experimental.
Agregado ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
Agregado CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL

Hoteles y Viajes

Se agregaron los siguientes campos a ListingDimensionInfo para Cosas que hacer para habilitar la creación de grupos de fichas según el estado y la ciudad donde el actividad de viajes disponible:
- activity_state
- activity_city
Se agregó compatibilidad con los siguientes segmentos a travel_activity_performance_view

Servicios locales

Agregado LocalServicesVerificationArtifact.business_registration_check_verification_artifact y BusinessRegistrationCheckArtifact para permitir que los anunciantes supervisen el progreso del registro comercial proceso de verificación de identidad.
Se agregó un recurso nuevo local_services_employee para permitir a los anunciantes recuperar la información de los empleados que agregaron.

Planificación

Se quitó score de AudienceInsightsAttributeMetadata

Recomendaciones

Agregado RecommendationService.GenerateRecommendations() que devuelve 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 la campaña.
Agregado RecommendationMetrics.conversions_value
Las palabras clave recomendadas sin un tipo de concordancia de palabras clave ahora tienen recommended_match_type Se establece en UNSPECIFIED en lugar de UNKNOWN.
Se agregaron los siguientes tipos de recomendaciones:
- MAXIMIZE_CONVERSION_VALUE_OPT_IN que recomienda habilitar las ofertas Maximizar valor de conversión estrategia
- IMPROVE_GOOGLE_TAG_COVERAGE lo 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 las campañas campañas
- REFRESH_CUSTOMER_MATCH_LIST que recomienda actualizar una lista de clientes que no se haya actualizado 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 la campaña o al nivel
- IMPROVE_DEMAND_GEN_AD_STRENGTH que recomienda mejorar la calidad del anuncio en las campañas de generación de demanda

Compras

Agregado CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT y CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS a fin de proporcionar errores más detallados en las campañas de Shopping vinculadas a un 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 se suspendió debido a una cuenta no autorizada actividad, customer.status y customer_client.status ahora se devuelven como SUSPENDED. Anteriormente, se devolvían como ENABLED
Se agregó compatibilidad para agregar y quitar una vinculación entre una cuenta de Google Ads y Una cuenta de Merchant Center:
- Agregado ProductLink.merchant_center y MerchantCenterIdentifier
- Agregado LinkedProductType.MERCHANT_CENTER
Agregado ProductLinkInvitationService y ProductLinkInvitation para admitir actualizar una invitación con vínculo enviada desde otros productos, disponible para hoteles de Google Merchant 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 vínculo 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 brindar asistencia agregar y quitar imágenes con esos recursos. Por consiguiente, también quitamos MediaFileService, que ya no es necesario
Agregado ListingGroupFilterDimension.webpage para admitir la creación de un filtro de grupo de fichas basado en etiquetas personalizadas y URL o subcadenas.
- 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.
Agregado ad_group_ad_asset_view.source a mostrar la fuente del recurso del anuncio del grupo de anuncios

Públicos

Para la Segmentación por clientes, se agregó CustomerMatchUserListMetadata.consent para admitir el consentimiento. A partir del 6 de marzo de 2024, si el consentimiento para los usuarios del EEE, el valor del consentimiento se determina 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 publicación de anuncios con 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 a para brindar un consentimiento. Consulta nuestra Guía de ventas en la tienda para más detalles. Si utilizas la Segmentación por clientes con las ventas en la tienda, revisa el Preguntas frecuentes información.
Agregado UserList.lookalike_user_list a la creación de un proyecto similar segmento, un público creado en función del público de origen existente proporcionado. Se pueden utilizar segmentos similares en una campaña de generación de demanda solamente.

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. Se debe establecer Audience.asset_group solo si Audience.scope es ASSET_GROUP
  - AssetGroupSignal.search_theme
    - Agregado CriterionType.SEARCH_THEME para admitir este nuevo tipo de criterio. Este nuevo tipo de criterio solo puede en campañas de máximo rendimiento para crear un AssetGroupSignal si propagas los datos AssetGroupSignal.search_theme con un criterio SearchThemeInfo.
- Agregado AssetGroupSignalOperation.exempt_policy_violation_keys para admitir la solicitud de exención cuando se agreguen indicadores de grupos de recursos.
- Se agregó un nuevo asset_group_top_combination_view para registrar los recursos con mejor rendimiento a nivel del grupo de recursos.
- Ahora se puede consultar asset_group con campos de métrica para permitir recuperar el rendimiento de una campaña de máximo rendimiento.
- En PerformanceMaxUpgradeStatus, se cambió el nombre UPGRADE_ELIGIBLE por UPGRADE_ELIGIBLE.
Para las campañas de generación de demanda y Descubrimiento campañas de CPA objetivo, las simulaciones de ofertas de CPA objetivo a nivel de la campaña (campaign_simulation.target_cpa_point_list.points) ahora muestra TargetCpaSimulationPoint.interactions en vez de TargetCpaSimulationPoint.clicks.
Se agregó BrandSuggestionService, que puede sugerir marcas en función del prefijo de marca proporcionado y la lista de entidades excluidas marcas. Estas marcas se pueden usar para crear un BRAND criterio, agregado a un conjunto compartido de BRANDS y, luego, adjuntarlo a una campaña CampaignCriterion con brand_list configurado en el conjunto compartido. Los criterios de la campaña se pueden orientar en las campañas de Búsqueda y excluirse en de máximo rendimiento, respectivamente.
- Campos:
  - SharedCriterion.brand
  - CampaignCriterion.brand_list
- Enumeraciones:
  - SharedSetType.BRANDS
  - CriterionType.BRAND_LIST
Agregado Campaign.asset_automation_settings[] para mostrar el estado de automatización de cada tipo de recurso.
Se agregaron los siguientes valores al CampaignPrimaryStatusReason enum:
- NO_ASSET_GROUPS
- ASSET_GROUPS_PAUSED

Conversiones

Se agregaron CallConversion.consent y ClickConversion.consent para admitir dar su consentimiento. Consulta nuestra guía de conversiones de llamada y la guía sobre conversiones por clic para obtener más información más detalles.
Se agregaron los siguientes campos relacionados con SKAdNetwork de las conversiones, disponibles cuando se las consulta 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. Usar esta para obtener detalles útiles sobre el estado de la carga de conversiones, como el de eventos exitosos, la tasa de éxito y el porcentaje de errores.
  - Caveat: Es una conversión que se sube, pero que genera una ConversionUploadError.CLICK_NOT_FOUND error se sigue contando como exitoso, pero también se marca como OfflineConversionAlert.
- Se agregó job_id como parámetro opcional para los siguientes tipos de solicitud, de modo que puedes agrupar de forma lógica varias solicitudes de carga en un solo trabajo:
  - 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 Privacy Sandbox entre varias redes de Android. atribución 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.
Agregado ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS Un objeto ConversionActionOperation que intenta usar uno de los métodos de atribución obsoleta basada en reglas de base ahora falla con este error. Antes, la operación fallaba con un UNKNOWN error.

Hoteles y Viajes

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

Anuncios de Servicios Locales

Se agregó LocalServicesSettings y su al informe customer para mostrar un evento local Información detallada sobre la licencia y los estados del seguro del anunciante de servicios.
Se agregaron los siguientes informes nuevos para la métrica Local Servicios:
- local_services_lead contiene todos los información detallada sobre Servicios Locales de Google Ads, como lead_charged, lead_type y lead_status.
  - Enumeraciones:
    - LeadStatus
    - LeadType
- local_services_lead_conversation contiene detalles de conversaciones telefónicas y de mensajes, como conversation_channel, call_duration_millis y call_recording_url.
  - La URL de grabación de llamadas telefónicas se autentica en función del cliente objetivo y sus cuentas de administrador.
- local_services_verification_artifact devuelve artefactos de un anunciante de Servicios Locales, como la verificación de antecedentes, licencias comerciales y datos de seguros comerciales. Cualquier documento asociado con licencia y seguro se puede acceder 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 con la devolución PlannableTargeting.surface_targeting para ReachPlanService.ListPlannableProducts, que describe las plataformas disponibles para un producto.
Se agregó un nuevo Enum ReachPlanSurface.
Se agregó compatibilidad con la orientación Target frecuencia con AdvancedProductTargeting.target_frequency_settings, que devuelve PlannedProductForecast.average_frequency.
Agregado AudienceInsightsService.GenerateSuggestedTargetingInsights para mostrar los públicos objetivo sugeridos.
Se agregaron los siguientes valores a ReachPlanError
- NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
- NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

Recomendaciones

Agregado RecommendationSubscriptionService que administra las suscripciones a 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á tráfico.
- SET_TARGET_CPA que recomienda establecer un CPA objetivo para las campañas que no tienen uno especificada.
- SET_TARGET_ROAS que recomienda establecer un ROAS objetivo para las campañas que no tienen uno especificada.

Informes

Se agregaron las siguientes métricas nuevas, que se pueden consultar con campaign (disponible para Display, video, discovery y campañas de aplicaciones) y segments.device:
- metrics.unique_users
- metrics.average_impression_frequency_per_user

Compras

Se quitó ShoppingSetting.sales_country, cuyos valores ahora se muestran como ShoppingSetting.feed_label
- Puedes seguir usando una cuenta de Merchant Center feed para una campaña el ShoppingSetting.feed_label . Debe establecerse con el valor de la etiqueta de feed o con el país de dos letras. código que se usó anteriormente para ShoppingSetting.sales_country. Para obtener más detalles, consulta el artículo de asistencia sobre feeds etiquetas.
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 utilizados 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 contenido Campaign.shopping_setting hasta la Búsqueda campañas. Intentar crear una campaña de Búsqueda con Campaign.shopping_setting o agregar Campaign.shopping_setting a una una campaña de Búsqueda existente ahora genera OPERATION_NOT_PERMITTED_FOR_CONTEXT.
Se quitó la compatibilidad para agregar contenido CampaignCriterion.listing_scope a las campañas de Búsqueda. Intentando agregar CampaignCriterion.listing_scope a una campaña de Búsqueda existente, ahora genera OPERATION_NOT_PERMITTED_FOR_CONTEXT
Se agregaron las siguientes conversiones con el carrito Métricas de datos:
- 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

Agregado CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals para configurar los objetivos de adquisición de clientes a nivel del cliente.
- Informe: customer_lifecycle_goal
Agregado CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals para configurar los objetivos de adquisición de clientes a nivel de la campaña.
- Informe: campaign_lifecycle_goal
Agregado 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 amplió la compatibilidad para orientar los anuncios a Google TV a nivel de la campaña:
- Agregado NetworkSettings.target_google_tv_network
- Agregado AdNetworkType.GOOGLE_TV
Se amplió la compatibilidad para orientar los anuncios a YouTube a nivel de la campaña:
- Agregado NetworkSettings.target_youtube
- En AdNetworkType, combinado YOUTUBE_WATCH y YOUTUBE_SEARCH a YOUTUBE.
- Agregado CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE

Notas de la versión archivadas

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