> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Pixel e Conversions API

> Configurare il tracciamento delle conversioni Facebook e Instagram nel tuo store storekit con Meta Pixel ed eventi Purchase server-side via Conversions API.

Usa il tracciamento Meta per misurare in che modo gli annunci Facebook e Instagram contribuiscono a visite, attività di checkout e ordini sul tuo store storekit.

La configurazione consigliata da storekit utilizza:

* Un Meta Pixel o dataset ID per identificare la corretta origine dati
* Eventi browser per l'attività del cliente, come page view e checkout
* La Meta Conversions API (CAPI) per eventi Purchase affidabili lato server, quando abilitata per il tuo store

## Prima di iniziare

Ti serve:

* L'accesso al Meta Business Portfolio o Business Suite della tua organizzazione
* L'autorizzazione a gestire il Pixel o il dataset in Meta Events Manager
* L'URL dello store storekit che vuoi misurare
* L'approvazione della persona responsabile della tua informativa sulla privacy, del consenso ai cookie e della misurazione pubblicitaria

Meta mostra sempre più spesso le origini degli eventi web come **dataset** in Events Manager. Un dataset collegato a un Pixel può usare lo stesso ID. Meta documenta la relazione in [About datasets in Meta Events Manager](https://www.facebook.com/business/help/750785952855662).

## Ti serve un'app Meta?

Normalmente non è necessario creare una tua app Meta per una configurazione manuale di storekit.

Meta consiglia di generare l'access token tramite Events Manager. Il flusso **Manage Integrations** documentato da Meta crea l'app Conversions API e il system user necessari senza App Review. Un'app personalizzata serve generalmente solo a un'organizzazione che sta costruendo un proprio onboarding basato su OAuth o che gestisce molti inserzionisti in modo programmatico.

Consulta la [guida introduttiva Conversions API](https://developers.facebook.com/docs/marketing-api/conversions-api/get-started/) attuale di Meta prima di creare le credenziali, perché Meta potrebbe modificare le etichette o i requisiti di permessi.

## 1. Seleziona o crea l'origine dati Meta

In [Meta Events Manager](https://www.facebook.com/events_manager2), seleziona il Pixel o il dataset che deve ricevere gli eventi da questo store.

Usa la stessa origine dati per gli eventi browser e server. Creare origini dati separate per lo stesso storefront rende più difficili l'attribuzione e la deduplicazione.

Annota il suo Pixel o dataset ID. Non confonderlo con un ad account ID, un Business Portfolio ID o un Meta app ID.

## 2. Aggiungi l'ID a storekit

L'integrazione Meta Pixel si configura separatamente per ogni store.

**1. Apri l'integrazione Meta Pixel**

Nella dashboard storekit, vai su **Stores** → il tuo store → **Settings** → **Integrations** → **Meta Pixel**.

**2. Inserisci l'ID dell'origine dati**

Inserisci l'ID in **Meta Pixel ID**.

**3. Salva l'impostazione**

Clicca su **Save**.

Ripeti questi passaggi per ogni store che deve inviare eventi alla stessa origine dati Meta o a una diversa.

## 3. Genera un access token per Conversions API

Nel tuo account Meta Business, apri Events Manager e seleziona il Pixel o il dataset. Poi apri **Settings**, trova **Conversions API** e in **Set up manually** scegli **Generate access token**.

Meta specifica che l'opzione del token è visibile solo agli utenti con permessi business sufficienti. Se l'opzione non è disponibile, chiedi a un amministratore Meta Business di completare il passaggio o di concederti l'accesso necessario.

Torna nell'integrazione **Meta Pixel** di storekit, inserisci il token in **Conversions API access token** e clicca su **Save**. Il tracciamento lato server è abilitato quando sono salvati sia il Pixel ID sia l'access token.

> [!WARNING]
>
> Tratta l'access token come una password. Incollalo solo in **Conversions API access token**. Non inserirlo in un ticket di supporto, in un documento condiviso, in un tag di analytics, nel codice del browser, in uno screenshot o in un messaggio di chat.

## 4. Comprendi quali eventi vengono inviati

La configurazione attuale può includere:

| Consegna | Eventi | Note |
| - | - | - |
| Meta Pixel browser | `PageView`, `AddToCart`, `InitiateCheckout`, `Purchase` | Abilitata dall'impostazione **Meta Pixel ID** |
| Conversions API | `Purchase` | Abilitata quando sono salvati sia **Meta Pixel ID** sia **Conversions API access token** |

I valori Purchase lato server provengono dall'ordine storekit completato, non dai valori forniti dal browser. Gli identificativi del cliente possono essere normalizzati e sottoposti a hash SHA-256 prima della consegna; possono essere inviati anche informazioni di contesto del sito come indirizzo IP, user agent del browser e URL di origine, per supportare matching e attribuzione.

## 5. Testa prima di avviare le campagne

### Verifica gli eventi browser

1. Installa l'estensione browser **Meta Pixel Helper** di Meta
2. Apri lo store storekit
3. Visita un menu, aggiungi un articolo e avvia il checkout
4. Conferma che gli eventi previsti utilizzino il Pixel o dataset ID desiderato

### Verifica gli eventi server

Lo strumento **Test Events** di Meta richiede l'inclusione di un `test_event_code` temporaneo nella richiesta server. Chiedi al supporto storekit di coordinare questo test; non esiste un campo per il codice nella dashboard.

Nel tuo account Meta Business, apri Events Manager, seleziona il Pixel o il dataset e poi apri **Test Events**.

1. Fornisci il codice di test generato tramite il processo sicuro concordato con il supporto storekit
2. Effettua un ordine di test
3. Conferma che Meta riceva un `Purchase` lato server

Rimuovi il codice di test dopo la verifica. Meta avverte che i Test Events possono comunque essere usati per la misurazione degli annunci, quindi esegui un test controllato reale invece di inviare ripetutamente ordini di produzione con un codice di test.

Puoi anche controllare **Overview** in Events Manager dopo un ordine reale per confermare che gli eventi di produzione stiano arrivando.

## Previeni eventi Purchase duplicati

Eventi Purchase duplicati possono gonfiare il fatturato riportato e le performance delle campagne.

* Non aggiungere un secondo tag Meta `Purchase` tramite Google Tag Manager
* Non installare un altro plugin Meta Pixel sullo stesso store
* Usa lo stesso Pixel o dataset per la consegna browser e server
* Coordina con il supporto storekit il rollout da browser a server

Meta deduplica gli eventi browser e server corrispondenti solo quando riportano lo stesso event name e event ID. Se Events Manager mostra eventi Purchase Browser e Server separati anziché un evento deduplicato, sospendi le decisioni sulle campagne basate su quei totali e contatta il supporto storekit.

## Privacy e consenso

La consegna lato server non elimina i tuoi obblighi in materia di privacy né sostituisce i controlli sui cookie e sul consenso.

Prima di abilitare il tracciamento Meta:

* Conferma la base giuridica per la misurazione pubblicitaria in ogni regione in cui operi
* Aggiorna le informative sulla privacy e sui cookie per descrivere Meta e la misurazione delle conversioni lato server
* Assicurati che la configurazione del consenso corrisponda alle indicazioni del tuo team legale o di privacy
* Evita di inviare dati che la tua organizzazione non ha approvato per l'uso pubblicitario
* Rivedi i Business Tools Terms di Meta e i requisiti di trattamento dei dati

## Rollout consigliato

1. Configura prima uno store non critico
2. Verifica il Pixel o dataset ID
3. Controlla gli eventi browser prima di abilitare la consegna lato server
4. Inserisci il Conversions API access token e salva l'integrazione
5. Completa un ordine di test controllato
6. Conferma che venga conteggiato un solo Purchase, senza fatturato duplicato
7. Confronta gli ordini storekit con i report Meta per diversi giorni
8. Estendi il rollout ai restanti store

## Risoluzione dei problemi

### L'opzione dell'access token non è visibile

Potresti non avere permessi Meta Business sufficienti. Chiedi a un amministratore di verificare il tuo accesso al Pixel o al dataset e segui la guida introduttiva attuale di Meta.

### Nessun Purchase server appare

Verifica che:

* Sia **Meta Pixel ID** sia **Conversions API access token** siano salvati
* Il Pixel o dataset ID corrisponda all'origine dati Meta selezionata
* L'ordine di test sia stato completato correttamente
* Events Manager mostri l'intervallo di date e l'origine dati previsti

### Il fatturato è superiore a quello di storekit

Cerca eventi Purchase Browser e Server duplicati, tag Purchase personalizzati in GTM, un altro plugin Pixel o lo stesso ordine di test inviato più di una volta.

### Gli eventi hanno una match quality bassa

Completa il test con dati cliente realistici, verifica che lo storefront fornisca un user agent del browser e un URL di origine normali e consulta la diagnostica di Meta per parametri mancanti.

## Correlati

> **[Google Tag Manager](/docs/it/guides/integrations/marketing/google-tag-manager)**
>
> Configura GTM separatamente dal tracciamento Meta

> **[Dati dei clienti](/docs/it/guides/marketing/customer-data)**
>
> Comprendi le informazioni sui clienti memorizzate in storekit


## Related topics

- [Google Tag Manager](/docs/it/guides/integrations/marketing/google-tag-manager.md)
- [Tracciamento eventi](/docs/it/privacy-security/event-tracking.md)
- [API e webhook](/docs/it/guides/integrations/api-webhooks.md)
- [Formato della risposta](/docs/it/developers/mcp/response-format.md)
- [1. Crea il tuo negozio](/docs/it/getting-started/launch/create-your-store.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.