Versión 2.9

Nuevas funciones de la versión 2.9 de la API de marketing

Contenido del anuncio

Crea campañas de Canvas en Facebook con la API de marketing. Gracias a la imagen, el sonido y el movimiento, el formato de vídeo hace que los anunciantes obtengan mejores resultados en cuanto a los objetivos de respuesta directa y de marca. Para obtener más información, consulta API de marketing > Anuncios de Canvas.

Anuncios dinámicos

• Calidad del catálogo de anuncios dinámicos: hemos añadido nuevas API para ayudarte a poner en circulación anuncios dinámicos con éxito: la API de comprobaciones y la de calidad. La API de comprobaciones permite verificar que el origen de las señales proporcione suficiente información para entregar los anuncios correctos si se usan anuncios dinámicos. La API de calidad permite verificar que la cantidad y la calidad de la información del catálogo y de la lista sean suficientes para entregar anuncios dinámicos. Para obtener más información, consulta Anuncios dinámicos > Calidad del catálogo y las señales.

• Varias imágenes para un mismo elemento: muestra varias imágenes para un mismo elemento en anuncios dinámicos con el formato por secuencia. Ahora pueden utilizarse hasta 20 imágenes de un catálogo para representar un mismo elemento en anuncios dinámicos con el formato por secuencia. Así puedes mostrar un único elemento, como un hotel o un destino, con varias imágenes. Puedes aprovechar esta función con dos opciones: force_single_link = true y show_multiple_images = true. Para obtener más información, consulta Anuncios dinámicos > Administración de anuncios > Plantilla de contenido.

Administración de anuncios

• Texto del anuncio: ahora puedes duplicar tus campañas, conjuntos de anuncios y anuncios existentes con la API de texto del anuncio. De este modo, no tendrás que volver a crear los anuncios de cero cada vez. En lugar de esto, puedes duplicar los que ya funcionan y crear recipientes de plantillas de anuncio. Para obtener más información, consulta Contenido, ubicación y vista previa.

• Alcance diario estimado: hay un nuevo extremo /delivery_estimate en los niveles del conjunto de anuncios y de la cuenta publicitaria. Este extremo permite obtener estimaciones de pujas y una predicción de resultados a partir de las conversiones y el alcance diarios de un conjunto de anuncios determinado. Para obtener más información, consulta Segmentación > Alcance diario estimado.

• API de motor de reglas: usa esta API para administrar fácilmente tus anuncios con mayor eficiencia y tomar decisiones más inteligentes en función de las reglas empresariales que tú definas. El motor de reglas sigue un modelo basado en notificaciones de inserción. Por ello, en lugar de tener que consultar la API continuamente para obtener información actualizada sobre los anuncios, te enviaremos notificaciones de inserción de forma proactiva y realizaremos las acciones que especifiques, siempre que se cumplan los criterios establecidos mediante las reglas. Para obtener más información sobre la API de motor de reglas, haz clic aquí.

• API de lotes: agrupa las solicitudes y envíalas de forma asíncrona. Agrupa varias llamadas a la API Graph en una única solicitud HTTP y ejecútalas de forma asíncrona sin necesidad de bloquear. También puedes especificar dependencias entre operaciones relacionadas. Facebook procesa las operaciones independientes de forma paralela y, las operaciones dependientes, de forma secuencial. Para obtener más información, consulta Solicitudes asíncronas y por lotes > API de lotes.

Ubicación de los anuncios

• Ubicación eficaz de los anuncios: aunque puedes definir las ubicaciones en las especificaciones de segmentación, no siempre sabrás si Facebook entrega realmente el anuncio en todas ellas. Anteriormente, si seleccionabas ubicaciones no válidas para un objetivo determinado, Facebook no realizaba la entrega en dichas ubicaciones y era necesario poner en circulación anuncios y experimentar con ellos para determinar los resultados reales. Con las API de ubicaciones del tipo effective_, puedes determinar las ubicaciones de anuncios reales que Facebook ofrece para el objetivo publicitario y la ubicación que tú especifiques. Asimismo, con la API de recomendaciones puedes averiguar por qué no se incluyen algunas ubicaciones. Para obtener más información, consulta Opciones avanzadas de segmentación > Ubicación eficaz.

