Skip to main content
POST
Impulsa una publicación existente de Facebook para crear un anuncio. Este endpoint te permite convertir tus publicaciones orgánicas en anuncios pagos con parámetros personalizados de segmentación, presupuesto y programación.
  • Los montos de presupuesto y de puja deben especificarse en USD con hasta dos decimales.
  • El anuncio debe ejecutarse durante al menos 30 horas para cumplir con el requisito de Facebook.
  • Puedes usar el endpoint de intereses para encontrar los IDs de intereses para la segmentación.
  • Facebook puede tardar hasta 24 horas en revisar y aprobar las publicaciones impulsadas.
  • Si usas fbPostId directamente (en lugar del postId de Ayrshare), asegúrate de que sea un ID de publicación de Facebook válido.
  • Si un impulso falla después de que Facebook haya creado su campaña (en el paso del creativo, del conjunto de anuncios o del anuncio), intentamos eliminar esa campaña. Si la eliminación también falla, la campaña vacía permanece en tu cuenta publicitaria. Puedes encontrarla y eliminarla en el Administrador de anuncios (Ads Manager).

Objetivos del anuncio

Cada anuncio debe tener un objetivo. El objetivo determina cómo se optimizará el anuncio para su visualización.
  • engagement: Este objetivo busca aumentar la interacción, asegurando al mismo tiempo que el anuncio llegue al mayor número de usuarios únicos. Equilibra la visibilidad con la interacción, mostrando el anuncio a tantas personas diferentes como sea posible que puedan interactuar con él.
  • interactions: Diseñado para aumentar interacciones, como me gusta, comentarios y compartidos, en el anuncio. Facebook prioriza mostrar el anuncio a los usuarios con mayor probabilidad de interactuar con él.
  • awareness_views: Se enfoca en aumentar el reconocimiento de marca maximizando la cantidad de veces que se muestra el anuncio. Prioriza mostrar el anuncio tantas veces como sea posible dentro del presupuesto, independientemente del alcance único.
  • awareness_audience: Busca aumentar el reconocimiento de marca maximizando la cantidad de personas únicas que ven el anuncio. Garantiza que el anuncio llegue a la mayor cantidad de usuarios diferentes posibles y maximiza el tamaño de la audiencia única en lugar de mostrarlo varias veces a la misma audiencia.
  • traffic: Envía a las personas fuera de Facebook hacia un destino que tú eliges, como tu sitio web, una página de destino o una oferta de empleo. Facebook optimiza para clics en el enlace en lugar de la interacción dentro de la plataforma. Este es el único objetivo que admite un botón de callToAction.
Aprende más sobre cómo integrar la Facebook Marketing API con Ayrshare en nuestra Guía de integración con la Facebook Marketing API.

Parámetros del encabezado

Parámetros del cuerpo

