Personalizzazione delle risorse del posizionamento

Usa questa soluzione per personalizzare le risorse delle creatività mostrate in diversi posizionamenti pubblicitari. Mantieni il controllo sulle creatività, usando al contempo posizionamenti diversi.

Placement Asset Customization è una delle nostre tre API che usano regole di personalizzazione delle risorse. Scopri di più sulle regole di personalizzazione delle risorse.

Primi passi

Passaggio 1: crea una campagna pubblicitaria e un gruppo di inserzioni
Passaggio 2: fornisci la creatività e personalizza le risorse
Passaggio 3: crea la tua inserzione
Passaggio 4 opzionale: ottieni insight e analizza i risultati
Passaggio 5 facoltativo: leggi la creatività dell'inserzione

La personalizzazione delle risorse del posizionamento con i post esistenti non è più supportata tramite l'API. Puoi usare questa opzione solo in Gestione inserzioni.

Passaggio 2: fornisci la creatività

Usa asset_feed_spec per fornire le tue creatività. Puoi specificare più risorse delle creatività per ogni tipo di risorsa, tra cui immagini, video, caroselli, titoli e testo del corpo. Fornisci solo una descrizione del link, poiché la descrizione non può essere personalizzata per posizionamento.

Per applicare la personalizzazione:

Imposta asset_customization_rules all'interno di asset_feed_spec.
Per ogni regola, aggiungi customization_spec e le etichette delle risorse.

Per la personalizzazione delle risorse del posizionamento, ad ogni asset_feed_spec deve essere associata più di una regola di personalizzazione.

Consulta Regole di personalizzazione delle risorse.

Proprietà supportate

Nome della proprietà Descrizione

Nome della proprietà	Descrizione
`customization_spec` tipo: Campi supportati	Obbligatorio. Posizionamenti in cui vuoi mostrare le risorse.
`image_label` formato: `{"name": "{LABEL_NAME}"}`	Obbligatorio per il formato `SINGLE_IMAGE`. Etichetta dell'immagine che vuoi mostrare. È allegata alle risorse immagine in `asset_feed_spec`.
`video_label` formato: `{"name": "{LABEL_NAME}"}`	Obbligatorio per il formato `SINGLE_VIDEO`. Etichetta del video che vuoi mostrare. È allegata alle risorse video in `asset_feed_spec`.
`carousel_label` formato: `{"name": "{LABEL_NAME}"}`	Obbligatorio per il formato `CAROUSELS`. Etichetta del carosello che vuoi mostrare. È allegata alle risorse carosello in `asset_feed_spec`. Nota: se fornisci caroselli tramite la Personalizzazione delle risorse del posizionamento, tutti gli allegati secondari devono essere definiti nella Specifica del feed delle risorse e bisogna farvi riferimento tramite adlabel. Gli allegati secondari non possono essere definiti in linea. Consulta Opzioni della specifica del feed delle risorse per maggiori dettagli sul formato `carousels`.

customization_spec

tipo: Campi supportati

Obbligatorio.

Posizionamenti in cui vuoi mostrare le risorse.

image_label

formato: {"name": "{LABEL_NAME}"}

Obbligatorio per il formato SINGLE_IMAGE.

Etichetta dell'immagine che vuoi mostrare. È allegata alle risorse immagine in asset_feed_spec.

video_label

formato: {"name": "{LABEL_NAME}"}

Obbligatorio per il formato SINGLE_VIDEO.

Etichetta del video che vuoi mostrare. È allegata alle risorse video in asset_feed_spec.

carousel_label
formato: {"name": "{LABEL_NAME}"}

Obbligatorio per il formato CAROUSELS.

Etichetta del carosello che vuoi mostrare. È allegata alle risorse carosello in asset_feed_spec.

Nota: se fornisci caroselli tramite la Personalizzazione delle risorse del posizionamento, tutti gli allegati secondari devono essere definiti nella Specifica del feed delle risorse e bisogna farvi riferimento tramite adlabel. Gli allegati secondari non possono essere definiti in linea. Consulta Opzioni della specifica del feed delle risorse per maggiori dettagli sul formato carousels.

Campi supportati in `customization_spec`

Nome della proprietà	Descrizione
`publisher_platforms`	Obbligatorio. Possibili posizionamenti per la tua inserzione. Le opzioni sono: `facebook`, `instagram`, `messenger` e `audience_network`.
`facebook_positions`	Facoltativo, ma obbligatorio se Facebook è selezionato in `publisher_platforms`. Posizionamento specifico di Facebook. Le opzioni sono: `feed`, `right_hand_column`, `marketplace`, `video_feeds`, `search` e `story`.
`instagram_positions`	Facoltativo, ma obbligatorio se Instagram è selezionato in `publisher_platforms`. Posizionamenti specifici di Instagram. Le opzioni sono: `stream`, `story`, `explore`, `explore_home`, `profile_feed` e `ig_search`. Nota: il posizionamento `explore_home` supporta solo il formato `SINGLE_IMAGE`.
`messenger_positions`	Facoltativo, ma necessario se Messenger è selezionato in `publisher_platforms`. Posizionamenti specifici di Messenger. Le opzioni sono: `messenger_home`, `sponsored_messages` e `story`.
`audience_network_positions`	Facoltativo, ma necessario se Audience Network è selezionato in `publisher_platforms`. Posizionamento specifico di Audience Network. Le opzioni sono: `classic`, `instream_video` e `rewarded_video`.

