API Marketing

Premiers pas avec les fonctionnalités d’IA générative sur l’API Marketing

Prise en charge de l’API pour les fonctionnalités d’IA générative

Les annonceurs doivent prévisualiser les contenus publicitaires générés par l’IA avant de les publier. Consultez les instructions de configuration fournies.

Meta ne garantit pas l’exhaustivité, la fiabilité ni l’exactitude des contenus générés tels que les textes, les arrière-plans ou les images agrandies. Si vous utilisez l’API Marketing pour accéder à nos fonctionnalités d’IA générative décrites ci-dessous, les Conditions générales relatives à l’utilisation de l’IA générative à des fins publicitaires s’appliquent en plus des Conditions générales de la plateforme Meta.

Ce document vous présente l’utilisation des fonctionnalités d’IA générative pour la génération de texte, l’agrandissement d’image et la création d’arrière-plan dans vos publicités.

Avant de commencer

Vous devez suivre quelques étapes pour configurer vos campagnes publicitaires avec les fonctionnalités d’IA générative de Meta.

  1. Créer une campagne
  2. Créer un ensemble de publicités
  3. Créer la publicité ou un contenu publicitaire autonome
  4. Prévisualiser le contenu publicitaire
  5. Activer la publicité

Génération de texte

Les suggestions de texte sont créées par une intelligence artificielle qui s’inspire de votre texte principal original, de vos publicités précédentes ou du contenu de votre Page professionnelle, afin de les rendre plus pertinentes. En ajoutant différentes options de texte à votre publicité, vous personnalisez votre contenu publicitaire et atténuez la lassitude, ce qui peut booster les performances. En savoir plus sur cette fonctionnalité ici.

Étape 1 : Activer la génération de texte lors de la création de votre publicité

Vous pouvez créer une publicité via le point de terminaison /ads ou concevoir un contenu publicitaire autonome via le point de terminaison /adcreatives. L’activation de cette fonctionnalité ne s’applique qu’à la publicité ou au contenu publicitaire spécifiquement créé dans la requête en cours. Pour activer la génération de texte, suivez ces étapes dans les deux approches :

  1. Ajouter un texte principal dans le champ message de l’objet object_story_spec
  2. Activer l’utilisation de la sous-propriété text_generation

Reportez-vous à l’exemple ci-dessous :

Activation via le point de terminaison /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

Vous pouvez également créer un objet publicitaire avec le point de terminaison act_<AD_ACCOUNT_ID>/ads :

Activation via le point de terminaison /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

Étape 2 : Prévisualiser la génération de texte

Lorsqu’une publicité est créée avec la sous-propriété text_generation, la fonctionnalité ne s’applique qu’à la publicité en cours, et les textes principaux générés sont insérés dans les spécifications du contenu publicitaire. Si la fonctionnalité a été activée via le point de terminaison /ads, le champ status sur le groupe publicitaire sera automatiquement réglé sur PAUSED (voir documentation). Vous pouvez passer en revue les suggestions générées avant de définir manuellement le statut de la publicité sur ACTIVE pour qu’elle puisse être diffusée.

Les spécifications du contenu publicitaire utilisant les suggestions générées peuvent être prévisualisées en lisant la sous-propriété asset_feed_spec à partir de l’ID du contenu publicitaire ou de l’ID publicité. Consultez la requête et la réponse ci-dessous :

Commencez par interroger asset_feed_spec du contenu publicitaire que vous avez créé à l’étape 1.

Requête

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

Réponse

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

Une fois que vous avez passé en revue les suggestions et qu’elles semblent acceptables pour la publication, passez à l’étape 3 pour définir la publicité sur ACTIVE. Si l’une des suggestions ne vous convient pas, créez une nouvelle annonce ou un nouveau contenu publicitaire sans recourir à la génération de texte.

Créer un contenu publicitaire sans activer la génération de texte

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

Étape 3 : Configurer le statut du groupe publicitaire sur ACTIVE

Une fois que vous avez examiné les suggestions de texte générées, vous pouvez définir le champ status de la publicité sur la valeur ACTIVE. Cette étape est nécessaire dans deux cas :

  1. Lorsqu’une publicité est activée pour cette fonctionnalité via le point de terminaison /ads
  2. Si la publicité est la première à utiliser un contenu publicitaire existant pour lequel la génération de texte a été activée.

Requête

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

Agrandissement d’image

Agrandissez automatiquement vos images pour qu’elles s’adaptent à tous les emplacements possibles.