Cambios importantes en la versión 2.9 de la API de marketing

Administración de anuncios

• Ubicación de vídeo sugerido: se seleccionaba automáticamente si usabas la ubicación de la sección de noticias de Facebook, ya que formaba parte de esta. A partir de la versión 2.9, se diferencia entre las ubicaciones de vídeo sugerido y de la sección de noticias para que puedas descartar la primera aunque decidas usar la segunda. En la versión 2.8 y anteriores, si usabas la ubicación de la sección de noticias de Facebook, dejaremos de entregar los anuncios automáticamente en la ubicación de vídeo sugerido cuando selecciones la de la sección de noticias.

• Objetivo de difusión local: se ha retirado el objetivo de campaña LOCAL_AWARENESS. A partir de la versión 2.9, no se aceptará LOCAL_AWARENESS como objetivo al crear nuevas campañas. Si deseas fomentar la difusión local con conjuntos de anuncios de ubicación única, usa campañas con el objetivo REACH. Ya no se admite LOCAL_AWARENESS con varias ubicaciones. Si tienes campañas en curso con este objetivo, podrás seguir consultándolas y editándolas, e incluso crear nuevos anuncios y conjuntos de anuncios para ellas. Si optas por copiar campañas en curso, el tipo de campaña determinará si puedes hacerlo o no. En el caso de campañas de ubicación única y con el objetivo LOCAL_AWARENESS, las copiamos con el parámetro REACH especificado. Si usas LOCAL_AWARENESS con varias ubicaciones, no podrás copiar la campaña.

• Objetivos de anuncios para móviles: para simplificar los objetivos de los anuncios para móviles, estamos retirando CanvasAppEngagement, CanvasAppInstalls, MobileAppInstalls y MobileAppEngagement, denominados CAE, MAE, CAI y MAI, respectivamente. A partir de la versión 2.9 no se pueden crear nuevas campañas con estos cuatro objetivos. En su lugar, pueden usarse las opciones siguientes:

  • Conjuntos de anuncios CAE con campañas LINK_CLICKS: usa LINK_CLICKS para crear campañas con anuncios de interacción con aplicaciones de página principal.

  • Conjuntos de anuncios MAE con objetivos de campaña LINK_CLICKS o CONVERSIONS: cambia a LINK_CLICKS o CONVERSIONS para crear campañas con anuncios de interacción con aplicaciones para móviles.

  • Conjuntos de anuncios CAI con APP_INSTALLS: usa APP_INSTALLS para crear campañas con anuncios sobre la descarga de aplicaciones para página principal.

  • MAI con APP_INSTALLS: usa APP_INSTALLS para crear campañas con anuncios sobre la descarga de aplicaciones para móviles.

• Compatibilidad de los objetivos de anuncios para móviles: si duplicas campañas CAE, MAE, CAI y MAI con las herramientas de Facebook o la API de marketing, estos objetivos retirados se convierten automáticamente en sus correspondientes equivalentes de la versión 2.9:

  • Campañas MAI o CAI: se convierten en campañas con el objetivo APP_INSTALLS.

  • Campañas CAE: se convierten en campañas con el objetivo LINK_CLICKS.

  • Campañas MAE: se convierten en campañas con los objetivos LINK_LICKS o CONVERSIONS, en función de las optimizaciones que especifiques para los conjuntos de anuncios de la campaña. Si hay conjuntos de anuncios secundarios optimizados con OFFSITE_CONVERSION, las campañas MAE se convierten en campañas CONVERSIONS. Si no los hay, las campañas MAE se convierten en campañas LINK_CLICKS.

• Categorías bloqueadas: se están retirando algunas categorías de Audience Network, vídeo in-stream y artículos instantáneos en favor de otras más unificadas en estas ubicaciones. Estas categorías ayudan a impedir la aparición de anuncios cuyo contenido pueda resultar inapropiado, como los relacionados con el juego o el alcohol. Se han retirado las categorías politics y religion. Se encuentran disponibles las categorías siguientes:

  • Para artículos instantáneos y Audience Network: debated_social_issues, mature_audiences, tragedy_and_conflict, dating y gambling.

  • Para vídeos in-stream: debated_social_issues, mature_audiences y tragedy_and_conflict.

