Reserva

La reserva te permite planificar y comprar tus campañas con un costo fijo, lo que ofrece un mejor alcance y una frecuencia de anuncios controlada, al mismo tiempo que te ayuda a prever el rendimiento de tus campañas. Esto es similar a cómo compra la gente de forma tradicional con los anuncios de TV. Se trata de una opción especializada y avanzada que la mayoría de los anunciantes solo utilizan cuando quieren asegurarse al máximo de que sus anuncios lleguen a un determinado número de cuentas del centro de cuentas.

La reserva funciona en todos los tipos de anuncios y dispositivos. Como Meta segmenta anuncios en función de personas reales (y no cookies), podemos predecir el alcance con mayor precisión y controlar la frecuencia en distintos dispositivos.

Restricciones

  • Disponible para determinadas cuentas publicitarias. Comprueba el parámetro CAN_USE_REACH_AND_FREQUENCY de una cuenta publicitaria.
  • La stop_time de un conjunto de anuncios debe mantenerse dentro de los 180 días posteriores a una predicción.
  • Las cuentas también tienen restricciones en función del país; compruébalas con una llamada de la API GET a https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>?fields=rf_spec.
  • Solo se puede establecer un país a la vez en target_spec.
  • No hay versiones mínimas de iOS para el campo user_os, como sí indicaría, por ejemplo, el valor iOS_ver_2.0_and_above.
  • Al momento de crear o actualizar una campaña de reserva, no puedes definir el presupuesto diario o total, el límite de impresiones diario o total, el límite de frecuencia o la puja externa, ni el campo PacingType.

Haz una búsqueda del campo rf_spec para conocer los límites aplicables:

Nombre Descripción

countries

Matriz

Países compatibles con la reserva.

min_campaign_duration

Objeto

Duración mínima de la campaña en días para cada país admitido.

max_campaign_duration

Objeto

Duración máxima de la campaña en días para cada país admitido.

max_days_to_finish

Objeto

Días de antelación con los que puede finalizar la campaña respecto al momento en que se realiza la predicción. Se indica para cada país admitido.

min_reach_limits

Objeto

Alcance mínimo en número de cuentas del centro de cuentas en relacíón con cada país admitido.

Los resultados se ven de la siguiente manera:

{
  "rf_spec": {
    "min_reach_limits": {
      "US": 1000000,
      "CA": 1000000,
    },
    "countries": [
      "US",
      "CA",
    ],
    "min_campaign_duration": {
      "US": 3,
      "CA": 3,
    },
    "max_campaign_duration": {
      "US": 30,
      "CA": 30,
    },
    "max_days_to_finish": {
      "US": 56,
      "CA": 56,
    }
  }
}

Crear predicciones

Las predicciones incluyen el número de cuentas del centro de cuentas a las que puede llegar tu anuncio en un intervalo de fechas en función de un alcance, una frecuencia, un público y un presupuesto determinados. Las estimaciones de reserva te pueden ayudar a simular los resultados de la vida útil de tu campaña y se ajustarán según tu configuración de objetivo, presupuesto, público, formato, ubicaciones, seguridad de la marca, objetivo de rendimiento y control de frecuencia.

Es posible realizar ediciones en una campaña de reserva después de realizar la reserva; pero, una vez que la campaña está activa, no puedes editarla ni pausarla, salvo que lo hagas para cambiar el contenido del anuncio. Si solo editas el contenido del anuncio, tu predicción no cambiará. Puedes borrar la campaña para cancelarla y detenerla, pero tendrás que volver a reservarla y recibirás nuevos CPM y predicciones sobre los resultados de la campaña. Solo reserve campañas que quieres ejecutarlas.** Si quieres realizar pruebas, limita tus reservas al menor tamaño y duración, y asegúrate de cancelarlas, ya que reservamos anuncios reales del inventario por ti.

Límites

Estos son los límites predeterminados para las predicciones:

  • Dirigido a públicos de al menos 300.000 cuentas del centro de cuentas.
  • Alcance mínimo de 200.000 cuentas del centro de cuentas.
  • Los conjuntos de anuncios deben estar en circulación un mínimo de un día y un máximo de 90 (La cantidad de días se corresponde con el número de días que abarca la campaña. Por ejemplo, si una campaña empieza el día 1 a las 12:00 y finaliza el día 2 a las 10:00, se considera que estuvo en circulación dos días, a pesar de que la diferencia en horas sea de menos de 24).
  • La hora de finalización de un conjunto de anuncios debe entrar en los 180 días posteriores a una predicción.
  • La campaña debe finalizar después de las 6:00 del último día en la zona horaria de la cuenta publicitaria.