À compter du 16 septembre 2024, la fonctionnalité d’agrandissement de l’image sera incluse dans les améliorations standard. Par conséquent, si vous créez une publicité ou un contenu publicitaire avec l’option d’agrandissement de l’image, reportez-vous aux informations de la page Améliorations standard pour le contenu publicitaire Advantage+ concernant la définition des standard_enhancements sous la forme d’un champ dans les creative_features_spec.

Étape 1 : Créer une publicité ou un contenu publicitaire avec l’option d’agrandissement d’image

Vous pouvez créer une publicité via le point de terminaison /ads ou concevoir un contenu publicitaire autonome via le point de terminaison /adcreatives. Dans les deux cas, activez l’option d’agrandissement d’image dans les spécifications du contenu publicitaire (voir les exemples ci-dessous).

Requête

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

Étape 2 : Prévisualiser l’agrandissement d’image

Cette fonctionnalité est prise en charge pour les emplacements suivants : INSTAGRAM_STANDARD, FACEBOOK_REELS_MOBILE, INSTAGRAM_REELS, MOBILE_FEED_STANDARD et INSTGRAM_STORY. Pour visualiser un aperçu de ces emplacements, effectuez une requête de type GET au point de terminaison /<AD_ID>/previews.

Si l’une des images générées ne vous convient pas, créez à nouveau la publicité ou le contenu publicitaire sans recourir à l’agrandissement d’image :

  • Définissez le paramètre creative_feature sur la valeur image_uncrop.
  • Effectuez une nouvelle requête d’aperçu si le champ status a pour valeur pending.

Remarque : si aucun nœud transformation_spec n’apparaît, cela signifie que le contenu publicitaire n’est pas éligible à l’agrandissement d’image.

Requête

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

Réponse

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

(Facultatif) Aperçu direct sans création de publicité

Vous pouvez également demander un aperçu en utilisant le point de terminaison act_<AD_ACCOUNT_ID>/generatepreviews sans créer réellement de publicité.

Requête

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

Génération d’arrière-plan

Nous produisons des arrière-plans variés pour les images de produits éligibles et nous diffusons la version qui fera le plus réagir votre audience. Ces arrière-plans sont générés à partir de votre élément d’origine.

Étape 1 : Créer une publicité ou un contenu publicitaire avec l’option de génération d’arrière-plan

Pour l’instant, la génération d’arrière-plan fonctionne uniquement avec les publicités dynamiques de produits ou les publicités de catalogue Advantage+ sur Mobile Feed.

Vous pouvez créer une publicité via le point de terminaison /ads ou concevoir un contenu publicitaire autonome via le point de terminaison /adcreatives. Dans les deux cas, activez l’option de génération d’arrière-plan dans les spécifications du contenu publicitaire (voir les exemples ci-dessous).

Requête

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

Étape 2 : Prévisualiser la génération d’arrière-plan

Nous produisons des arrière-plans variés pour les images de produits éligibles et nous diffusons la version qui fera le plus réagir votre audience. L’activation de cette fonctionnalité ne s’applique qu’à la publicité spécifiquement créée dans la requête en cours. Ces arrière-plans sont créés en utilisant votre élément d’origine et proposent des variations de couleur ou de motifs pour les images de produits éligibles. Vous pourrez observer l’arrière-plan de manière statique ou en direct en fonction de l’éligibilité de votre catalogue.

Si l’un des arrière-plans générés ne vous convient pas, créez à nouveau la publicité ou le contenu publicitaire sans avoir recours à la génération d’arrière-plan.

  • La prévisualisation n’est actuellement prise en charge que pour l’emplacement MOBILE_FEED_STANDARD
  • Définissez le paramètre creative_feature sur la valeur image_background_gen
  • Si l’aperçu en direct de vos produits de catalogue n’est pas disponible, un aperçu standard est affiché avec le paramètre status défini sur PENDING

Requête

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

Réponse

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

(Facultatif) Aperçu direct sans création de publicité

Vous pouvez également demander l’aperçu d’un contenu publicitaire en utilisant le point de terminaison /<AD_CREATIVE_ID>/previews sans créer réellement de publicité.

Requête

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

Réponse

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

À propos de la transparence en matière d’IA

Les images publicitaires créées ou modifiées de façon substantielle avec certaines fonctionnalités de création par IA générative disponibles dans les outils marketing de Meta peuvent inclure une entrée Notice sur l’IA dans le menu à trois points ou une option du même nom à côté de l’indication Sponsorisé. En savoir plus sur la transparence de l’IA générative pour les publicités.

En savoir plus