Scopri di più sulle nostre opzioni di posizionamento disponibili.

Esempio - Configurazione elenco

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
      "videos": [
      {
        "adlabels": [
          {
            "name": "labelfb"
          }
        ],
        "video_id": "<VIDEO_ID>"
      },
      {
        "adlabels": [
          {
            "name": "labelig"
          }
        ],
        "video_id": "<VIDEO_ID>"
      }
    ],
    "bodies": [
      {
        "text": "Begin Your Adventure"
      }
    ],
    "link_urls": [
      {
        "website_url": "<WEBSITE_URL>",
        "display_url": "<DISPLAY_URL>"
      }
    ],
    "titles": [
      {
        "text": "Level Up"
      }
    ],
    "ad_formats": [
      "SINGLE_VIDEO"
    ],
    "call_to_action_types": [
      "WATCH_MORE"
    ],
    "descriptions": [
      {
        "text": "Description"
      }
    ],
    "asset_customization_rules": [
      {
        "customization_spec": {          
          "publisher_platforms": [
            "facebook"
          ],          
          "facebook_positions": [
            "feed",
            "instream_video"
          ]
        },
        "video_label": {
          "name": "labelfb"
        }
      },
      {
        "customization_spec": {          
          "publisher_platforms": [
            "instagram"
          ],          
          "instagram_positions": [
            "stream"           
          ]
        },
        "video_label": {
          "name": "labelig"
        }
      }
    ]
  }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Esempio - Personalizzazione delle risorse per la Home di Esplora di Instagram

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' \
  -F 'asset_feed_spec={
        "ad_formats": [
          "SINGLE_IMAGE"
        ],
        "asset_customization_rules": [
          {
            "image_label": {
              "name": "<IMAGE-LABEL>"
            },
            "customization_spec": {
              "publisher_platforms": [
                "instagram"
              ],
              "instagram_positions": [
                "explore_home"
              ]
            }
          }
        ],
        "bodies": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "call_to_action_types": [
          "LEARN_MORE"
        ],
        "images": [
          {
            "hash": "<IMAGE-HASH>",
            "adlabels": [
              {
                "name": "adlabel1"
              }
            ]
          },
          {
            "hash": "<IMAGE-HASH>",
            "image_crops": {
              "100x100": [
                [
                  604,
                  0
                ],
                [
                  1659,
                  1055
                ]
              ]
            },
            "adlabels": [
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "link_urls": [
          {
            "website_url": "",
            "display_url": "",
            "deeplink_url": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "optimization_type": "PLACEMENT",
        "titles": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ]
      }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Esempio - Personalizzazione delle risorse dei risultati della ricerca di Instagram

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' \
  -F 'asset_feed_spec={
        "ad_formats": [
          "SINGLE_IMAGE"
        ],
        "asset_customization_rules": [
          {
            "image_label": {
              "name": "placement_asset_f1048d832ecd558_1661539731099"
            },
            "customization_spec": {
              "publisher_platforms": [
                "instagram"
              ],
              "instagram_positions": [
                "ig_search"
              ]
            }
          }
        ],
        "bodies": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "call_to_action_types": [
          "LEARN_MORE"
        ],
        "images": [
          {
            "hash": "9ffd7307eae1f9c6e5250fc8760d285f",
            "adlabels": [
              {
                "name": "adlabel1"
              }
            ]
          },
          {
            "hash": "9ffd7307eae1f9c6e5250fc8760d285f",
            "image_crops": {
              "100x100": [
                [
                  604,
                  0
                ],
                [
                  1659,
                  1055
                ]
              ]
            },
            "adlabels": [
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "link_urls": [
          {
            "website_url": "<WEBSITE_URL>",
            "display_url": "<DISPLAY_URL>",
            "deeplink_url": "<DEEPLINK_URL>",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "optimization_type": "PLACEMENT",
        "titles": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ]
      }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Consulta tutte le opzioni disponibili per la specifica del feed delle risorse.

Passaggio 5 facoltativo: leggi le creatività dell'inserzione

Per le inserzioni per la personalizzazione delle risorse dei posizionamenti, i campi delle creatività relativi a Instagram dovrebbero essere recuperati tramite {ad-account-id}/ads. Ad esempio: