Anuncios de clic a Messenger

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

curl -X POST "https://graph.facebook.com/v19.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

curl -X POST "https://graph.facebook.com/v19.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

curl -X POST "https://graph.facebook.com/v19.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.

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

curl -X POST "https://graph.facebook.com/v19.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

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.

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

curl -X POST "https://graph.facebook.com/v19.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

curl -X POST "https://graph.facebook.com/v19.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

curl -X POST "https://graph.facebook.com/v19.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" 
            }
          }
       }' 

Mensajes publicitarios

Los mensajes publicitarios son un tipo de anuncio que se puede enviar como mensaje a todas las cuentas del Centro de cuentas que tengan una conversación de Messenger existente con la página de Facebook de tu empresa. También puedes incluir otros criterios de segmentación, como datos demográficos‎, datos geográficos, audiencias personalizadas o intereses. Requisitos No utilices las audiencias personalizadas para evitar que los usuarios reciban mensajes publicitarios patrocinados. El valor de targeting.publisher_platforms solo puede ser messenger. El valor de targeting.messenger_positions solo puede ser sponsored_messages. El valor de targeting.device_platforms debe ser mobile y desktop. El valor de promoted_object debe ser el identificador de la página de Facebook de la empresa. Debes especificar una carga útil o una dirección URL para el botón. Debes proporcionar opciones en la conversación para no activar los mensajes o para bloquearlos tanto en ordenadores como en dispositivos móviles. Limitación Solo se admiten CPM con billing_event=IMPRESSIONS y optimization_goal=IMPRESSIONS. La puja mínima varía según el país. Más información. Solo se admiten texto o imágenes con los botones, o respuestas rápidas.

Para crear el contenido del anuncio de un mensaje publicitario, la solicitud debe incluir el parámetro object_id establecido en el identificador de la página de Facebook, el parámetro object_type establecido en SHARE, el objeto messenger_sponsored_message con el parámetro message.text establecido en el texto del anuncio y el objeto message.attachment con los parámetros siguientes:

Referencia rápida sobre los archivos adjuntos de los mensajes publicitarios de Messenger

Ejemplo de solicitud de contenido del anuncio con imágenes

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token"
           "object_id": "Your_page_id",
           "object_type": "SHARE",
           "messenger_sponsored_message": {
             "message":{
               "text":"Your_ad_creative_text",
               "attachment":{
                 "type":"template",   
                 "payload":{
                   "template_type":"generic", 
                   "elements":[{
                     "title":"Your_image_text",
                     "image_hash":"Your_image_hash",
                     "buttons":[{
                       "type":"web_url", 
                       "title":"Your_button_text", 
                       "url":"Your_destination_URL"
                     }]
                   }]
                 }
               }
             }
           }
         }'

Ejemplo de solicitud de contenido del anuncio con respuesta rápida

Para crear un mensaje publicitario con un mensaje de respuesta rápida, define el objeto messenger_sponsored_message.message con el valor de text establecido en la pregunta o directiva, y una matriz quick_replies para cada opción de respuesta rápida.

curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token"
           "object_id": "Your_page_id",
           "object_type": "SHARE",
           "messenger_sponsored_message": {
             "message":{
               "text":"Your_ad_creative_text",
               "quick_replies":[
                 {
                   "content_type": "text",
                   "title": "Your_reply_first_option_reply",
                   "payload": "Information_sent_via_postback_webhook_when_option_1_is_selected"
                 },
                 {
                   "content_type": "text",
                   "title": "Your_reply_second_option_reply",
                   "payload": "Information_sent_via_postback_webhook_when_option_2_is_selected"
                 }
               ]              
             }
           }'