API de marketing

Introducción a las funciones de IA generativa en la API de marketing

Compatibilidad de la API con las funciones de IA generativa

Los anunciantes son responsables de obtener una vista previa de los anuncios que incluyen contenido generado con IA antes de publicarlos. Consulta las instrucciones sobre la configuración de la vista previa.

Meta no ofrece ninguna garantía en relación con la exhaustividad, fiabilidad ni precisión de las generaciones de texto sugeridas, los fondos generados ni las imágenes expandidas. Si usas la API de marketing para acceder a nuestras funciones de IA generativa que se describen a continuación, se aplican las Condiciones de la IA generativa para contenido de anuncios además de las Condiciones de la plataforma de Meta.

En este documento se describe cómo usar las funciones de IA generativa de generación de texto, expansión de imágenes y generación de fondos para los anuncios.

Antes de empezar

Tienes que seguir estos pasos para configurar las campañas publicitarias con las funciones de IA generativa de Meta.

  1. Crear una campaña
  2. Crear un conjunto de anuncios
  3. Crear el anuncio o contenido de anuncio independiente
  4. Obtener la vista previa del contenido
  5. Habilitar el anuncio

Generación de texto

Las variaciones de texto se generan con IA que se inspira en el texto principal original, los anuncios anteriores o el contenido de la página de la empresa para ayudar a ofrecer sugerencias más pertinentes. Añadir más opciones de texto al anuncio puede ayudar a personalizar el contenido y reducir la saturación de contenido, lo que puede contribuir a aumentar el rendimiento. Obtén más información sobre esta función aquí.

Paso 1: Aceptar el uso de la generación de texto al crear el anuncio

Puedes crear un anuncio mediante el extremo /ads o crear contenido independiente mediante el extremo /adcreatives. La aceptación de la función solo se aplica al anuncio o contenido creado en la solicitud actual. En cualquiera de los enfoques, acepta el uso de la función de generación de texto de la siguiente forma:

  1. Proporciona un texto principal en el campo message de object_story_spec.
  2. Acepta el uso de text_generation.

Consulta los siguientes ejemplos de solicitud:

Aceptar mediante el extremo /adcreatives

curl -X POST \
  -F 'name=Text Gen Creative' \
  -F 'object_story_spec={
      "link_data": {
         "image_hash": "<IMAGE_HASH>", 
         "link": "<URL>", 
         "message": "<PRIMARY_TEXT_HERE>",  <--- Primary Text Here
      },
      "page_id": "<PAGE_ID>"
  }' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "text_generation": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

También puedes crear un objeto de anuncio con el extremo act_<AD_ACCOUNT_ID>/ads:

Aceptar mediante el extremo /ads

curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Text Gen Adgroup",
    "object_story_spec": {
      "link_data": {
         "image_hash": "<IMAGE_HASH>", 
         "link": "<URL>", 
         "message": "<PRIMARY_TEXT_HERE>",  <--- Primary Text Here
      },
      "page_id": "<PAGE_ID>"
    },
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "text_generation": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Paso 2: Obtener la vista previa de la generación de texto

Cuando se crea un anuncio con el uso de text_generation aceptado, la función solo se aplicará al anuncio actual y los textos principales generados se insertarán en la especificación de contenido. Si la función se aceptó mediante el extremo /ads, el campo status del grupo de anuncios se establecerá en PAUSED de forma predeterminada (consulta la documentación). Puedes revisar las sugerencias generadas antes de establecer manualmente el estado del anuncio en ACTIVE para que pueda entregarse.

Para obtener la vista previa de la especificación de contenido con sugerencias generadas, lee asset_feed_spec mediante el identificador del contenido o el identificador del anuncio. Consulta el siguiente ejemplo de solicitud y respuesta:

Para empezar, consulta el parámetro asset_feed_spec del contenido del anuncio independiente creado en el paso 1.

Solicitud

// request from creative
curl -X GET -G \
  -d 'fields=asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CREATIVE_ID>
  
// request from ad
curl -X GET -G \
  -d 'fields=creative{asset_feed_spec,status}' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_ID>

Respuesta

