Versión 2.11

API de marketing

Lanzamiento: 7 de noviembre de 2017 | Entrada de blog

• Nuevas funciones
• Cambios radicales
• Elementos obsoletos
• Elementos que quedan obsoletos de inmediato

Nuevas funciones

Nuevo diseño de la API del administrador comercial

Ahora tenemos una nueva relación que representa a los clientes y las agencias. Anteriormente no teníamos user, ya que administrábamos todos los accesos y las invitaciones a los negocios y sus activos a través de bid/userpermissions, lo que causaba problemas de rendimiento. Esto es lo más destacado de la nueva API:

• Usuarios específicos del negocio: el nuevo usuario está vinculado a un negocio particular y tiene permisos específicos para este. Los usuarios pueden administrar el perfil, los permisos y el acceso a activos que estén asociados con el negocio.
• Invitaciones: invita a personas para acceder a un negocio a través de extremos nuevos. Verifica y actualiza el estado de las invitaciones a usuarios en estos extremos.
• Categorías de activos: divide diferentes tipos de activos en categorías y proporciona extremos separados para cada una de ellas. Esto facilita la paginación de resultados al leer los activos. Además, reduce los problemas de rendimiento cuando administras miles de activos para un negocio. En el nuevo diseño, agregamos varios extremos nuevos.

Para acceder a los usuarios en los negocios:

• 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 del negocio:

• BUSINESS_ID/owned_pages: para obtener una lista de las páginas que pertenecen al negocio.
• BUSINESS_ID/client_pages: para obtener 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 que están pendientes de aprobación.
• BUSINESS_ID/pending_client_pages: para obtener una lista de las páginas que pertenecen a los clientes del negocio que están pendientes de aprobación.

Para acceder a las cuentas publicitarias del negocio:

• BUSINESS_ID/owned_ad_accounts: para obtener una lista de las cuentas publicitarias que pertenecen al negocio.
• BUSINESS_ID/client_ad_accounts: para obtener 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 que están pendientes de aprobación.
• BUSINESS_ID/pending_client_ad_accounts: para obtener una lista de las cuentas publicitarias de los clientes del negocio que están pendientes de aprobación.

Para acceder a los catálogos de productos del 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 obtener una lista de los catálogos de productos que pertenecen a los clientes del negocio.

Para acceder a las aplicaciones del negocio:

• BUSINESS_ID/owned_apps: para obtener una lista de las aplicaciones que pertenecen al negocio.
• BUSINESS_ID/client_apps: para obtener 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 del negocio que están pendientes de aprobación.

Para obtener más información, consulta Administrador comercial: API, Administrador comercial: usuario de sistema, API de administración de activos del negocio y API del administrador comercial: prácticas recomendadas.

Anuncios por secuencia y ubicación en tiempo real

Ahora puedes crear un anuncio por secuencia con un archivo adjunto que muestre una ubicación en tiempo real. Se agregaron 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

Ahora puedes dirigirte a zonas geográficas más allá de un determinado radio alrededor de la ubicación de la tienda. Agregamos el parámetro geo_locations en el campo targeting_specs cuando creas un conjunto de anuncios con el objetivo de visitas en el negocio. Consulta con tu representante de Facebook para solicitar acceso, según las limitaciones de disponibilidad. Visita el objetivo de visitas en el negocio.

• POST AD_ACCOUNT_ID/adsets tiene la nueva opción.
• Admite todas las zonas geográficas en Especificaciones de segmentación: ubicaciones, excepto la segmentación por country_groups y el tipo de ubicación travel_in.
• Para crear anuncios con el objetivo STORE_VISITS disponible de manera limitada, consulta Visitas en el negocio.

Conjunto de anuncios y tipos de destino

Esto refleja el tipo de destino y agrega enlaces, es decir, el lugar al que las personas se dirigen cuando hacen clic en un anuncio o una llamada a la acción de un anuncio. Además, proporciona un tipo de destino uniforme para todos los anuncios en un conjunto, de manera que estos solo contengan diferentes tipos de contenido. Consulta Conjunto de anuncios: tipos de destino.

• Agregamos destination_type para los conjuntos de anuncios.
• Disponible en /ADSET_ID.

Indicador de rendimiento clave