• Se ha retirado SUPPLEMENTAL_MEDIA_ID del contenido de los anuncios en los niveles de anuncio y cuenta publicitaria. Este campo ya no se puede leer.

• Se ha retirado ACTION_SPEC del contenido de los anuncios. Anteriormente se utilizaba con historias patrocinadas que ya no se admiten.

• Se han retirado los campos actor_image_hash, actor_image_url y actor_name del contenido de los anuncios en las versiones 2.9 y 2.8. Anteriormente se utilizaban con action_spec, que también se ha retirado.

• Se han retirado link_title y link_description de call_to_action en el contenido de los anuncios. Para definir títulos y descripciones en el contenido, usa name y description en link_data, o title y link_description en video_data.

• run_status=3: anteriormente hacía referencia a un campo y un valor que permitían eliminar contenido, lo que resultaba confuso. Para solucionar esto, se ha cambiado el nombre de run_status a status y el valor entero por el valor de cadena DELETED. Para eliminar contenido del anuncio, usa status=DELETED.

• Se ha retirado COVER_PHOTO_ID de GET en los extremos “creative” {creative_id} y {ad_account_id}/adcreatives. Se utilizaba con poca frecuencia y su uso era interno y limitado.

• image_url o image_hash: ahora solo se puede proporcionar uno de estos valores en video_data para el objeto object_story_spec del contenido del anuncio. Para obtener más información, consulta Referencia > Contenido.

• Se ha retirado OBJECT_INSTAGRAM_ID de GET para los extremos “creative”, incluidos {creative_id} y AD_ACCOUNT_ID/adcreatives. Este campo no estaba diseñado para uso externo.

• En la versión 2.8 y anteriores, instagram_story_id se usaba para recuperar identificadores de publicaciones de Instagram del contenido de los anuncios. Si anteriormente usabas este campo al proporcionar el contenido del anuncio, se lanzaba una excepción, pero se ignoraba este parámetro y se devolvían resultados con instagram_story_id. Si usabas esta respuesta, se generaba un error. Para resolver este problema, se ha cambiado el nombre de instagram_story_id a effective_instagram_story_id y este campo ya no se usa para proporcionar el contenido del anuncio.

• Ahora, los tipos de retorno spent, today_spent y yesterday_spent para todos los objetos de anuncio son String, no Integer. Este cambio afecta a las campañas, los conjuntos de anuncios y los anuncios.

Anuncios dinámicos

• No se admiten conjuntos de productos idénticos: ya no se pueden usar conjuntos de productos idénticos a otros conjuntos del mismo catálogo. Si intentas crear un conjunto de productos idéntico a otro de un mismo catálogo, nuestra API devolverá una excepción FacebookApiException con el código 10803 que incluirá el identificador del conjunto de productos idéntico.

• Se ha retirado quoted_fields en POST /{product_feed_id}. En la versión 2.6 se eliminó quoted_fields en POST /{product_feed_id/product_feeds}. Ahora se retira también en este parámetro para completar la limpieza correspondiente.

• El extremo POST {catalog-id}/batch ahora devuelve STRING debido a las mejoras que se están realizando en los catálogos de productos de anuncios dinámicos.

• Error en las actualizaciones de público: si usas anuncios dinámicos e intentas actualizar un público para estos anuncios, la solicitud genera un error. Para realizar cambios, debes eliminar el público asociado con los anuncios dinámicos y crear uno nuevo. Para obtener más información, consulta Anuncios dinámicos > Públicos y Públicos personalizados.

• template_url_spec sustituye a template_url. De este modo, puedes realizar un seguimiento de clics e insertar en los anuncios URL específicas del contexto, sin necesidad de limitarte a las URL del catálogo de productos. Por ejemplo, puedes incluir en un anuncio las fechas de entrada y salida que una persona ha seleccionado. Para obtener más información, consulta Anuncios dinámicos > Administración de anuncios.

Señales y segmentación

• Cambio de nombre de los orígenes de eventos: si anteriormente creabas o consultabas conversiones personalizadas, usabas los campos etiquetados como pixel_id, pixel_rule y pixel_aggregation_rule. Como estamos añadiendo la compatibilidad con los datos de las conversiones fuera de internet y de las conversiones personalizadas de las aplicaciones, estamos modificando las etiquetas de estos campos para expresar esta ampliación de ámbito. Ahora se denomina a estos campos event_source_id, rule y aggregation_rule.

