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

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

Ejemplo

Adición de 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": {
      "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 realiza correctamente, la aplicación recibe una respuesta JSON con el identificador del contenido del anuncio recién creado.

{
  "id": "<AD_CREATIVE_ID>"
}

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

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

Respuesta

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