Plataforma de Messenger

Anuncios de clic a Messenger

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 con mayor probabilidad de respuesta del usuario. Para obtener más información, consulta Anuncios de clic a varios destinos.

Información general sobre la creación de anuncios

Para crear y publicar un anuncio deberás hacer lo siguiente:

  1. Crear una campaña publicitaria.
  2. Crear un conjunto de anuncios que vincule los anuncios con la campaña publicitaria.
  3. Crear contenido para el tipo de anuncio de Messenger que quieras mostrar.
  4. Crear un anuncio vinculando el contenido del anuncio con el conjunto de anuncios.
  5. Publicar el anuncio en Facebook, Instagram y Messenger.

Antes de empezar

En esta guía se presupone lo siguiente:

Para realizar correctamente llamadas a todos los extremos de esta guía, necesitarás lo siguiente:

  • Un identificador de acceso a la página solicitado por una persona que pueda realizar la tarea ADVERTIZE en la página.
  • El usuario de la aplicación debe conceder los siguientes permisos:
    • ads_management
    • pages_manage_ads
    • pages_read_engagement
    • pages_show_list

Paso 1. Crear una campaña

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:

  • access_token
  • buying_type
  • name
  • objective: establecido en OUTCOME_TRAFFIC, o en OUTCOME_LEADS en el caso de los anuncios para clientes potenciales
  • special_ad_categories
  • status

Referencia rápida sobre las campañas publicitarias

Solicitud de ejemplo

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus valores.
curl -X POST "https://graph.facebook.com/v24.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"
}

Paso 2. Crear un conjunto de anuncios

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

Solicitud de ejemplo

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus valores.
curl -X POST "https://graph.facebook.com/v24.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"
}

Paso 3. Crear el contenido del anuncio

El contenido del anuncio te permite añadir activos a los anuncios.

Limitaciones

  • No se admiten los anuncios creados mediante object_story_id.
  • La persona debe tener Messenger instalado en su dispositivo para ver el anuncio.
  • No se admiten las ubicaciones en el lado derecho.

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

Anuncios de clic a Messenger

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

Ejemplo de solicitud de un anuncio con imagen

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como page_access_token, por tus valores.
curl -X POST "https://graph.facebook.com/v24.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

Ejemplo de solicitud de un anuncio con vídeo

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como page_access_token, por tus valores.
curl -X POST "https://graph.facebook.com/v24.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"
             } 
           }
         }'

Anuncio que utiliza un proceso de mensajes configurado en una aplicación de socio

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como page_access_token, por tus valores.
curl -X POST "https://graph.facebook.com/v24.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.

Relleno del mensaje de bienvenida de la página

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 de 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.

Limitaciones

  • Los títulos de las frases para romper el hielo no deben tener más de 80 caracteres.
  • Las respuestas de las frases para romper el hielo no deben tener más de 300 caracteres.
  • El texto del mensaje no debe tener más de 300 caracteres.

Ejemplo

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"
}

Clic para suscribirse

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
    • un objeto *_data que define el tipo de contenido multimedia.
    • la matriz 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.

Ejemplo de solicitud de un anuncio con imagen

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus valores.
curl -X POST "https://graph.facebook.com/v24.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"
                             }]
                         }]
                       }
                     }
                   } 
                 }
               }"
             }
           }
         }'

Anuncios para clientes potenciales en las conversaciones

A partir de la versión 24.0, desaparece la capacidad de crear anuncios para clientes potenciales que generen clientes potenciales en Messenger con la API. Podrás seguir creando anuncios de Messenger para clientes potenciales con el Administrador de anuncios. Para obtener más información, consulta Crear anuncios para clientes potenciales de clic a Messenger y que dirigen a Instagram Direct en el Administrador de anuncios de Meta.

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.

Requisitos de las plantillas de mensajes

  • Un mensaje de bienvenida que saluda a las personas después de tocar el anuncio y les muestra qué ofrece la empresa.
  • Preguntas que recopilan información sobre si la persona es un cliente potencial. Esto puede incluir preguntas sobre sus intereses, su ubicación y su información de contacto, como su correo electrónico y su número de teléfono.
  • Un mensaje de confirmación que permite dar las gracias a la persona por sus respuestas y le informa sobre lo que va a ocurrir a continuación. Encontrarás el nuevo cliente potencial en el Administrador de anuncios, en la herramienta de publicación de la página o en tu CRM.
  • Una política de privacidad, ya que vas a recoger información sobre los clientes.

