Integrazione con API e file di dati strutturati

Sia i file di dati strutturati (SDF) sia 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 modi per ottimizzare l'implementazione esistente utilizzando entrambi gli strumenti.

Se utilizzi già i file di dati strutturati

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

Generare e scaricare 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. Il download di molti dati SDF tramite l'interfaccia può essere complesso e richiedere molto tempo.

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

Cercare gli ID riferimento utilizzando l'API

I file di dati strutturati riflettono le configurazioni delle risorse di Display & Video 360. La maggior parte delle colonne SDF utilizza ID numerici per identificare altre risorse o configurazioni di targeting. Spesso hai bisogno di un riferimento per comprendere questi ID quando leggi e modifichi i 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 gli ID sconosciuti in tempo reale durante l'analisi dei tuoi SDF per recuperare informazioni sulle nuove risorse.

Consulta la documentazione di riferimento dell'API per un elenco esaustivo di servizi e metodi API disponibili.

Eccezioni esistenti

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

  • Targeting per affinità e in-market: recupera gli ID segmento 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 piattaforma di scambio pubblicitario utilizzati in queste colonne dal riferimento alla piattaforma di scambio pubblicitario SDF pubblicato. Recupera gli ID origine inventario e gli ID sub-exchange utilizzati in queste colonne utilizzando l'API Display & Video 360.
  • Targeting per app: recupera gli ID app utilizzati in queste colonne dalla piattaforma app pertinente.

Se utilizzi già l'API Display & Video 360

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

Aggiornare le risorse YouTube e partner utilizzando il caricamento SDF

Non puoi creare o aggiornare risorse YouTube e partner, come 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 tutti gli aggiornamenti devono essere eseguiti tramite l'interfaccia di Display & Video 360. Ciò limita le azioni collettive e la velocità con cui puoi aggiornare queste risorse.

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

Per saperne di più, leggi la guida all'API sul download dei file SDF e la documentazione sul caricamento dei file SDF.