{
  "asset_feed_spec": {
    "bodies": [
      {
        "text": "Buy some cool LED TV at cheap price"
      },
      {
        "text": "Get your dream LED TV at an unbeatable price! Buy now and save big!"
      },
      {
        "text": "Get the best LED TV deals! 📺 Save money and upgrade your entertainment."
      },
      {
        "text": "Get an LED TV at a low cost! Cheap, high-quality options are available."
      },
      {
        "text": "Get LED TVs at affordable prices  ✨  !"
      }
    ],
    "optimization_type": "DEGREES_OF_FREEDOM"
  },
  "id": "<CREATIVE_ID>"
}

Cuando se reciban las sugerencias y su publicación parezca aceptable, continúa con el paso 3 para establecer el anuncio en ACTIVE. Si ninguna de las sugerencias generadas es aceptable, crea un anuncio o contenido nuevo sin aceptar la generación de texto.

Crear contenido sin aceptar la generación de texto

curl -X POST \
  -F 'name=Text Gen Creative' \
  -F 'object_story_spec={
      "link_data": {
         "image_hash": "<IMAGE_HASH>", 
         "link": "<URL>", 
         "message": "<PRIMARY_TEXT_HERE>",
      },
      "page_id": "<PAGE_ID>"
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Paso 3: Establecer el estado del grupo de anuncios en ACTIVE

Después de verificar las sugerencias de texto generadas, puedes establecer el valor de status del anuncio en ACTIVE. Este paso tiene que llevarse a cabo en ambos casos:

  1. Cuando un anuncio acepta la función mediante el extremo /ads.
  2. Si el anuncio es el primero que usa contenido existente con la generación de texto aceptada.

Solicitud

curl \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_ID>

Expansión de imágenes

Expande automáticamente la imagen para que se ajuste a más ubicaciones.

A partir del 16 de septiembre de 2024, la función de expansión de imágenes se incluirá como parte de las mejoras estándar. Por lo tanto, si quieres crear un anuncio o el contenido de un anuncio que acepte la expansión de imágenes, consulta la información de Mejoras estándar para el contenido de Advantage+ sobre cómo establecer standard_enhancements como campo dentro de creative_features_spec.

Paso 1: Crear un anuncio o contenido con la expansión de imágenes aceptada

Puedes crear un anuncio mediante el extremo /ads o crear contenido independiente mediante el extremo /adcreatives. En cualquiera de los enfoques, acepta el uso de la función de expansión de imágenes en la especificación de contenido (consulta los ejemplos que se incluyen a continuación).

Solicitud

// creative example
curl -X POST \
  -F 'name=Image Expansion Creative' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "image_uncrop": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
// ad example
curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Image Expansion Adgroup",
    "object_story_spec": {
      "link_data": {
         "image_hash": "<IMAGE_HASH>", 
         "link": "<URL>", 
         "message": "You got this.",
      },
      "page_id": "<PAGE_ID>"
    },
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "image_uncrop": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Paso 2: Obtener la vista previa de la expansión de imágenes

Esta función es compatible con las ubicaciones INSTAGRAM_STANDARD, FACEBOOK_REELS_MOBILE, INSTAGRAM_REELS, MOBILE_FEED_STANDARD e INSTGRAM_STORY. Si quieres obtener una vista previa para esta ubicaciones, haz una solicitud GET al extremo /<AD_ID>/previews.

Si ninguna de las imágenes generadas es aceptable, vuelve a crear el anuncio o contenido sin aceptar la expansión de imágenes:

  • Establece creative_feature como image_uncrop.
  • Vuelve a solicitar la vista previa si el valor de status es pending.

Nota: Si no se muestra ningún nodo transformation_spec, el contenido no cumple los requisitos de la expansión de imágenes.

Solicitud

INSTAGRAM_STANDARD

curl -X GET -G \
  -d 'ad_format=INSTAGRAM_STANDARD' \
  -d 'creative_feature=image_uncrop' \
  -d 'access_token=/<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>/previews

FACEBOOK_REELS_MOBILE

curl -X GET -G \
  -d 'ad_format=FACEBOOK_REELS_MOBILE' \
  -d 'creative_feature=image_uncrop' \
  -d 'access_token=/<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>/previews

Respuesta

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "image_uncrop": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible"
          }
        ]
      }
    }
  ]
}

(Opcional) Vista previa directa sin creación de anuncios

También puedes solicitar una vista previa con el extremo act_<AD_ACCOUNT_ID>/generatepreviews sin necesidad de realmente crear ningún anuncio.

