Accedi

Benvenuto al nostro Centro Assistenza

Ottieni aiuto con integrazione e campagne live.

Benvenuto al nostro Centro Assistenza. Ottieni aiuto con integrazione e campagne live.

Dettagli sulla Marketing API

È possibile accedere alla Criteo API utilizzando questo URL: https://api.criteo.com/marketing

Endpoint

Autenticazione

Tipo

Endpoint

Obiettivo

Parametri

Osservazioni

POST

/oauth2/token

Recupera token che ti consentirà di pubblicare una richiesta sull'API

  • client_id (obbligatorio)
  • client_secret (obbligatorio)
  • grant_type (obbligatorio)

Il token sarà valido per 300 s

 

Gestione inserzionista

Tipo

Endpoint

Obiettivo

Parametri

GET

/portfolio

Recuperare il o i tuoi advertiser_Id

Nessuno

GET

/advertiser/{advertiser_Id}/campaigns

Recuperare la o le tue campagne e la o le tue categorie per uno specifico inserzionista

advertiser_Id (obbligatorio): string

GET

/advertiser/{advertiser_Id}/categories

Recuperare la o le tue campagne e la o le tue categorie per uno specifico inserzionista

Filtrare per stato di categoria

advertiser_Id (obbligatorio): int

enabledOnly: bool

GET

/advertiser/{advertiser_Id}/categories/{categoryHashCode}

Recuperare specifiche categorie per un specifico inserzionista

advertiser_Id (obbligatorio)

categoryHashCode (obbligatorio)

 


Gestione campagna

Tipo

Endpoint

Obiettivo

Parametri

GET

/campaigns/

Recuperare campagna/e per il tuo portafoglio

advertiser_Ids: string

campaignIds: string

campaignstatus: string

bidtype: string

GET

/campaigns/{campaignId}

Recuperare la tua campagna e le tue categorie per una campagna specifica

campaignId (obbligatorio): int

GET

/campaigns/{campaignId}/categories

Recuperare la tua campagna e le tue categorie per una campagna specifica

Filtrare per stato di categoria

campaignId (obbligatorio): int

enabledOnly: string

GET

/campaigns/{campaignId}/categories/{categoryHashCode}

Recuperare categorie di campagne specifiche del tuo portafoglio

campaignId (obbligatorio): int

categoryHashCodes (obbligatorio): int

GET

/campaigns/bids

Recuperare la o le tue offerte per il tuo portafoglio

advertiser_Ids: string

campaignIds: string

categoryHashCodes:string

bidType: string

campaignStatus: string

pendingChanges: bool

PUT

/campaigns/bids

Impostare nuovi valori di offerte per la tua campagna o per le tue categorie di campagne

bidChanges (obbligatorio): string

 

Reporting campagne

Tipo

Endpoint

Obiettivo

Parametri

Osservazioni

POST

/statistics

Recuperare report di performance pubblicitarie

statsQuery (obbligatorio)

Dettagli su questo endpoint nell'apposita sezione di documentazione

 

Gestione budget

Tipo

Endpoint

Obiettivo

Parametri

GET

/budgets

Recuperare budget per il tuo portafoglio

advertiser_Ids: string

budgetIds: string

onlyActiveCampaigns:bool

 

Gestione categorie

Tipo

Endpoint

Obiettivo

Parametri

GET

/categories

Recuperare le tue categorie per il tuo portafoglio

campaign_Ids: : string

advertiser_Ids: string

categoryHashCodes: string

enabledOnly: bool

PUT

/categories

Categorie abilitate o disabilitate

categoriesPerCatalog (obbligatorio)

 

Gestione dell'audience

Tipo

Endpoint

Obiettivo

Parametri

Osservazioni

GET

/audiences

Prendi l'elenco delle audience

advertiser_Id : int

Senza la specifica dell'ID inserzionista, il portafoglio dell'utente verrà restituito

POST

 /audiences/userlist/ 

Creare un'audience

advertiser_Id : int

name: string

description:string

