Versión 2.11

API de marketing

Publicación: 7 de noviembre de 2017 | Publicación en el blog

• Nuevas funciones
• Cambios importantes
• Retiradas
• Retiradas inmediatas

Nuevas funciones

Nuevo diseño de la API de Business Manager

Ahora tenemos una nueva relación que representa a clientes y agencias. Antes no contábamos con el nodo user, por lo que gestionábamos todos los accesos y las invitaciones a un negocio y sus activos mediante el perímetro bid/userpermissions, lo que provocaba problemas de rendimiento. Entre los aspectos más destacados de la nueva API, encontramos:

• Usuarios específicos del negocio: el nuevo usuario se vincula a un negocio determinado y tiene permisos específicos de este. Los usuarios pueden administrar su perfil, sus permisos y el acceso a activos asociado a dicho negocio.
• Invitaciones: invita a personas para que accedan a un negocio a través de nuevos extremos. Comprueba y actualiza el estado de las invitaciones de usuario en estos extremos.
• Categorías de activos: divide los distintos tipos de activos en categorías y facilita extremos independientes para cada una de ellas, lo que facilitará la paginación de resultados cuando leas activos y reducirá los problemas de rendimiento cuando administres miles de activos para un negocio. Hemos añadido varios extremos en este nuevo diseño.

Para acceder a los usuarios de un negocio:

• BUSINESS_ID/business_users
• BUSINESS_ID/system_users
• BUSINESS_ID/pending_users

Para acceder a los activos asignados a los usuarios:

• BUSINESS_USER_ID/assigned_pages
• BUSINESS_USER_ID/assigned_ad_accounts
• BUSINESS_USER_ID/assigned_product_catalogs
• SYSTEM_USER_ID/assigned_pages
• SYSTEM_USER_ID/assigned_ad_accounts
• SYSTEM_USER_ID/assigned_product_catalogs
• PENDING_USER_ID/assigned_pages
• PENDING_USER_ID/assigned_ad_accounts
• PENDING_USER_ID/assigned_product_catalogs

Para acceder a las páginas de un negocio:

• BUSINESS_ID/owned_pages: para obtener una lista de las páginas que pertenecen al negocio.
• BUSINESS_ID/client_pages: para conseguir una lista de las páginas de los clientes del negocio.
• BUSINESS_ID/pending_owned_pages: para obtener una lista de las páginas que pertenecen al negocio y que todavía están pendientes de aprobación.
• BUSINESS_ID/pending_client_pages: para conseguir una lista de las páginas que pertenecen a los clientes de un negocio y que están pendientes de aprobación.

Para acceder a las cuentas publicitarias de un negocio:

• BUSINESS_ID/owned_ad_accounts: para obtener una lista de las cuentas publicitarias que pertenecen al negocio.
• BUSINESS_ID/client_ad_accounts: para conseguir una lista de las cuentas publicitarias de los clientes del negocio.
• BUSINESS_ID/pending_owned_ad_accounts: para obtener una lista de las cuentas publicitarias que pertenecen al negocio y que todavía están pendientes de aprobación.
• BUSINESS_ID/pending_client_ad_accounts: para conseguir una lista de las cuentas publicitarias de los clientes del negocio y que todavía están pendientes de aprobación.

Para acceder a los catálogos de productos de un negocio:

• BUSINESS_ID/owned_product_catalogs: para obtener una lista de los catálogos de productos que pertenecen al negocio.
• BUSINESS_ID/client_product_catalogs: para conseguir una lista de los catálogos de productos que pertenecen a los clientes del negocio.

Para acceder a las aplicaciones de un negocio:

• BUSINESS_ID/owned_apps: para obtener una lista de las aplicaciones que pertenecen al negocio.
• BUSINESS_ID/client_apps: para conseguir una lista de las aplicaciones de los clientes del negocio.
• BUSINESS_ID/pending_client_apps: para obtener una lista de las aplicaciones que pertenecen a los clientes de un negocio y que están pendientes de aprobación.

Para obtener más información, consulta Business Manager > API, Business Manager > Usuario del sistema, API de administración de activos del negocio y API de Business Manager > Prácticas recomendadas.

Anuncios por secuencia y ubicación en tiempo real

