API Marketing

Primi passi con le funzioni di IA generativa sull'API Marketing

Supporto API per le funzioni di IA generativa

Gli inserzionisti sono responsabili di visualizzare in anteprima le creatività dell'inserzione in cui sono presenti creatività generate dall'IA prima di pubblicare le inserzioni. Consulta le istruzioni di configurazione dell'anteprima.

Meta non fornisce alcuna garanzia sulla completezza, l'affidabilità e l'accuratezza delle generazioni di testo suggerite, degli sfondi generati o delle immagini espanse. Se usi l'API Marketing per accedere alle nostre funzioni di IA generativa delineate di seguito, si applicano le Condizioni per l'IA generativa delle creatività delle inserzioni in aggiunta alle Condizioni della Piattaforma Meta.

Questo documento ti mostra come usare le funzioni di IA generativa di generazione del testo, espansione dell'immagine e generazione di sfondi per le inserzioni.

Prima di iniziare

Devi seguire questi passaggi per configurare le tue campagne pubblicitarie con le funzioni di IA generativa di Meta.

  1. Creazione di una campagna
  2. Creazione di un gruppo di inserzioni
  3. Creazione di una creatività dell'inserzione o standalone
  4. Visualizzazione di una creatività in anteprima
  5. Abilitazione di un'inserzione

Generazione di testo

Le varianti di testo sono generate con l'IA prendendo spunto dal tuo testo principale originale, dalle tue inserzioni precedenti o dai contenuti della tua Pagina aziendale per rendere i suggerimenti più pertinenti. Aggiungere altre opzioni di testo alla tua inserzione può aiutarti a personalizzare le creatività e ridurne la ripetitività, con un potenziale un aumento delle prestazioni. Scopri di più su questa funzione qui.

Passaggio 1: attivazione della generazione di testo quando crei l'inserzione

Puoi creare un'inserzione attraverso l'endpoint /ads o creare una creatività standalone attraverso l'endpoint /adcreatives. L'attivazione della funzione si applica solo all'inserzione o alla creatività creata nella richiesta corrente. Per entrambi gli approcci, segui questi passaggi per attivare la funzione Generazione di testo:

  1. Fornisci un testo principale nel campo message della object_story_spec.
  2. Attiva text_generation.

Consulta le richieste di esempio sotto:

Attivazione tramite endpoint /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

In alternativa, puoi creare un oggetto pubblicitario con l'endpoint act_<AD_ACCOUNT_ID>/ads:

Attivazione tramite endpoint /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

Passaggio 2: anteprima per la generazione di testo

Quando si crea un'inserzione con la funzione text_generation attivata, questa sarà applicata solo all'inserzione specifica e i testi principali generati saranno inseriti nella specifica della creatività. Se la funzione è stata attivata attraverso l'endpoint /ads, il campo status sul gruppo di inserzioni sarà PAUSED per impostazione predefinita (vedi documentazione). Puoi rivedere i suggerimenti generati prima di impostare manualmente lo stato dell'inserzione su ACTIVE perché possa essere pubblicata.

La specifica della creatività contenente i suggerimenti generati può essere visualizzata in anteprima leggendo il parametro asset_feed_spec attraverso l'ID della creatività o l'ID dell'inserzione. Vedi l'esempio di richiesta e di risposta qui sotto:

Inizia interrogando il parametro asset_feed_spec della creatività dell'inserzione standalone creata al passaggio 1.

Richiesta

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

Risposta