Limitaciones

  • Las plantillas de mensajes no se pueden editar ni eliminar una vez creadas.

Crear una plantilla de mensaje

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
  • Una matriz 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

Ejemplo de plantilla de mensaje para clientes potenciales

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como page_access_token, por tus valores.
curl -X POST "https://graph.facebook.com/v24.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.

Obtener una lista de formularios

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.

Ejemplos de contenido del anuncio

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:
    • El parámetro *_data.page_welcome_message establecido en el par de clave-valor.
      • ctm_lead_gen_template_id:Your_messenger_lead_gen_template_id

Ejemplo de contenido del anuncio para anuncios de Messenger para clientes potenciales con una imagen

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus valores.
curl -X POST "https://graph.facebook.com/v24.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" }"
            }
          }
       }'

Ejemplo de contenido del anuncio para anuncios de Messenger para clientes potenciales con un vídeo

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus valores.
curl -X POST "https://graph.facebook.com/v24.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" 
            }
          }
       }'

Creación de contenido de anuncios con contenido de Instagram

Publicaciones de Instagram

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/v24.0/act_<AD_ACCOUNT_ID>/adcreatives

Imágenes de Instagram

curl -X POST \
  -F 'name=Sample ad creative from Instagram image' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_user_id": "<IG_USER_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/v24.0/act_<AD_ACCOUNT_ID>/adcreatives

Creación de contenido de anuncios con contenido de Facebook

Consulta Usar publicaciones como anuncios de Instagram: publicaciones de Facebook para obtener más información.

curl -i -X POST \
  "https://graph.facebook.com/v24.0/act_<AD_ACCOUNT>/adcreatives
  ?object_story_id=<postOwnerID_postID>
  &instagram_user_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 con el formato de postOwnerID_postID e instagram_user_id es el identificador de una 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.

Añadir extensiones de productos a clic a Messenger

¿Que es el clic a Messenger con extensiones de productos?

Las extensiones de productos (la función “Mostrar producto” en el Administrador de anuncios de Meta) son una optimización de contenido de Advantage+ que muestra los productos de tu catálogo debajo del contenido multimedia único estático cuando es probable que mejore el rendimiento. En este documento se muestra cómo usar las funciones de extensiones de productos en los anuncios de clic a Messenger. Si quieres obtener más información sobre cómo añadir extensiones de productos para anuncios que no sean de clic a Messenger, consulta esta página.

Referencia

Anuncios de clic a Messenger
Extensiones de productos para contenido de Advantage+

Criterios de elegibilidad

  • Debes tener un catálogo conectado a una tienda en Facebook.
  • El catálogo debe tener al menos un producto.
  • La campaña debe tener el objetivo OUTCOME_ENGAGMENET, OUTCOME_LEAD,OUTCOME_SALES o LINK_CLICK.
  • Debes tener un anuncio con formato de imagen o vídeo único o cuyo contenido sea una publicación existente de Facebook.

Crear con una imagen única

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus valores.
curl -X POST "https://graph.facebook.com/v24.0/act_ad_account_id/ads"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token",
           "creative_sourcing_spec": {
              "associated_product_set_id": "Your_associated_product_set_id"
            },
            "degrees_of_freedom_spec": {
              "creative_features_spec": {
                "product_extensions": {
                   "enroll_status": "OPT_IN"
                }
              }
            },
            "object_story_spec": {
              "page_id": Your_facebook_page_id",
              "link_data": {
                "call_to_action": {
                  "type": "MESSAGE_PAGE",
                  "value": {
                    "app_destination": "MESSENGER"
                  }
                },
                "image_hash":"Your_image_hash", (or “picture”: "Your_picture_url")"
                "link": "https://fb.com/messenger_doc/",
                "name": "Chat in Messenger"
              },
              "product_data": [
                {
                  "product_id": Your_product_id_1",
                  "product_source": "MANUAL",
		"product_decision": "ACCEPT"
                },
                {
                  "product_id":Your_product_id_2",
                  "product_source": "MANUAL",
		"product_decision": "ACCEPT"
                }
              ]
            }