Ahora puedes crear un anuncio por secuencia con un elemento adjunto que muestre una ubicación en tiempo real. Se han añadido las opciones type=REALTIME y location_source_id = PAGE_ID en place_data para AD_CREATIVE_ID/object_story_spec. Esto está disponible en el campo object_story_spec en:

• POST /AD_ACCOUNT_ID/adcreatives
• GET CREATIVE_ID

Visitas en el negocio y dirigirse a ubicaciones geográficas específicas

Aparte del radio que hayas determinado en torno a la ubicación de un establecimiento, ahora puedes dirigirte a zonas geográficas específicas. Hemos añadido el parámetro geo_locations en el campo targeting_specs cuando creas un conjunto de anuncios con el objetivo de visitas en el negocio. Esta opción tiene disponibilidad limitada, ponte en contacto con tu representante de Facebook para obtener acceso. Consulta Objetivo de visitas en el negocio.

• El perímetro POST AD_ACCOUNT_ID/adsets incluye la nueva opción.
• Se admiten todas las zonas geográficas incluidas en Especificaciones de segmentación > Lugares, excepto en las segmentaciones por country_groups y el tipo de lugar travel_in.
• La opción de crear anuncios con el objetivo STORE_VISITS está disponible de forma limitada. Consulta Visitas en el negocio.

Conjunto de anuncios y tipos de destino

Este elemento se usa para indicar el tipo de destino al que enlaza un anuncio, es decir, el lugar al que se dirige a una persona cuando hace clic en un anuncio o en la llamada a la acción de un anuncio. Con este elemento se facilita un tipo de destino coherente para todos los anuncios de un conjunto, de forma que estos solo contienen distintos tipos de contenido publicitario. Consulta Conjunto de anuncios > Tipo de destino.

• Se ha añadido el elemento destination_type para conjuntos de anuncios.
• Disponible en /ADSET_ID.

Indicador clave de rendimiento

Se ha añadido el nuevo campo kpi_type a AD_ACCOUNT_ID/CAMPAIGN_ID, con el que se describe el tipo de indicador clave de rendimiento del que te interesa realizar un seguimiento para la campaña o los objetos de anuncio de esta. Para consultar los datos de estadísticas en función del campo kpi_type en kpi_results, realiza estas llamadas:

• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights

Para obtener más información, consulta Referencia > Campaña publicitaria.

Cambios importantes

Administración de anuncios

• Invalidación de los anuncios dirigidos a la posiciónright_hand_column: los anuncios que se dirijan a esta posición con contenidos no válidos para right_hand_column en el perímetro AD_ACCOUNT_ID/adsets devuelven un error. No se permite utilizar right_hand_column como ubicación única para los anuncios con vídeo, de colección o de Canvas. Solo puedes usar right_hand_column como ubicación única con los formatos de anuncio con imagen única y por secuencia.

• Se ha cambiado el métodoGET VERSION/RF_PREDICTION_ID/pause_periods: en lugar de un valor de tipo String, ahora devuelve uno del tipo Array, para facilitar la gestión.

API de Business Manager

• Se ha cambiado el nombre de algunos campos: los campos admin_system_user y system_user ahora se llaman admin y employee, respectivamente. Esto afecta a los siguientes perímetros:

  • /{business-id}/userpermissions
  • /{business-id}/system_users

Retiradas

Administración de anuncios

Se han retirado optimizaciones para el objetivoVIDEO_VIEWS: en las campañas con el objetivo VIDEO_VIEWS ya no se pueden usar CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT, POST_ENGAGEMENT o REACH como objetivos de optimización:

• Si se crean conjuntos de anuncios con estos objetivos de optimización, se devuelve un error.
• Si se duplican conjuntos de anuncios con el objetivo de optimización REACH, se cambia automáticamente al objetivo de optimización VIDEO_VIEWS.
• Si se duplican conjuntos de anuncios con CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT o POST_ENGAGEMENT como objetivo de optimización, se devuelve un error. Esto sucede porque al crear o duplicar un anuncio en un conjunto de anuncios existente, se intenta reutilizar cualquiera de estos objetivos de optimización.

Este cambio afecta a los siguientes perímetros:

• POST ACCOUNT_ID/adsets
• POST AD_ACCOUNT_ID/ads
• POST CAMPAIGN_ID/copies
• POST ADSET_ID/copies
• POST AD_ID/copies

