La reserva te permite planear y comprar tus campañas a un coste fijo y optimiza el alcance y controla la frecuencia de los anuncios a la vez que te ayuda a predecir el rendimiento de la campaña. Este sistema es parecido a la forma en que se suelen comprar anuncios para televisión. Se trata de una opción avanzada y especializada que la mayoría de los anunciantes solo utilizarán si quieren asegurarse de que sus anuncios llegarán a una cantidad determinada de cuentas del Centro de cuentas.
La reserva funciona con varios dispositivos y tipos de anuncios. Dado que Meta segmenta anuncios en función de personas reales (y no cookies), podemos predecir el alcance y controlar la frecuencia de entrega en distintos dispositivos con más precisión.
CAN_USE_REACH_AND_FREQUENCY
de una cuenta publicitaria.stop_time
del conjunto de anuncios debe situarse dentro de los 180 días siguientes a una predicción. GET
a la API a https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>?fields=rf_spec
.target_spec
.user_os
, como, por ejemplo, iOS_ver_2.0_and_above
.PacingType
.Busca rf_spec
para averiguar los límites aplicables:
Nombre | Descripción |
---|---|
Matriz | Países en los que está disponible 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 para cada país admitido. |
El resultado será similar al siguiente:
{ "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 la cantidad de cuentas del Centro de cuentas a las que puede llegar el anuncio en un intervalo de fechas en función del alcance, la frecuencia, la audiencia y el presupuesto especificados. Las estimaciones de la reserva te pueden ayudar a simular los resultados totales de la campaña y se ajustarán según la configuración que hayas establecido para el objetivo, el presupuesto, la audiencia, los formatos y las ubicaciones, la seguridad de marca, el objetivo de rendimiento y el control de frecuencia.
Es posible editar una campaña de reserva después de realizar la reserva, pero una vez que la campaña esté en circulación, no la podrás editar ni pausar salvo para cambiar el contenido de los anuncios. La predicción no cambiará si solo editas el contenido del anuncio. Puedes eliminar una campaña para cancelarla o detenerla, pero tendrás que volver a reservar la campaña, y podrías recibir un CPM y una predicción nuevos sobre los resultados de la campaña. Reserva solo las campañas que tengas previsto poner en circulación.** Si quieres realizar pruebas, limita tus reservas al menor tamaño y duración, y asegúrate de cancelarlas, ya que estas siempre se realizan con anuncios reales del inventario.
Estos son los límites predeterminados para las predicciones:
Para obtener información detallada, especifica los campos. Para ver todos los elementos reachfrequencyprediction
de una cuenta, envía una solicitud HTTP GET
a https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions?fields={COMMA_SEPERATED_FIELD_LIST}
.
Para llegar a todos los elementos reachfrequencyprediction
en función de un identificador reachfrequencyprediction
, envía una solicitud HTTP GET
con los campos que quieras: https://graph.facebook.com/{API_VERSION}/{RF_PREDICTION_ID}?fields={COMMA_SEPERATED_FIELD_LIST}
.
De forma predeterminada, Meta devuelve el identificador. Para obtener detalles acerca de los campos, consulta Predicción de reserva, Lectura.
Se muestran los posibles resultados de status
en reachfrequencyprediction
. Las limitaciones iniciales aparecen cuando es pertinente, pero pueden variar en el futuro en función de la cuenta publicitaria o del país:
Código | Estado | Descripción |
---|---|---|
1 | SUCCESS | La predicción se ha realizado correctamente. |
2 | PENDING | La predicción todavía se está generando. |
3 | FAIL | No se puede llegar a la audiencia. El alcance es demasiado amplio o el presupuesto es demasiado alto. |
4 | FAIL | Los ajustes de la predicción no son válidos (por ejemplo, la duración). |
5 | FAIL | Valor de |
6 | FAIL | El presupuesto o la puja para el alcance especificado son demasiado bajos. |
7 | FAIL | La longitud del conjunto de anuncios es demasiado corta. |
8 | FAIL | La longitud del conjunto de anuncios es demasiado larga. |
9 | FAIL | Falta demasiado tiempo para la fecha de finalización del conjunto de anuncios. |
10 | FAIL | No se ha especificado 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 el feed). |
12 | FAIL | Existe algún problema con las fechas (de inicio o finalización) del conjunto de anuncios: la hora de inicio ya ha pasado, las horas especificadas no incluyen la medianoche o las fechas no abarcan un día completo. La fecha de finalización ya ha pasado, supera los 90 días de distancia respecto a la inicial o no termina después de las 6:00. |
13 | FAIL | No se admite todavía el país objetivo. |
14 | FAIL | Las fechas del conjunto de anuncios incluyen días no disponibles. |
15 | FAIL | No hay suficiente inventario, por lo que no se pueden realizar reservas. Consulta “Reservar predicciones” para obtener más información. |
16 | FAIL | No se ha conseguido obtener el alcance mínimo necesario para la cuenta. Consulta “Obtener restricciones de la cuenta”. |
17 | FAIL | El alcance real disponible para 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 | La programación de franjas del día que se ha facilitado no es válida. |
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 ha cambiado lo suficiente para que la predicción sea 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 lift de la exclusión del 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 que tu campaña está en circulación. |
26 | FAILURE_EMPTY_AUDIENCE | La audiencia seleccionada está vacía y no se puede usar. |
27 | FAIL | No se permite realizar modificaciones en tu 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 restricciones de tiempo. |
30 | FAIL | Para editar un conjunto de anuncios de reserva que se encuentra en circulación, elige un presupuesto mayor que el gasto actual. |
31 | FAIL | El estudio de lift del grupo de cuentas o campañas empieza una vez iniciada la campaña. |
32 | FAIL | El estudio de lift del grupo de cuentas o campañas termina antes de que finalice la campaña. |
35 | FAIL | No se puede establecer la hora de inicio de la campaña de reserva en el pasado. |
36 | FAIL | Asegúrate de que la duración del conjunto de anuncios de reserva sea superior a un día y que la hora de inicio o finalización de la campaña sea válida. |
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 | Determinadas versiones de sistemas operativos para móviles no se pueden segmentar con el tipo de compra de reserva. |
41 | FAIL | Los amigos de las conexiones no se pueden segmentar con el tipo de compra de reserva. |
42 | FAIL | Las campañas de reserva no se pueden publicar cuando Audience Network es la única ubicación seleccionada. Selecciona la ubicación de Audience Network con el feed de Facebook o el feed de Instagram como ubicaciones adicionales. |
44 | FAIL | La reserva no admite Facebook Stories. |
45 | FAIL | Para usar Facebook Stories como ubicación, selecciona también los feeds de Facebook o Instagram Stories. |
50 | FAIL | La combinación de ubicaciones seleccionada no se puede usar cuando se compra con reserva. En el caso de la compra de pedidos de inserción de reserva, asegúrate de que el objetivo sea “Reproducciones de vídeo”. De lo contrario, para usar la función in-stream de Facebook, selecciona la ubicación de los feeds de Facebook. |
53 | FAIL | La ubicación de vídeo in-stream solo está disponible para las audiencias 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 la audiencia para incluir solo a personas de esos países. |
60 | FAIL | Para usar Facebook Marketplace, selecciona la ubicación de los 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 el anuncio se muestre en la sección Explorar de Instagram, también tendrás que seleccionar el feed de Instagram como ubicación. |
100 o más | FATAL | Error del sistema, no es culpa del usuario. Reintentar. |
Facilita el identificador de la predicción y sus datos como parámetros de entrada para crear uno nuevo que sirva de identificador de la reserva. A continuación, adjunta este nuevo identificador de reserva a tu 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 el inventario temporalmente para ti. Tienes aproximadamente una hora a partir de la reserva para asignar un anuncio a un conjunto de anuncios.
Si el límite por hora de las solicitudes de reserva se supera, verás el siguiente mensaje y código de error: 613: Las llamadas a esta API han superado el límite de frecuencia.
La reserva de predicciones para tus conjuntos de anuncios te permite bloquear el precio y tener un alcance predecible. Puedes reservar una audiencia identificada mediante reachfrequencyprediction
durante un periodo determinado con reserve
para action
. 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 en función de una predicción, haz una llamada POST
a la API a https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions
.
Para los valores reach
, budget
y impression
, puedes reservar una predicción para un punto concreto de curve_budget_reach
, en lugar de la tupla original del alcance o el presupuesto de la predicción. Usa estos campos:
Nombre | Descripción |
---|---|
Entero | Obligatorio. Identificador de |
Cadena | Obligatorio para realizar reservas y cancelaciones. Las opciones son las siguientes:
|
Entero | Opcional. La predicción reservada o el identificador de reserva. Con una nueva reserva, se libera una audiencia reservada, que se utiliza para esta. Consulta Reutilización de audiencias reservadas |
Entero | Opcional. Identificador de la predicción creada anteriormente. Las nuevas predicciones utilizan la audiencia de una predicción determinada. Nota: |
Entero | Opcional. Si se especifica, proporciona valores para Especifica |
Entero | Opcional. Si se especifica, proporciona valores para Especifica |
Entero | Opcional. Si se especifica, proporciona valores para Puedes invalidar este valor. Para hacerlo, especifica valores de |
Meta reserva predicciones de forma asíncrona; debes consultar y comprobar el estado de la predicción. Inicialmente, el estado de predicción es 2
(PENDING). Al finalizar, el estado es 1
, SUCCESS
o 15
, FAIL
, lo que significa que no se dispone de inventario suficiente para hacer 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 producidos entren dentro de lo razonable.
Después de reservar 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, tu conjunto de anuncios debe cumplir estos requisitos:
start_time
: derivada de la predicciónend_time
: derivada de la prediccióntargeting
: derivada de la predicciónbid_amount
optimization_goal
lifetime_budget
o daily_budget
.rf_prediction_id
para conectar la predicción con el nuevo conjunto de anuncios. buying_type
es RESERVED
.También puedes conectar reachfrequencyprediction
con los conjuntos de anuncios para modificar su predicción. Para hacerlo, envía una solicitud POST
a https://graph.facebook.com/{ad_set_id}
con rf_prediction_id
para el valor de reachfrequencyprediction
que quieras utilizar.
Estas son las limitaciones del conjunto de anuncios:
facebook
, instagram
. feed
y rightcolumn
. stream
, story
, explore
, explore_home
y reels
. Si la ubicación incluye instagram
, debes utilizar destination_ids
, no destination_id
. El campo destination_ids
debe contener el identificador de la página de Facebook utilizado como destination_id
, además del identificador de la cuenta de Instagram. promoted_object
del conjunto de anuncios debe coincidir con el de destination_id
de la predicción. En el caso de las publicaciones de página, debe ser el identificador de página especificado. Cuando se trate de anuncios sobre aplicaciones, debe coincidir con el identificador de aplicación especificado.El importe que te cobramos por las campañas de reserva se basa en 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 liberará el inventario restante, pero es posible que penalicemos la cuenta publicitaria correspondiente en caso de que esta situación se haya repetido varias veces.
Al crear una campaña mediante el tipo de compra de reserva de Meta, aceptas pagar los costes propuestos por el inventario de anuncios que reserves. Si quieres cambiar el tamaño de tu audiencia o la frecuencia de los anuncios, ten en cuenta que también cambiarán los costes correspondientes. Puedes hacer estos cambios en cualquier momento antes de iniciar la campaña. También puedes editar el contenido del anuncio hasta que comience la campaña.
Los conjuntos de anuncios de reserva pueden incluir varios anuncios, y puedes añadir más en cualquier momento. Si se activa el conjunto de anuncios y no incluye anuncios activos, debes crear tu primer anuncio durante las primeras 24 horas (en el caso de los conjuntos de anuncios con una duración de tres 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 poner en pausa una campaña de reserva antes de que comience. Una vez iniciada, solo puedes editar el contenido del anuncio y el presupuesto o ampliar la fecha de finalización. La predicción no cambiará si solo editas el contenido del anuncio.
Si modificas el presupuesto o la fecha de finalización, podría generarse una nueva predicción para tu campaña, que aparecerá en las estimaciones de reservas.
No puedes poner en pausa la campaña de reserva una vez iniciada, pero sí eliminarla para cancelarla en cualquier momento.
Para pausar o editar un conjunto una vez iniciado, consulta Pausar o reiniciar conjuntos de anuncios en circulación y Editar conjuntos de anuncios en circulación. Para eliminar un conjunto activo, consulta la referencia sobre conjuntos de anuncios. Se te cobrarán las impresiones entregadas.
Nota: Para evitar posibles errores, recomendamos encarecidamente no eliminar todos los anuncios cuando un conjunto de anuncios de reserva esté activo.
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 a menos que la desasocies. Envía una solicitud HTTP POST
al conjunto de anuncios y define rf_prediction_id
con un valor igual a 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 esté activo un conjunto de anuncios, la reserva ya no se puede desasociar y los atributos del conjunto no se pueden modificar, con la excepción de los siguientes atributos de anuncio incluidos en la lista de autorizados:
name
creative_id
creative_spec
conversion_specs
tracking_specs
view_tags
Puedes pausar un conjunto activo. Consulta la referencia sobre conjuntos de anuncios. 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. Envía una solicitud POST
a reachfrequencypredictions
. Consulta Crear una predicción y Reservar la predicción. Debes pasar un parámetro “existing_campaign_id” para volver a activar el conjunto de anuncios en la solicitud. Después de crear y reservar una predicción nueva, conecta reachfrequencyprediction
con el conjunto de anuncios mediante una solicitud HTTP POST
a https://graph.facebook.com/{ad_set_id}
que especifique rf_prediction_id
para la predicción que quieres utilizar.
Después de que se ponga en circulación un conjunto de anuncios, puedes realizar los cambios siguientes:
Un conjunto activo no se puede editar ni pausar si cumple los criterios siguientes:
Para editar conjuntos de anuncios en circulación, obtén una nueva predicción. Consulta Crear una predicción y Reservar la predicción. Debes pasar un parámetro “existing_campaign_id” para volver a activar el conjunto activo en la solicitud.
Después de crear y reservar una nueva predicción, puedes conectar reachfrequencyprediction
al conjunto de anuncios mediante una solicitud HTTP POST a https://graph.facebook.com/{ad_set_id} en la que se especifique rf_prediction_id
como el identificador de reachfrequencyprediction que quieres utilizar.
Si cancelas una reserva, se libera el inventario reservado para ponerlo a disposición de otros anunciantes. Sin embargo, puedes volver a utilizar la audiencia de una predicción que hayas reservado anteriormente, siempre que no la estés usando ya. Esto nos permite tener en cuenta más inventario a la hora de crear una predicción, sin que tengas que cancelar una reserva existente.
Al crear una reserva, incluye rf_prediction_id_to_share
, que corresponde al 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 una predicción nueva, también debes pasar el parámetro adicional rf_prediction_id_to_release
, que es el identificador de la reserva anterior.
Puedes establecer rotaciones para los anuncios del conjunto que estés usando. Para ello, no es necesario desasociar la reserva del conjunto. Añade uno o varios anuncios al conjunto y espera a que 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 y los anuncios. A continuación, especifica la secuencia en el nivel del conjunto de anuncios en creative_sequence
. Cada anuncio del conjunto puede no aparecer o mostrarse una o varias veces a lo largo de la secuencia.
Si la longitud de la matriz creative_sequence
es igual a cero, significa que no estás utilizando ninguna secuenciación. Si no es igual a cero, es recomendable definirla con un valor igual al de frequency_cap
en rf_prediction_id
. Si la longitud es superior al valor de frequency_cap
, truncaremos los últimos anuncios de la matriz. Si la longitud es inferior a frequency_cap
, completaremos la matriz automáticamente de forma recursiva. Para ello, repetiremos la secuencia desde el principio. Para aclarar los resultados, define la longitud de creative_sequence
con un valor igual al 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. Los anuncios que no se incluyan en creative_sequence
no se entregarán.
No se pueden pausar, archivar ni eliminar los anuncios incluidos en un conjunto en el que se emplee la secuenciación, tanto si forman parte de la secuencia como si no.
Esta función solo está disponible para conjuntos de anuncios de reserva; p. ej., el valor de buying_type
de la campaña de anuncios principal es RESERVED
y este conjunto de anuncios tiene definido el valor de rf_prediction_id
.
Para obtener información más detallada, consulta el documento del conjunto de anuncios.
Para obtener un alcance predecible en Instagram, puedes crear una campaña de reserva con el elemento buying_type
definido como RESERVED
.
La reserva te ayuda a planear y reservar campañas de reconocimiento e interacción y optimiza el alcance, el lift en recuerdo publicitario y el ThruPlay.
Las estimaciones de alcance del Administrador de anuncios y la API pueden orientar a los socios acerca de los resultados que es razonable esperar. La comunidad de Instagram es lo primero. Intentamos conseguir nuestros objetivos de alcance de forma conservadora y tenemos previsto evolucionar con el tiempo. Todas las políticas que se aplican al uso de las 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 | Ya se ha asignado el conjunto de anuncios a una reserva. Si quieres usar otra predicción, desasocia la actual del conjunto usando un valor nulo y, a continuación, asigna una nueva predicción. |
1487578 | El identificador de |
1487581 | No se puede modificar la predicción de reserva en un conjunto de anuncios activo. |
1487594 | No hay ningún anuncio en el conjunto de anuncios de reserva. |
1487595 | La especificación de segmentación en el conjunto de anuncios de reserva no es válida. |
1487614 | La hora de inicio del conjunto de anuncios no coincide con la predicción original. |
1487615 | La hora de detenció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 | Ha fallado 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. |
Creación de un elemento reachfrequencyprediction
para el valor de destination_id
de una aplicación:
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"}
Creación de un elemento reachfrequencyprediction
para el valor de destination_id
de 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"}
Creación de un elemento reachfrequencyprediction
para el valor de destination_id
de una aplicación con una ubicación en 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"}
Sondea el extremo siguiente mediante solicitudes HTTP GET para recuperar el estado hasta que sea distinto de 2
:
https://graph.facebook.com/67890123456?fields=status
Si el estado es 1
(correcto), se puede conectar con un conjunto de anuncios o reservar.
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"}
Sondea el extremo siguiente mediante solicitudes HTTP GET para recuperar el estado hasta que sea distinto de 2
:
https://graph.facebook.com/<API_VERSION>/<PREDICTION_ID>?fields=status
Si el estado es 1
(correcto), se puede asociar con un conjunto de anuncios. Veamos a continuación 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 del 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 al 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>"