En esta guía, se explica cómo crear y publicar anuncios de clic a Messenger mediante la API de marketing.
Si quieres usar el administrador de anuncios para crear una campaña de anuncios para clientes potenciales, visita el servicio de ayuda de Meta para empresas.
Los anuncios de clic a Messenger redireccionan a las personas que hacen clic en ellos directamente una conversación con tu negocio en Messenger. Usa estos anuncios para llegar a las personas a gran escala y ofrecer un servicio personalizado de calidad.
Los anuncios de clic a Messenger admiten anuncios con una imagen, un video, una secuencia o una presentación. También puedes incluir plantillas de llamada en el anuncio.
Si te interesa crear anuncios que dirijan a las personas a chats de Instagram o WhatsApp, consulta Anuncios de clic a Instagram o Anuncios de clic a WhatsApp para obtener ayuda. También puedes crear anuncios que elijan el destino desde el que es más probable que el usuario responda. Consulta Anuncios de clic a varios destinos para obtener más información.
Para crear y publicar un anuncio, deberás realizar las siguientes acciones:
En esta guía, se da por sentado que tienes con lo siguiente:
Para que las llamadas que se realizan a los puntos de conexión que se mencionan en esta guía se efectúen correctamente, necesitarás lo siguiente:
ADVERTIZE
en la página.ads_management
pages_manage_ads
pages_read_engagement
pages_show_list
Para crear una campaña publicitaria, envía una solicitud POST
al punto de conexión act_ad_account_id/campaigns
, donde ad_account_id es el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:
|
|
Referencia rápida de la campaña publicitaria
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/campaigns" \
-H "Content-Type: application/json" \
-d '{
"access_token":"Your_page_access_token",
"buying_type":"AUCTION",
"name":"Messenger_ad_campaign_name",
"objective":"OUTCOME_TRAFFIC",
"status":"PAUSED",
"special_ad_categories":["NONE"],
}'
Si la operación se procesa correctamente, la app recibirá una respuesta JSON con el identificador de la campaña.
{ "id": "campaign_id" }
Para crear un conjunto de anuncios, envía una solicitud POST
al punto de conexión act_ad_account_id/adsets
, donde ad_account_id es el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:
access_token
bid_amount
billing_event
configurado como IMPRESSIONS
campaign_id
daily_budget
destination_type
configurado como MESSENGER
name
optimization_goal
configurado en CONVERSATIONS
, IMPRESSIONS
o LEAD_GENERATION
o QUALITY_LEAD
para clientes potencialespromoted_object
configurado como el identificador de la página de Facebook de tu negocio.status
configurado como PAUSED
targeting
Referencia rápida del conjunto de anuncios
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/adsets"
-H "Content-Type: application/json"
-d '{
"access_token":"Your_page_access_token",
"bid_amount":"Your_bid_amount",
"billing_event":"IMPRESSIONS",
"campaign_id":"Your_campaign_id",
"daily_budget":"Your_daily_budget",
"destination_type":"MESSENGER",
"name:"Your_messenger_adset_name",
"optimization_goal:IMPRESSIONS",
"status:PAUSED",
"targeting":{
"geo_locations": { "countries":["US","CA"] },
"device_platforms": ["mobile", "desktop"],
"publisher_platforms": ["messenger"]
}
}'
Si se envía correctamente, tu app recibirá la siguiente respuesta JSON con el identificador del conjunto de anuncios.
{ "id": "adset_id" }
El contenido del anuncio te permite agregar activos a los anuncios.
Limitaciones
|
Para crear el contenido de un anuncio, envía una solicitud POST
al punto de conexión /act_ad_account_id/adcreatives
, donde ad_account_id es el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:
access_token
name
object_story_spec
: obligatorio.privacy_url
: obligatorio en el caso de los anuncios para clientes potenciales.standard_enhancements.enroll_status
: obligatorio en el caso del contenido de anuncios que cumplen con los requisitos para las mejoras estándar. Referencia rápida destacada del parámetro del contenido del anuncio
Para crear el contenido de un anuncio de clic a Messenger, envía una solicitud POST
al punto de conexión /act_ad_account_id/adcreatives
, donde ad_account_id es el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:
access_token
name
object_story_spec
con un objeto *_data
que define el tipo de contenido multimedia.Referencia rápida del anuncio con imagen
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/adcreatives"
-H "Content-Type: application/json"
-d '{
"access_token":"page_access_token",
"name":"Your_CTM_image_ad_name",
"object_story_spec":{
"page_id": "your_page_id",
"link_data": {
"page_welcome_message": "Your_welcome_message",
"image_hash": "Your_image_hash",
"link": "Your_image_URL",
"call_to_action": {
"type":"LEARN_MORE",
"value":{ "app_destination":"MESSENGER" }
}
}
}
}'
Referencia rápida del anuncio con video de clic a Messenger
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/adcreatives"
-H "Content-Type: application/json"
-d '{
"access_token": "page_access_token",
"name": "Your_CTM_image_ad_name",
"object_story_spec": {
"page_id": "your_page_id",
"video_data": {
"call_to_action": {
"type": "LEARN_MORE",
"value": { "app_destination": "MESSENGER" }
},
"link_description": "Your_link_description",
"image_url": "Your_thumbnail_URL",
"page_welcome_message": "Your_welcome_text",
"video_id": "video_id"
}
}
}'
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/adcreatives"
-H "Content-Type: application/json"
-d '{
"access_token": "page_access_token",
"name": "Your_CTM_image_ad_name",
"object_story_spec": {
"page_id": "your_page_id",
"link_data": {
"image_hash": "your_image_hash",
"link": "your_image_URL",
"call_to_action": {
"type": "MESSAGE_PAGE",
"value": { "app_destination":"MESSENGER" }
}
}
},
"asset_feed_spec": {
"additional_data": {
"partner_app_welcome_message_flow_id": "FLOW-ID"
}
}
}'
Para obtener más información sobre los flujos de la app de mensajes, consulta flujos de mensajes de bienvenida en la documentación de la plataforma de Messenger.
El mensaje predeterminado que ve el cliente es "¡Hola! Quiero más información.". Puedes crear mejores experiencias del usuario más personalizadas para tus anuncios de clic Messenger si personalizas el mensaje de bienvenida, los mensajes para empezar una conversación y los mensajes de autocompletar del anuncio en el campo page_welcome_message
en object_story_spec
.
Para obtener más información sobre los mensajes para empezar una conversación, consulta la referencia sobre ice_breakers
Crea el objeto page_welcome_message
para agregar mensajes para empezar una conversación con un mensaje de bienvenida.
"page_welcome_message": { "type":"VISUAL_EDITOR", "version":2, "landing_screen_type":"welcome_message", "media_type":"text", "text_format":{ "customer_action_type":"ice_breakers", "message":{ "ice_breakers":[ {"title":"Can I make a purchase?","response":"This is a response 1"}, {"title":"Can I see a menu?", "response":"This is a response 2"}, {"title":"Where are you located?", "response":"This is a response 3"}], "quick_replies":[], "text":"Hi {{user_first_name}}! Please let us know how we can help you."} }, "user_edit":false, "surface":"visual_editor_new" }
Los anuncios de clic para suscribirse son anuncios de clic a Messenger en los cuales object_story_spec.page_welcome_message
es una matriz de objetos con una plantilla de mensajes de notificación. Cuando una persona hace clic en el botón Recibir mensajes de tu anuncio, acepta recibir mensajes de marketing de tu negocio.
Para crear el contenido de un anuncio de clic para suscribirse, envía una solicitud POST
al punto de conexión /act_ad_account_id/adcreatives
, donde ad_account_id es el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:
access_token
name
object_story_spec
con los siguientes elementos:
*_data
que define el tipo de contenido multimedia. page_welcome_message
que define la solicitud de suscripción a los mensajes de marketing. Debe incluir el valor landing_screen_type
configurado como marketing_messages
y el archivo adjunto al mensaje payload.template_type
configurado como nofitication_messages
.
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/adcreatives"
-H "Content-Type: application/json"
-d '{
"access_token": "page_access_token",
"name": "Your_CTS_image_ad_name",
"object_story_spec": {
"page_id": "your_page_id",
"link_data": {
"image_hash": "Your_image_hash",
"link": "Your_image_URL",
"call_to_action": {
"type": "LEARN_MORE",
"value":{ "app_destination": "MESSENGER" }
}
"page_welcome_message": "{
"landing_screen_type": "marketing_messages",
"media_type": "image",
"image_format": {
"customer_action_type": "buttons",
"message": {
"text": "Your_welcome_message",
"attachment": {
"type": "template",
"payload":{
"template_type":"notification_messages",
"elements": [{
"title": "Your_CTS_title",
"subtitle": "Your_CTS_subtitle",
"image_url": "Your_image_URL",
"app_id": "Your_Meta_app_ID",
"buttons": [{
"type": "postback",
"payload": "Data_to_include_in_webhook_notification",
"title": "Get messages"
}]
}]
}
}
}
}
}"
}
}
}'
Los anuncios de Messenger para clientes potenciales te permiten generar clientes potenciales en Messenger mediante una plantilla de chat automática. Puedes hacer preguntas concretas a las personas que están interesadas en tu negocio directamente en la plataforma de mensajería que elijas, reunir las preferencias de los clientes y hacer preguntas personalizadas para dar prioridad a los clientes potenciales más calificados.
Antes de crear contenido para anuncios de Messenger para clientes potenciales, debes aceptar las Condiciones de los anuncios de Messenger para clientes potenciales .
Para crear una plantilla de mensaje, envía una solicitud POST
al punto de conexión /page_id/messenger_lead_forms
, donde page_id es el identificador de la página de Facebook de tu empresa. En la solicitud, debes incluir los siguientes parámetros:
access_token
privacy_url
step_list
que incluye message
, reply_type
, step_id
y step_type
template_name
reminder_text
La siguiente plantilla de mensaje incluye tu template_name
, privacy_url
, step_list
con un mensaje de bienvenida en step_id: 0
, preguntas de step_id: 1
para 4
, un mensaje de confirmación en step_id: 5
y un mensaje de descalificación en step_id: 6
.
Referencia rápida de la plantilla de mensaje
curl -X POST "https://graph.facebook.com/v21.0
/your_page_ID/messenger_lead_forms"
-H "Content-Type: application/json"
-d '{
"access_token": "Your_page_access_token",
"privacy_url": "Your_privacy_policy_URL",
"reminder_text": "Your_reminder_text",
"template_name": "Your_template_name",
"step_list": [
{
"step_id": "0",
"message": "Your_welcome_message",
"step_type": "INTRO",
"reply_type": "NONE",
"next_step_ids": "1"
},
{
"step_id": "1"
"message": "Are_you_interested_in_our_products_or_services?",
"step_type": "QUESTION",
"reply_type": "QUICK_REPLIES",
"answers": ["Yes", "Not now", "Maybe"],
"next_step_ids": [2,6,2],
"allow_to_skip": false,
"answer_validation_enabled": true
},
{
"step_id": "2",
"message": "What city do you live in?",
"step_type": "QUESTION",
"reply_type": "PREFILL",
"prefill_type": "CITY",
"next_step_ids": "3",
"allow_to_skip": true
},
{
"step_id": "3",
"message": "What is your phone number?",
"step_type": "QUESTION",
"reply_type": "PREFILL",
"prefill_type": "PHONE",
"next_step_ids": "4",
"allow_to_skip": false,
"answer_validation_enabled": true
},
{
"step_id": "4",
"message": "What is your email address?",
"step_type": "QUESTION",
"reply_type": "PREFILL",
"prefill_type": "EMAIL",
"next_step_ids": "5",
"allow_to_skip": false,
"answer_validation_enabled": true
},
{
"step_id": "5",
"message": "Your_confirmation_message",
"step_type": "CONFIRMATION",
"reply_type": "NONE"
},
{
"step_id": "6",
"message": "Your_disqualification_message",
"step_type": "DISQUALIFY",
"reply_type": "NONE"
}
]
}'
Si la operación se realiza con éxito, la app recibirá un objeto JSON que contiene el identificador de la plantilla.
{ "id": "your_messenger_lead_gen_template_id" }
Un fblead_form
también se crea y se asocia con la plantilla de mensaje como parte de este proceso.
Para obtener una lista de la generación de clientes potenciales de Messenger a partir de plantillas, puedes enviar una solicitud GET
al punto de conexión /page_id/messenger_lead_forms
. También puedes obtener información sobre una plantilla especifica si envías una solicitud GET
al punto de conexión /
Your_messenger_lead_gen_template_id
.
Para crear el contenido de los anuncios para clientes potenciales, envía una solicitud POST
al punto de conexión /act_
ad_account_id
/adcreatives
, donde ad_account_id
es el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:
access_token
name
object_story_spec
con un objeto *_data
que defina el tipo de contenido multimedia, imagen o video, y que contenga lo siguiente:
*_data.page_welcome_message
configurado en el par clave-valor
ctm_lead_gen_template_id:
Your_messenger_lead_gen_template_id
curl -X POST "https://graph.facebook.com/v21.0
/act_AD_ACCOUNT_ID/adcreatives"
-H "Content-Type: application/json"
-d '{
"access_token": "Your_page_access_token",
"degrees_of_freedom_spec": {
"creative_features_spec": {
"standard_enhancements": { "enroll_status": "OPT_IN" }
}
},
"name": "Your_lead_ad_image_ad_name",
"object_story_spec": {
"page_id": "Your_page_id",
"link_data": {
"call_to_action": {
"type": "MESSAGE_PAGE",
"value": { "app_destination": "MESSENGER" }
},
"description": "Sample_description",
"image_hash": "Your_image_hash",
"message": "Sample_message_for_Creative",
"page_welcome_message": "{ "ctm_lead_gen_template_id": "Your_messenger_lead_gen_template_id" }"
}
}
}'
curl -X POST "https://graph.facebook.com/v21.0
/act_AD_ACCOUNT_ID/adcreatives"
-H "Content-Type: application/json"
-d '{
"access_token": "Your_page_access_token",
"degrees_of_freedom_spec": {
"creative_features_spec": {
"standard_enhancements": { "enroll_status": "OPT_IN" }
}
},
"name": "Your_lead_ad_video_ad_name",
"object_story_spec": {
"page_id": "your_page_id",
"video_data": {
"call_to_action": {
"type": "MESSAGE_PAGE",
"value":{ "app_destination": "MESSENGER" }
},
"image_url": "Your_thumbnail_url",
"link_description": "Your_link_description ",
"message": "Sample message for Creative ",
"page_welcome_message": "{ "ctm_lead_gen_template_id": "Your_messenger_lead_gen_template_id" }",
"video_id": "Your_video_id"
}
}
}'
Consulta Usar publicaciones de Instagram como anuncios de Instagram para obtener más información.
curl -X POST \
-F 'name=Sample ad creative from Instagram post' \
-F 'object_id=<PAGE_ID>' \
-F 'instagram_user_id=<INSTAGRAM_USER_ID>' \
-F 'source_instagram_media_id=<INSTAGRAM_POST_ID>' \
-F 'call_to_action={
"type": "INSTAGRAM_MESSAGE",
"value": {
"link": "https://www.instagram.com"
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
curl -X POST \
-F 'name=Sample ad creative from Instagram image' \
-F 'object_story_spec={
"page_id": "<PAGE_ID>",
"instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
"link_data": {
"message": "<AD_PRIMARY_TEXT>",
"picture": "<IMAGE_URL>"
"page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
"call_to_action": {
"type": "INSTAGRAM_MESSAGE",
"value": {
"app_destination": "INSTAGRAM_DIRECT"
}
}
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
Consulta Usar publicaciones como anuncios de Instagram: publicaciones de Facebook para obtener más información.
curl -i -X POST \
"https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT>/adcreatives
?object_story_id=<postOwnerID_postID>
&instagram_actor_id=<IG_USER_ID>
&call_to_action="{'type':MESSAGE_PAGE,'value':{'app_destination':'MESSENGER'}}"
&access_token=<ACCESS_TOKEN>"
Donde object_story_id
es el identificador de la publicación en el formato de postOwnerID_postID
y instagram_actor_id
es un identificador de la cuenta de Instagram conectada a la página o el identificador de la cuenta de Instagram respaldada por la página. Consulta más información en Configurar cuentas de Instagram con páginas.
Para crear el anuncio, debes asociar su contenido y el conjunto de anuncios. Para crear el anuncio, envía una solicitud POST
al punto de conexión /act_ad_account_id/ads
, donde ad_account_id es el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:
Referencia rápida de anuncios de cuentas publicitarias
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/ads"
-H "Content-Type: application/json"
-d '{
"access_token": "Your_page_access_token",
"adset_id": "Your_ad_set_id",
"creative": { "creative_id": "Your_ad_creative_id" },
"status": "PAUSED"
}'
Si la operación se procesa correctamente, tu app recibirá la siguiente respuesta JSON con el identificador del anuncio.
{ "id": "ad_id" }
También puedes configurar una llamada a la acción cuando crees tu anuncio.
"call_to_action": { "value": {"app_destination":"MESSENGER"}, "type": "MESSAGE_PAGE" }
Verifica que el anuncio esté en el administrador de anuncios. Haz clic en el botón Revisar y publicar, en la esquina superior derecha. Selecciona la campaña, el conjunto de anuncios de la campaña y el anuncio.
Puedes publicar el anuncio desde el administrador de anuncios o mediante la API. Para publicarlo mediante la API, repite el paso 4 con el parámetro status
configurado como ACTIVE
.
Meta revisará el anuncio y el estado será PENDING_REVIEW
. Una vez aprobado, el estado será ACTIVE
, y se entregará el anuncio.
Puedes crear mensajes que incluyan más de un elemento de mensaje, como una plantilla de llamada o varias plantillas. Para agregar estos elementos, debes configurar una matriz de objetos correspondientes al valor *_data.page_welcome_message
en lugar del valor de una cadena.
Referencia rápida de la matriz de mensajes de bienvenida de la página
Puedes agregar una plantilla de llamada al anuncio de clic a Messenger. Para eso, debes configurar el valor de *_data.page_welcome_message
como una matriz de objetos que definen los elementos de la plantilla de llamada. Configura el parámetro landing_screen_type
como call_prompt
, media_type
como text
, el objeto text_format.message
con text
como texto del mensaje de bienvenida, y call_prompt_data.call_prompt_message
como una plantilla para llamar a tu negocio.
... "page_welcome_message": "[ { "landing_screen_type": "call_prompt", "media_type": "text", "text_format": { "message": { "text": "Your_welcome_message", "call_prompt_data": { "call_prompt_message": "Your_call_prompt_message" } } }, } ]" ...
Para crear un anuncio con varias plantillas, configura el parámetro *_data.page_welcome_message
como una matriz con una plantilla de mensaje . En el siguiente ejemplo, se agrega una plantilla de una respuesta rápida.
... "page_welcome_message": "[{ 'message': { 'text':' Your_question_or_directive ', 'quick_replies':[ { 'content_type':'text', 'title':' Option_1 ', 'payload':' Option_1_information_for_webhook ' }, { 'content_type':'text', 'title':' Option_2 ', 'payload':' Option_2_information_for_webhook ' }, { 'content_type':'text', 'title':' Option_3 ', 'payload':' Option_3_information_for_webhook ' } ] } }]", ...
Si todavía no lo hiciste, configura webhooks para recibir notificaciones cuando una persona haga clic en tu anuncio.
Obtén más información sobre la API de marketing y las opciones adicionales relacionadas con los anuncios de clic a Messenger.