Se ha retirado el elementoreach como valor del campo optimization_goal para el objetivo de reconocimiento de marca. Se ha eliminado para el perímetro /adset; está disponible únicamente para la optimización del recuerdo del anuncio. Así se evita la confusión en caso de utilizar el alcance como objetivo dedicado.

Se ha retirado la optimizaciónBRAND_AWARENESS: se ha sustituido por AD_RECALL_LIFT. Esta medida refleja un nuevo modelo de entrega de anuncios más eficaz. El nuevo objetivo de optimización admite la combinación de contenidos, como la inclusión de anuncios estáticos y con vídeo en el mismo conjunto de anuncios y las pujas manuales. El objetivo BRAND_AWARENESS ya no está disponible en:

• POST /ADSET_ID
• GET /ADSET_ID
• POST /AD_ACCOUNT_ID/adsets

Se ha retiradofrequency_cap, incluidos los campos lifetime_frequency_cap y frequency_cap_reset_period en:

• POST AD_ACCOUNT_ID/adsets
• GET /ADSET_ID
• POST /ADSET_ID

Utiliza frequency_control_specs en su lugar.

Se ha retirado el coste por acciónPOST_ENGAGEMENT: ya no puedes usar POST_ENGAGEMENT como valor del campo billing_event para este objetivo. Con esta medida, se consiguen reducir las diferencias entre la medición y la entrega de anuncios. Esto afecta al extremo /AD_SET_ID.

Medición y estadísticas de anuncios

Se ha retirado el elementovideo_15_sec_watched_actions en:

• GET AD_ACCOUNT_ID/insights
• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights
• POST AD_ACCOUNT_ID/insights
• POST CAMPAIGN_ID/insights
• POST ADSET_ID/insights
• POST AD_ID/insights

Se ha retirado el camporecurrence_value de la API de medición avanzada, también conocido como “programación del informe” en la API de Atlas. Lo hemos sustituido por el campo recurrence_values. Consulta Medición avanzada > Programaciones de informes.

Administración de negocios

Se han retirado los siguientes extremos para el nuevo diseño de la API de Business Manager:

• BUSINESS_ID/userpermissions
• BUSINESS_ID/business_persona
• business_persona_id

Se han retirado los siguientes extremos para la administración de tus activos:

• BUSINESS_ID/pages
• BUSINESS_ID/adaccounts
• BUSINESS_ID/product_catalogs
• BUSINESS_ID/apps

Para acceder a los activos, utiliza los extremos BUSINESS_ID/owned_ASSET o BUSINESS_ID/client_ASSET.

Se han retirado los siguientes extremos para la administración de activos que pertenezcan a otros negocios:

• BUSINESS_ID/assigned_ad_accounts
• BUSINESS_ID/assigned_pages
• BUSINESS_ID/assigned_product_catalogs

En su lugar, utiliza el extremo BUSINESS_USER_ID/assigned_ASSET.

Retiradas inmediatas

Estas retiradas afectarán a todas las versiones de la API y entrarán en vigor el 14 de noviembre de 2017.

Anuncios sobre eventos y anuncios con enlace

Se ha retirado la creación y edición de anuncios sobre eventos o anuncios con enlace que no estén conectados a una página válida. El siguiente formato ya no es válido y devuelve un error.

Se van a retirar las siguientes firmas:

• Anuncios sobre eventos

  • Objetivo: EVENT_RESPONSES.
  • Campos de contenido: body, object_id.
• Anuncios con enlace

  • Objetivo: LINK_CLICKS.
  • Campos de contenido: title, body, object_url (image_file o image_hash).

Firmas admitidas

• Anuncios sobre eventos

  • Objetivo: EVENT_RESPONSES.
  • Campos de contenido: object_story_id o object_story_spec.
• Anuncios con enlace

  • Objetivo: LINK_CLICKS.
  • Campos de contenido: object_story_id o object_story_spec.

Los anuncios con enlace y sobre eventos que hayas creado previamente seguirán funcionando, pero no podrás modificar su contenido o crear nuevos anuncios una vez que este cambio entre en vigor, ya que obtendrás errores. Consulta Anuncios locales y sobre eventos y Referencia > Anuncio.