Leer predicciones

Para obtener más información, debes especificar los campos Para consultar todos los elementos reachfrequencyprediction de una cuenta, haz una solicitud HTTP GET al perímetro https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions?fields={COMMA_SEPERATED_FIELD_LIST}.

Para llegar a todos los elementos reachfrequencyprediction a partir de un identificador de reachfrequencyprediction, haz una solicitud HTTP GET con los campos que te interesen: https://graph.facebook.com/{API_VERSION}/{RF_PREDICTION_ID}?fields={COMMA_SEPERATED_FIELD_LIST}.

De manera predeterminada, Meta devuelve el identificador. Para conocer los detalles del campo, consulta Predicción de reserva, Lectura.

Códigos de estado de respuesta

En la siguiente tabla se muestran los posibles resultados del campo status en el elemento reachfrequencyprediction. Las limitaciones iniciales aparecen cuando es pertinente, pero pueden variar en el futuro en función de la cuenta publicitaria o el país:

Código Estado Descripción

1

SUCCESS

La predicción se realizó con éxito.

2

PENDING

La predicción se está generando.

3

FAIL

No se puede llegar al público. El alcance es demasiado amplio o el presupuesto es demasiado alto.

4

FAIL

Los parámetros de la predicción no son válidos (por ejemplo, la duración).

5

FAIL

targeting_spec no válido.

6

FAIL

El presupuesto o la puja para el alcance especificado son demasiado bajos.

7

FAIL

La duración del conjunto de anuncios es demasiado breve.

8

FAIL

La duración del conjunto de anuncios es demasiado larga.

9

FAIL

La fecha de finalización del conjunto de anuncios es demasiado lejana.

10

FAIL

No se especificó el límite de frecuencia.

11

FAIL

No se admite la ubicación de anuncios especificada (por ejemplo, combinar la publicación de anuncios en el lateral derecho y en la sección de noticias).

12

FAIL

Existe algún problema con las fechas del conjunto de anuncios (hora de inicio y/o finalización): son del pasado, las horas especificadas no incluyen la medianoche o las fechas no abarcan un día completo. Ya pasó la hora de finalización, se excedieron los 90 días desde la hora de inicio o no finaliza después de las 6:00.

13

FAIL

Todavía no se admite el país objetivo.

14

FAIL

Las fechas del conjunto de anuncios incluyen días restringidos.

15

FAIL

No hay suficiente inventario, no se pueden realizar reservas. Consulta cómo reservar una predicción.

16

FAIL

No se consiguió obtener el alcance mínimo necesario para la cuenta. Consulta cómo obtener las restricciones de la cuenta.

17

FAIL

El alcance real disponible de esta predicción es menor que el alcance mínimo del país objetivo (normalmente es de 200.000 personas para la mayoría de los países).

18

FAIL

Se proporcionó un programa de franjas del día no válido.

19

FAIL

No se puede alcanzar el CPM objetivo.

20

FAIL

El límite de frecuencia es demasiado bajo para la entrega combinada.

21

FAIL

El inventario de anuncios cambió lo suficiente como para causar una predicción inexacta.

23

FAIL

El intervalo del límite de frecuencia no se admite en el país objetivo.

24

FAIL

El conjunto de anuncios del estudio de mejora exclusiva en el grupo de cuentas o campañas no es coherente con la predicción de reserva.

25

FAIL

El límite de frecuencia no puede superar el número de días de circulación de la campaña.

26

FAILURE_EMPTY_AUDIENCE

El público seleccionado esta vacío y no se puede usar.

27

FAIL

No se permiten realizar modificaciones en la campaña en circulación.

28

FAIL

No se puede modificar la campaña en circulación creada con un pedido de inserción.

29

FAIL

No se puede modificar la campaña en circulación debido a límites de tiempo.

30

FAIL

Para editar un conjunto de anuncios de reserva, elige un presupuesto mayor que el gasto actual.

31

