Versión 3.0

API de marketing

Lanzamiento: 1 de mayo de 2018 | Disponible hasta: 1 de febrero de 2019 | Publicación en el blog

• Nuevas funciones
• Cambios importantes
• Retiradas
• Retiradas inmediatas

Nuevas funciones

Estrategia de puja de menor coste, campo bid_strategy

Hemos añadido el nuevo campo bid_strategy para {account-id}/adsets, que te permite elegir una estrategia de puja publicitaria según tus objetivos empresariales. Cada estrategia tiene ventajas y desventajas. Las opciones son las siguientes:

• LOWEST_COST: obtén el mayor número de resultados según tu presupuesto de los conjuntos de anuncios y tu optimization_goal para la entrega. Facebook aumentará automáticamente la puja según sea necesario para gastar tu presupuesto. Con esta opción, puedes proporcionar un importe máximo para la puja o no proporcionar ningún límite.

• TARGET_COST: proporciona costes medios estables para tus anuncios a medida que aumentas tu presupuesto de los conjuntos de anuncios.

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

Anuncios de colección: creación

Nueva API para crear anuncios de colección: anteriormente, cada vez que creabas un anuncio de colección, Facebook creaba un lienzo en segundo plano. De este modo, se limitaba el acceso al lienzo subyacente, ya que no podías usarlo para volver a dirigirte a audiencias mediante las audiencias de interacción del lienzo. Ahora, al crear un anuncio de colección a partir de conjuntos de productos, también debes crear explícitamente un lienzo con los elementos correctos. Al usar este lienzo en un anuncio de colección, Facebook genera el anuncio de colección automáticamente. Para ver más detalles, consulta Anuncios de colección a partir de conjuntos de productos.

Cambios de última hora

Administración de anuncios

• Invalidación de la columna de la derecha: invalidamos los anuncios que solo se dirigen 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 derecha para los formatos de anuncio compatibles con los objetivos siguientes: Tráfico, conversiones y ventas del catálogo de productos.

• Los elementos is_autobid y is_average_price_pacing se han retirado en las solicitudes GET y POST de la versión 3.0 y posteriores.

Audiencias y segmentación de anuncios

• Se ha cambiado la sintaxis de las reglas para las audiencias personalizadas: hemos actualizado la estructura de las reglas que se usan para crear audiencias personalizadas de sitios web, de aplicaciones para móviles, de interacción con páginas, de anuncios para clientes potenciales, de interacción con el lienzo y fuera de internet. De este modo, puedes crear reglas según el comportamiento agregado y de diferentes orígenes de eventos, así como excluir reglas. Consulta:

  • Audiencias personalizadas de tu sitio web, Reglas de audiencias

  • Audiencias personalizadas de tu aplicación para móviles, Reglas de audiencias

  • Audiencias personalizadas de interacción con la página

  • Audiencias de interacción en anuncios para clientes potenciales

  • Audiencias de interacción para el lienzo

  • Audiencias personalizadas a partir de conversiones fuera de internet

Anuncios dinámicos

• Acceso al catálogo de productos: para acceder a los artículos del catálogo debes especificar el sector del catálogo correcto. Si tu solicitud no coincide con el sector correcto de tu catálogo, recibirás un error. Por ejemplo, si tienes un catálogo de comercio electrónico, debes acceder a él 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 permitimos las cadenas vacías como parámetros para las opciones de etiquetas de plantilla en los anuncios dinámicos. Por ejemplo, si pasas una cadena vacía a {{trip.checkin_date date_format:}}, recibirás un error. Para obtener información general, consulta Anuncios dinámicos: administración de anuncios.

Medición y estadísticas de anuncios

• Tiempos de espera agotados de las estadísticas: si esperamos que una solicitud a la API de estadísticas agote el tiempo de espera antes de la finalización, devolvemos un error con el código de error 100 y el subcódigo 1504033. Realizamos esta estimación en función del tamaño de la solicitud y el progreso del procesamiento relacionado con los límites del tiempo de espera. Si recibes este error, debes realizar una solicitud asíncrona a la API de estadísticas para estos datos. Consulta Trabajos asíncronos de la API de estadísticas.

• Valores negativos en datos de eventos: si publicas datos de eventos en {data_set_id}/events con un valor negativo, se produce un error. Esto afecta al campo data para POST /{data_set_id-id}/events.

• Estadísticas de la optimización del presupuesto de la campaña: adset_budget_value ahora devuelve using campaign budget cuando tu campaña publicitaria usa la optimización del presupuesto de la campaña. Esto afecta a 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.

• Ordenación predeterminada del píxel: si llamas al perímetro GET {account_id}/adspixel en una cuenta empresarial o publicitaria, devolvemos los resultados ordenados de forma predeterminada por nombre del píxel, en lugar de la hora de la última activación del píxel.

• Cambio de nombre del campo de estadísticas del píxel: hemos cambiado el nombre del campo timestamp del perímetro de estadísticas del píxel a start_time. Representa la hora de inicio del momento en que comenzamos a agregar los datos por hora sobre las activaciones del píxel. Ahora lo devolvemos en formato ISO 8601 e incluimos el desplazamiento por zona horaria. De este modo, se corrige un problema por el que devolvíamos marcas de tiempo de Unix no válidas. Se verán afectados los siguientes extremos: GET {ads-pixel-id}/stats.