Crear con un vídeo único

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus valores.
curl -X POST "https://graph.facebook.com/v24.0/act_ad_account_id/ads"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token",
           "creative_sourcing_spec": {
              "associated_product_set_id": "Your_associated_product_set_id"
            },
            "degrees_of_freedom_spec": {
              "creative_features_spec": {
                "product_extensions": {
                   "enroll_status": "OPT_IN"
                }
              }
            },
            "object_story_spec": {
              "page_id": "Your_facebook_page_id",
              "video_data": {
                "video_id":"Your_video_id"",
                "video_thumbnail_id": "0",
                "call_to_action": {
                  "type": "MESSAGE_PAGE",
                  "value": {
                    "app_destination": "MESSENGER",
                    "link": "https://fb.com/messenger_doc/"
                  }
                },
                "image_url": "Your_image_url",
                "title": "Chat in Messenger",
                "video_thumbnail_source": "generated_default"
              },

              "product_data": [
                {
                  "product_id": Your_product_id_1",
                  "product_source": "MANUAL",
		"product_decision": "ACCEPT"
                },
                {
                  "product_id":Your_product_id_2",
                  "product_source": "MANUAL",
		"product_decision": "ACCEPT"
                }
              ]
            }

Crear con una publicación existente de Facebook con el tipo de contenido multimedia de foto o vídeo

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus valores.
curl -X POST "https://graph.facebook.com/v24.0/act_ad_account_id/ads"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token",
           "object_story_id": "Your_object_story_id(pageID_postID)",
           "creative_sourcing_spec": {
              "associated_product_set_id": "Your_associated_product_set_id"
            },
            "degrees_of_freedom_spec": {
              "creative_features_spec": {
                "product_extensions": {
                  "enroll_status": "OPT_IN"
                },
                "multi_photo_to_video": {
                  "enroll_status": "OPT_IN"
                }
              }
            },
            "product_data": [
              {
                "product_id": Your_product_id_1",
                "product_source": "MANUAL",
		"product_decision": "ACCEPT"
              },
              {
                "product_id":Your_product_id_2",
                "product_source": "MANUAL",
		"product_decision": "ACCEPT"
              }
            ]
          }

Crear con una publicación existente de Facebook con un tipo de contenido multimedia de álbum

En el caso de las publicaciones con varias fotos, se añadirán extensiones de productos después de convertir las distintas fotos en un vídeo.
Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus valores.
curl -X POST "https://graph.facebook.com/v24.0/act_ad_account_id/ads"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token",
           "object_story_id": "Your_object_story_id(pageID_postID)",
           "creative_sourcing_spec": {
              "associated_product_set_id": "Your_associated_product_set_id"
            },
            "degrees_of_freedom_spec": {
              "creative_features_spec": {
                "product_extensions": {
                   "enroll_status": "OPT_IN"
                }
              }
            },
            "product_data": [
              {
                "product_id": Your_product_id_1",
                "product_source": "MANUAL"
		"product_decision": "ACCEPT"
              },
              {
                "product_id":Your_product_id_2",
                "product_source": "MANUAL"
		"product_decision": "ACCEPT"
              }
            ]
          }

Paso 4. Crear el anuncio

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:

  • access_token
  • adset_id (del paso 2)
  • creative_id (del paso 3)
  • name
  • status

Referencia rápida sobre los anuncios de cuentas publicitarias

Ejemplo de solicitud de un anuncio con contenido

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus valores.
curl -X POST "https://graph.facebook.com/v24.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"
}

Llamada a la acción

También puedes establecer una llamada a la acción al crear el anuncio.

"call_to_action": {
  "value": {"app_destination":"MESSENGER"},
  "type": "MESSAGE_PAGE"
}

Paso 5. Publicar el anuncio

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á.

Elementos avanzados del clic a Messenger

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

Añadir una invitación de llamada

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.

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como page_access_token, por tus valores.
... 
      "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"
              }
            }
          },
        }
      ]"
...

Añadir una o más plantillas

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.

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como page_access_token, por tus valores.
... 
      "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  '
            }
          ]
        }
      }]",
...

Pasos siguientes

Si aún no lo has hecho, configura los webhooks para recibir notificaciones cuando un usuario haga clic en el anuncio.

Más información

Obtén más información sobre la API de marketing y sobre opciones adicionales de clic a Messenger.

API de marketing

Plataforma de Messenger