string
requerido
El ID de la cuenta publicitaria de Facebook en la que se impulsará la publicación. El ID de la cuenta puede recuperarse desde el endpoint de cuentas publicitarias.
string
requerido
Nombre para tu anuncio (aparece en el Administrador de Anuncios de Facebook) con el formato {adName} - {postId o fbPostId} - {fecha actual}.
number
requerido
Monto máximo de puja en USD. El monto mínimo de puja es $1.00.
number
requerido
Presupuesto diario en USD. El presupuesto mínimo es $1.00.
string
requerido
El ID de publicación social de Facebook de la publicación a impulsar, que te permite crear un anuncio a partir de una publicación creada directamente en Facebook. Este es el ID de la publicación en Facebook, no de Ayrshare. Requerido si postId no está establecido.
string
predeterminado:"engagement"
requerido
El objetivo del anuncio. Valores: engagement, interactions, awareness_views, awareness_audience y traffic. Consulta los detalles de los objetivos del anuncio arriba para más información.
object
Ubicaciones objetivo del anuncio con un objeto de arreglos: countries, regions, cities. Un objeto que no indica ningún país, región ni ciudad, como {}, se rechaza con el código 101; omite locations para dirigir el anuncio a EE. UU.
string
requerido
El ID de publicación de Ayrshare de la publicación a impulsar. Requerido si fbPostId no está establecido.
string
predeterminado:"active"
requerido
El estado del anuncio. Valores: active y paused.Más adelante puedes cambiar el estado del anuncio usando el endpoint de actualización de anuncio.
boolean
predeterminado:false
Controla la compartición de presupuesto entre conjuntos de anuncios a nivel de campaña de Meta. Meta ahora requiere este campo en cada campaña creada sin un presupuesto a nivel de campaña, por lo que Ayrshare siempre lo envía — con valor predeterminado false por compatibilidad hacia atrás.Establécelo en true para permitir que Meta comparta hasta aproximadamente el 20% del presupuesto de un conjunto de anuncios entre otros conjuntos de anuncios de la misma campaña para optimizar el rendimiento general. Consulta la referencia del ad campaign group de Meta para más detalles.
object
Agrega un botón de llamada a la acción, como Apply Now o Shop Now, a la publicación impulsada. El botón abre la URL que proporciones.
callToAction solo se admite con el objetivo del anuncio traffic. Enviarlo con engagement, interactions, awareness_views o awareness_audience devuelve un 400 con code: 101 que nombra los objetivos compatibles. Anteriormente el valor se aceptaba con cualquier objetivo y luego se ignoraba silenciosamente, produciendo un anuncio sin botón.
callToAction.link proporciona la URL de destino. Cuando Meta muestra la llamada a la acción como un botón en la publicación existente, las urlTags se añaden al enlace de ese botón. Se permite goal: "traffic" sin un callToAction, y crea un anuncio de tráfico sin botón.El callToAction que envías se devuelve en la respuesta del impulso con type en mayúsculas — consulta el ejemplo Post Boosted with a Call to Action — y después también se devuelve en el anuncio mediante Anuncios impulsados.
object
Realiza el seguimiento del anuncio usando un Facebook Pixel.
array
Agrega etiquetas UTM a la URL del anuncio.
Por ejemplo, si la URL de enlace es https://www.mysite.com/my-post y las etiquetas de URL agregadas son:utm_source=ayrshare, utm_medium=social y utm_campaign=ayrshare-social.La URL del anuncio será: https://www.mysite.com/my-post?utm_source=ayrshare&utm_medium=social&utm_campaign=ayrshare-social.
array
Meta requiere que los anunciantes en categorías especiales de anuncios se auto-identifiquen con la categoría de su campaña.Si tu negocio está en una de estas categorías, debes seleccionar la categoría apropiada al impulsar tu publicación.Se admiten los siguientes valores:
  • housing: Anuncios que promuevan o enlacen directamente con una oportunidad de vivienda o servicio relacionado, incluyendo, entre otros, listados para la venta o alquiler de una casa o apartamento, seguros para propietarios de vivienda, seguros hipotecarios, préstamos hipotecarios, reparaciones de vivienda y servicios de valoración o crédito con garantía hipotecaria.
  • financial_product_services: Anuncios que promuevan o enlacen directamente con una oferta de productos y servicios financieros, incluido el crédito. financial_products_services se acepta como grafía equivalente, y credit se acepta como el nombre que Meta daba antes a esta categoría — los tres llegan a Meta como la misma categoría, así que envía el que ya tengas.
  • employment: Anuncios que promuevan o enlacen directamente con una oportunidad de empleo, incluidos, entre otros, trabajos a tiempo parcial o completo, pasantías o programas de certificación profesional. Los anuncios relacionados que entran en esta categoría incluyen promociones de bolsas de empleo o ferias, servicios de agregación o anuncios que detallen los beneficios que una empresa puede ofrecer, independientemente de una oferta de trabajo específica.
  • none: El valor predeterminado. Declara que la campaña no está en ninguna categoría especial de anuncios. Enviarlo explícitamente equivale a omitir specialAdCategories por completo, y se acepta para que un cliente que siempre envía el campo pueda indicar “sin categoría” sin tratarlo como caso especial.
  • issues_elections_politics: Anuncios realizados por, en nombre de, o sobre un candidato a un cargo público, una figura política, un partido político o que aboguen por el resultado de una elección a un cargo público. Esto también incluye anuncios sobre cualquier elección, referéndum o iniciativa electoral, incluidas las campañas electorales de “Sal a votar”. Anuncios regulados como publicidad política o sobre temas sociales en cualquier lugar donde se publique el anuncio. Si seleccionas temas, elecciones o política, debes seleccionar el país en el que deseas publicar estos anuncios. Se te exige estar autorizado para publicar anuncios sobre temas sociales, elecciones o política en el país especificado.
