Anuncios de clic a varios destinos

En esta guía se describe cómo crear y publicar anuncios de clic a varios destinos con la API de marketing.

Los anuncios de clic a varios destinos envían a las personas que hacen clic en ellos directamente a conversaciones con tu empresa en la aplicación o aplicaciones de mensajes (Messenger, Instagram o WhatsApp) desde las que es más probable que respondan. Utilízalos para llegar a personas a gran escala y ofrecer un servicio personalizado y destacado.

Los anuncios de varios destinos implican que el anuncio puede dirigirse a cualquier combinación de destinos: chat de Messenger, chat de Instagram o chat de WhatsApp.

Si quieres crear un anuncio que solo se dirija a un destino, consulta:

• Anuncios de clic a Messenger
• Anuncios de clic a Instagram
• Anuncios de clic a WhatsApp

Información general sobre la creación de anuncios

En este documento se describen los pasos que tienes que seguir si quieres configurar la integración para los anuncios de clic a varios destinos. Necesitarás 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 varios destinos que quieras mostrar.
4. Crear un anuncio vinculando el contenido del anuncio con el conjunto de anuncios.

Antes de empezar

En esta guía se presupone lo siguiente:

• Tienes una cuenta publicitaria con Meta.
• Has subido a los servidores de Meta todos los activos (como fotos o vídeos) que vas a utilizar en los anuncios.

Paso 1: Crear una campaña publicitaria

Para empezar, crea una campaña publicitaria. Para ello, realiza 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:

Parámetros

Solicitud

curl -X POST \
  -F 'name=Click to Multi Destination Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Respuesta

Si la operación se realiza correctamente, la aplicación recibe una respuesta JSON con el identificador de la campaña recién creada.

{
  "id": "<AD_CAMPAIGN_ID>"
}

Actualización

Puedes realizar una solicitud POST a /<AD_CAMPAIGN_ID> para actualizar una campaña.

Lectura

Para comprobar que hayas creado correctamente un campaña de clic a varios destinos, puedes realizar una solicitud GET a /<AD_CAMPAIGN_ID>. Consulta la referencia sobre campañas publicitarias para obtener una lista completa de los parámetros disponibles.

Solicitud

curl -X GET -G \
  -d 'fields=name,status,objective' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CAMPAIGN_ID>

Respuesta

{
  "name": "Click to Multi Destination Campaign",
  "status": "ACTIVE",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_CAMPAIGN_ID>"
}

Paso 2: Crear un conjunto de anuncios

Cuando tengas una campaña publicitaria, crea el conjunto de anuncios. Para crear un conjunto de anuncios, realiza 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:

Parámetros

Consulta la referencia sobre conjuntos de anuncios de cuentas publicitarias para obtener una lista completa de los parámetros disponibles.

Solicitud

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=<DAILY_BUDGET>' \
  -F 'destination_type=<DESTINATION_TYPE>' \
  -F 'name=<AD_SET_NAME>' \
  -F 'optimization_goal=CONVERSATIONS' \
  -F 'promoted_object={
      "page_id": "<PAGE_ID>"
    }' \
  -F 'status=ACTIVE' \
  -F 'start_time=<START_TIME>' \
  -F 'targeting={ 
        "geo_locations": { "countries":["US","CA"] },
        "device_platforms": ["mobile", "desktop"]
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

Respuesta

Si la operación se realiza correctamente, la aplicación recibe una respuesta JSON con el identificador del conjunto de anuncios recién creado.

{
  "id": "<AD_SET_ID>"
}

Actualización

Puedes realizar una solicitud POST a /<AD_SET_ID> para actualizar un conjunto de anuncios.

Lectura

Para comprobar que hayas creado correctamente un conjunto de anuncios de clic a varios destinos, puedes realizar una solicitud GET a /<AD_SET_ID>. Consulta la referencia sobre conjuntos de anuncios para obtener una lista completa de los parámetros disponibles.

Solicitud

curl -X GET -G \
  -d 'fields=name,destination_type,optimization_goal,bid_strategy' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_SET_ID>

Respuesta

{
  "name": "<AD_SET_NAME>",
  "destination_type": "<DESTINATION_TYPE>",
  "optimization_goal": "CONVERSATIONS",
  "bid_strategy": "LOWEST_COST_WITHOUT_CAP'"
  "id": "<AD_SET_ID>"
}

Paso 3: Crear el contenido del anuncio

El contenido del anuncio te permite añadir activos a los anuncios. Para crear el contenido del anuncio, realiza 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:

Parámetros

{
  "type": "MESSAGE_PAGE",
    "value": {
       "app_destination": "MESSENGER",
       "link": "https://fb.com/messenger_doc/"
    }
} 

{
  "type": "WHATSAPP_MESSAGE",
    "value": {
       "app_destination": "WHATSAPP",
       "link": "https://api.whatsapp.com/send"
    }
}

{
  "type": "INSTAGRAM_MESSAGE",
    "value": {
       "app_destination": "INSTAGRAM_DIRECT",
       "link": "https://www.instagram.com"
    }
}

Consulta la referencia sobre el contenido del anuncio para obtener una lista completa de los parámetros disponibles.

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 varios destinos, 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"
}

