Versión 3.0

API de marketing

Lanzamiento: 1 de mayo de 2018 | Disponible hasta: 1 de febrero de 2019 | Entrada de blog

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

Nuevas funciones

Estrategia de puja de menor costo, campo bid_strategy

Presentamos el nuevo campo bid_strategy para {account-id}/adsets, que te permite seleccionar una estrategia de puja de anuncios en función de tus objetivos comerciales. Todas las estrategias tienen ventajas y desventajas. Las opciones incluyen:

• LOWEST_COST: obtén la mayor cantidad de resultados posible en función del presupuesto del conjunto de anuncios y el optimization_goal de entrega. Facebook pujará más de forma automática según lo que se necesite para gastar tu presupuesto. Con esta opción, puedes especificar un valor máximo para la puja o no.

• TARGET_COST: ofrece costos promedio estables para tus anuncios a medida que aumentas el presupuesto del conjunto de anuncios.

Para obtener más información, consulta Compra y optimización de anuncios, Estrategia de puja

Anuncios de colección, Creación

Nueva API para crear anuncios de colección: antes, Facebook creaba un Canvas en segundo plano cada vez que creabas un anuncio de colección. Eso limitaba el acceso al Canvas subyacente: no podías usarlo para hacer retargeting de determinados públicos con los públicos de interacción de Canvas. Ahora, si creas un anuncio de colección a partir de conjuntos de productos, debes crear un Canvas con los elementos correctos de forma explícita. Cuando usas ese Canvas en un anuncio de colección, Facebook genera automáticamente el anuncio de colección. Para obtener más información, consulta Anuncios de colección a partir de conjuntos de productos.

Cambios radicales

Administración de anuncios

• Invalidación de la columna de la derecha: invalidamos los anuncios dirigidos exclusivamente a la posición right_hand_column de Facebook con objetivos no válidos para right_hand_column en {ad_account_id}/adsets. Ahora, solo admitimos la ubicación en la columna derecha para los formatos de anuncio compatibles con los siguientes objetivos: tráfico, conversiones y ventas del catálogo de productos.

• is_autobid y is_average_price_pacing quedan obsoletos tanto en GET como en POST a partir de la versión 3.0.

Públicos y segmentación de anuncios

• Cambio de la sintaxis de reglas para los públicos personalizados: actualizamos la estructura de las reglas utilizadas para crear públicos personalizados del sitio web, públicos personalizados de la app para celulares, públicos personalizados de interacción con las páginas, públicos de interacción para anuncios para clientes potenciales, públicos de interacción para Canvas y públicos personalizados offline. Esto te permite crear reglas basadas en comportamientos agregados, crear reglas a partir de distintos orígenes de eventos y excluir reglas. Consulta:

  • Públicos personalizados a partir de tu sitio web, Reglas del público,

  • Públicos personalizados a partir de la app para celulares, Reglas del público,

  • Públicos personalizados de interacción con las páginas,

  • Públicos de interacción para anuncios para clientes potenciales,

  • Públicos de interacción para Canvas y

  • Públicos personalizados a partir de conversiones offline.

Anuncios dinámicos

• Acceso al catálogo de productos: para acceder a los artículos del catálogo, debes especificar el sector correcto del catálogo. Si la solicitud no coincide con el sector del catálogo, se produce un error. Por ejemplo, si tienes un catálogo de comercio electrónico, debes acceder con el extremo /products correspondiente, como GET {catalog_id}/products, GET {product_feed_id}/products o GET {product_set_id}/products. No puedes acceder al catálogo con extremos de otros sectores, como GET {catalog_id}/autos, GET {product_feed_id}/hotels o GET {product_set_id}/flights.

• Cadena vacía en etiquetas de plantilla: ya no admitimos las cadenas vacías como parámetros para las opciones de etiqueta de plantilla de los anuncios dinámicos. Por ejemplo, si envías una cadena vacía a {{trip.checkin_date date_format:}}, se produce un error. Para obtener información general, consulta Anuncios dinámicos, Administración de anuncios.

Estadísticas de anuncios y medición

• Tiempos de espera de estadísticas: si consideramos que una solicitud a la API de estadísticas superará el tiempo de espera antes de completarse, devolveremos un error con el código 100 y el subcódigo 1504033. Hacemos la estimación sobre la base del tamaño de la solicitud y de cuánto avanzó el procesamiento respecto de los límites de los tiempos de espera. Si se produce ese error, debes hacer una solicitud asincrónica a la API de estadísticas para acceder a los datos. Consulta Trabajos asincrónicos de la API de estadísticas.

• Valores negativos en datos de eventos: si envías datos de eventos a {data_set_id}/events con un valor negativo, se produce un error. Esto afecta el campo data de POST /{data_set_id-id}/events.

• Estadísticas sobre la optimización del presupuesto de la campaña: adset_budget_value ahora devuelve using campaign budget si tu campaña publicitaria usa la optimización del presupuesto de la campaña. Esto afecta lo siguiente:

  • GET {adaccount-id}/insights,

  • GET {campaign-id}/insights,

  • GET {adset-id}/insights,

  • GET {ad-id}/insights,

  • POST {adaccount-id}/insights,

  • POST {campaign-id}/insights,

  • POST {adset-id}/insights,

  • POST {ad-id}/insights.

• Orden predeterminado para el píxel: si haces una llamada al perímetro GET {account_id}/adspixel en una cuenta de empresa o una cuenta publicitaria, los resultados se devuelven ordenados de forma predeterminada según el nombre del píxel y no según la última activación del píxel.

• Cambio de nombre de campo de estadísticas del píxel: cambiamos el nombre del campo timestamp en el perímetro de estadísticas del píxel por start_time. Representa el momento en que comenzamos a agregar los datos por hora sobre activaciones del píxel. Ahora, lo devolvemos en formato ISO 8601 e incluimos el desplazamiento de zona horaria. De esa manera, se resuelve el problema por el cual devolvíamos marcas de tiempo de Unix no válidas. Se verá afectado el extremo GET {ads-pixel-id}/stats.

Elementos obsoletos

Administrador comercial

El extremo POST {pixel-id}/shared_agencies quedó obsoleto. Usa la interfaz de usuario del administrador comercial para compartir el píxel de anuncios con las agencias.

Administración de anuncios

• kpi_custom_conversion_id, kpi_type y kpi_results quedaron obsoletos en /{ad_campaign_id} y /ad_account_ID/campaigns.

• A fin de simplificar la API, la marca "redownload" quedó obsoleta en los siguientes extremos:

  • POST {ad-id}/,

  • POST {adset-id}/,

  • POST act_{ad-account-id},

  • POST act_{ad-account-id}/ads,

  • POST act_{ad-account-id}/adsets

  La información puede leerse con el parámetro "fields".

• Se dejó de utilizar el campo zipbytes en POST act_{ad-account-id}/adimages, y se eliminó la posibilidad de subir archivos ZIP a ese perímetro. Usa imágenes con las extensiones jpg, jpeg, gif, bmp, png, tiff o tif.

• El método vigente para crear anuncios de colección, que utilizaba una llamada a la API con todos los activos necesarios como parámetros, quedó obsoleto. Ahora, debes crear un Canvas y usar el enlace del Canvas para crear el anuncio de colección. Eso te permite acceder al objeto Canvas subyacente para, por ejemplo, hacer retargeting de un público. Consulta Anuncios de colección.

• Ya no es posible usar el formato de anuncio por secuencia en anuncios con el objetivo de interacción con una publicación de la página. Esa combinación ya no es válida. Consulta Validación, Objetivos y contenidos.

Compra y pujas de anuncios

• El campo is_autobid y el campo is_average_price_pacing quedaron obsoletos en los extremos POST {ad-account-id}/adsets y POST {adset-id}. Ahora, debes usar el nuevo campo bid_strategy para especificar una estrategia de puja específica para el conjunto de anuncios. Para obtener más información, consulta Pujas y optimización.

• Algunos campos de delivery_estimate para anuncios y cuentas publicitarias quedaron obsoletos. Los resultados no satisfacían las necesidades de los anunciantes. Además, es posible que el importe de puja recomendado por Facebook no sea adecuado para los objetivos comerciales de muchos anunciantes. Los campos y parámetros que dejaron de utilizarse incluyen:

  • el campo bid_estimate,

  • el parámetro currency,

  • el parámetro daily_budget y

  • el parámetro optimize_for.

  Te recomendamos que utilices el valor comercial real e intrínseco que obtienes de los anuncios de Facebook como base para decidir la puja. Si todavía no conoces ese valor, es recomendable que uses las pujas automáticas. A fin de obtener información general, consulta Servicio de ayuda para anunciantes, Subastas de anuncios y Compra y optimización de anuncios.

• El resultado devuelto por el campo curve_budget_reach en GET /{rf-prediction-id} quedó obsoleto. Ahora se devuelve el mapa. Dejamos de utilizar el valor devuelto con formato de cadena JSON serializada. Esto afecta lo siguiente: GET /{rf-prediction-id}.

• Se dejó de utilizar el perímetro GET /{ad-account-id}/ratecard.

• Dejaron de utilizarse varios campos relacionados con la facturación en /ad_accounts. Esto incluye:

  • next_bill_date

  • active_billing_date_preference

  • pending_billing_date_preference

  • active_asl_schedule

  • salesforce_invoice_group_id

  • transactions

  • adspaymentcycle

  • show_checkout_experience

• Dejaron de utilizarse los campos pixel_id y external_event_source en GET /customaudience.

Estadísticas de anuncios y medición

• Se dejó de utilizar matched_unique_users en OFFLINE_EVENT_SET_ID devuelto por GET /{data-set-id} y GET /{data-set-upload-id}. Consulta API de conversiones offline.

• Se dejó de utilizar el perímetro attributed_events y el campo attribute_stats en GET /{data_set_id} API. Usa la API GET /{data_set_id}/stats para obtener estadísticas de eventos atribuidas.

• Se dejó de utilizar el campo matched_unique_users en OFFLINE_EVENT_SET_ID devuelto por GET /{data-set-id} y la llamada "GET" /{data-set-upload-id}.

• Los valores devueltos de forma predeterminada en GET {data_set_upload_id} quedaron obsoletos. Los siguientes campos ya no se devuelven de forma predeterminada: first_upload_time, last_upload_time, api_calls, valid_entries, matched_entries, duplicate_entries, event_time_min, event_time_max, event_stats y matched_unique_users.

• Los valores devueltos de forma predeterminada en GET {data_set_id}/stats quedaron obsoletos. Ahora, solo se devuelven las estadísticas de recuento de forma predeterminada. Para especificar qué estadísticas deben devolverse, usa el parámetro fields (o el parámetro summary en el caso de estadísticas acumuladas, como average_upload_delay).

• Los valores devueltos de forma predeterminada en GET {data_set_id} quedaron obsoletos. Los siguientes campos ya no se devuelven de forma predeterminada: attribute_stats, duplicate_entries, event_stats, event_time_max, event_time_min, matched_entries, matched_unique_users, usage y valid_entries.

• Se dejó de utilizar el perímetro GET {data-set-upload-id}/stats. Usa los campos valid_entries o matched_entries de GET {data-set-upload-id}.

• Se dejó de utilizar canvas_component_avg_pct_view de la API de estadísticas.