Los valores no distinguen mayúsculas de minúsculas. Un valor no reconocido se rechaza con un 400 y code: 101 que enumera los valores aceptados. Anteriormente, un valor no reconocido se descartaba silenciosamente y la campaña se creaba sin categoría, por lo que un error tipográfico dejaba un anuncio regulado en circulación sin ninguna categoría declarada.La lista de valores aceptados en ese mensaje de error está escrita en la forma en mayúsculas de Meta y también nombra las grafías alternativas anteriores, por lo que se lee NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT. Son las mismas cinco categorías listadas aquí — FINANCIAL_PRODUCT_SERVICES y CREDIT son los equivalentes de financial_product_services, no categorías adicionales. El endpoint de intereses devuelve el mismo mensaje.Repetir una categoría, o enviar dos grafías de la misma, como ["credit", "financial_product_services"], se acepta y se consolida en una sola categoría antes de llegar a Meta. Un valor vacío se rechaza con un 400 y code: 101.Para encontrar los IDs de intereses que Meta permite para una de estas categorías, pasa el mismo valor al endpoint de intereses.Meta también necesita los países en los que se publica un anuncio de categoría especial. Ayrshare los toma de locations: los países que indiques, más el país de cada región y ciudad. Así, un impulso housing que segmenta una ciudad del Reino Unido se configura para el Reino Unido, sin nada adicional en tu solicitud. Sin locations, el anuncio se publica en EE. UU. y la campaña se configura para EE. UU.Meta también establece un radio mínimo alrededor de cada ciudad para estas categorías. Una ciudad del Reino Unido con un radio de 17 kilómetros fue rechazada con #2909039, que exige al menos 25 kilómetros (15 millas), así que usa 25 kilómetros o más.
Meta exige que los anunciantes hayan auto-identificado la categoría de su campaña. Meta utiliza revisores humanos y aprendizaje automático para identificar este tipo de anuncios. Si nos envías un specialAdCategory incorrecto, existe el riesgo de que tus anuncios se pausen hasta que se ajuste la campaña.
string
Fecha y hora de finalización en formato ISO 8601 (debe ser al menos 30 horas después del inicio), por ejemplo 2025-03-01T00:00:00Z.Si no se establece, el anuncio se ejecutará indefinidamente y tendrá fecha de finalización ongoing.
object
Excluye ubicaciones usando un objeto con arreglos de countries, regions y cities.
string
predeterminado:"all"
El género de la audiencia. Valores: all, male, female.
array
Los intereses objetivo del anuncio como un arreglo de IDs de intereses de Facebook.
number
predeterminado:65
Edad máxima para la segmentación del anuncio (predeterminado: 65).
number
predeterminado:18
Edad mínima para la segmentación del anuncio (predeterminado: 18).
string
Fecha y hora de inicio en formato ISO 8601, por ejemplo 2025-03-01T00:00:00Z.Si no se establece, el anuncio comenzará inmediatamente.
string
El beneficiario del anuncio para el cumplimiento de la Ley de Servicios Digitales (DSA) para países de la UE. Debe establecerse junto con dsaPayor si se proporciona alguno de los dos. Por favor, consulta nuestra guía sobre DSA para más información.
string
El pagador del anuncio para el cumplimiento de la Ley de Servicios Digitales (DSA) para países de la UE. Debe establecerse junto con dsaBeneficiary si se proporciona alguno de los dos.