Solicitud

FACEBOOK_REELS_MOBILE

curl -X GET -G \
  -d 'ad_format=FACEBOOK_REELS_MOBILE' \
  -d 'creative_feature=image_uncrop' \
  -d 'creative={
       "object_story_spec": {
         "page_id": "<PAGE_ID>",
          "link_data": {
            "image_hash": "<IMAGE_HASH>",
            "link": "<WEBSITE_LINK>"
          }
        }
     }'
  -d 'access_token=<ACCESS_TOKEN>'
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/generatepreviews

Generación de fondos

Crearemos diferentes fondos para imágenes de productos que cumplan los requisitos y entregaremos la versión a la que es más probable que responda la audiencia. Estos fondos se crean a partir del activo original.

Paso 1: Crear un anuncio o contenido con la generación de fondos aceptada

En este momento, la generación de fondos solo funciona con los anuncios de productos dinámicos o los anuncios de catálogo de Advantage+ en el feed para móviles.

Puedes crear un anuncio mediante el extremo /ads o crear contenido independiente mediante el extremo /adcreatives. En cualquiera de los enfoques, acepta el uso de la función de generación de fondos en la especificación de contenido (consulta los ejemplos que se incluyen a continuación).

Solicitud

// creative example
  curl -X POST \
  -F 'name=Background Gen Creative' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "image_background_gen": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

// ad example
curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Background Gen Adgroup",
    "object_story_spec": {
      "page_id": "<PAGE_ID>",
      "template_data": {
        "description": "Description {{product.description}} ",
        "link": "https://www.example.com/",
        "message": "Test {{product.name | titleize}} ",
        "name": "Headline {{product.price}}"
      }
    },
    "product_set_id": "<PRODUCT_SET_ID>",
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "image_background_gen": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Paso 2: Obtener la vista previa de la generación de fondos

Si aceptas la función, crearemos diferentes fondos para imágenes de productos que cumplan los requisitos y entregaremos la versión a la que es más probable que responda la audiencia. La aceptación de la función solo se aplica al anuncio creado en la solicitud actual. Estos fondos se crean a partir del activo original, con diferentes colores o patrones para imágenes de productos que cumplen los requisitos. Obtendrás una vista previa estática o en directo del fondo generado en función de la idoneidad del catálogo.

Si ninguno de los fondos generados es aceptable, vuelve a crear el anuncio o contenido sin aceptar la generación de fondos.

  • Actualmente la vista previa solo es compatible con la ubicación MOBILE_FEED_STANDARD.
  • Establece creative_feature como image_background_gen.
  • Si la vista previa en directo de los productos del catálogo no está lista, se muestra una vista previa de las existencias con el valor de status establecido en PENDING.

Solicitud

MOBILE_FEED_STANDARD

curl -X GET -G \
  -d 'ad_format=MOBILE_FEED_STANDARD' \
  -d 'creative_feature=image_background_gen' \
  -d 'access_token=/<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>/previews

Respuesta

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "image_background_gen": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible" // or one of "pending", "ineligible"
          }
        ]
      }
    }
  ]
}

(Opcional) Vista previa directa sin creación de anuncios

También puedes solicitar una vista previa de un contenido con el extremo /<AD_CREATIVE_ID>/previews sin necesidad de realmente crear ningún anuncio.

Solicitud

MOBILE_FEED_STANDARD

curl -X GET -G \
  -d 'ad_format=MOBILE_FEED_STANDARD' \
  -d 'creative_feature=image_background_gen' \
  -d 'access_token=<ACCESS_TOKEN>'
  https://graph.facebook.com/v19.0/<AD_CREATIVE_ID>/generatepreviews

Respuesta

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "image_background_gen": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible" // or one of "pending", "ineligible"
          }
        ]
      }
    }
  ]
}

Acerca de la transparencia de la IA

Las imágenes de anuncios creadas o editadas materialmente con determinadas funciones creativas de la IA generativa de Meta que están disponibles en nuestras herramientas de marketing pueden contener información sobre IA en el menú de tres puntos de un anuncio o tener una etiqueta de información sobre IA junto a la etiqueta de publicidad. Obtén más información sobre la transparencia de la IA generativa en los anuncios.

Más información