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 sobre 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/v19.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/v19.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/v19.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 haces 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/v19.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 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> sea 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.

Ejemplo:

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": {
      "text": "<GREETING_MESSAGE>",
      "ice_breakers": [
        {
          "title": "<ICEBREAKER>"
        },
        {
          "title": "<ICEBREAKER>"
        },
        {
          "title": "<ICEBREAKER>"
        }
      ]
    }
  }
}

Ejemplos de creación de contenido del anuncio

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/v19.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>"
}

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/v19.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/v19.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>"
}

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/v19.0/<AD_ID>

Respuesta

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