Retiradas

Business Manager

Se ha retirado el extremo POST {pixel-id}/shared_agencies. Usa la IU de Business Manager para compartir el píxel de anuncios con las agencias.

Administración de anuncios

• Se han retirado kpi_custom_conversion_id, kpi_type y kpi_results de /{ad_campaign_id} y /ad_account_ID/campaigns.

• Se ha retirado la marca "redownload" de los extremos siguientes para simplificar la API:

  • POST {ad-id}/,

  • POST {adset-id}/,

  • POST act_{ad-account-id},

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

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

  Todavía puedes leer esta información con el parámetro "fields".

• Se ha retirado el campo zipbytes de POST act_{ad-account-id}/adimages y se ha eliminado la posibilidad de subir archivos ZIP a dicho perímetro. Usa una imagen con las extensiones siguientes: jpg, jpeg, gif, bmp, png, tiff o tif.

• Se ha retirado el método actual para crear los anuncios de colección que usaban una llamada a la API con todos los activos necesarios como parámetros. En su lugar, ahora primero debes crear un lienzo y luego usar su enlace para crear un anuncio de colección. Esto te permite acceder al objeto del lienzo subyacente para, por ejemplo, poder volver a segmentar las audiencias. Consulta Anuncios de colección.

• Se ha retirado el uso del formato de anuncio por secuencia para los anuncios con el objetivo de interacción con una publicación de la página. Esta combinación ya no es válida. Consulta Validación, objetivos y contenidos.

Compra y pujas de anuncios

• Se han retirado los campos is_autobid y is_average_price_pacing de los extremos POST {ad-account-id}/adsets y POST {adset-id}. En su lugar, utiliza el nuevo campo bid_strategy para especificar una estrategia de puja determinada para el conjuntos de anuncios. Para obtener más información, consulta Pujas y optimización.

• Se han retirado los campos en delivery_estimate para los anuncios y las cuentas publicitarias. Los resultados no cumplían las necesidades de los anunciantes. Además, muchos anunciantes tienen objetivos empresariales que es posible que el importe de puja sugerido por Facebook no cumpla de forma óptima. Entre los campos y parámetros obsoletos se incluyen los siguientes:

  • Campo bid_estimate

  • Parámetro currency

  • Parámetro daily_budget

  • Parámetro optimize_for

  Te recomendamos que uses el valor empresarial real e intrínseco que obtienes de los anuncios de Facebook y realices pujas en función del mismo. Si todavía no lo conoces, te recomendamos que uses la puja automática. Para obtener información general, consulta Servicio de ayuda de anuncios: Subastas de anuncios y Compra y optimización de anuncios.

• Se ha retirado el resultado devuelto del campo curve_budget_reach en GET /{rf-prediction-id}. Ahora devolvemos el mapa y hemos retirado el valor de retorno como cadena serializada JSON. Esto afecta a GET /{rf-prediction-id}.

• Se ha retirado el perímetro GET /{ad-account-id}/ratecard.

• Se han retirado varios campos relacionados con la facturación en /ad_accounts. Esto incluye lo siguiente:

  • next_bill_date

  • active_billing_date_preference

  • pending_billing_date_preference

  • active_asl_schedule

  • salesforce_invoice_group_id

  • transactions

  • adspaymentcycle

  • show_checkout_experience

• Se ha retirado la solicitud GET /customaudience de los campos pixel_id y external_event_source.

Medición y estadísticas de anuncios

• Se ha retirado el elemento matched_unique_users de OFFLINE_EVENT_SET_ID devuelto por GET /{data-set-id} y GET /{data-set-upload-id}. Consulta la documentación API de conversiones sin conexión.

• Se han retirado el perímetro attributed_events y el campo attribute_stats de GET /{data_set_id} API. Utiliza la API GET /{data_set_id}/stats para obtener estadísticas del evento atribuido.

• Se ha retirado el campo matched_unique_users de OFFLINE_EVENT_SET_ID devuelto por las solicitudes GET /{data-set-id} y GET /{data-set-upload-id}.

• Se han retirado los valores de devolución predeterminados de GET {data_set_upload_id}. Ya no devuelve los siguientes campos 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.

• Se han retirado los valores de devolución predeterminados de GET {data_set_id}/stats. Ahora solo devuelve las estadísticas del recuento de forma predeterminada. Para especificar las estadísticas que deben devolverse, usa el parámetro fields o summary para estadísticas acumulativas como average_upload_delay.

• Se han retirado los valores de devolución predeterminados para GET {data_set_id}. Ya no devuelve los siguientes campos de forma predeterminada: attribute_stats, duplicate_entries, event_stats, event_time_max, event_time_min, matched_entries, matched_unique_users, usage, valid_entries.

• Se ha retirado el perímetro GET {data-set-upload-id}/stats. Utiliza los campos valid_entries o matched_entries de GET {data-set-upload-id} en su lugar.

• Se ha retirado canvas_component_avg_pct_view de la API de estadísticas.