Integrazione con API e file di dati strutturati

Sia i file di dati strutturati (SDF) che l'API Display & Video 360 supportano la gestione collettiva delle configurazioni delle risorse di Display & Video 360. Ogni strumento ha limitazioni uniche. Questa guida suggerisce dei modi per ottimizzare l'implementazione esistente usando entrambi gli strumenti.

Se utilizzi già file di dati strutturati

Utilizza l'API Display & Video 360 per supportare l'integrazione dei file SDF attraverso il recupero programmatico dei file e dei metadati pertinenti.

Genera e scarica file utilizzando l'API

Per impostazione predefinita, i file di dati strutturati vengono scaricati manualmente utilizzando l'interfaccia di Display & Video 360. Questi download sono generalmente limitati a un singolo inserzionista e devono essere avviati da pagine di risorse specifiche. Scaricare grandi quantità di dati SDF tramite l'interfaccia può essere un processo complesso e dispendioso in termini di tempo.

Semplifica questo processo generando e scaricando i file di dati strutturati in modo programmatico mediante l'API Display & Video 360. Leggi la nostra guida per istruzioni dettagliate su come implementare questa funzionalità.

Cercare gli ID di riferimento utilizzando l'API

I file di dati strutturati riflettono le configurazioni delle risorse Display & Video 360. La maggior parte delle colonne dei file SDF utilizza ID numerici per identificare altre risorse o configurazioni di targeting. Spesso è necessario un riferimento per comprendere questi ID durante la lettura e la modifica dei dati SDF.

Utilizza l'API Display & Video 360 per recuperare in blocco le informazioni di riferimento. Puoi recuperare gli ID disponibili utilizzati dalla maggior parte delle colonne SDF utilizzando le funzioni GET o LIST della risorsa pertinente.

Recupera e memorizza nella cache le informazioni di riferimento in modo programmatico per utilizzarle durante l'analisi e la modifica dei file di dati strutturati. Puoi aggiornare regolarmente la cache e, se necessario, cercare ID sconosciuti in tempo reale durante l'analisi dei tuoi SDF per recuperare informazioni su nuove risorse.

Leggi la documentazione di riferimento API per un elenco completo dei metodi e dei servizi API disponibili.

Eccezioni esistenti

Un numero ridotto di ID di riferimento utilizzati dai file di dati strutturati non può essere recuperato con l'API Display & Video 360:

  • Targeting in-market e di affinità: recupera gli ID segmenti di pubblico utilizzati in queste colonne dall'interfaccia di Display & Video 360.
  • ID attività Floodlight di conversione: recupera gli ID attività Floodlight utilizzati in queste colonne dall'interfaccia di Display & Video 360.
  • Targeting origine inventario: recupera gli ID Exchange utilizzati in queste colonne dal riferimento pubblicato per lo scambio SDF. Recupera gli ID origine dell'inventario e gli ID delle piattaforme di scambio pubblicitario secondarie utilizzati in queste colonne utilizzando l'API Display & Video 360.
  • Targeting per app: recupera gli ID app utilizzati in queste colonne dalla piattaforma per app pertinente.

Se utilizzi già l'API Display & Video 360

Utilizza SDF per supportare l'integrazione dell'API Display & Video 360 attraverso la creazione e l'aggiornamento collettivi delle risorse YouTube e Partners.

Aggiornare le risorse di YouTube e partner utilizzando il caricamento di SDF

Non puoi creare o aggiornare le risorse di YouTube e partner, ad esempio tipi specifici di elementi pubblicitari, gruppi di annunci e annunci, utilizzando l'API Display & Video 360. Puoi recuperare le configurazioni e il targeting assegnato per queste risorse, ma eventuali aggiornamenti devono essere eseguiti tramite l'interfaccia di Display & Video 360. Questo limita le azioni collettive e la frequenza con cui puoi aggiornare queste risorse.

Utilizza il caricamento dei file di dati strutturati per creare o aggiornare collettivamente le risorse di YouTube e partner tramite l'interfaccia di Display & Video 360. Anche se devi caricare i file di dati strutturati manualmente, puoi completare la maggior parte del processo, ovvero recuperare e modificare i file in modo programmatico.

Per ulteriori informazioni, consulta la guida alle API sul download dei file SDF e la documentazione sul caricamento dei file SDF.