En esta guía se describe cómo crear y publicar anuncios de clic a Messenger con 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 dirigen a las personas que hacen clic en ellos directamente a conversaciones con tu empresa en Messenger. Utilízalos para llegar a personas a gran escala y ofrecer un servicio personalizado y destacado.
Los anuncios de clic a Messenger admiten anuncios con una imagen, un vídeo, una secuencia o una película. También puedes incluir invitaciones de llamada en el anuncio.
Si te interesa crear anuncios que dirijan a los usuarios a los chats de Instagram o WhatsApp, consulta Anuncios de clic a Instagram o Anuncios de clic a WhatsApp para obtener más información. También puedes crear anuncios que elijan el destino en el que es más probable que responda el usuario. Para obtener más información, consulta Anuncios de clic a varios destinos.
Para crear y publicar un anuncio deberás hacer lo siguiente:
En esta guía se presupone lo siguiente:
Para realizar correctamente llamadas a todos los extremos de esta guía, 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 extremo act_ad_account_id/campaigns
, donde ad_account_id es el identificador de la cuenta publicitaria de Meta. La solicitud debe incluir lo siguiente:
|
|
Referencia rápida sobre las campañas publicitarias
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 realiza correctamente, la aplicación recibe 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 extremo act_ad_account_id/adsets
, donde ad_account_id es el identificador de la cuenta publicitaria de Meta. La solicitud debe incluir lo siguiente:
access_token
bid_amount
billing_event
establecido en IMPRESSIONS
campaign_id
daily_budget
destination_type
establecido en MESSENGER
name
optimization_goal
establecido en CONVERSATIONS
o IMPRESSIONS
; o bien en LEAD_GENERATION
o QUALITY_LEAD
en el caso de los anuncios para clientes potenciales.promoted_object
establecido en el identificador de la página de Facebook de la empresa.status
establecido en PAUSED
.targeting
Referencia rápida sobre los conjuntos 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 la operación se realiza correctamente, la aplicación recibe la siguiente respuesta JSON con el identificador del conjunto de anuncios.
{ "id": "adset_id" }
El contenido del anuncio te permite añadir activos a los anuncios.
Limitaciones
|
Para crear el contenido del anuncio, envía una solicitud POST
al extremo /act_ad_account_id/adcreatives
, donde ad_account_id es el identificador de la cuenta publicitaria de Meta. La solicitud debe incluir lo siguiente:
access_token
name
object_story_spec
: obligatorio.privacy_url
: obligatorio para los anuncios para clientes potenciales.standard_enhancements.enroll_status
: obligatorio para el contenido de los anuncios que cumple los requisitos de las mejoras estándar. Referencia rápida sobre el parámetro de contenido del anuncio de nivel superior
Para crear el contenido del anuncio de un anuncio de clic a Messenger, envía una solicitud POST
al extremo /act_ad_account_id/adcreatives
, donde ad_account_id es el identificador de la cuenta publicitaria de Meta. La solicitud debe incluir lo siguiente:
access_token
name
object_story_spec
con un objeto *_data
que define el tipo de contenido multimedia.Referencia rápida sobre los anuncios con imágenes
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 sobre los anuncios con vídeo 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 procesos de aplicaciones de mensajes, consulta Procesos de mensajes de bienvenida en la documentación de la plataforma de Messenger.
El mensaje predeterminado que ve un cliente es “Hola. ¿Puedo obtener más información sobre esto?”. Si quieres crear experiencias de usuario más personalizadas para los anuncios con clic a Messenger, puedes adaptar el mensaje de saludo, las frases para romper el hielo y los mensajes de relleno automático de los anuncios en el campo page_welcome_message
en object_story_spec
.
Para obtener más información sobre las frases para romper el hielo, consulta la referencia de ice_breakers
.
Crea el objeto page_welcome_message
para añadir frases para romper el hielo con un mensaje de saludo.
"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 (CTS) son anuncios de clic a Messenger en los que object_story_spec.page_welcome_message
es una matriz de objetos con una plantilla de mensaje de notificación. Cuando una persona hace clic en el botón Recibir mensajes del anuncio, acepta recibir mensajes de marketing de tu empresa.
Para crear el contenido del anuncio de un anuncio de clic para suscribirse, envía una solicitud POST
al extremo /act_ad_account_id/adcreatives
, donde ad_account_id es el identificador de la cuenta publicitaria de Meta. La solicitud debe incluir lo siguiente:
access_token
name
object_story_spec
con
*_data
que define el tipo de contenido multimedia. page_welcome_message
que define la solicitud de activación de los mensajes de marketing. Debe incluir landing_screen_type
establecido en marketing_messages
y el archivo adjunto del mensaje payload.template_type
establecido en 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 permiten generar clientes potenciales en Messenger mediante una plantilla de chat automatizado. Puedes hacer preguntas concretas a las personas interesadas en tu empresa directamente en la plataforma de mensajes que prefieras, recopilar las preferencias de los clientes y hacer preguntas personalizadas para priorizar a los clientes potenciales mejor calificados.
Antes de crear el contenido del anuncio para anuncios de Messenger para clientes potenciales, debes aceptar los términos y condiciones de los anuncios de Messenger para clientes potenciales.
Para crear una plantilla de mensaje, envía una solicitud POST
al extremo /page_id/messenger_lead_forms
, donde page_id es el identificador de la página de Facebook de la empresa. La solicitud debe incluir lo siguiente:
access_token
privacy_url
step_list
que incluya message
, reply_type
, step_id
y step_type
template_name
reminder_text
La siguiente plantilla de mensaje incluye el valor de template_name
y de privacy_url
. También incluye un parámetro step_list
con un mensaje de bienvenida en step_id: 0
, preguntas desde step_id: 1
hasta 4
, un mensaje de confirmación en step_id: 5
y un mensaje de descalificación en step_id: 6
.
Referencia rápida sobre las plantillas de mensajes
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 correctamente, la aplicación recibirá un objeto JSON con el identificador de la plantilla.
{ "id": "your_messenger_lead_gen_template_id" }
Como parte de este proceso, también se crea un elemento fblead_form
y se asocia a la plantilla de mensaje.
Para obtener una lista de las plantillas de formularios de generación de clientes potenciales, envía una solicitud GET
al extremo /page_id/messenger_lead_forms
. También puedes obtener información sobre una plantilla determinada. Para ello, envía una solicitud GET
al extremo /
Your_messenger_lead_gen_template_id
.
Para crear el contenido del anuncio de un anuncio para clientes potenciales, envía una solicitud POST
al extremo /act_
ad_account_id
/adcreatives
, donde ad_account_id
es el identificador de la cuenta publicitaria de Meta. La solicitud debe incluir lo siguiente:
access_token
name
object_story_spec
con un objeto *_data
que defina el tipo de contenido multimedia (imagen o vídeo) y contenga lo siguiente:
*_data.page_welcome_message
establecido en el par de 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 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 formato postOwnerID_postID
y instagram_actor_id
es el 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, tienes que asociar el contenido del anuncio y el conjunto de anuncios. Para crear el anuncio, envía una solicitud POST
al extremo /act_ad_account_id/ads
, donde ad_account_id es el identificador de la cuenta de Meta. La solicitud debe incluir lo siguiente:
Referencia rápida sobre los 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 realiza correctamente, la aplicación recibe la siguiente respuesta JSON con el identificador del anuncio.
{ "id": "ad_id" }
También puedes establecer una llamada a la acción al crear el anuncio.
"call_to_action": { "value": {"app_destination":"MESSENGER"}, "type": "MESSAGE_PAGE" }
Verifica que el anuncio existe 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 para la campaña y el anuncio.
Puedes publicar el anuncio desde el Administrador de anuncios o mediante la API. Para publicar el anuncio mediante la API, repite el paso 4 con el parámetro status
establecido en ACTIVE
.
Meta revisará el anuncio y el estado será PENDING_REVIEW
. Una vez aprobado el anuncio, el estado cambiará a ACTIVE
y el anuncio se entregará.
Puedes crear mensajes que incluyan más de un elemento de mensaje, como una invitación de llamada o varias plantillas. Para añadir estos elementos, define una matriz de objetos para el valor *_data.page_welcome_message
en lugar de un valor de cadena.
Referencia rápida sobre la matriz del mensaje de bienvenida de la página
Para añadir una invitación de llamada en un anuncio de clic a Messenger, establece el valor de *_data.page_welcome_message
en una matriz de objetos que define los elementos de la invitación de llamada. Establece el parámetro landing_screen_type
en call_prompt
, media_type
en text
y el objeto text_format.message
con text
en el texto del mensaje de bienvenida. Por último, establece call_prompt_data.call_prompt_message
en la invitación para llamar a tu empresa.
... "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, establece el parámetro *_data.page_welcome_message
en una matriz con una plantilla de mensaje . El siguiente ejemplo muestra cómo añadir una plantilla para 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 aún no lo has hecho, configura los webhooks para recibir notificaciones cuando un usuario haga clic en el anuncio.
Obtén más información sobre la API de marketing y sobre opciones adicionales de clic a Messenger.