v16.1.0 (24/04/2024)
En la versión 16.1, se agregaron las siguientes funciones y cambios.
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 recursos relacionados con las campañas de generación de demanda para
ad_group_ad_asset_view
yasset_field_type_view
. - Nuevo valor enum:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
.
Públicos
- Nuevo valor enum:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
, que limita la cantidad de listas de usuarios similares que puede tener un cliente a 1,000.
Campañas
- Compatibilidad con simulaciones de ofertas de campañas de ROAS objetivo para 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 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
- Campos nuevos en
BrandInfo
:display_name
primary_url
rejection_reason
status
- Nueva enumeración:
BrandRequestRejectionReason
. - Nuevo valor enum:
CriterionType.LIFE_EVENT
.
Experimentos
- Nuevo valor enum:
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 de crédito y la marca de tiempo de la actualización, respectivamente.local_services_lead_conversation.message_details.attachment_urls
, que muestra las URLs que se pueden usar para descargar el contenido del archivo adjunto.
Videos
customer.video_brand_safety_suitability
yBrandSafetySuitability
, que admiten la recuperación de idoneidad de la seguridad de la marca del video a nivel del cliente.- Nuevo valor enum:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
v16 (21/2/2024)
En la versión 16, se agregaron las siguientes funciones y cambios.
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 mediante elverification_program
proporcionado. Crea una sesión de verificación nueva y muestra una respuesta vacía para una verificación creada correctamente.GetIdentityVerification()
se puede usar para recuperar información de verificación, 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 delaction_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, disponible para las campañas de generación de demanda con un valor no nulo deCampaign.shopping_setting
.
- Se agregó compatibilidad para configurar
- Se agregó a los siguientes campos a
AdGroup
para mostrar si el grupo de anuncios se publica o los motivos por los que no lo hace:primary_status
primary_status_reasons
- Se agregó a los siguientes campos a
AdGroupAd
para mostrar si el anuncio del grupo de anuncios se está publicando 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
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 Actividades para permitir la creación de grupos de fichas en función del estado y la ciudad donde está disponible la actividad de viaje: - 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 de la empresa. - 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 según la configuración especificada, como los tipos de recomendaciones y de canales de publicidad. Esto es particularmente útil durante la creación de la campaña. - Se agregó
RecommendationMetrics.conversions_value
. - Las palabras clave recomendadas sin tipo de concordancia de palabras clave sin establecer ahora tienen
recommended_match_type
configurada 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áginasPERFORMANCE_MAX_FINAL_URL_OPT_IN
, que recomienda activar la expansión de la URL final para tus campañas de máximo rendimientoREFRESH_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 clienteIMPROVE_DEMAND_GEN_AD_STRENGTH
, que recomienda mejorar la calidad de los anuncios en las campañas de generación de demanda.
Compras
- 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 para 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 15.
Administración de cuentas
- Si tu cuenta está suspendida debido a actividad no autorizada en ella, ahora se muestran
customer.status
ycustomer_client.status
comoSUSPENDED
. Anteriormente, se mostraban comoENABLED
. - Se agregó compatibilidad para agregar y quitar un vínculo 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 vinculación enviada desde otros productos, disponibles para las 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 de cuentas de Hotel Center conAccountLinkService
.- Para actualizar una invitación de vínculo desde una cuenta de Hotel Center, usa
ProductLinkInvitationService
.
- Para actualizar una invitación de vínculo desde una cuenta de Hotel Center, usa
Recursos
- Se reemplazó
ImageAdInfo.media_file
porImageAdInfo.image_asset
para admitir el agregado y la 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 grupos de fichas basado en etiquetas personalizadas y subcadenas 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 admitir el consentimiento. A partir del 6 de marzo de 2024, si falta el consentimiento para los usuarios del EEE, el valor correspondiente se determina como consentimiento no otorgado. Los datos de los usuarios del EEE que no den su consentimiento no se procesarán ni se podrán utilizar 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 detalles. - Para las ventas en la tienda, se agregó
UserData.consent
para admitir el consentimiento. Consulta nuestra guía sobre las ventas en la tienda para obtener más detalles. Si usas la Segmentación por clientes con las ventas en la tienda, consulta 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
debe establecerse solo siAudience.scope
esASSET_GROUP
.
- Se agregaron
AssetGroupSignal.search_theme
- Se agregó
CriterionType.SEARCH_THEME
para admitir este nuevo tipo de criterio. Este nuevo tipo de criterio solo se puede usar en las campañas de máximo rendimiento para crear unAssetGroupSignal
. Para ello, propaga elAssetGroupSignal.search_theme
con un criterio deSearchThemeInfo
.
- 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 nuevo elemento
asset_group_top_combination_view
para informar sobre 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 discovery y de generación de demanda, 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 en función del prefijo de marca proporcionado y la lista de marcas excluidas. Estas marcas se pueden usar para crear un criterio deBRAND
, agregarlo a un conjunto compartidoBRANDS
y, luego, adjuntarlo a una campaña creando unCampaignCriterion
conbrand_list
configurado en el conjunto compartido. Los criterios de las campañas se pueden segmentar en las campañas de Búsqueda y excluirse de 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 enumeración
CampaignPrimaryStatusReason
:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversiones
- Se agregaron
CallConversion.consent
yClickConversion.consent
para admitir el consentimiento. Consulta nuestra guía de conversiones de llamada y nuestra guía sobre conversiones por clic 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 elemento
offline_conversion_upload_client_summary
de un campo del 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 exitosos, la tasa de éxito y el porcentaje de errores.- Caveat: Una conversión que se sube, pero que genera un error
ConversionUploadError.CLICK_NOT_FOUND
, se sigue registrando como exitosa, pero también se marca comoOfflineConversionAlert
.
- Caveat: 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 a fin de que puedas agrupar varias solicitudes de carga de forma lógica 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 elemento
- Se agregaron tres informes para admitir la atribución entre 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
. Un objetoConversionActionOperation
que intenta usar uno de los modelos de atribución basados en reglas obsoletos ahora falla con este error. Anteriormente, 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 detallados de la licencia y los seguros 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 del mensaje y de la conversación telefónica, comoconversation_channel
,call_duration_millis
ycall_recording_url
.- La URL de grabación de llamadas telefónicas se autentica en la cuenta del cliente de destino 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 del seguro comercial. Se puede acceder a cualquier documento asociado con la licencia y el seguro a través de una URL.
Planificación
- Se agregó compatibilidad a fin de mostrar
Forecast.views
yPlannedProductForecast.views
paraReachPlanService.ListPlannableProducts
con los tipos de productos aplicables. - Se agregó compatibilidad a fin de mostrar
PlannableTargeting.surface_targeting
paraReachPlanService.ListPlannableProducts
, que describe las plataformas disponibles para un producto. - Se agregó un nuevo enum
ReachPlanSurface
. - Se agregó compatibilidad con la frecuencia objetivo mediante la orientación de
AdvancedProductTargeting.target_frequency_settings
, que muestraPlannedProductForecast.average_frequency
. - Se agregó
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
- Se agregó
RecommendationSubscriptionService
, que administra 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 que se prevé que aumentará el tráfico.SET_TARGET_CPA
, que recomienda establecer 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.
Informes
- Se agregaron las siguientes métricas nuevas, que se pueden consultar con
campaign
(disponible para campañas de Display, video, discovery y de aplicaciones) ysegments.device
:
Compras
- 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 con el campo
ShoppingSetting.feed_label
. Se debe establecer en el valor de la etiqueta de feed o en el código de país de dos letras que se usó anteriormente paraShoppingSetting.sales_country
. Para obtener más información, consulta el artículo de asistencia sobre etiquetas de feed.
- Puedes seguir usando un feed de Merchant Center específico para una campaña con el campo
- Se quitó la dependencia de las categorías de producto de un código de país en los informes.
El conjunto de IDs de categorías admitidos no cambió.
- 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. Si intentas crear una campaña de Búsqueda conCampaign.shopping_setting
o agregarCampaign.shopping_setting
a una campaña de Búsqueda existente, ahora obtendrásOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Se quitó la compatibilidad para agregar
CampaignCriterion.listing_scope
a las campañas de Búsqueda. Si intentas agregarCampaignCriterion.listing_scope
a una campaña de Búsqueda existente, ahora obtendrásOPERATION_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 objetivos de adquisición de clientes a nivel del cliente.- Informe:
customer_lifecycle_goal
- Informe:
- Se agregó
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
para configurar 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 orientar 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 segmentar anuncios 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ó
v14.1.0 (9/8/2023)
Las siguientes funciones y actualizaciones nuevas se introdujeron en la versión 14.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
- Campos nuevos en
AssetGroup
para mostrar si el grupo de recursos está activo o los motivos por los que no lo hace:primary_status
primary_status_reasons
- Campos nuevos en
AssetGroupAsset
para mostrar si el recurso del grupo de recursos se está publicando o los motivos por los que no lo hace:primary_status
primary_status_details
primary_status_reasons
- Valores nuevos en la enumeración
CallToActionType
:BUY_NOW
DONATE_NOW
ORDER_NOW
PLAY_NOW
SEE_MORE
START_NOW
VISIT_SITE
WATCH_NOW
- Valores nuevos en la enumeración
AssetLinkError
:CUSTOMER_NOT_VERIFIED
UNSUPPORTED_CALL_TO_ACTION
PAGE_FEED_INVALID_LABEL_TEXT
Facturación
- Campos nuevos en
Invoice
yAccountSummary
:export_charge_subtotal_amount_micros
export_charge_tax_amount_micros
export_charge_total_amount_micros
Campañas
Valores nuevos en la enum
CampaignPrimaryStatusReason
:HAS_ASSET_GROUPS_DISAPPROVED
HAS_ASSET_GROUPS_LIMITED_BY_POLICY
MOST_ASSET_GROUPS_UNDER_REVIEW
DiscoveryCampaignSettings
conupgraded_targeting
(solo cuentas incluidas en la lista de entidades permitidas):- Cuando
upgraded_targeting
se establece entrue
, puedes agregar una ubicación y un idioma como criterio del grupo de anuncios.
- Cuando
Criterios
Nuevo valor enum:
CriterionError.INVALID_DETAILED_DEMOGRAPHIC
Compatibilidad para agregar
LanguageInfo
yLocationInfo
comoAdGroupCriterion
(solo para cuentas permitidas):- Esta opción solo está disponible para una campaña discovery con la segmentación actualizada habilitada
Experimentos
- Valores nuevos en la enumeración
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 cuentaImprovePerformanceMaxAdStrengthRecommendation
, que recomienda mejorar la calidad 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 campaña de máximo rendimiento.
Informes
- Métricas y segmentos nuevos sobre los clientes nuevos en comparación con los recurrentes:
- Nuevas vistas
customer_search_term_insight
ycampaign_search_term_insight
:metrics.search_volume
muestra el rango de volumen para una categoría de estadísticas de los términos de búsqueda
Compras
- Campos nuevos para los grupos de fichas:
- Campo nuevo:
ShoppingSetting.advertising_partner_ids
- Valores nuevos en 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 suDiscoveryVideoResponsiveAdInfo
correspondiente
v14 (7/6/2023)
Las siguientes funciones y actualizaciones nuevas se introdujeron en la versión 14.
Campañas
Conversiones
Se agregó compatibilidad para identificar las conversiones de Google Analytics y determinar si una conversión se importa desde una propiedad Universal Analytics o 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 agregaron los siguientes valores a
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
- Enumeraciones
Se agregó
job_id
a las respuestas que muestranConversionAdjustmentUploadService.UploadConversionAdjustments
yConversionUploadService.UploadClickConversions
para asociar una respuesta a unOfflineConversionUploadSummary.job_id
.
Criterios
Se agregó compatibilidad para recuperar, crear y actualizar palabras clave negativas a nivel de la cuenta:
- Campos:
- 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
Anuncios de hoteles
- Se cambió el nombre de
SuggestTravelAssetsRequest.place_id
porSuggestTravelAssetsRequest.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 de
campaign_criterion_simulation
- Se agregó compatibilidad con
YOUTUBE_DYNAMIC_LINEUP
como dimensión enAudienceInsightsService.ListAudienceInsightsAttributes
. - Se agregó
DynamicLineupAttributeMetadata.sample_channels
, que se usa en las respuestas deGenerateAudienceCompositionInsights
para proporcionar canales de muestra en 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 reducir el ROAS objetivo. - Se agregó
RaiseTargetCpaRecommendation
, que recomienda aumentar el CPA objetivo. - Se agregó
ResponsiveSearchAdAssetRecommendation.current_ad
Informes
- Se agregaron los siguientes valores a
ServedAssetFieldType
, que están disponibles enad_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 Versiones anteriores para ver las notas de la versión archivadas.