Riferimento

Post

EndpointDescrizione

/{ad-account-id}/ads

Crea un'inserzione.

/{agreement-request-id}

Approva o rifiuta una richiesta di contratto aziendale in sospeso.

/{business-creative-folder-id}

Crea e aggiorna una cartella delle creatività business.

/{business-id}/creative_folders

Fornisce una cartella delle creatività business.

/{business-id}/images

Carica immagini in una cartella delle creatività.

/{business-id}/videos

Carica video in una cartella delle creatività.

/{business-creative-folder-id}/agencies

Aggiunge un partner a una cartella delle creatività.

/{business-creative-folder-id}/assigned_users

Ottiene una lista di persone che hanno accesso alla cartella delle creatività business.

Lettura

EndpointDescrizione

/{business-creative-folder-id}

Ottiene dettagli su una cartella delle creatività business.

/{business-id}/creative_folders

Ottiene una lista di cartelle delle creatività business a cui un'azienda può accedere.

/{business-id}/creatives

Ottiene immagini aziendali e video aziendali dell'azienda.

/{business-id}/initiated_sharing_agreement

Ottiene una lista di richieste di contratti in sospeso.


Questo endpoint è stato reintrodotto a maggio 2020. In precedenza, /initiated_sharing_agreement era stato dichiarato obsoleto con il lancio di API Graph V6.0.

/{business-image-id}

Ottiene dettagli per un'immagine.

/{business-image-id}/insights

Ottiene insight per un'immagine condivisa.

/{business-video-id}

Ottiene dettagli del video condiviso.

/{business-video-id}/insights

Ottiene insight per il video condiviso.

/{business-creative-folder-id}/agencies

Ottiene una lista di aziende che hanno accesso alla tua cartella delle creatività.

/{business-creative-folder-id}/assigned_users

Ottiene una lista di persone che hanno accesso alla tua cartella delle creatività.

Eliminazione

EndpointDescrizione
/{business-creative-folder-id}

Elimina una cartella delle creatività.

/{business-creative-folder-id}/agencies

Rimuove un partner dalla cartella delle creatività.

/{business-creative-folder-id}/assigned_users

Rimuove un utente dalla cartella delle creatività.

/{business-image-id}

Rimuove un'immagine condivisa.

/{business-video-id}

Rimuove un video condiviso.

Attività consentite

Attività autorizzata per l'utente businessDescrizione

CREATE_CONTENT

Questo utente può creare cartelle.

MANAGE_CONTENT

Questo utente può gestire le risorse della cartella delle creatività.

MANAGE_PERMISSIONS

Questo utente può gestire le autorizzazioni della cartella delle creatività business.

VIEW_CONTENT

Questo utente può visualizzare le risorse in una cartella delle creatività.

VIEW_INSIGHTS

Questo utente può visualizzare gli insight per una risorsa creatività.

Insight

Queste metriche sono in fase di sviluppo.

Nome della metricaDescrizione
impressions

Il numero di volte in cui la tua immagine o il tuo video sono stati visualizzati in un'inserzione.

inline_link_clicks

Il numero di clic sui link nella tua inserzione. I clic sul link in linea usano una finestra di attribuzione per clic fissa di 1 giorno.

video_play_actions

Il numero di volte in cui il tuo video inizia a essere riprodotto. Contiamo per ogni impression del video ed escludiamo le riproduzioni ripetute.

actions

Il numero totale di azioni che le persone hanno eseguito attribuite alle tue inserzioni. Le azioni possono includere interazioni, clic o conversioni. Consulta questo documento per una lista completa dei tipi supportati.

video_thruplay_watched_actions

Il numero di volte in cui il tuo video è stato riprodotto fino alla fine o per almeno 15 secondi.

quality_ranking

Una classifica della qualità percepita della tua inserzione. La qualità viene misurata usando il feedback di un'inserzione e l'esperienza post-clic. Un'inserzione è classificata rispetto ad altre inserzioni che competono per lo stesso pubblico.


Valori possibili includono:

  • BELOW_AVERAGE_10
  • BELOW_AVERAGE_20
  • BELOW_AVERAGE_35
  • AVERAGE
  • ABOVE_AVERAGE
  • UNKNOWN, se non ci sono abbastanza informazioni sull'inserzione.

Questo è correlato alla diagnostica di rilevanza dell'inserzione.

Sono disponibili i seguenti dettagli:

  • age
  • gender
  • country
  • objective
  • publisher_platform
  • platform_position
  • device_platform
  • optimization_goal