Presupuestos de campaña

Para que el presupuesto esté en la campaña en lugar del conjunto de anuncios, envía budget.level: "campaign" en la forma anidada. El conjunto de anuncios queda entonces sin presupuesto propio. Funciona con presupuestos diarios y totales.
  • budget.level: adSet (el valor predeterminado) o campaign. Un presupuesto de campaña no se puede combinar con adSetBudgetSharingEnabled. Enviar ambos se rechaza con un 400 y code: 101.
  • La respuesta añade budgetLevel: "campaign" para un presupuesto de campaña. Un presupuesto de conjunto de anuncios no devuelve budgetLevel, así que trata la ausencia del campo como adSet.
  • En Historial, budgetDaily muestra el presupuesto diario de la campaña para un anuncio con presupuesto diario de campaña. Si varios anuncios comparten un mismo presupuesto de campaña, cada uno muestra el presupuesto completo de la campaña, no su parte. Historial no muestra los presupuestos totales, ni de la campaña ni del conjunto de anuncios. Una vez agotado un presupuesto total de campaña, cada anuncio de esa campaña muestra deliveryStatus: "COMPLETED" tras la siguiente actualización nocturna, incluido un anuncio programado o en revisión. Un anuncio rechazado se mantiene en REJECTED.

Impulsar en una campaña o un conjunto de anuncios existente

De forma predeterminada, cada impulso crea su propia campaña, su propio conjunto de anuncios y su propio anuncio. Para añadir el impulso a una campaña o a un conjunto de anuncios que ya gestionas en Meta, envía la forma anidada con attachTo.
  • attachTo.campaignId: el impulso crea un nuevo conjunto de anuncios y un anuncio dentro de esa campaña. Envía budget, targeting y bidAmount como de costumbre: se aplican al nuevo conjunto de anuncios.
  • attachTo.adSetId: el impulso crea solo el anuncio, dentro de ese conjunto de anuncios. Envía también attachTo.campaignId, la campaña a la que pertenece el conjunto de anuncios. Omite budget, targeting y platformOptions.facebook.bidAmount: el conjunto de anuncios conserva los suyos. Enviar cualquiera de ellos devuelve un 400 con code: 101.
  • La campaña o el conjunto de anuncios debe estar en la cuenta publicitaria indicada en accountId y no debe pertenecer a los impulsos de otro usuario. De lo contrario, la solicitud devuelve un 400. Además, un impulso de Facebook no puede adjuntarse a una campaña creada por un impulso de Instagram, ni a la inversa.
  • attachTo no se puede combinar con budget.level: "campaign", specialAdCategories ni adSetBudgetSharingEnabled, que se establecen en una campaña nueva. Enviarlos devuelve code: 101.
  • Pausar o activar el impulso cambia solo lo que el impulso creó: el anuncio, y el conjunto de anuncios cuando lo creó el impulso. La campaña o el conjunto de anuncios que indicaste en attachTo conserva su propio estado. El anuncio solo se publica mientras la campaña y el conjunto de anuncios que lo contienen estén activos. Esto también se aplica cuando Ayrshare pausa tus anuncios, por ejemplo, cuando se elimina un perfil.
  • Si el impulso falla, la campaña o el conjunto de anuncios indicado en attachTo nunca se elimina.
  • Si el conjunto de anuncios al que te adjuntas está en una campaña que tiene el presupuesto (un presupuesto de campaña), Historial informa del impulso como de cualquier anuncio con presupuesto de campaña: budgetDaily muestra el presupuesto completo de la campaña, no la parte del impulso, y una vez agotado un presupuesto total de campaña, cada anuncio que Ayrshare registra en esa campaña muestra deliveryStatus: "COMPLETED" tras la siguiente actualización nocturna, incluido un anuncio programado o en revisión. Un anuncio rechazado se mantiene en REJECTED.