Pubblico personalizzato in base alle interazioni

Crea un pubblico personalizzato basato su persone che hanno interagito con i tuoi contenuti su Facebook o Instagram. I tipi di pubblico attualmente supportati includono Pagina, profilo business di Instagram, inserzioni per acquisizione contatti, inserzioni per esperienze interattive, shopping e realtà aumentata.

Questa guida descrive l'API utilizzando come esempio il pubblico in base alle interazioni con la Pagina. Facebook aggiorna il tuo pubblico personalizzato per le interazioni con la Pagina aggiungendo continuamente persone che interagiscono con la tua Pagina. Quando crei per la prima volta questo pubblico, Facebook lo precompila con una lista di persone che hanno già interagito con la tua Pagina nel periodo di mantenimento specificato.

Da settembre 2018, non è più supportato subtype per gruppi di pubblico personalizzato per siti web, app, gruppi di pubblico personalizzato in base alle interazioni e gruppi di pubblico da dati di conversione offline. L'unica eccezione è che subtype è ancora supportato per i gruppi di pubblico personalizzato in base alle interazioni per i video.
Se stati creando gruppi di pubblico dall'Europa o con targetizzazione di utenti in Europa, vedi la modifica del 2 dicembre 2020 senza cambio di versione.

Creazione di un pubblico

Per creare un pubblico personalizzato in base alle interazioni, l'account pubblicitario deve accettare le Condizioni d'uso per il pubblico personalizzato in Gestione inserzioni.

Per creare un pubblico che elenchi le persone che hanno interagito con la tua Pagina in base all'evento page_engaged:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

Parametri

Nome	Descrizione
`name` stringa	Obbligatorio. Nome del pubblico personalizzato.
`rule` Oggetto JSON	Obbligatorio. Regole per definire il pubblico. Segue la stessa sintassi del pubblico personalizzato dal sito web.

Il pubblico personalizzato in base alle interazioni è un tipo di pubblico personalizzato. Per tutti i campi disponibili, vedi Riferimento per il pubblico personalizzato.

Nota: ogni account pubblicitario può creare un massimo di 500 gruppi di pubblico personalizzato in base alle interazioni.

Regole di interazione

Puoi determinare se Facebook aggiunge qualcuno al pubblico personalizzato o meno con le Regole del pubblico.

Specifica i campi type e id in event_sources nella regola per indicare type e id dell'oggetto di interazione. Il campo id accetta un singolo ID oggetto o array di ID dello stesso tipo.

Sono origini di eventi supportati e ID oggetto di interazione corrispondenti:

page: ID Pagina Facebook.
lead: ID modulo per l'acquisizione di contatti.
ig_lead_generation: ID modulo per l'acquisizione di contatti.
canvas: ID Canvas.
ig_business: ID profilo business di Instagram.
shopping_page: ID della Pagina dello Shop di Facebook.
shopping_ig: ID dello Shop di Instagram.
ar_experience: un'esperienza interattiva che utilizza un effetto AR.
ar_effects: un effetto Facebook o Instagram che possiedi. Non include gli effetti usati nelle inserzioni.

Ogni regola è composta da un object_id e un event_name.

Pagine

Imposta object_id come ID della Pagina. In event_name, usa uno dei seguenti eventi di interazione:

page_engaged: persone che hanno visitato la tua Pagina o hanno interagito con i contenuti o le inserzioni della tua Pagina, su Facebook o Messenger. Questo è il tipo di interazione più inclusivo e include tutti gli altri tipi di interazione.
page_visited: persone che hanno visitato la tua Pagina.
page_liked: persone che attualmente hanno messo Mi piace alla tua Pagina (consulta i dettagli sul mantenimento e le regole relative ai "Mi piace" sulla Pagina).
page_messaged: persone che hanno inviato un messaggio alla tua Pagina.
page_cta_clicked: persone che hanno fatto clic su qualsiasi pulsante di call to action sulla tua Pagina (ad esempio, "Contattaci" o "Acquista ora").
page_or_post_save: persone che hanno salvato la tua Pagina o uno dei suoi post.
page_post_interaction: persone che hanno interagito con uno dei post della Pagina. Le interazioni includono reazioni (ovvero Mi piace, Love, Ahah, Wow, Sigh, Grrr), condivisioni, commenti, clic sui link o scorrimento di un carosello.

Inserzioni per acquisizione contatti

Imposta object_id su FORM_ID e rule per monitorare uno dei seguenti eventi di inserzione per acquisizione contatti:

lead_generation_submitted: tutti gli utenti che hanno compilato e inviato il modulo.
lead_generation_dropoff: tutti gli utenti che hanno chiuso il modulo senza inviarlo. Possono avere o meno compilato alcuni campi.
lead_generation_opened: tutte le persone che hanno aperto il modulo di generazione di contatti indipendentemente dal fatto che lo abbiano inviato.

Esperienze interattive

Imposta object_id su "CANVAS_ID". La rule deve monitorare uno degli eventi seguenti:

instant_shopping_document_open
instant_shopping_document_pause
instant_shopping_document_resume
instant_shopping_document_close
instant_shopping_did_scroll
instant_shopping_element_click
instant_shopping_element_impression

Profilo business di Instagram

L'object_id deve essere l'"INSTAGRAM_BUSINESS_PROFILE_ID" e la rule deve monitorare uno degli eventi del profilo business di Instagram seguenti:

