API de marketing

Primeros pasos para usar funciones de IA generativa en la API de marketing

Compatibilidad de la API para funciones de IA generativa

Los anunciantes tienen la responsabilidad de ver el anuncio con contenido generado con IA antes de publicarlo. Consulta la vista previa para obtener instrucciones de configuración.

Meta no brinda ninguna garantía en relación con la integridad, confiabilidad y precisión de las generaciones de texto sugerido, los fondos generados o las imágenes ampliadas. 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 muestra cómo usar las funciones de IA generativa de generación de texto, ampliación de la imagen y generación de fondo para anuncios.

Antes de empezar

Debes seguir estos pasos para configurar tus campañas de anuncios con las funciones de IA generativa de Meta.

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

Generación de texto

Las variaciones de texto se generan con IA a partir de tu texto principal original, tus anuncios previos o el contenido de tu página comercial para que las sugerencias sean más relevantes. Agregar más opciones de texto a tu anuncio puede ayudarte a personalizar el contenido y reducir la fatiga de contenido, lo cual puede aumentar el rendimiento. Obtén más información sobre esta función aquí.

Paso 1: Acepta usar la generación de texto al crear el anuncio

Puedes crear un anuncio a través del punto de conexión /ads o crear contenido independiente a través del punto de conexión /adcreatives. La aceptación de la función solo se aplica al anuncio o el contenido creado en la solicitud actual. En cualquiera de las dos opciones, acepta usar la función de generación de texto de la siguiente manera:

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

Observa el siguiente ejemplo de solicitud:

Aceptar a través del punto de conexión /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 del anuncio con el punto de conexión act_<AD_ACCOUNT_ID>/ads:

Aceptar a través del punto de conexión /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: Vista previa de la generación de texto

Cuando se crea un anuncio con la aceptación para usar text_generation, la función solo se aplica al anuncio actual y el texto principal generado se inserta en la especificación del contenido. Si la función se aceptó a través del punto de conexión /ads, el campo status del grupo de anuncios se configura en PAUSED de manera predeterminada (consulta la documentación). Puedes revisar las sugerencias generadas antes de configurar manualmente el estado del anuncio en ACTIVE para que se pueda entregar.

Puedes leer la asset_feed_spec con el identificador del contenido o el identificador del anuncio para obtener una vista previa de la especificación del contenido que contiene las sugerencias generadas. Consulta la solicitud y la respuesta de ejemplo a continuación:

Primero, consulta asset_feed_spec en el contenido del anuncio independiente creada 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>"
}

Una vez que se revisaron las sugerencias y que parecen aceptables para su publicación, sigue con el paso 3 para configurar el anuncio en ACTIVE. Si alguna de las sugerencias generadas no es aceptable, crea un nuevo anuncio o contenido 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: Configura el estado del grupo de anuncios en ACTIVE

Después de verificar las sugerencias de texto generadas, puedes configurar el status del anuncio en ACTIVE. Este paso debe realizarse en ambos casos:

  1. Cuando un anuncio acepta la función a través del punto de conexión /ads.
  2. Si el anuncio es el primero en usar un contenido preexistente 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>

Ampliación de imagen

Amplía tu imagen automáticamente para que se adapte a más ubicaciones.

A partir del 16 de septiembre de 2024, la función de ampliación de imágenes estará incluida como parte de las mejoras estándar. Por lo tanto, si creas un anuncio o un contenido del anuncio en el que está activada la ampliación de imágenes, consulta la información referida al contenido Advantage+ de las mejoras estándar en lo que respecta a la configuración de standard_enhancements como campo dentro de las creative_features_spec.

Paso 1: Crea un anuncio o contenido con la opción de ampliación de imagen aceptada

Puedes crear un anuncio a través del punto de conexión /ads o crear contenido independiente a través del punto de conexión /adcreatives. En cualquier caso, acepta usar la función de ampliación de imagen en la especificación del contenido (consulta los ejemplos que aparecen 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: Vista previa de la ampliación de imagen

Esta función es compatible con las ubicaciones INSTAGRAM_STANDARD, FACEBOOK_REELS_MOBILE, INSTAGRAM_REELS, MOBILE_FEED_STANDARD y INSTGRAM_STORY. Para obtener una vista previa de estas ubicaciones, haz una solicitud GET al punto de conexión /<AD_ID>/previews.

Si alguna de las imágenes generadas no es aceptable, vuelve a crear el anuncio o contenido sin aceptar la ampliación de imagen:

  • Configura creative_feature en image_uncrop.
  • Vuelve a solicitar la vista previas si status se muestra como pending.

Nota: Si no se muestra un nodo transformation_spec, quiere decir que el contenido no es apto para la ampliación de imagen.

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 la creación de un anuncio

También puedes solicitar una vista previa con el punto de conexión act_<AD_ACCOUNT_ID>/generatepreviews sin crear un 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 fondo

Crearemos diferentes fondos para las imágenes de productos apta y entregaremos la versión que tenga más probabilidades de recibir respuesta por parte de tu público. Estos fondos se crearon en función de tu recurso original.

Paso 1: Crea un anuncio o contenido con la opción de generación de fondo aceptada

Actualmente, la generación de fondo solo funciona con anuncios de productos dinámicos o anuncios de catálogo Advantage+ en feeds para dispositivos móviles.

Puedes crear un anuncio a través del punto de conexión /ads o crear contenido independiente a través del punto de conexión /adcreatives. En cualquiera de las opciones, acepta usar la función de generación de fondo en la especificación del contenido (consulta los siguientes ejemplos).

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: Vista previa de la generación de fondo

Con la aceptación del uso de la función, crearemos diferentes fondos para las imágenes de los productos aptos y entregaremos la versión que tenga más probabilidades de recibir respuesta por parte de tu público. La aceptación de la función solo se aplica al anuncio creado en la solicitud actual. Estos fondos se crean en función de tu recurso original y contiene diferentes colores o patrones para las imágenes de productos aptos. Verás una vista previa estática o activa del fondo generado según la elegibilidad del catálogo.

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

  • Actualmente, la vista previa solo es compatible con la ubicación MOBILE_FEED_STANDARD.
  • Configura creative_feature en image_background_gen.
  • Si la vista previa activa de tus productos de catálogo no está lista, se muestra una vista previa del inventario con el status configurado 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 la creación de un anuncio

También puedes solicitar una vista previa de un contenido con el punto de conexión /<AD_CREATIVE_ID>/previews sin crear un 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"
          }
        ]
      }
    }
  ]
}

Sobre la transparencia de la IA

Las imágenes de anuncios creadas o editadas materialmente con ciertas características creativas de IA generativa disponibles en nuestras herramientas de marketing pueden incluir información sobre la IA en el menú de tres puntos de un anuncio o tener una etiqueta de información referida a la IA junto a la etiqueta de publicidad. Obtén información sobre la transparencia de la IA generativa en los anuncios.

Más información