• Píxel de conversión: este píxel se retiró el 15 de febrero de 2017. En consecuencia, se han retirado todos los perímetros y los nodos para crear, actualizar y leer el píxel de conversión, así como para hacer referencia a él, en todas las versiones de la API.

• El parámetro friends_of_connection asociado con los identificadores de evento se ha retirado como opción de segmentación de anuncios. Esto significa que no se pueden segmentar los amigos de las personas que han aceptado la invitación a un evento de Facebook.

• Compatibilidad con delivery_estimate: se han realizado cambios en el alcance estimado para que el extremo delivery_estimate que se ha lanzado recientemente resulte compatible:

  • Se ha eliminado el campo bid_estimations del extremo /reach_estimates y se han transferido todas las funciones documentadas a /delivery_estimate.

  • /AD_ID/reachestimate se ha retirado. Para acceder a esta información usa /ADSET_ID/delivery_estimate.

  • Se ha eliminado el campo data.

Estadísticas

• Retiradas de date_preset: se están retirando varios valores de date_preset y sustituyendo por otros nuevos. Estos nuevos valores se han diseñado para simplificar su uso y en consonancia con las expectativas de los anunciantes. Asimismo, dejarán de incluir datos del día en curso. Por ejemplo, una solicitud realizada el 8 de febrero, con el intervalo de fechas predefinido de los últimos siete días, generará un informe que abarcará desde el 1 de febrero hasta las 23:59 del 7 de febrero, ambos días incluidos. El 8 de febrero quedará excluido. Se han retirado los valores siguientes:

  • last_3_days se ha sustituido por last_3d.

  • last_7_days se ha sustituido por last_7d.

  • last_14_days se ha sustituido por last_14d.

  • last_28_days se ha sustituido por last_28d.

  • last_30_days se ha sustituido por last_30d.

  • last_90_days se ha sustituido por last_90d.

  • last_week se ha sustituido por last_week_sun_sat y last_week_mon_sun.

  • this_week se ha sustituido por this_week_sun_today y this_week_mon_today.

  • Se ha retirado last_3_months.

  • En la versión 2.8 y anteriores, se pueden utilizar tanto estos valores nuevos como los valores antiguos predefinidos de fechas.

• Selección predeterminada de date_preset: si anteriormente se realizaba una consulta de estadísticas sin date_preset, se utilizaba de forma predeterminada last_30_days, que incluía la actividad del día en curso, desde las 0:00, de acuerdo con la zona horaria de la cuenta publicitaria. A partir de la versión 2.9, se utiliza last_30d de forma predeterminada. Este parámetro incluye los 30 días anteriores completos, hasta las 23:59 de la última noche, de acuerdo con la zona horaria de la cuenta. No incluye el día en curso.

• Se ha retirado video_complete_watched_actions, que proporcionaba la misma información que video_30_sec_watched_actions.

• Se han retirado unique_impression y unique_social_impressions. Utiliza reach y social_reach en su lugar.

• Se han retirado los resultados obsoletosnewsfeed_clicks, newsfeed_impressions, newsfeed_avg_position, video_avg_sec_watched_actions y video_avg_pct_watched_actions.

• follow, gift_sale, video_play y vote se han retirado del campo action_type:.

• Ahora se puede acceder a click_to_play_video mediante el desglose action_video_type.

• Se ha retirado de la API de estadísticas el campo de desglose placement para los datos de entrega. Solo se admite ["publisher_platform", "platform_position"] en la versión 2.9. En la versión 2.8 se pueden seguir utilizando ["placement"] o ["publisher_platform", "platform_position"] como desgloses.

• attribution_spec: anteriormente se utilizaban dos campos independientes para los intervalos de atribución de visualización y de clics en la API de estadísticas. Ahora se debe utilizar attribution_spec para definir ambos intervalos. Si se define attribution_spec, se sobrescribirá la configuración existente. Si se había definido previamente la atribución de visualización y de clics, cuando se defina attribution_spec como event_type = CLICK_THROUGH solo se eliminará la atribución de visualización.