Editar

Compartir a través de


Preguntas frecuentes

Este artículo contiene respuestas a algunas preguntas más frecuentes sobre la API de Bing Ads.

Obtener ayuda

¿Dónde puedo obtener ayuda?

El foro microsoft Q&A está disponible para que la comunidad de desarrolladores formule y responda preguntas sobre las API de Bing Ads y los scripts de Microsoft Advertising. Microsoft supervisa los foros y las respuestas a las preguntas que la comunidad aún no ha respondido.

Importante

Para asegurarse de que vemos su pregunta, etiquete esta opción con "advertising-api".

Si la investigación implica información confidencial de la cuenta o los datos personales, o si no encuentra la información que necesita para resolver el problema a través de Microsoft Q&A, póngase en contacto con el Soporte técnico de Microsoft Advertising. Para resolver el problema de forma eficaz, proporcione soporte técnico con los detalles solicitados en Soporte técnico de participación.

¿Cómo puedo averiguar sobre los cambios?

Las notas de la versión y la Guía de migración son excelentes recursos con los que empezar.

Puede registrarse en el boletín mensual a través de la pestaña Noticias del Portal para desarrolladores, donde también se agregan los anuncios de blog más recientes.

Introducción

¿Cuáles son los requisitos para usar la API de Bing Ads?

Para empezar, debe registrarse para obtener una cuenta de Microsoft Advertising y, a continuación, obtener el token de desarrollador en la pestaña Cuenta del Portal para desarrolladores.

¿Qué lenguajes de programación y SDK se admiten?

Puede desarrollar aplicaciones de API de Bing Ads con cualquier lenguaje de programación que admita servicios web. Los kits de desarrollo de software (SDK) de Bing Ads API mejoran la experiencia de desarrollo de aplicaciones de API de Bing Ads con lenguajes .NET, Java, PHP y Python. Cada SDK incluye un proxy para todos los servicios web Bing Ads API y abstrae los detalles de bajo nivel de la autenticación con OAuth. Puede usar las interfaces BulkServiceManager y ReportingServiceManager de alto nivel para abstraer y ejecutar operaciones en bulk y Reporting Services de bajo nivel.

Hemos escuchado solicitudes de SDK adicionales, por ejemplo, Perl y Ruby, aunque no hay ningún plan para agregar soporte técnico a corto plazo.

¿Cómo puedo ver ejemplos de código en diferentes lenguajes de programación?

Además de los ejemplos de código , encontrará fragmentos de código en muchas de las guías técnicas, por ejemplo, la guía de introducción . Puede usar el selector de idioma en la parte superior o derecha de esas páginas para ver ejemplos en CSharp, Java, Php o Python. Al elegir un idioma, la configuración se conserva a medida que navega por otras páginas. El selector de idioma solo incluirá idiomas que tengan ejemplos para esa página específica y tendrá como valor predeterminado C# si el idioma que estableció anteriormente no está disponible para la página a la que ha navegado.

Disponibilidad de características

¿Debo usar la API de administración masiva o de campañas?

Se recomienda el servicio masivo , especialmente si necesita agregar o actualizar anuncios y palabras clave en varios grupos de anuncios o campañas de una cuenta. Algunas características no están disponibles en masa, por ejemplo , AddUetTags, GetBMCStoresByCustomerId, GetGeoLocationsFileUrl y GetMediaMetaDataByAccountId. Por supuesto, para estas características debe usar el servicio De administración de campañas.

¿Qué informes de rendimiento de API están disponibles y cuándo estarán disponibles mis datos?

El servicio de informes admite la mayoría de los mismos tipos de informe que puede encontrar en la aplicación web de Microsoft Advertising. Asegúrese de consultar las guías Atributos de informe y Estadísticas de rendimiento y Períodos de tiempo de retención de datos de informes para obtener detalles de disponibilidad.