ig_business_profile_all: persone che hanno visitato il tuo profilo business di Instagram o che hanno interagito con contenuti o inserzioni del tuo profilo business di Instagram. Questo è il tipo di interazione più inclusivo e include tutti gli altri tipi di interazione. È un'unione di ig_business_profile_engaged, ig_user_messaged_business e ig_user_messaged_business.
ig_business_profile_engaged: persone che hanno interagito con il profilo business di Instagram o con i contenuti o le inserzioni del profilo business di Instagram.
ig_user_messaged_business: persone che hanno inviato messaggi al tuo profilo business di Instagram.
ig_business_profile_visit: persone che hanno visitato il tuo profilo business di Instagram.
ig_business_profile_ad_saved: persone che hanno salvato contenuti o inserzioni organici dal tuo profilo business di Instagram.
ig_ad_like
ig_ad_comment
ig_ad_share
ig_ad_save
ig_ad_cta_click
ig_ad_carousel_swipe
ig_organic_like
ig_organic_comment
ig_organic_share
ig_organic_save
ig_organic_swipe
ig_organic_carousel_swipe

Il tipo di creator di contenuti multimediali di Instagram attualmente non è supportato per la creazione di pubblico personalizzato in base alle interazioni video.

Shopping

Una regola sulle interazioni per lo shopping deve monitorare uno degli eventi seguenti:

VIEW_CONTENT: persone che hanno visualizzato la pagina dei dettagli dei prodotti. Questa opzione è disponibile a livello globale.
ADD_TO_CART: persone che hanno aggiunto il tuo prodotto al carrello. Questa opzione è disponibile solo per le aziende abilitate al pagamento e solo per i consumatori negli Stati Uniti.
PURCHASE: persone che hanno acquistato i tuoi prodotti. Questa opzione è disponibile solo per le aziende abilitate al pagamento e solo per i consumatori negli Stati Uniti.

Per creare una regola che aggiunge persone che hanno visualizzato il tuo prodotto:

curl -i -X POST
-F 'name="test_api"'\
-F 'rule= {
	"inclusions": {
		"operator": "or",
		"rules": [
			{
				"event_sources": [
					{
						"id": "<ID>",
						"type": "shopping_ig"
					}
				]
				"retention_seconds": <RETENTION_SECONDS>,
				"filter": {
					"operator": "and",
					"filters": [
						{
						"field":"event",
						"operator":"eq",
						"value": "VIEW_CONTENT"
						}
					]
				}
			}
		]
	}
}
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

I parametri page_messaged e ig_user_messaged_business potrebbero non essere disponibili in Europa a causa delle nuove leggi sulla privacy.

Realtà aumentata

Il pubblico personalizzato in base alle interazioni con la realtà aumentata può contenere due parti: esperienza AR ed effetto AR.

Per un pubblico personalizzato in base alle interazioni con un'esperienza AR, imposta l'object_id come ID del contenitore dati delle inserzioni AR e per il event_name archiviato usa ar_camera_open o camera_cta_click.
Per un pubblico personalizzato in base alle interazioni con un effetto AR, imposta l'object_id come ID dell'effetto AR e usa ar_effect_open per il campo event_name.

Giorni di mantenimento massimi

Per i requisiti legali e di privacy, sono consentiti giorni di mantenimento massimi diversi per ogni tipo di origine di evento:

Inserzioni per generazione di contatti: 90 giorni
Profilo business di Instagram: 730 giorni
Pagina: 730 giorni
- Nota: il pubblico di "Mi piace" sulla Pagina non ha mantenimento
Esperienze interattive, precedentemente note come Canvas: 730 giorni
Shopping: 365 giorni. I dati sono disponibili da aprile 2020.
Realtà aumentata: 365 giorni

Regole di interazione con sezione di esclusione

Le regole del pubblico in base alle interazioni sono compatibili con le regole di pubblico personalizzate del sito web. Pertanto, possono avere più regole di inclusione ed esclusione. Gli utenti che soddisfano almeno una delle regole saranno aggiunti al pubblico.

Nell'esempio seguente, creiamo un gruppo di pubblico che include gli utenti che hanno visitato la tua Pagina o che hanno interagito con la tua Pagina, ma esclude gli utenti che hanno cliccato sulla call to action:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       },
       "exclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_cta_clicked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

Per maggiori informazioni, consulta Pubblico personalizzato dal tuo sito web.

Regole multiple

Il pubblico creato in base alle interazioni può avere più regole e al pubblico saranno aggiunti gli utenti che soddisfano almeno una delle regole. Un esempio di creazione di un pubblico che include gli utenti che hanno inviato messaggi alla tua Pagina o cliccato sulla call to action:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 },
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

Pagine multiple

Le regole non sono limitate a una singola Pagina. Puoi avere una Pagina diversa per ogni regola e gli utenti che hanno interagito con almeno una delle Pagine verranno inclusi nel pubblico.

Di seguito è riportato un esempio di pubblico che include tutti gli utenti che hanno visitato almeno una delle tre Pagine:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               },
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

Per dettagli sul pubblico personalizzato, consulta Pubblico personalizzato, Riferimento.

Mantenimento e regole relative ai "Mi piace" sulla Pagina

Il pubblico di "Mi piace" sulla Pagina non ha mantenimento (retention_seconds=0). Inoltre, le regole dei "Mi piace" sulla Pagina non possono essere combinate con altri eventi della Pagina.

Di seguito è riportato un esempio di creazione di un pubblico di "Mi piace" sulla Pagina:

curl -X POST \
  -F 'name="Page Likes Audience Name"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 0,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_liked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences