API Marketing

Primi passi con il formato pubblicitario flessibile

Questo documento illustra in che modo il formato pubblicitario flessibile consente l'automazione creativa multi-risorsa raggruppando le risorse correlate in un'unica inserzione senza dover selezionare un formato specifico.

Prima di iniziare

Dovrai familiarizzare con questi passaggi per configurare le tue campagne pubblicitarie per il formato pubblicitario flessibile:

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

Limitazioni

  • Attualmente solo gli obiettivi della campagna OUTCOME_SALES e OUTCOME_APP_PROMOTION supportano il formato pubblicitario flessibile.

Creazione di un'inserzione usando il formato pubblicitario flessibile

Puoi usare creative_asset_groups_spec per fornire più risorse creative, con le seguenti limitazioni:

  • Sono richiesti almeno 1 image o video per gruppo.
  • Tutte le call_to_actions fornite devono avere lo stesso type.
  • Non possono essere presenti più di 5 texts per text_type per gruppo.

Ad esempio, per creare un'inserzione usando il formato pubblicitario flessibile attraverso l'endpoint /ads:

curl \
  -F 'adset_id=<ADSET_ID>' \
  -F "creative={
    'name': 'Sample Creative',
    'object_story_spec': {  
      ...    
    },
  }" \
  -F 'creative_asset_groups_spec={
  "groups": [
    {
      "images": [
        {
          "hash": <IMAGE_HASH_1>,
        },
        {
          "hash": <IMAGE_HASH_2>,
        }
      ],
      "videos": [
        {
          "video_id": <VIDEO_ID_1>,
        },
        {
          "video_id": <VIDEO_ID_2>,
        },
      ],
      "texts": [
        {
          "text": "Summer Sale",
          "text_type": "primary_text",
        },
        {
          "text": "Everything 50% Off",
          "text_type": "headline",
        }
      ],
      "call_to_action": {
        "type": "LEARN_MORE",
        "value": {
          "link": "https://www.example.com/",
        }
      }
    }
  ],
}' \
  -F 'status=PAUSED' \
  -F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/ads

Lettura del formato pubblicitario flessibile

Per controllare la tua inserzione, leggi creative_asset_group_spec:

curl -G \
  -d 'fields=creative_asset_groups_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_ID>/
Risposta
{
  "creative_asset_groups_spec": {
    "groups": [
      {
        "images": [
          {
            "hash": <IMAGE_HASH_1>,
          },
          {
            "hash": <IMAGE_HASH_2>,
          }
        ],
        "texts": [
          {
            "text": "Summer Sale",
            "text_type": "primary_text"
          },
          {
            "text": "Everything 50% off",
            "text_type": "headline"
          }
        ],
        "videos": [
          {
            "video_id": <VIDEO_ID_1>,
            "image_hash": <VIDEO_THUMBNAIL_HASH_1>
          },
          {
            "video_id": <VIDEO_ID_2>,
            "image_hash": <VIDEO_THUMBNAIL_HASH_2>
          }
        ],
        "group_uuid": <GROUP_ID>
      }
    ]
  },
  "id": <AD_ID>
}

Altri contenuti da consultare

Per ulteriori informazioni sui componenti e i concetti menzionati in questa guida, consulta queste guide: