Versione 13.0

API Graph

Data di rilascio 8 febbraio 2022 | Disponibile fino a Da definire | Post sul blog

API Instagram Graph

Contenuto multimediale di IG

La versione 13 sarà l'ultima a consentire richieste al campo video_title sui contenuti multimediali di IG senza restituire un errore. Come promemoria, il comportamento corrente dell'API delineato nel nostro post sul blog del 5 ottobre 2021 è il seguente:

• Il campo media_product_type restituisce FEED per tutte le versioni.
• Il campo video_title viene omesso dalle risposte per tutte le versioni.
• I campi comments e mentions dei webhook di Instagram ora sono supportati per tutte le versioni.

Il comportamento precedente si applica a tutti i contenuti multimediali di IG, inclusi quelli creati con l'app Instagram TV, indipendentemente dalla data di creazione.

Insight sugli utenti

Si applica alla versione 13.0 e successive

Le seguenti metriche degli insight sugli utenti di IG non supportano più i parametri since e until e le risposte non includeranno la proprietà JSON end_time.

• audience_city
• audience_country
• audience_gender_age
• audience_locale

API Marketing

Data di rilascio 8 febbraio 2022 | Disponibile fino a 25 gennaio 2023 | Post sul blog

Creatività dell'inserzione

Inserzioni con personalizzazione delle risorse di posizionamento

Si applica alla versione 13.0 e successive.

Il nodo asset_feed_spec dell'endpoint POST /{ad-account-id}/adcreatives ora consentirà la creazione di inserzioni carosello con le inserzioni con personalizzazione delle risorse di posizionamento.

API Ads Library

Libreria inserzioni

Si applica alla versione 13.0 e successive.

I seguenti segmenti e campi della query sull'endpoint GET /ads_archive sono diventati obsoleti e sono stati sostituiti:

I seguenti parametri restituiti sull'endpoint GET /ads_archive sono diventati obsoleti e sono stati sostituiti:

Gruppi di inserzioni

Espansione del pubblico simile

Si applica alla versione 13.0 e successive. Si applicherà a tutte le versioni a partire dal 9 maggio 2022.

Per i gruppi di inserzioni appena creati per i quali viene eseguita l'ottimizzazione per valore, conversioni o eventi nell'app, l'espansione del pubblico simile sarà attivata per impostazione predefinita e non può essere disabilitata. Quando riceveremo un gruppo di inserzioni per il quale viene eseguita l'ottimizzazione per valore, conversioni o eventi nell'app, restituiremo una nuova proprietà del pubblico simile nella mappa targeting_optimization_types che indica che l'espansione del pubblico simile è abilitata e che integra la proprietà detailed_targeting esistente per l'espansione della targetizzazione dettagliata.

Questa modifica riguarda i seguenti endpoint:

• POST /{ad-account-id}/adsets
• GET /{ad-account-id}/adsets

API Conversions

Parametri sulle informazioni dei clienti

Si applica alla versione 13.0 e successive.

Esistono nuovi requisiti per le combinazioni di parametri sulle informazioni dei clienti considerate valide per un evento. Un evento sarà considerato non valido se include solo parametri costituiti da una delle seguenti combinazioni o da un loro sottoinsieme:

• ct + country + st + zp + ge + client_user_agent
• db + client_user_agent
• fn + ge
• ln + ge

Per assicurarti che i tuoi eventi non restituiscano un errore, ti consigliamo di consultare le best practice dell'API Conversions.

Questa modifica riguarda i seguenti endpoint:

• POST /{pixel-id}/events
• POST /{offline_dataset_id}/events

Piattaforma di vendita

API Shipping Profiles

Si applica alla versione 13.0 e successive.

Il campo handling_time dell'endpoint GET /{cms-id}/shipping_profiles è stato spostato dall'oggetto shipping_profile all'oggetto address_category.

Catalogo

API Feed

Si applica alla versione 13.0 e successive.

Il codice di errore di caricamento dell'elenco prodotti XML_JUNK_AFTER_DOCUMENT è stato rinominato DATA_OUTSIDE_XML_TAGS. Si tratta solo di una modifica del nome.

È interessato l'endpoint seguente:

• GET /{feed_upload_session_id}