Agregamos el nuevo campo kpi_type a AD_ACCOUNT_ID/CAMPAIGN_ID, que describe el tipo de indicador de rendimiento clave al que quieres hacer un seguimiento para la campaña o los objetos de anuncio en la campaña. Para consultar los datos de estadísticas por kpi_type en kpi_results, haz estas llamadas:

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

Para obtener más información, consulta Campaña publicitaria: referencia.

Cambios radicales

Administración de anuncios

• Invalida los anuncios que se dirijan aright_hand_column: los anuncios que se dirijan a esta posición con contenidos no válidos para right_hand_column en AD_ACCOUNT_ID/adsets devuelven un error. No permitimos la ubicación solo en right_hand_column con los formatos de anuncios con video, de colección o Canvas. Para la ubicación solo en right_hand_column, puedes usar los anuncios de una sola imagen y secuencia.

• CambiamosGET VERSION/RF_PREDICTION_ID/pause_periods: para devolver Array ahora, no String para permitir una mejor administración.

API del administrador comercial

• Cambiamos el nombre de algunos campos: el campo admin_system_user pasó a llamarse admin y el campo system_user ahora se llama employee. Esto afecta a los siguientes parámetros:

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

Elementos obsoletos

Administración de anuncios

Algunas optimizaciones quedaron obsoletas paraVIDEO_VIEWS: las campañas con el objetivo VIDEO_VIEWS ya no pueden usar CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT, POST_ENGAGEMENT ni REACH como objetivos de optimización:

• Al crear conjuntos de anuncios con estos objetivos de optimización, se devuelve un error.
• Al duplicar conjuntos de anuncios con el objetivo de optimización REACH, se convierte automáticamente al objetivo de optimización VIDEO_VIEWS.
• Al duplicar conjuntos de anuncios con CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT o POST_ENGAGEMENT como objetivo de optimización, se devuelve un error. Esto ocurre 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

reachquedó obsoleto: como un optimization_goal para el objetivo de reconocimiento de marca. Se eliminó para /adset y solo está disponible para la optimización de recuerdo del anuncio. Esto evita la confusión para cualquiera que use el alcance como un objetivo específico.

La optimización BRAND_AWARENESS quedó obsoleta: se reemplazó por AD_RECALL_LIFT. Esto refleja un modelo de entrega de anuncios nuevo y más eficaz. El nuevo objetivo de optimización admite la combinación de contenidos, por ejemplo, los anuncios estáticos y con video en el mismo conjunto de anuncios y la puja manual. BRAND_AWARENESS ya no está disponible en:

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

frequency_capquedó obsoleto: incluidos los campos lifetime_frequency_cap y frequency_cap_reset_period en:

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

En su lugar, usa frequency_control_specs.

POST_ENGAGEMENTdel costo por acción quedó obsoleto: ya no puedes usar POST_ENGAGEMENT como un billing_event para este objetivo. Esto hace que la entrega de anuncios y la medición concuerden mejor. /AD_SET_ID es el extremo afectado.

Estadísticas de anuncios y medición

video_15_sec_watched_actionsquedó obsoleto 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

recurrence_valuequedó obsoleto: en la API de medición avanzada. El campo también se conocía en la API de Atlas como programación de informe. Lo reemplazamos por recurrence_values. Ver Medición avanzada: programaciones de informes.

Administrador comercial

Extremos que quedaron obsoletos para el nuevo diseño de la API del administrador comercial:

• BUSINESS_ID/userpermissions
• BUSINESS_ID/business_persona
• business_persona_id

Extremos que quedaron obsoletos para administrar los activos:

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

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

Extremos que quedaron obsoletos para administrar activos que pertenezcan a otro negocio:

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

En su lugar, usa BUSINESS_USER_ID/assigned_ASSET.

Elementos que quedan obsoletos de inmediato

Estos elementos obsoletos afectan 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

La creación y edición de anuncios sobre eventos y anuncios con enlace que no estén conectados con una página valida quedaron obsoletas. El siguiente formato ya no es válido y devuelve un error.

Firmas que quedaron obsoletas:

• 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 sobre eventos y anuncios con enlaces existentes que creaste anteriormente seguirán funcionando, pero no puedes modificar su contenido ni crear anuncios nuevos una vez que este cambio entre en vigor o, de lo contrario, recibirás errores. Consulta Anuncios sobre eventos y anuncios locales y Anuncio: referencia.