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.

Ricerca

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

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.
`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.

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.

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':6003119440445}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsuggestions

Fornisci questi parametri:

Nome Descrizione

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.
`locale` tipo: stringa	Facoltativo. La lingua in cui visualizzare i nomi e le descrizioni del pubblico. La lingua predefinita è quella dell'account pubblicitario.

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.

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

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.

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

Nome	Descrizione
`valid` tipo: booleano	Se il pubblico della targetizzazione è valido o meno.

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.