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.
CAN_USE_REACH_AND_FREQUENCY
de una cuenta publicitaria.stop_time
de un conjunto de anuncios debe mantenerse dentro de los 180 días posteriores a una predicción. GET
a https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>?fields=rf_spec
.target_spec
.user_os
, como sí indicaría, por ejemplo, el valor iOS_ver_2.0_and_above
.PacingType
.Haz una búsqueda del campo rf_spec
para conocer los límites aplicables:
Nombre | Descripción |
---|---|
Matriz | Países compatibles con la reserva. |
Objeto | Duración mínima de la campaña en días para cada país admitido. |
Objeto | Duración máxima de la campaña en días para cada país admitido. |
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. |
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, } } }
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.
Estos son los límites predeterminados para las 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.
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 |
|
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. |
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.
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 |
---|---|
Entero | Obligatorio. Identificador de |
Cadena | Se requiere para la reserva y la cancelación. Las opciones son:
|
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. |
Entero | Opcional. Es el identificador de la predicción creada anteriormente. Las nuevas predicciones utilizan el público de una predicción determinada. Nota: |
Entero | Opcional. Si se especifica, debes facilitar los campos Para ello, especifica los subcampos |
Entero | Opcional. Si se especifica, debes facilitar Especifica |
Entero | Opcional. Si se especifica, debes facilitar Puedes reemplazar este valor. Para ello, especifica los subcampos |
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.
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:
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
lifetime_budget
o daily_budget
.rf_prediction_id
, con el que adjuntas la predicción al nuevo conjunto de anuncios. 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:
facebook
, instagram
. feed
y rightcolumn
. 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. 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.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.
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.
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
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.
Después de que se ponga en circulación un conjunto de anuncios, puedes hacer los cambios siguientes:
No puedes editar ni pausar un conjunto de anuncios activo si se cumplen uno de los siguientes criterios:
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.
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.
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.
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ó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 |
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. |
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>"