# API Conversions di Meta (CAPI) per i moduli di contatto: inviare i contatti senza doppi conteggi

> **Risposta**: l'API Conversions di Meta (CAPI) invia gli eventi dal tuo server invece che dal browser del visitatore. Usala insieme al Pixel e assegna **a entrambi lo stesso nome evento e lo stesso ID evento**; Meta ne terrà uno e scarterà il duplicato. I contatti che il Pixel perde (ad blocker, limiti di tracciamento dei browser, schede chiuse) vengono comunque registrati dall'evento lato server.

## Perché il Pixel da solo non basta

Il Pixel funziona nel browser del visitatore. Ad blocker, limiti di tracciamento di iOS e persone che chiudono la scheda subito dopo l'invio fanno perdere eventi. Meta allora sottostima le conversioni e ottimizza gli annunci su meno dati. Una copia lato server colma il vuoto.

## Cosa ti serve

1. **ID del Pixel (dataset)** da Gestione eventi di Meta → Origini dati.
2. **Token di accesso dell'API Conversions**: Gestione eventi → il tuo dataset → Impostazioni → API Conversions → Genera token di accesso.
3. **Codice evento di prova** (facoltativo): compare nella scheda Eventi di prova e inizia con `TEST`.

## Come funziona la deduplicazione

| Inviato da | Nome evento | ID evento |
|---|---|---|
| Pixel nel browser | `Lead` | `fbq('track', 'Lead', {}, {eventID: 'abc123'})` |
| Server (CAPI) | `Lead` | `"event_id": "abc123"` |

Quando da entrambi arrivano lo stesso nome e lo stesso ID, Meta ne tiene uno. Se gli ID sono diversi, o il nome è diverso (per esempio `Lead` e `SubmitApplication`), il contatto viene contato due volte. Genera un unico ID nel browser al momento dell'invio e passalo a entrambi.

## Cosa inserire nell'evento lato server

- `event_name` (Lead), `event_time`, `event_id`, `action_source: "website"`, `event_source_url`
- `user_data`
  - inviati così come sono: `client_ip_address`, `client_user_agent`, `fbc` (cookie dell'ID clic), `fbp` (cookie dell'ID browser)
  - con hash SHA-256: telefono (`ph`, cifre con prefisso internazionale, es. 821012345678), email (`em`, in minuscolo), nome

Più identificatori migliorano la qualità della corrispondenza degli eventi, ma prima sistema il consenso.

## Consenso: i dati con hash restano dati personali

Secondo il Personal Information Protection Act coreano (e la maggior parte delle leggi sulla privacy), applicare un hash a un numero di telefono non lo rende anonimo, e Meta è un destinatario estero. Una configurazione sicura:

1. Aggiungi un consenso separato e facoltativo per il "trasferimento all'estero per la misurazione pubblicitaria": destinatario (Meta Platforms), paese, dati, finalità, conservazione.
2. Includi i recapiti con hash solo per chi ha acconsentito.
3. Per tutti gli altri, invia l'evento solo con IP, user agent e ID dei clic.
4. Non inviare mai informazioni sanitarie come i sintomi.

Vedi [testo di consenso per i moduli di contatto in Corea](/en/guides/landing-consent-text) oppure generalo con lo [strumento gratuito per il consenso](/en/tools/consent).

## Verifica

1. Aggiungi il codice evento di prova e invia un contatto di prova.
2. In Eventi di prova dovresti vedere un evento Browser e uno Server, uno dei quali segnato come deduplicato.
3. Rimuovi il codice di prova prima di andare online.

## Rimanda indietro gli esiti

Quando un contatto diventa una consulenza o una vendita, invia un evento personalizzato lato server con gli stessi identificatori con hash (o un ID esterno). Meta potrà così imparare quali persone vanno oltre la compilazione del modulo.

## Con CutLanding

Incolla l'ID del Pixel e il token di accesso in Impostazioni → Collegamenti. Dopo il salvataggio di un contatto, gli eventi del Pixel e del server partono con lo stesso ID, i recapiti con hash vengono aggiunti solo per chi ha dato il consenso alla misurazione pubblicitaria, i dati sanitari non vengono mai inviati e gli invii falliti vengono ritentati per 24 ore.

## FAQ

### Posso rimuovere il Pixel e usare solo l'API Conversions?

Meta consiglia di usarli entrambi con la deduplicazione. I dati del browser (cookie fbp e fbc) aiutano la corrispondenza, e se una delle due parti fallisce l'altra registra comunque il contatto.

### I miei contatti vengono contati due volte. Perché?

I nomi o gli ID degli eventi sono diversi tra Pixel e server. Usa un unico ID per invio su entrambi i lati e lo stesso nome evento.

### E se il mio token di accesso viene divulgato?

Genera un nuovo token in Gestione eventi e sostituiscilo ovunque sia usato. Conserva il token solo sul server, mai nell'HTML della pagina.


---
Source: https://cutlanding.com/it/guides/meta-conversions-api
© CutLanding (컷랜딩). Quote freely with a link to the source.