La ID audience è quella seguente (incrementata ogni volta che viene creata un'audience)

PUT

/audiences/{audienceId} 

Modifica metadati di un'audience

name: string

description: string

 

PATCH

/audiences/userlist/{audienceId}

Aggiungi/Rimuovi utenti di un'audience

operation: string (AGGIUNGI 
o RIMUOVI) 

schema: string (email o madid)

identifiers: elenco di stringa

Limite di 50.000 di identificatori per richiesta.

gli identificatori possono essere

email: solo testo, MD5 o SHA256 di MD5

MADID: IDFA o AAID

Nota: l'API non accetta ID di cookie da DMP

CANCELLA 

/audiences/userlist/{audienceId}/users

Rimuovi tutti gli utenti di un'audience

   

CANCELLA 

/audiences/{audienceId}

Cancella un'audience

   

 

Parametri

Parametro

Usato per...

Dettagli

client_id

Recupero token

La tua email (le stesse credenziali di accesso usate per il Criteo Management Center)

client_secret

Recupero token

La tua password (le stesse credenziali di accesso usate per il Criteo Management Center)

grant_type

Recupero token

Sempre uguale a "client_credentials"

advertiser_Id

Recupero dati specifici inserzionista

Recuperato dall' /endpoint portfolio

Recuperati da endpoint / advertisers

Recuperati da endpoint / audience

Recuperati da /audiences/userlist/ 

advertiser_Ids

Recupero dati di specifici inserzionisti

Recuperati da endpoint / budget

Recuperati da endpoint / campaigns

Recuperati da endpoint /campaigns/bids

Recuperati da endpoint / categories

Recuperati da endpoint / statistics

È possibile richiedere advertiser_Ids multipli separandoli con virgole, ad es. 1,2,3

enabledOnly

Filtrare elenco categorie

Recuperato da endpoint / categorie

Recuperate dall'endpoint /advertiser/{advertiser_id}/categories

Recuperato da endpoint /campaigns/{campaignid}/categories

enabled

aggiornare stato categoria

Recuperato da endpoint / categorie

categoryHashCode

Recupero dati categoria specifica

Aggiornamento stato categoria specifica

Recuperati dall'endpoint /advertiser/{advertiser_id}/categories/{categoriesHashCode}

categoryHashCodes

Recupero dati categorie specifiche

Aggiornamento valore offerta categorie specifiche campagna

Recuperati da endpoint / categories

Recuperati da endpoint /campaigns/bids

Recuperato da endpoint /campaigns/{campaignid}//categories/{categoriesHashCode}

È possibile richiedere categoryhashcodes multipli separandoli con virgole, ed es. 1,2,3

budgetIds

Recupero dati budget specifico

Recuperati da endpoint / budget

onlyactiveCampaigns

Filtrare campagne per stato

Recuperati da endpoint / budget

campaignID

Recupero dati campagna specifica

Aggiornamento valore offerta campagna specifica

Recuperati da endpoint /campaigns/{campaignid}

Recuperato da endpoint /campaigns/{campaignid}/categories

Recuperati da endpoint /campaigns/{campaignid}/categories/{categoriesHashCode}

Recuperati da endpoint /campaigns/bids

campaignIds

Recupero dati campagne specifiche

Recuperati da endpoint / campaigns

Recuperati da endpoint /campaigns/bids

Recuperati da endpoint / categories

È possibile richiedere campaignids multipli separandoli con virgole, ad es. 1,2,3

bidType

Filtrare per tipi di offerta

Recuperati da endpoint / campaigns

Recuperati da endpoint / campaigns/bids

bidValue

Aggiornamento valore offerta categorie specifiche campagna

Recuperati da endpoint / campaigns/bids

campaignStatus

Filtrare per stato campagna

Recuperati da endpoint / campaigns

Recuperati da endpoint /campaigns/bids

pendingChanges

Filtrare la campagna con modifiche in corso o decise

Recuperati da endpoint /campaigns/bids

catalogId

Aggiornare lo stato della categoria

Recuperato da endpoint / categorie

audienceId

Aggiornare un'audience specifica

Recuperata da / audiences/ 

Nome

Aggiornare nome audience

Recuperato da endpoint /audiences/userlist/ 

Recuperato dall'endpoint /audiences/{audience_id} 

description

Aggiornare descrizione audience

Recuperato da endpoint /audiences/userlist/ 

Recuperato dall'endpoint /audiences/{audience_id} 

Funzionamento

Azione su un'audience

Recuperata da endpoint /audiences/userlist/{audience_id} 

Il valore deve derivare dai seguenti: AGGIUNGI / RIMUOVI

Schema

Tipo di dati audience

Recuperati da endpoint /audiences/userlist/{audience_id} 

Identificatori

Identificatore elenco di utenti

Recuperato dall'endpoint /audiences/{audience_id} 

reportType

Export report statistiche

Recuperato da /statistics

Il valore deve derivare da quanto segue: Performance campagna / Report DPA Facebook / Report ID transazione

ignoreXDevice

Export report statistiche

Recuperato da /statistics

startDate

Export report statistiche

Recuperato da /statistics

endDate

Export report statistiche

Recuperato da /statistics

dimensions

Export report statistiche

Recuperato da /statistics

Max 3 dimensioni

metrics

Export report statistiche

Recuperato da /statistics

Le metriche devono essere prese da MC UI

format

Export report statistiche

Recuperato da /statistics

Il valore deve derivare dai seguenti: XML, JSON, CSV, EXCEL, HTML

valuta

Export report statistiche

Recuperato da /statistics

Il valore deve essere un codice valuta ISO

Fuso orario

Export report statistiche

Recuperato da /statistics

Il valore deve derivare da quanto segue: GMT / PST / JST 


Codici di risposta

Codice di risposta

Motivo

200

Riuscito

400

Richiesta non valida, sintassi non valida

401

Autenticazione non riuscita

403

Accesso non consentito

429

Limite quota raggiunto, non più di 200 richieste al minuto, per cliente

500

Errore sconosciuto

Questo articolo ti è stato utile?
Utenti che ritengono sia utile: 0 su 0
Powered by Zendesk