Anuncios de clic a varios destinos

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

Los anuncios de clic a múltiples destinos dirigen a las personas que hacen clic en ellos a una conversación con tu negocio en la app de mensajes o en las apps que suelen utilizar para responder (Messenger, Instagram o WhatsApp). Usa estos anuncios para llegar a las personas a gran escala y ofrecer un servicio personalizado de calidad.

Como el nombre lo indica, el anuncio puede ir a una combinación de destinos: chat de Messenger, de Instagram o de WhatsApp.

Si quieres crear un anuncio que solo vaya a un destino, consulta lo siguiente:

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

Información general de la creación de anuncios

En este documento, se describen los pasos que debes seguir para configurar la integración de anuncios de clic a varios destinos. Debes 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 un contenido del anuncio correspondiente al tipo de anuncio de varios destinos que quieres mostrar
4. Crear un anuncio vinculando el contenido del anuncio con el conjunto de anuncios

Antes de empezar

En esta guía, se da por sentado que tienes lo siguiente:

• Una cuenta publicitaria de Meta
• Recursos subidos, como imágenes o videos, para usar en los anuncios que se mostrarán en los servidores de Meta

Paso 1: Crear una campaña publicitaria

Empieza por crear tu campaña publicitaria. Para hacerlo, 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:

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 procesa correctamente, la app recibirá una respuesta JSON con el identificador de la campaña que se creó recientemente.

{
  "id": "<AD_CAMPAIGN_ID>"
}

Actualización

Puedes actualizar una campaña si envías una solicitud POST a /<AD_CAMPAIGN_ID>.

Lectura

Para verificar si se creó correctamente una campaña de clic a varios destinos, puedes enviar una solicitud GET a /<AD_CAMPAIGN_ID>. Consulta la referencia de la campaña publicitaria para obtener un listado completo de todos los perí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

Una vez que tienes una campaña de anuncios, crea tu conjunto de anuncios. Para hacerlo, envía una solicitud POST al punto de conexión /act_<AD_ACCOUNT_ID>/adsets, donde <AD_ACCOUNT_ID> sea el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:

Parámetros

Consulta nuestra Referencia del conjunto de anuncios de la cuenta publicitaria para obtener la 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 procesa correctamente, la app recibirá una respuesta JSON con el identificador del conjunto de anuncios que se creó recientemente.

{
  "id": "<AD_SET_ID>"
}

Actualización

Puedes actualizar un conjunto de anuncios si envías una solicitud POST a /<AD_SET_ID>.

Lectura

Si deseas verificar si se creó correctamente un conjunto de anuncios de clic a varios destinos, puedes enviar una solicitud GET a /<AD_SET_ID>. Consulta la referencia sobre conjunto 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 agregar activos a los anuncios. Para hacerlo, 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:

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 nuestra Referencia del contenido del anuncio para obtener la lista completa de los parámetros disponibles.

Completar el mensaje de bienvenida a la página

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 a varios destinos si personalizas el mensaje de bienvenida, los mensajes para empezar una conversación y los mensajes de autocompletar 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.

Limitaciones

• Los títulos de los mensajes para empezar una conversación no deben superar los 80 caracteres.
• Las respuestas de los mensajes para empezar una conversación no deben superar los 300 caracteres.
• El texto del mensaje no debe superar los 300 caracteres.

Ejemplo:

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

Ejemplos de creación de contenido del anuncio

Agrega el campo page_welcome_message al contenido como se indica a continuación.

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 procesa correctamente, la app recibirá una respuesta JSON con el identificador del contenido del anuncio que se creó recientemente.

{
  "id": "<AD_CREATIVE_ID>"
}

Crear contenido del anuncio con contenido de Instagram

Publicaciones de Instagram

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

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

Crear contenido del anuncio 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 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.

Actualización

Puedes actualizar el contenido del anuncio si envías una solicitud POST a /<AD_CREATIVE_ID>.

Lectura

Para verificar si se creó correctamente el contenido del anuncio de clic a varios destinos, puedes enviar una solicitud GET a /<AD_CREATIVE_ID>. Consulta el 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 con tus conjuntos de anuncios. Para hacerlo, envía una solicitud POST al punto de conexión /act_<AD_ACCOUNT_ID>/ads, donde <AD_ACCOUNT_ID> sea el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:

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 procesa correctamente, la app recibirá una respuesta JSON con el identificador del anuncio que se creó recientemente.

{
  "id": "<AD_ID>"
}

Llamada a la acción

También puedes configurar una llamada a la acción cuando crees tu 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"
      }
    }
  ]
}

Consulta la documentación sobre las especificaciones de la lista de activos para obtener más información.

Actualización

Puedes actualizar un anuncio si envías una solicitud POST a /<AD_ID>.

Lectura

Si deseas verificar si se creó correctamente un anuncio de clic a varios destinos, puedes enviar una solicitud GET a /<AD_ID>. Consulta la referencia de los anuncios para obtener un listado completo de todos los perímetros.

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