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.
- El campo
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:
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únsegments.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
ycampaign
: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 alAdService
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:
Recursos
- Se agregó una nueva enumeración:
ClickType.AD_IMAGE
- Se agregaron los siguientes informes nuevos con métricas nuevas para las campañas de máximo rendimiento y de Búsqueda:
Públicos
Trabajos por lotes
- Agregado
BatchJobError.REQUEST_TOO_LARGE
, que se arrojará cuando elAddBatchJobOperationsRequest
enviado supere los 10484504 bytes. - Se agregó compatibilidad con la configuración
MutateOperation.asset_group_operation
. cuando usesBatchJobService
. 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 esAdvertisingChannelType.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
asegments.sk_ad_network_fine_conversion_value
- Se agregó
segments.sk_ad_network_redistributed_fine_conversion_value
.
- Se cambió el nombre de
- Las siguientes métricas ahora se 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
paragender_view
- Se agregó compatibilidad con
metrics.phone_calls
parakeyword_view
Servicios locales
- Se agregó
LocalServicesLeadService.AppendLeadConversation()
que se usa para agregar un nuevoLocalServicesLeadConversation
aLocalServicesLead
, 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
conlead_type
se estableció enLeadType.MESSAGE
puede especificarse enConversation.local_services_lead
- El tamaño de
- Se agregaron nuevos valores de enumeración a
ConversationType
WHATSAPP
para representar una conversación que se presentó a través de WhatsApp.ADS_API
para representar una conversación iniciada con el nuevoLocalServicesLeadService.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ánQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
Por ejemplo:product_link.advertising_partner.customer
yproduct_link.data_partner.data_partner_id
no se puede seleccionar en la misma consulta. - Pasa un
page_size
aGoogleAdsService.Search
generará unaRequestError.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
consegments.date
cuando usesGoogleAdsService.Search
oGoogleAdsService.SearchStream
. No se permite la segmentación por fecha; se mostrará unShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
.
- Puedes filtrar las métricas
Informe
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, utilizaUserListCustomerTypeService.MutateUserListCustomerTypes()
en su lugar.- Adjuntar o desvincular una lista de usuarios mediante el parámetro de configuración
UserListCustomerType.customer_type_category
aUserListCustomerTypeCategory.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.
- Adjuntar o desvincular una lista de usuarios mediante el parámetro de configuración
Videos
- Se agregaron los siguientes valores a
ContentLabelType
Puedes excluir estosContentLabelTypes
a nivel del cliente:BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
BRAND_SUITABILITY_GAMES_FIGHTING
BRAND_SUITABILITY_GAMES_MATURE
BRAND_SUITABILITY_HEALTH_SENSITIVE
BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
BRAND_SUITABILITY_NEWS_RECENT
BRAND_SUITABILITY_NEWS_SENSITIVE
BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
BRAND_SUITABILITY_POLITICS
BRAND_SUITABILITY_RELIGION
- Se agregó
AdVideoAsset.ad_video_asset_info
para admitir preferencias de inventario para recursos de video al crearDemandGenVideoResponsiveAdInfo
- (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
yasset_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
comoMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
Cuando se establece entrue
, cualquier error sin bloqueo relacionado con fallas de operación se devolverán comoMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
- Nuevos valores de enumeración en
CustomerSkAdNetworkConversionValueSchemaError
:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
Criterios
- Nuevos campos en
BrandInfo
:display_name
primary_url
rejection_reason
status
- 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
ylocal_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
yBrandSafetySuitability
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
desdeAccountLink
aProductLink
yProductLinkInvitation
- Se quitaron
data_partner
ygoogle_ads
deAccountLink
- Agregado
IdentityVerificationService
a administrar la verificación del anuncianteStartIdentityVerification()
se usa para iniciar una sesión de verificación con elverification_program
Crea una nueva sesión de verificación y muestra una respuesta vacía para una la verificación se creó correctamente.GetIdentityVerification()
se puede usar para recuperar información de verificación, que devuelve varios objetos deIdentityVerification
. CadaIdentityVerification
incluye lo siguiente:verification_program
que es el tipo de programa de verificación de identidadidentity_verification_requirement
que contenga detalles relacionados con la fecha límite para el anunciante debe completar la verificaciónverification_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ónaction_url
dirige al cliente a una URL para completar la verificación.invitation_link_expiration_time
representa la fecha de vencimiento. duranteaction_url
- Enumeraciones:
- Errores:
- 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
ysegments.month
- Se convirtió
campaign
en un recurso atribuido en lugar de un recurso de segmentación.
- 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 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 correspondienteDemandGenProductAdInfo
, disponible para de generación de demanda con un valorCampaign.shopping_setting
- Se agregó compatibilidad con la configuración
- 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: - Se agregó compatibilidad con los siguientes segmentos a
travel_activity_performance_view
Servicios locales
- Agregado
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
yBusinessRegistrationCheckArtifact
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
deAudienceInsightsAttributeMetadata
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 enUNSPECIFIED
en lugar deUNKNOWN
. - Se agregaron los siguientes tipos de recomendaciones:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
que recomienda habilitar las ofertas Maximizar valor de conversión estrategiaIMPROVE_GOOGLE_TAG_COVERAGE
lo 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 las campañas campañasREFRESH_CUSTOMER_MATCH_LIST
que recomienda actualizar una lista de clientes que no se haya actualizado 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 la campaña o al nivelIMPROVE_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
yCampaignError.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
aCustomerLifecycleGoalOperation
yCampaignLifecycleGoalOperation
para que estos tipos de operaciones sean coherentes con otros tipos de operaciones de la API.
v15 (18/10/2023)
Las siguientes funciones y actualizaciones nuevas se introdujeron en la versión v15.
Administración de cuentas
- Si tu cuenta se suspendió debido a una cuenta no autorizada
actividad,
customer.status
ycustomer_client.status
ahora se devuelven comoSUSPENDED
. Anteriormente, se devolvían comoENABLED
- 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
yMerchantCenterIdentifier
- Agregado
LinkedProductType.MERCHANT_CENTER
- Agregado
- Agregado
ProductLinkInvitationService
yProductLinkInvitation
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
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 vínculo desde cuentas de Hotel Center conAccountLinkService
- Para actualizar una invitación de vinculación desde una cuenta de Hotel Center, usa
ProductLinkInvitationService
- Para actualizar una invitación de vinculación desde una cuenta de Hotel Center, usa
Recursos
- Se reemplazó
ImageAdInfo.media_file
porImageAdInfo.image_asset
para brindar asistencia agregar y quitar imágenes con esos recursos. Por consiguiente, también quitamosMediaFileService
, 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
porAssetGroupListingGroupFilter.listing_source
yListingGroupFilterListingSource
- También se reemplazó
- 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
yAudience.asset_group
para limitar el uso del público a un grupo de recursos específico. Se debe establecerAudience.asset_group
solo siAudience.scope
esASSET_GROUP
- Se agregaron
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 unAssetGroupSignal
si propagas los datosAssetGroupSignal.search_theme
con un criterioSearchThemeInfo
.
- Agregado
- 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 nombreUPGRADE_ELIGIBLE
porUPGRADE_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 muestraTargetCpaSimulationPoint.interactions
en vez deTargetCpaSimulationPoint.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 unBRAND
criterio, agregado a un conjunto compartido deBRANDS
y, luego, adjuntarlo a una campañaCampaignCriterion
conbrand_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:
- Enumeraciones:
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
yClickConversion.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
ocampaign
: - Se reemplazó
metrics.sk_ad_network_conversions
pormetrics.sk_ad_network_installs
- Se agregó compatibilidad para diagnosticar la carga de conversiones sin conexión.
- Se movió el
offline_conversion_upload_client_summary
de un campo en el recursocustomer
a un informe de nivel superior. 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 comoOfflineConversionAlert
.
- Caveat: Es una conversión que se sube, pero que genera una
- 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: - Se agregó
INVALID_JOB_ID
a los siguientes errores: - Se reemplazó
INVALID_CONVERSION_ACTION
porNO_CONVERSION_ACTION_FOUND
yINVALID_CONVERSION_ACTION_TYPE
en los siguientes errores:
- Se movió el
- Se agregaron tres informes para admitir Privacy Sandbox entre varias redes de Android.
atribución 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.
- Agregado
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
Un objetoConversionActionOperation
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 unUNKNOWN
error.
Hoteles y Viajes
- Se agregó compatibilidad con 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 su al informecustomer
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, comolead_charged
,lead_type
ylead_status
.- Enumeraciones:
local_services_lead_conversation
contiene detalles de conversaciones telefónicas y de mensajes, comoconversation_channel
,call_duration_millis
ycall_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.
Planificación
- Se agregó compatibilidad para mostrar
Forecast.views
yPlannedProductForecast.views
paraReachPlanService.ListPlannableProducts
para los tipos de productos aplicables. - Se agregó compatibilidad con la devolución
PlannableTargeting.surface_targeting
paraReachPlanService.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 devuelvePlannedProductForecast.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: - 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) ysegments.device
:
Compras
- Se quitó
ShoppingSetting.sales_country
, cuyos valores ahora se muestran comoShoppingSetting.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 paraShoppingSetting.sales_country
. Para obtener más detalles, consulta el artículo de asistencia sobre feeds etiquetas.
- Puedes seguir usando una cuenta de Merchant Center
feed para una campaña
el
- 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
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 utilizados en
- Se quitó la compatibilidad para agregar contenido
Campaign.shopping_setting
hasta la Búsqueda campañas. Intentar crear una campaña de Búsqueda conCampaign.shopping_setting
o agregarCampaign.shopping_setting
a una una campaña de Búsqueda existente ahora generaOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Se quitó la compatibilidad para agregar contenido
CampaignCriterion.listing_scope
a las campañas de Búsqueda. Intentando agregarCampaignCriterion.listing_scope
a una campaña de Búsqueda existente, ahora generaOPERATION_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
- Informe:
- Agregado
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
para configurar los objetivos de adquisición de clientes a nivel de la campaña.- Informe:
campaign_lifecycle_goal
- Informe:
- 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
- Agregado
- Se amplió la compatibilidad para orientar los anuncios a YouTube a nivel de la campaña:
- Agregado
NetworkSettings.target_youtube
- En
AdNetworkType
, combinadoYOUTUBE_WATCH
yYOUTUBE_SEARCH
aYOUTUBE
. - Agregado
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
- Agregado
Notas de la versión archivadas
Consulta el artículo Versiones obsoletas para ver las notas de la versión archivadas.