Notas de la versión para scripts de Microsoft Advertising

Para obtener información sobre los cambios que se incluyeron con cada versión, consulte las secciones siguientes.

31 de marzo de 2021

La posición media ya no está disponible en Microsoft Advertising.

El método getAveragePosition se quita del objeto Stats .

La columna AveragePosition se quita como una condición con los siguientes selectores.

5 de marzo de 2021

Se ha agregado compatibilidad con la tasa de impresiones máxima absoluta y la tasa de impresiones superior como porcentaje del total de impresiones.

Se agregaron los métodos siguientes al objeto Stats .

Se han agregado AbsoluteTopImpressionRate y TopImpressionRate como posibles columnas que puede especificar con los siguientes selectores.

23 de febrero de 2021

Se ha agregado compatibilidad con anuncios de búsqueda con capacidad de respuesta.

  • Se agregó el objeto ResponsiveSearchAd , que define un anuncio de búsqueda con capacidad de respuesta.

  • Se ha agregado el objeto ResponsiveSearchAdBuilder , que se usa para agregar un anuncio de texto expandido al grupo de anuncios.

  • Se agregó el responsiveSearchAdBuilder método al objeto AdBuilderSpace . Si desea crear un anuncio de búsqueda con capacidad de respuesta, llamaría al responsiveSearchAdBuilder método para obtener el objeto ResponsiveSearchAdBuilder .

  • Se ha agregado el objeto AdTextAsset , que contiene propiedades para descripciones de anuncios de búsqueda con capacidad de respuesta y titulares.

  • Se agregó el responsiveSearchAd método al objeto AdTypeSpace , que contiene los métodos utilizados para probar si un anuncio es del tipo especificado. Por ejemplo, para probar si el anuncio es un anuncio de búsqueda con capacidad de respuesta.

  • Se agregó el responsiveSearchAd método al objeto AdViewSpace , que se usa para convertir un anuncio a un tipo específico. Por ejemplo, convierta el objeto de anuncio base en un anuncio de búsqueda con capacidad de respuesta.

21 de enero de 2021

Se ha agregado compatibilidad con audiencias dirigidas y excluidas.

Este cambio agregó los siguientes objetos:

10 de diciembre de 2020

Se ha agregado compatibilidad con ubicaciones dirigidas y excluidas.

Este cambio agregó los siguientes objetos:

Se agregó el objeto ExcludedLocationOperation , que se usa para determinar si scripts agregaron correctamente la ubicación excluida.

Se agregó el objeto TargetedLocationOperation , que se usa para determinar si scripts agregaron correctamente la ubicación de destino.

31 de marzo de 2020

Se agregaron los siguientes objetos que derivan de ProductGroup:

Se agregaron los métodos siguientes a ProductGroup:

  • asChannel()
  • asChannelExclusivity()

Se han quitado las llamadas a Logger.Log() de algunos ejemplos de script. Dado que el registro es una llamada costosa en términos de rendimiento, la guía consiste en usar el registro con moderación y probablemente no dentro de bucles de gran volumen, excepto para proporcionar notificación de problemas. Además, en lugar de usar varias Log() llamadas para escribir varias líneas, use una sola llamada e incluya caracteres de nueva línea ('\n').

Enero de 16 de 2020

Se ha agregado compatibilidad con grupos de productos. El soporte técnico se limita a enumerar grupos de productos y actualizar sus ofertas. Para obtener ejemplos, consulte ejemplos de script.

Este cambio agregó los siguientes objetos:

Se agregaron los siguientes objetos que derivan de ProductGroup:

Se han agregado los métodos siguientes a AdsApp:

Se agregaron los métodos siguientes a AdGroup:

Se agregó el siguiente método a Cammpaign:

Se agregó CampaignType como columna posible al método withCondition del objeto AdGroupSelector.

Se ha agregado Type como columna posible al método withCondition del objeto CampaignSelector.

18 de octubre de 2019

Se agregó la Id columna al withCondition() método de los objetos AdSelector y KeywordSelector . Puede usar esta columna para comprobar si hay anuncios o palabras clave con identificadores mayores que el identificador especificado (por ejemplo, withCondition('Id > 1234')).

Se ha agregado la solución de script Comprobar direcciones URL de anuncio y palabra clave , que puedes usar para comprobar si los anuncios o palabras clave de tus cuentas contienen direcciones URL rotas.

7 de octubre de 2019

Se ha agregado CombinedApprovalStatus como una posible columna que puede especificar al seleccionar palabras clave. Por ejemplo, puede usar la columna para seleccionar palabras clave que se han desaprobado por motivos editoriales. Vea KeywordSelector.withCondition.

13 de septiembre de 2019

Se agregó el objeto ExecutionInfo , que contiene información sobre el entorno en el que se está ejecutando actualmente el script. Por ejemplo, si el script se ejecuta en modo de vista previa o la cantidad de tiempo que el script puede continuar ejecutándose.

Se agregó el getExecutionInfo método al objeto AdsApp . Use este método para obtener el ExecutionInfo objeto .

Se agregó el getRemainingDailyQuota método al objeto UrlFetchApp . Use este método para obtener el número restante de fetch() llamadas que el usuario puede realizar hoy.

20 de agosto de 2019

A continuación se muestra un cambio de solo documentación.

  • Se aclaró que Scripts usa la zona horaria de la cuenta como en otro lugar de Microsoft Advertising. Por ejemplo, si usa el método .forDateRange() de un selector, Scripts usa la zona horaria de la cuenta para determinar los datos que se van a devolver. Más información
  • Se aclaró que la latencia de datos en scripts es la misma que en otros lugares de Microsoft Advertising. Más información

Los siguientes son cambios de API no importantes para admitir etiquetas.

  • Se agregaron los métodos siguientes al objeto AdsApp .
    • createLabel: crea una etiqueta
    • etiquetas: obtiene un selector que se usa para filtrar la lista de etiquetas de esta cuenta.
  • Se agregaron los siguientes objetos relacionados con la etiqueta.
    • Etiqueta : define una etiqueta.
    • LabelSelector : obtiene una lista de etiquetas para la cuenta.
    • LabelIterator : recorre en iteración una lista de etiquetas que coincidieron con los criterios de selección del selector.
  • Se agregaron los métodos siguientes al objeto Keyword .
    • applyLabel: aplica la etiqueta a la palabra clave
    • labels: obtiene un selector que se usa para filtrar la lista de etiquetas aplicadas a esta palabra clave.
    • removeLabel: quita la etiqueta de esta palabra clave.
  • Se agregó la columna LabelNames al método withCondition del objeto KeywordSelector.
  • Se agregaron los métodos siguientes a los objetos Ad y ExpandedTextAd .
    • applyLabel: aplica la etiqueta al anuncio.
    • etiquetas: obtiene un selector que se usa para filtrar la lista de etiquetas aplicadas a este anuncio.
    • removeLabel: quita la etiqueta de este anuncio
  • Se agregó la columna LabelNames al método withCondition del objeto AdSelector.
  • Se agregaron los métodos siguientes al objeto AdGroup .
    • applyLabel: aplica la etiqueta al grupo de anuncios.
    • etiquetas: obtiene un selector que se usa para filtrar la lista de etiquetas aplicadas a este grupo de anuncios.
    • removeLabel: quita la etiqueta de este grupo de anuncios.
  • Se agregó la columna LabelNames al método withCondition del objeto AdGroupSelector.
  • Se agregaron los métodos siguientes al objeto Campaign .
    • applyLabel: aplica la etiqueta a la campaña.
    • etiquetas: obtiene un selector que se usa para filtrar la lista de etiquetas aplicadas a esta campaña.
    • removeLabel: quita la etiqueta de esta campaña
  • Se agregó la columna LabelNames al método withCondition del objeto CampaignSelector.

30 de abril de 2019

A continuación se muestra un cambio de solo documentación.

  • 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. Todas las referencias a la plataforma de Bing Ads en la documentación se cambiaron a Microsoft Advertising.

Los siguientes son cambios de API no importantes para admitir la actualización de marca.

  • Se agregó el objeto AdsApp . Los scripts seguirán admitiendo el objeto BingAdsApp por compatibilidad con versiones anteriores; sin embargo, se recomienda actualizar los scripts para usar los nuevos objetos lo antes posible.

25 de marzo de 2019

A continuación se muestra un cambio de solo documentación.

11 de febrero de 2019

Se agregaron los métodos siguientes al objeto BingAdsAccountStats .

Nota:

Si usa los métodos getClickConversionRate() y getConvertedClicks(), debe actualizar los scripts para usar los métodos getConversionRate() y getConversions().

