Skip to main content
POST
Impulsa una publicación existente de Instagram 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 Instagram.
  • Puedes usar el endpoint de intereses para encontrar los IDs de intereses para la segmentación.
  • Instagram puede tardar hasta 24 horas en revisar y aprobar las publicaciones impulsadas.
  • Si usas socialPostId directamente (en lugar del postId de Ayrshare), asegúrate de que sea un ID de publicación de Instagram 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. Instagram 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.
Los anuncios de Instagram requieren una cuenta de Instagram Business conectada a través de Facebook, una página de Facebook asociada y el permiso ads_management. Vuelve a vincular a través de Facebook para otorgar este permiso. Las cuentas conectadas con Instagram Login no pueden usar estos endpoints de anuncios. El ID del medio y el ID de la cuenta de Instagram se resuelven a partir de tu cuenta vinculada; no envíes instagram_user_id.
El selector socialPostId también acepta el alias específico de Instagram igPostId. fbPostId solo aplica a Facebook. Las respuestas exitosas incluyen platform: "instagram", socialPostId e igPostId.

Parámetros del encabezado

Parámetros del cuerpo

string
Una clave única y no vacía para esta solicitud de impulso. Reintenta el mismo payload con la misma clave para evitar crear un anuncio duplicado. Reutilizar la clave con un payload o plataforma diferente devuelve HTTP 409. Una solicitud aún en curso también devuelve 409; una reserva no disponible devuelve 503 sin crear un anuncio.
boolean
predeterminado:false
Permite a Meta compartir el presupuesto entre los conjuntos de anuncios de la campaña.
string
requerido
El ID de la cuenta publicitaria de Instagram 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 Instagram) con el formato {adName} - {postId o socialPostId} - {fecha actual}.
number
requerido
Monto máximo de puja en USD, como un monto positivo con hasta dos decimales.
number
requerido
Presupuesto diario en USD. Usa un monto positivo con hasta dos decimales. Meta puede aplicar mínimos adicionales según tu cuenta y tu objetivo.
string
El ID de publicación social de Instagram de la publicación a impulsar, que te permite crear un anuncio a partir de una publicación creada directamente en Instagram. Este es el ID de la publicación en Instagram, no de Ayrshare. Requerido si postId no está establecido.
string
predeterminado:"engagement"
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.
object
Países objetivo del anuncio con {"countries": ["US", "CA"]} usando códigos de país. También puedes proporcionar arreglos regions y cities; consulta regiones y ciudades. 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
El ID de publicación de Ayrshare de la publicación a impulsar. Requerido si socialPostId no está establecido.
string
predeterminado:"active"
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.
object
Realiza el seguimiento del anuncio usando un Meta 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.
  • 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 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 identifiquen correctamente 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 specialAdCategories incorrecto, existe el riesgo de que tus anuncios se pausen hasta que se ajuste la campaña.
string
La persona u organización que se beneficia del anuncio. Se establece junto con dsaPayor. Usa el endpoint de recomendaciones DSA para obtener sugerencias.
string
La persona u organización que paga el anuncio. Se establece junto con dsaBeneficiary.
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 la misma estructura de countries, regions y cities que locations.
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 Instagram.
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.
Reemplaza los IDs de ejemplo por los tuyos. Establece startDate y endDate según tu programación prevista; las fechas de ejemplo son ilustrativas.

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.instagram.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 Instagram no puede adjuntarse a una campaña creada por un impulso de Facebook, 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.