Cuando un usuario hace clic en un anuncio, el sistema puede tardar hasta dos horas en procesar el clic (3 horas para las conversiones) y ponerlo a disposición de los informes. Cuando todos los datos del día anterior se han procesado y puesto a disposición de los informes, este estado se conoce como Libros cerrados. Para obtener más información sobre cuándo se cierran los libros para la generación de informes, vea Zonas horarias en Informes.

OAuth

¿Cuándo se requerirá la autenticación multifactor a través de Bing Ads API, Content API y Hotel Price Ads API?

Importante

En junio de 2022, introdujimos la autenticación multifactor como requisito para Bing Ads. Es posible que tenga que realizar un cambio de código para cumplir con este requisito. Microsoft Advertising está realizando comprobaciones técnicas de cumplimiento a principios de octubre.

En esta entrada de blog se describen los pasos que debe seguir para garantizar el cumplimiento.

Para obtener más información, consulte la guía de requisitos de autenticación multifactor .

¿Es necesario realizar cambios para cumplir con el requisito de autenticación multifactor?

Debe actualizar la aplicación para usar el nuevo msads.manage ámbito a través del punto de conexión de Plataforma de identidad de Microsoft. Todos los desarrolladores de aplicaciones deben realizar acciones para usar el nuevo ámbito.

Debe solicitar consentimiento a un usuario a través del nuevo msads.manage ámbito y el punto de conexión de Plataforma de identidad de Microsoft.

¿Es necesario registrar una nueva aplicación para usar msads.manage?

Si tiene un identificador de aplicación anterior (también conocido como id. de cliente) con formato hexadecimal, por ejemplo, 0000000012345A67, debe registrar una nueva aplicación. Los identificadores de aplicación de Plataforma de identidad de Microsoft válidos tienen el formato de GUID con guiones, por ejemplo, 00001111-aaaa-2222-bbbb-3333cccc4444. Si no ve una aplicación existente en el Azure Portal - Registros de aplicaciones, es una indicación de que debe reemplazarla por una nueva aplicación.

¿Necesita un usuario conceder consentimiento al actualizar a msads.manage?

Sí. Debe solicitar consentimiento a un usuario a través del nuevo msads.manage ámbito y el punto de conexión de Plataforma de identidad de Microsoft.

¿Cuál es la experiencia del usuario cuando se le solicita consentimiento a través del punto de conexión de Plataforma de identidad de Microsoft?

Cuando se solicita consentimiento a un usuario (mediante el inquilino común) con el punto de conexión Plataforma de identidad de Microsoft, la experiencia de inicio de sesión del usuario variará en función de la identidad subyacente detrás de sus credenciales.

Nota:

Debe controlar los códigos de error de operación 122 a 125 para ayudar a los usuarios de la aplicación a seleccionar las credenciales correctas, es decir, la cuenta profesional frente a la personal.

Cuando un usuario pasa de usar su cuenta personal a su cuenta profesional o educativa en Microsoft Advertising, ¿qué ocurre con su token de actualización?

Si el usuario ya no tiene una identidad de cuenta personal de MSA, Bing Ads API ya no aceptará su token de acceso existente. Del mismo modo, el token de actualización ya no se puede usar para solicitar un nuevo token de acceso, por lo que tendrá que solicitar de nuevo el consentimiento del usuario para que la aplicación administre sus cuentas de Microsoft Advertising. Debe descartar el token de actualización anterior.

¿Admite el espacio aislado cuentas profesionales o educativas?

No. Las cuentas profesionales o educativas solo se admiten en producción.

Quiero ejecutar mi aplicación sin interacción del usuario. ¿Cómo puedo autenticarme sin que se me pida permiso para usar las credenciales de Microsoft Advertising?