{
  "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 volta rivisti i suggerimenti e confermato che sono idonei alla pubblicazione, procedi al passaggio 3 per impostare l'inserzione su ACTIVE. Se uno o più dei suggerimenti generati non sono accettabili, crea una nuova inserzione o creatività senza attivare la generazione di testo.

Creazione di creatività senza attivare la generazione di testo

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

Passaggio 3: impostazione dello stato del gruppo di inserzioni su ACTIVE

Dopo aver verificato i suggerimenti di testo generati, puoi impostare lo status dell'inserzione su ACTIVE. Questo passaggio deve essere effettuato in entrambi i casi seguenti:

  1. Quando attivi la funzione per un'inserzione tramite l'endpoint /ads.
  2. Se l'inserzione è la prima inserzione a usare una creatività esistente con attivazione della generazione di testo.

Richiesta

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

Espansione dell'immagine

Espandi automaticamente la tua immagine per adattarsi a più posizionamenti.

A partire dal 16 settembre 2024, la funzione Espansione dell'immagine sarà inclusa come parte dei miglioramenti standard. Pertanto, se crei un'inserzione o una creatività dell'inserzione con Espansione dell'immagine abilitata, fai riferimento alle informazioni riportate in Miglioramenti standard per le creatività Advantage+ sull'impostazione standard_enhancements come campo all'interno di creative_features_spec.

Passaggio 1: creazione di un'inserzione o una creatività con espansione dell'immagine attivata

Puoi creare un'inserzione attraverso l'endpoint /ads o creare una creatività standalone attraverso l'endpoint /adcreatives. Per entrambi gli approcci, attiva la funzione Espansione dell'immagine nella specifica della creatività (vedi esempi sotto).

Richiesta

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

Passaggio 2: anteprima per l'espansione dell'immagine

Questa funzione è supportata per i posizionamenti INSTAGRAM_STANDARD, FACEBOOK_REELS_MOBILE, INSTAGRAM_REELS, MOBILE_FEED_STANDARD e INSTGRAM_STORY. Per visualizzare l'anteprima per questi posizionamenti, effettua una richiesta GET all'endpoint /<AD_ID>/previews.

Se una o più delle immagini generate non sono accettabili, ricrea l'inserzione o la creatività senza attivare l'espansione dell'immagine:

  • Imposta creative_feature come image_uncrop.
  • Richiedi nuovamente l'anteprima se lo status risulta pending.

Nota: se non viene mostrato alcun nodo transformation_spec, significa che la creatività non è idonea per l'espansione dell'immagine.

Richiesta

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

Risposta

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

(Facoltativo) Anteprima diretta senza creazione delle inserzioni

Puoi anche richiedere un'anteprima usando l'endpoint act_<AD_ACCOUNT_ID>/generatepreviews senza dover creare un'inserzione.

Richiesta

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

Generazione di sfondi

Creeremo sfondi diversi per le immagini dei prodotti idonei e pubblicheremo la versione a cui è più probabile che il tuo pubblico risponda. Questi sfondi sono stati creati in base alla tua risorsa originale.

Passaggio 1: creazione di un'inserzione o una creatività con generazione di sfondi attivata

La generazione di sfondi al momento funziona solo con inserzioni dinamiche per i prodotti o inserzioni del catalogo Advantage+ nel feed mobile.

Puoi creare un'inserzione attraverso l'endpoint /ads o creare una creatività standalone attraverso l'endpoint /adcreatives. Per entrambi gli approcci, attiva la funzione Generazione di sfondi nella specifica della creatività (vedi esempi sotto).

Richiesta

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

Passaggio 2: anteprima per la generazione di sfondi

A funzione attivata, creeremo sfondi diversi per le immagini dei prodotti idonei e pubblicheremo la versione a cui è più probabile che il tuo pubblico risponda. L'attivazione della funzione si applica solo all'inserzione creata nella richiesta corrente. Questi sfondi sono creati in base alla tua risorsa originale, con colori o motivi diversi per le immagini dei prodotti idonei. Vedrai un'anteprima statica o in tempo reale del tuo sfondo generato in base all'idoneità del catalogo.

Se uno o più degli sfondi generati non sono accettabili, ricrea l'inserzione o la creatività senza attivare la generazione di sfondi.

  • L'anteprima è al momento supportata solo per il posizionamento MOBILE_FEED_STANDARD.
  • Imposta creative_feature come image_background_gen.
  • Se l'anteprima in tempo reale per i prodotti del catalogo non è pronta, viene visualizzata un'anteprima disponibile con status impostato su PENDING.

Richiesta

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

Risposta

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

(Facoltativo) Anteprima diretta senza creazione delle inserzioni

Puoi anche richiedere l'anteprima di una creatività usando l'endpoint /<AD_CREATIVE_ID>/previews senza dover creare un'inserzione.

Richiesta

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

Risposta

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

Informazioni in merito alla trasparenza sull'IA

Le immagini delle inserzioni create o modificate materialmente con determinate funzioni creative dell'IA generativa di Meta disponibili nei nostri strumenti di marketing possono includere informazioni sull'IA nel menu con tre puntini di un'inserzione o avere un'etichetta informativa sull'IA accanto all'etichetta sponsorizzata. Scopri di più in merito alla trasparenza sull'IA generativa per le inserzioni.

Per saperne di più