Creatività dell'inserzione

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.

Inizia

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:

  1. Imposta asset_customization_rules all'interno di asset_feed_spec.
  2. 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

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, audience_network e threads.

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, story e notification.

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: 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.

threads_positions

Facoltativo, ma necessario se Threads è selezionato in publisher_platforms.

Posizionamento specifico di Threads: threads_stream

Nota:publisher_platform: instagram e instagram_positions: stream sono obbligatori per selezionare threads_positions: threads_stream.

Scopri di più sulle nostre opzioni di posizionamento disponibili.

Esempio - Configurazione elenco

curl -X POST \ -F 'object_story_spec={ "page_id": "<PAGE_ID>", "instagram_user_id": "<IG_USER_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/v24.0/act_<AD_ACCOUNT_ID>/adcreatives

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

curl -X POST \ -F 'object_story_spec={ "page_id": "<PAG_-ID>", "instagram_user_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": "<WEBSITE_URL>", "display_url": "<DISPLAY_URL>", "deeplink_url": "<DEEPLINK_URL>", "adlabels": [ { "name": "adlabel1" }, { "name": "adlabel2" } ] }], "optimization_type": "PLACEMENT", "titles": [{ "text": "<TEXT>", "adlabels": [ { "name": "adlabel1" }, { "name": "adlabel2" } ] }] }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adcreatives

Esempio - Personalizzazione delle risorse dei risultati della ricerca di Instagram

curl -X POST \ -F 'object_story_spec={ "page_id": "<PAGE_ID>", "instagram_user_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": "<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/v24.0/act_<AD_ACCOUNT_ID>/adcreatives

Esempio — Configurazione del feed di Threads

curl -X POST \ -F 'object_story_spec={ "page_id": "<PAGE_ID>", "instagram_user_id": "<IG_USER_ID>", "threads_user_id" : "<THREADS_USER_ID>", }' \ -F 'asset_feed_spec={ "videos": [{ "adlabels": [{"name": "labelfb"}], "video_id": "<VIDEO_ID>" }, { "adlabels": [{"name": "labelig"}], "video_id": "<VIDEO_ID>" }, { "adlabels": [{"name": "labelthreads"}], "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": ["instagram"], "instagram_positions": ["stream"] }, "video_label": { "name": "labelig" } }, { "customization_spec": { "publisher_platforms": ["threads"], "threads_positions": ["threads_stream"] }, "video_label": { "name": "labelthreads" } }, { "customization_spec": {}, "video_label": { "name": "labelfb" } }], "optimization_type": "PLACEMENT" }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v23.0/act_<AD_ACCOUNT_ID>/adcreatives

Consulta tutte le opzioni disponibili per la specifica del feed della risorsa.

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 act_<AD_ACCOUNT_ID>/ads. Ad esempio:

https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/ads?fields=creative{effective_instagram_media_id,instagram_permalink_url}