Ejemplos de creación de contenido del anuncio

Añade el campo page_welcome_message al contenido de la siguiente forma.

Solicitud

curl -X POST \
-F 'name=<CREATIVE_NAME>' \
-F 'object_story_spec={
     "page_id": "438346666550309",
     "link_data": {
       "name": "<AD_HEADLINE>",
       "message": "<AD_PRIMARY_TEXT>",
       "image_hash": "<IMAGE_HASH>"
       "link": "https://fb.com/messenger_doc/",
       "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
       "call_to_action": {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER"
         }
       }
     }
   }' \
-F 'asset_feed_spec={
     "optimization_type": "DOF_MESSAGING_DESTINATION",
     "call_to_actions": [
       {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER",
           "link": "https://fb.com/messenger_doc/"
         }
       },
       {
         "type": "WHATSAPP_MESSAGE",
         "value": {
           "app_destination": "WHATSAPP",
           "link": "https://api.whatsapp.com/send"
         }
       },
       {
         "type": "INSTAGRAM_MESSAGE",
         "value": {
           "app_destination": "INSTAGRAM_DIRECT",
           "link": "https://www.instagram.com"
         }
       }
     ]
   }' \
-F 'degrees_of_freedom_spec={
     "creative_features_spec": {
       "standard_enhancements": {
         "enroll_status": "OPT_IN"
       }
     }
   }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Respuesta

Si la operación se realiza correctamente, la aplicación recibe una respuesta JSON con el identificador del contenido del anuncio recién creado.

{
  "id": "<AD_CREATIVE_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/v21.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_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

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

Actualización

Puedes realizar una solicitud POST a /<AD_CREATIVE_ID> para actualizar el contenido del anuncio.

Lectura

Para comprobar que hayas creado correctamente el contenido del anuncio de clic a varios destinos, puedes realizar una solicitud GET a /<AD_CREATIVE_ID>. Consulta Contenido del anuncio para obtener una lista completa de los parámetros disponibles.

Solicitud

curl -X GET -G \
  -d 'fields=name,object_story_spec{page_welcome_message},asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CREATIVE_ID>

Respuesta

{
  "name": "<CREATIVE_NAME>",
  "object_story_spec": {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "ice_breakers",
        "message": {
          "text": "Sample greeting message",
          "ice_breakers": [
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            }
          ]
        }
      }
    }
  },
  "asset_feed_spec": {
    "optimization_type": "DOF_MESSAGING_DESTINATION",
    "call_to_actions": [
      {
        "type": "MESSAGE_PAGE",
        "value": {
          "app_destination": "MESSENGER",
          "link": "https://fb.com/messenger_doc/"
        }
      },
      {
        "type": "WHATSAPP_MESSAGE",
        "value": {
          "app_destination": "WHATSAPP",
          "link": "https://api.whatsapp.com/send"
        }
      },
      {
        "type": "INSTAGRAM_MESSAGE",
        "value": {
          "app_destination": "INSTAGRAM_DIRECT",
          "link": "https://www.instagram.com"
        }
      }
    ]
  },
  "id": "<AD_CREATIVE_ID>"
}

Paso 4: Crear un anuncio

Los anuncios te permiten asociar información del contenido del anuncio a los conjuntos de anuncios. Para crear un anuncio, realiza una solicitud POST al extremo /act_<AD_ACCOUNT_ID>/ads, donde <AD_ACCOUNT_ID> es el identificador de la cuenta publicitaria de Meta. La solicitud debe incluir lo siguiente:

Parámetros

Solicitud

curl -X POST \
  -F 'name=<AD_NAME>' \
  -F 'adset_id=<AD_SET_ID> \
  -F 'creative={
       "creative_id": "<AD_CREATIVE_ID>"
     }' \
  -F 'status=ACTIVE \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Respuesta

Si la operación se realiza correctamente, la aplicación recibe una respuesta JSON con el identificador del anuncio recién creado.

{
  "id": "<AD_ID>"
}

Llamada a la acción

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

"asset_feed_spec": {
  "optimization_type": "DOF_MESSAGING_DESTINATION",
  "call_to_actions": [
    {
      "type": "MESSAGE_PAGE",
      "value": {
        "app_destination": "MESSENGER",
        "link": "https://fb.com/messenger_doc/"
      }
    },
    {
      "type": "INSTAGRAM_MESSAGE",
      "value": {
        "app_destination": "INSTAGRAM_DIRECT",
        "link": "https://www.instagram.com"
      }
    }
  ]
}

Obtén más información en la documentación de la especificación de listas de piezas de contenido.

Actualización

Puedes realizar una solicitud POST a /<AD_ID> para actualizar un anuncio.

Lectura

Para comprobar que hayas creado correctamente un anuncio de clic a varios destinos, puedes realizar una solicitud GET a /<AD_ID>. Consulta la referencia sobre anuncios para obtener una lista completa de los parámetros disponibles.

Solicitud

curl -X GET -G \
  -d 'fields=status,adset_id \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_ID>

Respuesta

{
  "status": "ACTIVE",
  "adset_id": "<AD_SET_ID>",
  "id": "<AD_ID>"
}