Saltar al contenido principal
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.

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.
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

accountId
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.
adName
string
requerido
Nombre para tu anuncio (aparece en el Administrador de Anuncios de Facebook) con el formato {adName} - {postId o fbPostId} - {fecha actual}.
bidAmount
number
requerido
Monto máximo de puja en USD. El monto mínimo de puja es $1.00.
budget
number
requerido
Presupuesto diario en USD. El presupuesto mínimo es $1.00.
fbPostId
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.
goal
string
predeterminado:"engagement"
requerido
El objetivo del anuncio. Valores: engagement, interactions, awareness_views y awareness_audience. Consulta los detalles de los objetivos del anuncio arriba para más información.
locations
object
requerido
Ubicaciones objetivo del anuncio con un objeto de arreglos: countries, regions, cities.
postId
string
requerido
El ID de publicación de Ayrshare de la publicación a impulsar. Requerido si fbPostId no está establecido.
status
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.
adSetBudgetSharingEnabled
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.
tracking
object
Realiza el seguimiento del anuncio usando un Facebook Pixel.
urlTags
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.
specialAdCategories
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.
  • 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.
  • 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.
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.
endDate
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.
excludedLocations
object
Excluye ubicaciones usando un objeto con arreglos de countries, regions y cities.
gender
string
predeterminado:"all"
El género de la audiencia. Valores: all, male, female.
interests
array
Los intereses objetivo del anuncio como un arreglo de IDs de intereses de Facebook.
maxAge
number
predeterminado:65
Edad máxima para la segmentación del anuncio (predeterminado: 65).
minAge
number
predeterminado:18
Edad mínima para la segmentación del anuncio (predeterminado: 18).
startDate
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.
dsaBeneficiary
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.
dsaPayor
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.