API Marketing

Targetizzazione dettagliata

Con Ricerca targetizzazione, puoi trovare la targetizzazione con un tipo specifico di targetizzazione in una singola chiamata API. Con l'API Detailed Targeting, puoi cercare contemporaneamente più tipi di targetizzazione in una singola richiesta. Inoltre, puoi ottenere suggerimenti sulla base della tua query.

L'API ha quattro endpoint: Ricerca, Suggerimenti, Sfoglia e Convalida.

La risposta per questi endpoint include quanto segue:

Nome Descrizione

id

tipo: stringa

ID del pubblico di destinazione

name

tipo: stringa

Nome del pubblico di destinazione

audience_size_lower_bound

intero

Minorante delle dimensioni stimate del pubblico di destinazione

audience_size_upper_bound

intero

Maggiorante delle dimensioni stimate del pubblico di destinazione

path

tipo: array di stringhe

Include la categoria e tutte le categorie principali nelle quali rientra la targetizzazione

description

tipo: stringa

Descrizione breve del pubblico di destinazione

Se non fornisci limit_type, filtreremo i risultati con meno di 2000 persone in quattro categorie: work_employers, work_positions, education_majors, education_schools. In caso contrario, otterrai risultati meno significativi. Quando usi limit_type, viene applicato un filtro in base a una di queste quattro categorie e non viene restituito tutto.

Recupera gruppi di pubblico di destinazione per le tue inserzioni che corrispondono alla query di ricerca. In questo endpoint, puoi fornire i parametri seguenti:

curl -G \
-d "q=harvard" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsearch
Nome Descrizione

q

tipo: stringa

Obbligatorio.

Stringa della query

limit

tipo: intero

Facoltativo.

Numero di risultati

limit_type

tipo: stringa

Facoltativo.

Limita il tipo di pubblico da recuperare. Per impostazione predefinita, vengono recuperati tutti i tipi.

Valori validi:

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

tipo: stringa

Facoltativo.

La lingua in cui visualizzare i nomi e le descrizioni del pubblico, se disponibile. La lingua predefinita è quella dell'account pubblicitario.

Suggerimenti

Restituisce gruppi di pubblico aggiuntivi che puoi targetizzare in base ad alcuni gruppi di pubblico selezionati forniti.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003263791114}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsuggestions

Fornisci questi parametri:

Nome Descrizione

targeting_list

tipo: array di {'type':'{TYPE}', 'id':{ID}}

Obbligatorio.

Array di coppie di {'type':'{TYPE}', 'id':{ID}} come pubblico di input per i suggerimenti.

limit

tipo: intero

Facoltativo.

Numero di risultati. Il valore predefinito è 30. Il valore massimo è 45.

limit_type

tipo: stringa

Facoltativo.

Limita il tipo di pubblico da recuperare. Per impostazione predefinita, vengono recuperati tutti i tipi.

Valori validi:

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

tipo: stringa

Facoltativo.

La lingua in cui visualizzare i nomi e le descrizioni del pubblico. La lingua predefinita è quella dell'account pubblicitario.

Sfoglia

Ottieni la targetizzazione in una tassonomia strutturata per categorie di Facebook, fornitori di dati di terze parti e alcuni interessi. I risultati di questo endpoint vengono visualizzati nella funzionalità Sfoglia nel componente dell'interfaccia utente della targetizzazione dettagliata in Gestione inserzioni.

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingbrowse

Fornisci i parametri facoltativi seguenti:

Nome Descrizione

limit_type

tipo: stringa

Limita il tipo di pubblico da recuperare. Per impostazione predefinita, vengono recuperati tutti i tipi.

locale

tipo: stringa

La lingua in cui visualizzare i nomi e le descrizioni del pubblico. La lingua predefinita è quella dell'account pubblicitario.

Convalida

Verifica se un pubblico è valido o meno per la targetizzazione. Questa funzione è utile se hai già creato un gruppo di inserzioni e desideri verificare se le sue specifiche di targetizzazione sono ancora valide. Se la targetizzazione non è valida, devi eliminarla dalla specifica di targetizzazione.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003283735711}, {'type':'relationship_statuses','id':100}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingvalidation

Oltre ai campi di risposta standard della targetizzazione dettagliata, questo endpoint restituisce anche:

Nome Descrizione

valid

tipo: booleano

Se il pubblico della targetizzazione è valido o meno.

Ecco la lista dei parametri di input:

Nome Descrizione

targeting_list

tipo: array di {'type':'{TYPE}', 'id':{ID}}

Array di coppie di {'type':'{TYPE}', 'id':{ID}} per la convalida. Preferito.

id_list

tipo: array di stringhe

Array di ID per la convalida. Va a buon fine solo se un ID è identificabile in modo univoco nel nostro database del pubblico.

name_list

tipo: array di stringhe

Array di stringhe per la convalida. Solo interessi, non fa distinzione tra maiuscole e minuscole.

locale

tipo: stringa

Lingua in cui visualizzare i nomi e le descrizioni del pubblico. La lingua predefinita è quella dell'account pubblicitario.

Fornisci almeno uno dei seguenti: targeting_list, id_list e name_list.