Para administrar mediante programación una cuenta de Microsoft Advertising, debe proporcionar su consentimiento al menos una vez a través del flujo de consentimiento de la aplicación web. Para la autenticación repetida o a largo plazo, debe seguir el flujo de concesión de código de autorización para obtener un token de acceso y un token de actualización. A partir de entonces, puede usar el token de actualización más reciente para solicitar nuevos tokens de acceso y actualización sin ninguna interacción adicional del usuario. Es posible que deba solicitar de nuevo el consentimiento del usuario, por ejemplo, si el usuario ha pasado por la recuperación de la cuenta, ha cambiado su contraseña o ha quitado los permisos para que la aplicación se autentique en su nombre.

¿Cuándo expiran los tokens de acceso y actualización?

El token de acceso suele expirar después de una hora, aunque siempre debe comprobar la hora de expiración cada vez que solicite un nuevo token.

Los tokens de actualización son, y siempre serán, completamente opacos para la aplicación. Son de larga duración, por ejemplo, 90 días para los clientes públicos, pero la aplicación no debe escribirse para esperar que un token de actualización dure cualquier período de tiempo. Los tokens de actualización se pueden invalidar en cualquier momento y la única manera de que una aplicación sepa si un token de actualización es válido es intentar canjearlo mediante una solicitud de token. Incluso si actualiza continuamente el token en el mismo dispositivo con el token de actualización más reciente, debe esperar iniciar de nuevo y solicitar el consentimiento del usuario si, por ejemplo, ha firmado el usuario, el usuario de Microsoft Advertising ha cambiado su contraseña, ha quitado un dispositivo de su lista de dispositivos de confianza o ha quitado permisos para que la aplicación se autentique en su nombre. En cualquier momento sin previo aviso, Microsoft puede determinar que se debe conceder de nuevo el consentimiento del usuario. Como procedimiento recomendado, siempre debe almacenar de forma segura el token de actualización más reciente cada vez que solicite nuevos tokens de acceso y actualización.

¿Por qué necesito un token de acceso y un token de desarrollador?

El token de acceso representa las credenciales de usuario que tienen acceso a una o varias cuentas de Microsoft Advertising. El identificador de aplicación (también conocido como client_id) identifica la aplicación para cada usuario de Microsoft Advertising que conceda consentimiento. El token de desarrollador concede a la aplicación permiso para usar la API de Bing Ads.

Marca

¿Se cambiará el nombre de Bing Ads API junto con la plataforma Microsoft Advertising?

Bing Ads ahora es Microsoft Advertising. Nuestro nuevo nombre refleja cómo estamos creciendo nuestras soluciones publicitarias para ayudarle a llegar a más clientes. No hay planes para cambiar el nombre de ninguna de las versiones de API actuales. En la tabla siguiente se enumeran los nombres que tienen o no han cambiado. Para obtener más información, consulte el anuncio de marca.

Nombre anterior Nombre actual
Vista previa de anuncios y herramienta de diagnóstico Vista previa de anuncios y herramienta de diagnóstico
Bing Ads Microsoft Advertising
profesionales acreditados Bing Ads profesionales acreditados Bing Ads
Bing Ads API Bing Ads API
aplicación Bing Ads Aplicación de Microsoft Advertising
API de contenido de Bing Ads API de contenido de Bing Ads
Editor Bing Ads Microsoft Advertising Editor
Bing Ads Fans Microsoft Advertising Fans
inteligencia de Bing Ads Inteligencia de Microsoft Advertising
Bing Ads Partner Microsoft Advertising Partner
Bing Ads Scripts Microsoft Advertising Scripts
Bing Ads SDK Bing Ads SDK
Bing Hotel Center Centro de hoteles de Microsoft
Bing Merchant Center Centro de comerciantes de Microsoft
Bing Network Microsoft Advertising Network
Distribución de Bing Network Sitios de partners de Microsoft Advertising
Bing Partner Awards Premios de partners de Microsoft Advertising
Programa de partners de Bing Programa de partners de Microsoft Advertising
Campañas de Bing Shopping Campañas de compras de Microsoft
Palabra clave Planner Palabra clave Planner
Anuncios de precios de hotel Anuncios de precios de hotel
Hotel API Hotel API