Se agregaron los métodos siguientes al objeto Stats .

Nota:

Si usa los métodos getClickConversionRate() y getConvertedClicks(), debe actualizar los scripts para usar los métodos getConversionRate() y getConversions().

27 de noviembre de 2018

A continuación se muestra un cambio de solo documentación.

7 de noviembre de 2018

A continuación se muestra un cambio de solo documentación.

  • Se ha cambiado la nota de vista previa para indicar que Scripts está ahora en versión beta abierta y disponible para todos los usuarios de Microsoft Advertising.

4 de octubre de 2018

Esta es la versión beta de Scripts. Para obtener información sobre cómo participar en el programa, póngase en contacto con su administrador de cuentas. Las clases y la documentación de Scripts están sujetas a cambios.

Se agregaron los siguientes objetos para admitir la captura de direcciones URL.

  • Se agregó el objeto UrlFetchApp , que es el objeto de nivel superior que se usa para capturar recursos de la web.

  • Se agregó HTTPResponse, que contiene los métodos para acceder al contenido del recurso capturado.

  • Se agregó el tema Límites urlFetch , que enumera los límites para capturar recursos de la web.

Agregue los temas siguientes:

2 de octubre de 2018

Se agregaron los siguientes objetos y métodos para admitir varias cuentas.

  • Se agregó el currentAccount método a BingAdsApp. Use este método para obtener el objeto Account , que contiene información sobre la cuenta que el script está procesando actualmente.

  • Se agregó el objeto AccountsApp . Este es el objeto de nivel superior que se usa si administra cuentas para otros usuarios. Úsela para obtener la lista de cuentas a las que tiene acceso y para seleccionar la cuenta que se va a administrar.

  • Se agregó el objeto BingAdsAccount . Úsela para obtener información de la cuenta de una cuenta administrada, como el nombre, el identificador de cliente y los datos de rendimiento de nivel de cuenta.

  • Se agregó el objeto BingAdsAccountIterator . Úsela para recorrer en iteración la lista de cuentas administradas que seleccionó.

  • Se agregó el objeto BingAdsAccountSelector . Úsela para seleccionar la lista de cuentas administradas que desea obtener.

  • Se agregó el objeto BingAdsAccountStats . Úsela para acceder a los datos de rendimiento de la cuenta administrada.

  • Se agregó el objeto ExecutionResult . Úselo para obtener los resultados y devolver el valor de la función que especifique en el executeInParallel método selector (consulte BingAdsAccountSelector).

Se agregaron los siguientes campos al objeto Budget para admitir presupuestos compartidos.

  • campañas: obtiene un selector que devuelve todas las campañas que comparten este presupuesto.
  • getEntityType: obtiene el tipo del objeto.
  • getId: obtiene el identificador que identifica de forma única el presupuesto compartido.
  • getName: obtiene el nombre del presupuesto compartido.
  • getStats: obtiene los datos de rendimiento de las campañas que comparten este presupuesto.
  • getType: obtiene el tipo del presupuesto (por ejemplo, DAILY).
  • isExplicitlyShared: obtiene un valor booleano que indica si este presupuesto es un presupuesto compartido.

Los getIdmétodos , getNamey getStats devuelven datos solo para presupuestos compartidos; los getId métodos y getName devuelven null para los presupuestos no compartidos (campañas individuales).

Se agregó el campo siguiente al objeto BingAdsApp .

  • budgets: obtiene todos los presupuestos compartidos de la cuenta. Use el selector para filtrar la lista de presupuestos compartidos.

Se agregaron los siguientes objetos que se usan para filtrar y recorrer en bucle una lista de presupuestos compartidos.

  • BudgetSelector : contiene los métodos para filtrar y ordenar la lista de presupuestos compartidos.

  • BudgetIterator : contiene los métodos para recorrer en bucle la lista de presupuestos compartidos. El método del get selector devuelve el iterador.

El selector solo devuelve presupuestos compartidos, no incluye presupuestos no compartidos (campañas individuales). Para determinar si una campaña usa un presupuesto individual, obtenga el presupuesto llamando al método de getBudget la campaña. A continuación, llame al método del isExplicitlyShared presupuesto para determinar si el presupuesto se comparte. El presupuesto se comparte si isExplicitlyShared devuelve true.

lunes, 1 de octubre de 2018

Se agregó el siguiente método al objeto Keyword .

  • getQualityScore : obtiene la puntuación de calidad de la palabra clave. La puntuación está en el intervalo de 1 a 10 (mayor). La puntuación muestra la competitividad de los anuncios en Marketplace mediante la medición de la relevancia de las palabras clave y las páginas de aterrizaje en los términos de búsqueda de los clientes.

12 de septiembre de 2018

Se agregaron los métodos siguientes para obtener las entidades primarias y secundarias de una entidad.

  • AdGroup.getCampaign : obtiene la campaña a la que pertenece el grupo de anuncios.
  • AdGroup.keywords : obtiene un selector que se usa para filtrar la lista de palabras clave del grupo de anuncios.
  • AdParam.getAdGroup : obtiene el grupo de anuncios al que pertenece la palabra clave asociada a este parámetro de sustitución.
  • AdParam.getKeyword : obtiene la palabra clave a la que se aplica el parámetro de sustitución.
  • Campaign.adGroups : obtiene un selector que se usa para filtrar la lista de grupos de anuncios de la campaña.
  • Campaign.keywords : obtiene un selector que se usa para filtrar la lista de palabras clave de la campaña.
  • Keyword.getCampaign : obtiene la campaña a la que pertenece la palabra clave.
  • Keyword.getAdGroup : obtiene el grupo de anuncios al que pertenece la palabra clave.
  • NegativeKeywordList.campaigns : obtiene un selector que se usa para filtrar la lista de campañas a las que está asociada la lista de palabras clave negativas.

9 de septiembre de 2018

Se ha agregado compatibilidad con anuncios.

  • Se agregó el newAd método a AdGroup. El método devuelve un objeto AdBuilderSpace , que se usa para obtener un generador de anuncios.

  • Se agregó el objeto AdBuilderSpace . El objeto contiene métodos para obtener generadores de anuncios. Por ejemplo, si desea crear un anuncio de texto expandido, llamaría al método del expandedTextAdBuilder objeto para obtener el objeto ExpandedTextAdBuilder .

  • Se ha agregado el objeto ExpandedTextAdBuilder , que se usa para agregar un anuncio de texto expandido al grupo de anuncios.

  • Se agregó el objeto AdOperation , que se usa para determinar si scripts agregaron correctamente el anuncio.

  • Se agregó el objeto AdViewSpace , que contiene los métodos utilizados para convertir un anuncio a un tipo específico. Por ejemplo, convierta el objeto de anuncio base en un anuncio de texto expandido.

  • Se agregó el objeto AdTypeSpace , que contiene los métodos utilizados para probar si un anuncio es del tipo especificado. Por ejemplo, para probar si el anuncio es un anuncio de texto expandido.

  • Se ha agregado el objeto Ad , que es el tipo de anuncio base. También define un anuncio de texto.

  • Se agregó el objeto AdUrls , que contiene los métodos para obtener las direcciones URL del anuncio, la plantilla de seguimiento y los parámetros personalizados.

  • Se agregó el objeto ExpandedTextAd , que define un anuncio de texto expandido.

  • Se ha agregado el objeto AdSelector , que se usa para especificar los criterios de filtro para seleccionar anuncios.

  • Se ha agregado el objeto AdIterator , que se usa para recorrer en iteración la lista filtrada de anuncios.

  • Se agregó el ads método a BingAdsApp. El método devuelve el objeto AdSelector , que se usa para especificar los criterios de filtro para seleccionar anuncios en la cuenta.

  • Se agregó el ads método a AdGroup. El método devuelve el objeto AdSelector , que se usa para especificar los criterios de filtro para seleccionar anuncios en el grupo de anuncios.

  • Se agregó el ads método a Campaign. El método devuelve el objeto AdSelector , que se usa para especificar los criterios de filtro para seleccionar anuncios en la campaña.

15 de junio de 2018

Versión beta cerrada. Esta versión de Scripts de Microsoft Advertising solo está disponible para seleccionar participantes. Para obtener información sobre cómo participar en el programa de versión preliminar, póngase en contacto con el administrador de cuentas. Las clases y la documentación de Scripts están sujetas a cambios.

Esta versión inicial incluye las siguientes funcionalidades:

  • Administración principal de campañas (campañas, grupos de anuncios, palabras clave)
  • Datos de rendimiento a nivel de entidad (campañas, grupos de anuncios, palabras clave)
  • Listas de palabras clave negativas compartidas
  • Last updated on