FAIL

El estudio de mejora del grupo de cuentas o campañas empieza después de que se inicie la campaña.

32

FAIL

El estudio de mejora del grupo de cuentas o campañas termina antes de que finalice la campaña.

35

FAIL

La fecha y hora de inicio de la campaña de reserva no puede ser anterior a la actual.

36

FAIL

Asegúrate de que la duración del conjunto de anuncios de reserva sea superior a un día y de que las horas de inicio y finalización de la campaña sean válidas.

37

FAIL

Audience Network no admite el objetivo con el tipo de compra de reserva.

39

FAIL

La combinación de ubicaciones seleccionada no se puede usar cuando se compra con reserva.

40

FAIL

No es posible dirigirse a versiones específicas del SO de celulares con el tipo de compra de reserva.

41

FAIL

No es posible dirigirse a amigos de conexiones con el tipo de compra de reserva.

42

FAIL

Las campañas de reserva no se pueden ejecutar cuando se selecciona Audience Network como única ubicación. Selecciona la ubicación de Audience Network con el feed de Facebook o de Instagram como ubicaciones adicionales.

44

FAIL

La reserva no admite Facebook Stories.

45

FAIL

Para usar Facebook Stories como una ubicación, selecciona también los feeds de Facebook o las Instagram Stories.

50

FAIL

La combinación de ubicaciones seleccionada no se puede usar cuando se compra con reserva. En el caso de las compras de IO con reservas, asegúrate de que el objetivo sea reproducciones de video. De lo contrario, para usar Facebook instream, selecciona la ubicación de feeds de Facebook.

53

FAIL

La ubicación de video instream solo está disponible para públicos de Estados Unidos, Reino Unido, Australia, Nueva Zelanda, Irlanda, Tailandia, México, Perú, Francia, Alemania, Argentina, Colombia, España, Chile, Ecuador, República Dominicana, Guatemala, Bolivia, Honduras, El Salvador, Noruega, Suecia, Países Bajos, Bélgica, Polonia, Portugal, Dinamarca, India, Malasia, Filipinas, Indonesia y Vietnam. Para continuar, edita tu público e incluye solo a personas de esos países.

60

FAIL

Para usar Facebook Marketplace, selecciona la ubicación de feeds de Facebook.

66

FAIL

La ubicación de la columna derecha de Facebook no se puede combinar con otras ubicaciones.

69

FAIL

Si quieres que tu anuncio aparezca en la sección "Explorar" de Instagram, también deberás seleccionar el feed de Instagram como ubicación.

100+

FATAL

Error del sistema, no es culpa del usuario. Reintentar.

Usar predicciones

Proporciona tu identificador de predicciones y sus datos como entrada para crear un nuevo identificador que funcione como identificador de reserva. A continuación, adjunta este nuevo identificador al conjunto de anuncios. Al crear una reserva, el inventario deja de estar disponible para otros, por lo que debes adjuntarlo antes de que caduque.

Si la reserva se realiza correctamente, reservaremos temporalmente el inventario para ti. Dispondrás aproximadamente de una hora tras hacer la reserva para asignar un anuncio a un conjunto de anuncios.

Si se excede el límite de tiempo para las solicitudes de reserva, verás el siguiente código de error y el mensaje: 613: Las llamadas a esta API superaron el límite de frecuencia.

Reservar

Reserva predicciones para tus conjuntos de anuncios si quieres bloquear el precio y tener un alcance predecible. Utiliza el valor reserve del campo action para reservar un público identificado mediante un elemento reachfrequencyprediction durante un período de tiempo determinado. Puedes usar un solo identificador de predicción para crear varias reservas. Por ejemplo:

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
// Response 
{"id":9876543210"}

Para reservar inventario a partir de una predicción, haz una llamada de API POST a https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions.

Para los campos reach, budget e impression, puedes reservar una predicción en un punto específico en curve_budget_reach, en lugar de recurrir a la tupla original de alcance o presupuesto de la predicción. Usa los siguientes campos:

Nombre Descripción

rf_prediction_id

Entero

Obligatorio.

Identificador de reachfrequencyprediction

action

Cadena

Se requiere para la reserva y la cancelación.

Las opciones son:

  • reserve: reserva inventario con la predicción anterior
  • cancel: cancela la predicción reservada

rf_prediction_id_to_release

Entero

Opcional.

Es la predicción reservada o el identificador de reserva. Con una nueva reserva, se libera un público reservado, que se utiliza para esta. Consulta Volver a usar públicos reservados.

rf_prediction_id_to_share

Entero

Opcional.

Es el identificador de la predicción creada anteriormente. Las nuevas predicciones utilizan el público de una predicción determinada.


Nota:rf_prediction_id_to_share debe estar configurado en un identificador de predicción válido para usar el objetivo TRAFFIC o las optimizaciones POST_ENGAGEMENT y LINK_CLICKS. Consulta el registro de cambios para obtener más información.

reach

Entero

Opcional. Si se especifica, debes facilitar los campos budget e impression.

Para ello, especifica los subcampos reach, budget y impression para el punto correspondiente en el campo curve_budget_reach. Puedes reemplazar este valor.

budget

Entero

Opcional. Si se especifica, debes facilitar reach e impression.

Especifica reach, budget e impression para el punto correspondiente en curve_budget_reach. Puedes reemplazar este valor.

impression

Entero

Opcional. Si se especifica, debes facilitar reach y budget.

Puedes reemplazar este valor. Para ello, especifica los subcampos reach, budget e impression para el punto correspondiente en el campo curve_budget_reach.

Meta reserva predicciones de forma asíncrona. Debes consultar y comprobar el estado de la predicción. Inicialmente, el estado de la predicción es 2 (PENDING). Una vez completada, el estado pasa a 1, (SUCCESS) o 15 (FAIL), el cual implica que no tenemos suficiente inventario para completar la reserva.

Como el sistema de reservas es dinámico; es posible que veas pequeños cambios en la disponibilidad del inventario entre el momento de la predicción y el de la reserva. Sin embargo, Meta respeta los valores que obtienes en el momento de la predicción, siempre que los cambios estén dentro de un límite razonable.

Asignar predicciones a conjuntos de anuncios

Una vez que hayas reservado correctamente una predicción, crea un conjunto de anuncios con ella:

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

Para asignar correctamente una predicción, el conjunto de anuncios debe reunir estos criterios:

  • No especifiques los campos siguientes:
  • start_time: se deriva de la predicción.
  • end_time: se deriva de la predicción.
  • targeting: se deriva de la predicción.
  • bid_amount
  • optimization_goal
  • Puede ser lifetime_budget o daily_budget.
  • Puedes asignar reservas a conjuntos que no tengan anuncios activos. Sin embargo, debes tener al menos un anuncio activo antes de que se inicie el conjunto de anuncios.
  • Debes incluir el campo rf_prediction_id, con el que adjuntas la predicción al nuevo conjunto de anuncios.
  • El atributo del campo buying_type de la campaña publicitaria correspondiente debe ser RESERVED.

También puedes adjuntar el elemento reachfrequencyprediction a conjuntos de anuncios para modificar su predicción. Haz una solicitud POST a https://graph.facebook.com/{ad_set_id} con el parámetro rf_prediction_id correspondiente al elemento reachfrequencyprediction que deseas usar.

A continuación, se muestran los límites del conjunto de anuncios:

  • Opciones de la plataforma de publicación: facebook, instagram.
  • Opciones de ubicación de Meta: feed y rightcolumn.
  • Opciones de ubicación de Instagram: stream, story, explore, explore_home y reels. Si la ubicación incluye instagram, debes usar el campo destination_ids (y no destination_id). El campo destination_ids debe contener el identificador de la página de Facebook que se usa como destination_id, más el identificador de la cuenta de Instagram.
  • Se pueden usar los públicos personalizados o las categorías de socios, pero no ambos.
  • No se admiten los públicos personalizados de sitios web ni la segmentación de exclusión en función de la interacción con videos o fans.
  • El campo promoted_object del conjunto de anuncios debe coincidir con el campo destination_id de la predicción. Para las publicaciones de páginas, debe ser el identificador de página especificado. Para los anuncios sobre apps, debe coincidir con el identificador de app especificado.
  • Se admite la frecuencia de anuncios estándar y programada, pero no la entrega acelerada.

El importe que te cobramos por las campañas de reserva es en base a las impresiones reales entregadas. Si pasa la hora de inicio de la campaña y el conjunto no tiene anuncios activos, la campaña no se entregará, por lo que no se realizará ningún cobro. Meta libera el inventario restante; sin embargo, podemos penalizar la cuenta de anuncios si esta situación se repite con frecuencia.

Cuando creas una campaña mediante el tipo de compra de reserva de Meta, aceptas pagar el costo propuesto fijo por el inventario publicitario que reservas. Si quieres cambiar el tamaño de tu público o la frecuencia del anuncio, ten en cuenta que también cambiarán los costos correspondientes. Puedes hacer estos cambios en cualquier momento antes de iniciar la campaña. Puedes editar el contenido de tu anuncio hasta que se inicia la campaña.

Administrar anuncios

Los conjuntos de anuncios de reserva pueden incluir varios anuncios. Además, puedes agregar más anuncios en cualquier momento. Si se activa el conjunto de anuncios y no incluye anuncios activos, debes crear el primer anuncio durante las primeras 24 horas (en el caso de los conjuntos de anuncios con una duración de 3 a 30 días), o bien en las primeras seis horas (si el conjunto va a estar en circulación entre uno y dos días). Si no creas el anuncio a tiempo, eliminaremos la reserva.

Desasociar predicciones, modificar conjuntos de anuncios

Puedes editar o pausar tu campaña de reserva antes de que empiece. Una vez que empiece la campaña, solo puedes editar el contenido del anuncio, el presupuesto o ampliar la fecha de finalización. Si solo editas el contenido del anuncio, tu predicción no cambiará.

Si modificas el presupuesto o la fecha de finalización, se puede generar una nueva predicción para la campaña, que verás en las estimaciones de reserva.

No puedes pausar tu campaña de reserva una vez que empiece, pero puedes eliminarla para cancelarla en cualquier momento.

Para obtener información sobre cómo pausar o editar un conjunto de anuncios después de que se haya puesto en circulación, consulta Pausar o reiniciar conjuntos de anuncios en circulación y Editar conjuntos de anuncios en circulación. Para aprender a eliminar un conjunto activo, consulta la referencia Conjunto de anuncios. Se te cobrarán las impresiones entregadas.

Ten en cuenta que, para evitar posibles errores, te recomendamos no eliminar los anuncios cuando se publica un conjunto de anuncios de reserva.

Si asignas una reserva a un conjunto de anuncios antes de que este se active, no podrás cambiar la mayoría de los atributos, excepto que desasocies la reserva. Haz una solicitud HTTP POST al conjunto y establece el valor de rf_prediction_id en 0. Solo puedes modificar el atributo name en el objeto del conjunto de anuncios.

Para desasociar una reserva:

curl \
-F "rf_prediction_id=0" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

Una vez que un conjunto de anuncios esté activo, la reserva correspondiente no podrá desasociarse y los atributos del conjunto no se podrán modificar, excepto en el caso de algunos atributos de anuncio que se incluyen en la lista de autorizados y se enumeran a continuación:

  • name
  • creative_id
  • creative_spec
  • conversion_specs
  • tracking_specs
  • view_tags

Pausar y reiniciar conjuntos de anuncios

Puedes pausar un conjunto de anuncios activo. Consulta la referencia Conjunto de anuncios para obtener más información al respecto. Si pausas un conjunto durante más de 30 minutos, ya no podremos garantizar la predicción correspondiente.

Para volver a activar un conjunto que se haya pausado durante más de 30 minutos, tendrás que obtener una nueva predicción. Para ello, haz una solicitud POST al perímetro reachfrequencypredictions. Consulta Crear predicciones y Reservar predicciones para obtener más información. Debes pasar un parámetro "existing_campaign_id" para volver a activar el conjunto de anuncios en la solicitud. Una vez que hayas creado y reservado una nueva predicción, adjunta el elemento reachfrequencyprediction al conjunto de anuncios mediante una solicitud HTTP POST al perímetro https://graph.facebook.com/{ad_set_id}, especificando el parámetro rf_prediction_id correspondiente a la predicción que quieras usar.

Editar conjuntos de anuncios en circulación

Después de que se ponga en circulación un conjunto de anuncios, puedes hacer los cambios siguientes:

  • Aumentar o disminuir el presupuesto y el alcance del conjunto de anuncios. El presupuesto y el alcance deben ser superiores al gasto actual y al alcance entregado, respectivamente.
  • Ampliar la programación del conjunto de anuncios a 90 días.

No puedes editar ni pausar un conjunto de anuncios activo si se cumplen uno de los siguientes criterios:

  • Tiene una entrega muy insuficiente. Menos de un 10% de la entrega establecida en la predicción. Conjuntos con un gasto excesivo, por encima del presupuesto.
  • Está en circulación solo un día.
  • Finaliza en las próximas 24 horas.

Para editar conjuntos de anuncios en circulación, obtén una nueva predicción. Consulta Crear una predicción y Reservar la predicción para obtener más información. Debes pasar el parámetro de existing_campaign_id para volver a activar el conjunto de anuncios en la solicitud.

Después de crear y reservar una predicción, puedes adjuntar un elemento reachfrequencyprediction al conjunto de anuncios si haces una solicitud HTTP POST al perímetro https://graph.facebook.com/{ad_set_id}, especificando el parámetro rf_prediction_id como identificador del elemento reachfrequencyprediction que quieres usar.

Volver a usar públicos reservados

Si cancelas una reserva, se libera el inventario reservado para ponerlo a disposición de otros anunciantes. Sin embargo, puedes volver a utilizar el público de una predicción que hayas reservado anteriormente, siempre que no lo estés usando ya. Esto nos permite tener en cuenta inventario adicional a la hora de crear una predicción, sin que tengas que cancelar una reserva existente.

Cuando crees una reserva, incluye el parámetro rf_prediction_id_to_share. Este es el identificador de una predicción anterior. Esto invalidará la reserva anterior, de forma que podrás utilizar el inventario correspondiente para la reserva que acabas de crear.

Para reservar la nueva predicción, también debes pasar el parámetro adicional rf_prediction_id_to_release, que corresponde al identificador de la reserva anterior.

Rotación y secuenciación de anuncios

Puedes rotar los anuncios en el conjunto de anuncios que estás usando. Para ello, no es necesario desasociar la reserva del conjunto. Agrega uno o varios anuncios al conjunto y espera a que este se active. En ese momento, podrás cambiar el estado del anuncio inicial a "En pausa". Debes tener al menos un anuncio activo en el conjunto.

Puedes diseñar una secuencia de anuncios para que se entreguen en un orden específico. En primer lugar, crea el conjunto de anuncios y los anuncios. A continuación, especifica la secuencia en el nivel de conjunto de anuncios en creative_sequence. Cada anuncio individual de este conjunto de anuncios podrá aparecer una vez en la secuencia, varias veces o nunca.

Si la longitud de la matriz de creative_sequence es 0, no estás usando la secuenciación. Si la longitud no es 0, te recomendamos que sea igual al valor de frequency_cap en rf_prediction_id. Si la longitud es mayor que el valor de frequency_cap, quitaremos los últimos anuncios de la matriz. Si la longitud es menor que el valor de frequency_cap, completaremos automáticamente de forma recursiva la matriz, repitiendo la secuencia desde el principio. Para que los resultados sean claros, establece la longitud de creative_sequence para que coincida con el valor de frequency_cap.

Cada anuncio de la secuencia tiene el estado ACTIVE, PENDING_REVIEW o CREDIT_CARD_NEEDED. Para que se muestre un anuncio determinado de la secuencia a un usuario, primero deben haberse entregado todos los anuncios anteriores de ella. No se entregarán anuncios que no estén incluidos en el campo creative_sequence.

No se pueden pausar, archivar o eliminar los anuncios incluidos en un conjunto en el que se emplee la secuenciación, ya sea que formen parte de la secuencia o no.

Esta función solo está disponible para los conjuntos de anuncios de reserva, es decir, el campo buying_type de la campaña a la que pertenecen debe ser RESERVED, y los conjuntos deben tener configurado un campo rf_prediction_id.

Consulta la referencia sobre el conjunto de anuncios para obtener más información.

Reserva de Instagram

Para obtener un alcance predecible en Instagram, puedes crear una campaña de reserva con buying_type configurado en RESERVED.

La reserva te ayuda a planificar y reservar las campañas de reconocimiento e interacción, lo que optimiza el alcance, la mejora de recuerdo del anuncio y ThruPlay.

El alcance estimado en el administrador de anuncios y la API brindan a los socios una orientación sobre lo que pueden esperar. La comunidad de Instagram está en primer lugar. Intentamos alcanzar los objetivos de manera conservadora y esperamos que evolucionen con el tiempo. Todas las políticas que se aplican al uso de estimaciones de reserva para Facebook también se aplican a Instagram.

Códigos de error

Código Descripción

1487583

No se puede asignar una predicción de reserva a un conjunto sin anuncios.

1487055

El estado del conjunto de anuncios no es válido.

1487600

El conjunto de anuncios ya está asignado a una reserva. Si quieres usar otra predicción, desasocia la actual del conjunto usando un valor nulo y, a continuación, asigna la nueva predicción.

1487578

El identificador especificado del elemento reachandfrequencyprediction no existe o no pertenece a la cuenta facilitada.

1487581

No se puede modificar la predicción de reserva en un conjunto de anuncios activo.

1487594

No hay anuncios en el conjunto de anuncios de reserva.

1487595

Especificación de destino no válida en el conjunto de anuncios de reserva.

1487614

La hora de inicio del conjunto de anuncios no coincide con la predicción original.

1487615

La hora de finalización del conjunto de anuncios no coincide con la predicción original.

1487616

No se puede asociar el conjunto de anuncios con una predicción no válida.

1487671

No se admite la transición directa de una predicción a otra para un conjunto de anuncios.

1487244

Se produjo un error en la actualización del conjunto de anuncios: la causa debería incluirse en la respuesta.

1487672

No se ha podido asignar la predicción al conjunto de anuncios.

1487680

No tienes permiso para usar conjuntos de anuncios de reserva.

Ejemplos

Crear un elemento reachfrequencyprediction para un campo destination_id en el que se especifica una app:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<APP_ID>' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Crear un elemento reachfrequencyprediction para un campo destination_id en el que se especifica una página:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<PAGE_ID>' \
-F 'prediction_mode=1' \
-F "objective=POST_ENGAGEMENT" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Crear un elemento reachfrequencyprediction para un campo destination_id en el que se especifica una app con ubicaciones de Instagram:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook","instagram"], "device_platforms":["mobile"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_ids=[<APP_ID>,<INSTAGRAM_ACCOUNT_ID>]' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Consulta el siguiente punto de conexión mediante solicitudes HTTP GET para recuperar el estado hasta que este sea distinto de 2:

https://graph.facebook.com/67890123456?fields=status

Si el estado es 1 (SUCCESSFUL), puedes reservar la predicción correspondiente o adjuntarla a un conjunto de anuncios.

Reservar una predicción:

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
{"id":"9876543210"}

Consulta el siguiente punto de conexión mediante solicitudes HTTP GET para recuperar el estado hasta que este sea distinto de 2:

https://graph.facebook.com/<API_VERSION>/<PREDICTION_ID>?fields=status

Si el estado es 1 (SUCCESSFUL), puedes adjuntar la predicción correspondiente a un conjunto de anuncios. Veamos cómo configurar la estructura de la campaña. Para ello, crearemos una campaña, un conjunto de anuncios, contenido publicitario y un anuncio, y asignaremos la reserva al conjunto de anuncios.

Crear una campaña publicitaria:

curl \
-F "name=Test" \
-F "buying_type=RESERVED" \
-F "status=ACTIVE" \
-F "objective=POST_ENGAGEMENT" \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

{"id":"1122334455"}

Crear un conjunto de anuncios:

curl  \
-F "name=TestReachSet" \
-F "status=1" \
-F "campaign_id=<CAMPAIGN_ID>" \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets"

{"id":"09876543"}

Generar el contenido de un anuncio:

curl \
-F "name=sample creative" \
-F "type=1" \
-F "title=hello world" \
-F "body=hi i'm an ad" \
-F "link_url="https://www.facebook.com/" \
-F "image_hash=4aca812b4eadb72818a2c4124abd121a" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives"

{"id":"1323123123123"}

Crear un anuncio:

// Create an ad
curl \
-F "name=my ad" \
-F "adset_id=<AD_SET_ID>" \
-F "creative={'creative_id':<CREATIVE_ID>}" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads"

{"id":"3213213123"}

Asignar una nueva predicción a un conjunto de anuncios:

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"