Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Invio WhatsApp di eventi di conversione in AWS Messaggistica social per gli utenti finali
Se pubblichi campagne «Ads that Click to WhatsApp» su «Meta, puoi inviare gli eventi di conversione (ad esempio acquisti, lead o visualizzazioni di contenuti) a Meta per l'attribuzione e l'ottimizzazione degli annunci. Invia questi eventi direttamente tramite AWS End User Messaging Social, senza chiamare l'API Meta Graph.
AWS End User Messaging Social fornisce due API per questo flusso di lavoro:
+ **CreateWhatsAppDataset**— Crea (o recupera) il set di dati sulle conversioni per il tuo account WhatsApp aziendale (WABA). Un set di dati è il contenitore Meta utilizzato per ricevere e attribuire gli eventi di conversione.
+ **SendWhatsAppConversionEvent**— Invia uno o più eventi di conversione all'API Meta Conversions, dove vengono attribuiti al clic sull'annuncio che ha avviato la WhatsApp conversazione.
## Come funziona il monitoraggio degli eventi di conversione
Il flusso di lavoro end-to-end è:
1. Un cliente fa clic sul tuo annuncio «Click to WhatsApp" Meta e inizia una conversazione con la tua attività.
1. Il messaggio in entrata arriva nella destinazione dell'evento [ configurata ](managing-event-destinations.html) (argomento Amazon SNS EventBridge, Amazon o Amazon Connect). Include un `ctwa_clid` (ID click-to-click) che identifica il WhatsApp clic sull'annuncio. L'applicazione deve acquisire e memorizzare questo valore.
1. Quando si verifica una conversione (ad esempio, il cliente effettua un acquisto), l'applicazione chiama `SendWhatsAppConversionEvent` con `ctwa_clid` i dettagli dell'evento.
1. AWS End User Messaging Social inoltra l'evento all'API Meta Conversions per l'attribuzione.
`ctwa_clid`È incluso nell'`referral`oggetto del payload del webhook con messaggio in entrata quando un cliente inizia una conversazione da un annuncio. L'esempio seguente mostra la parte pertinente del messaggio webhook:
```
{
"messages": [
{
"from": "12345678",
"id": "ABGGFlA5FpafAgo6tHcNmNjXmuSf",
"referral": {
"body": "This is a great product",
"ctwa_clid": "ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a",
"headline": "Our new product",
"source_id": "1234567890",
"source_type": "ad",
"source_url": "https://fb.me/AAAAA"
},
"text": {
"body": "Can I learn more about your business?"
},
"timestamp": "1678189586",
"type": "text"
}
]
}
```
Memorizza il `ctwa_clid` valore dell'`referral`oggetto. Trasmettilo in ogni evento `user_data` di conversione che invii per questa conversazione. Per ulteriori informazioni sul webhook di riferimento, consulta i componenti [ Webhooks ](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components#messages-object) nella documentazione per gli sviluppatori. Meta
## Prerequisiti
Prima di inviare eventi di conversione, hai bisogno di quanto segue:
+ Un account WhatsApp aziendale (WABA) collegato al tuo AWS account.
+ Una campagna «Ads that Click to WhatsApp» attiva suMeta.
+ La tua applicazione deve acquisire il messaggio ricevuto `ctwa_clid` dal webhook in entrata quando un cliente inizia una conversazione facendo clic su un annuncio. Questo valore è generato da Meta e non può essere fabbricato.
**Importante**
Se hai collegato il tuo account WhatsApp aziendale (WABA) prima del 6 agosto 2026, devi ripetere il flusso di registrazione per concedere a AWS End User Messaging Social le autorizzazioni per inviare eventi di conversione. Segui i passaggi da 1 a 14 in «Registrazione tramite la console» in [ Registrazione a e seleziona il WABA esistente e il numero di telefono già associati al tuo account. WhatsApp ](getting-started-whatsapp.html) AWS Puoi quindi saltare i passaggi rimanenti.
## Passaggio 1: creare un set di dati sulle conversioni
Prima di poter inviare eventi di conversione, devi creare un set di dati sulle conversioni per il tuo WABA. Ogni WABA ha esattamente un set di dati (questo viene applicato da). Meta L'operazione è idempotente: se esiste già un set di dati, viene restituito l'ID del set di dati esistente.
L'esempio seguente crea o recupera il set di dati per un WABA. Sostituiscilo {{waba-id}} con l'ARN del tuo account WhatsApp aziendale collegato (WABA) (ad esempio,). `arn:aws:social-messaging:us-east-1:123456789012:waba/a1b2c3d4e5example`
```
aws socialmessaging create-whatsapp-dataset \
--region us-east-1 \
--id {{waba-id}}
```
La risposta contiene l'ID del set di dati. Salva questo valore. Lo passi come `datasetId` parametro ogni volta che invii un evento di conversione.
```
{
"datasetId": "123456789012345"
}
```
## Fase 2: Inviare eventi di conversione
Dopo aver creato un set di dati, puoi inviare eventi di conversione Meta utilizzando l'`SendWhatsAppConversionEvent`API. Ogni chiamata invia uno o più eventi all'API Meta Conversions per l'attribuzione.
Il contenuto dell'evento inviato nel `event-data` parametro segue il formato server-evento dell'API Meta Conversions. AWS End User Messaging Social inoltra questo contenuto a. Meta Per l'elenco completo dei campi degli eventi, consulta [ il riferimento ai parametri Meta server-event ](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/server-event) nella documentazione per gli Meta sviluppatori.
### Invia un evento di conversione degli acquisti
L'esempio seguente riporta una `Purchase` conversione. Sostituisci i valori segnaposto con i tuoi.
```
aws socialmessaging send-whatsapp-conversion-event \
--region us-east-1 \
--id {{waba-id}} \
--dataset-id {{dataset-id}} \
--event-data '{
"data": [
{
"event_name": "Purchase",
"event_time": 1720000000,
"action_source": "business_messaging",
"messaging_channel": "whatsapp",
"user_data": {
"whatsapp_business_account_id": "{{meta-waba-id}}",
"ctwa_clid": "{{click-id}}"
},
"custom_data": {
"currency": "USD",
"value": 99.99
}
}
]
}'
```
La risposta contiene un ID della richiesta che identifica l'invio:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
### Invia un evento di conversione dei lead
Non-purchase tipi di eventi come quelli `LeadSubmitted` non richiesti`custom_data`.
```
aws socialmessaging send-whatsapp-conversion-event \
--region us-east-1 \
--id {{waba-id}} \
--dataset-id {{dataset-id}} \
--event-data '{
"data": [
{
"event_name": "LeadSubmitted",
"event_time": 1720000000,
"action_source": "business_messaging",
"messaging_channel": "whatsapp",
"user_data": {
"whatsapp_business_account_id": "{{meta-waba-id}}",
"ctwa_clid": "{{click-id}}"
}
}
]
}'
```
### Invia più eventi in un'unica richiesta
L'`data`array accetta più eventi in una singola chiamata. Metaconsente fino a 1.000 eventi per richiesta.
```
aws socialmessaging send-whatsapp-conversion-event \
--region us-east-1 \
--id {{waba-id}} \
--dataset-id {{dataset-id}} \
--event-data '{
"data": [
{
"event_name": "ViewContent",
"event_time": 1720000000,
"action_source": "business_messaging",
"messaging_channel": "whatsapp",
"user_data": {
"whatsapp_business_account_id": "{{meta-waba-id}}",
"ctwa_clid": "{{click-id}}"
}
},
{
"event_name": "Purchase",
"event_time": 1720000500,
"action_source": "business_messaging",
"messaging_channel": "whatsapp",
"user_data": {
"whatsapp_business_account_id": "{{meta-waba-id}}",
"ctwa_clid": "{{click-id}}"
},
"custom_data": {
"currency": "USD",
"value": 149.00
}
}
]
}'
```
## Riferimento all'evento di conversione
Il `event-data` parametro è un oggetto JSON con un `data` array contenente uno o più oggetti evento. Le tabelle seguenti descrivono i campi più comunemente utilizzati per le conversioni «Ads that Click to WhatsApp». Metaè la fonte di verità per il contenuto degli eventi; consulta [ il riferimento ai parametri Meta server-event ](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/server-event) nella documentazione per gli Meta sviluppatori per le specifiche complete.
### Campi evento obbligatori
| Campo | Tipo | Description |
| --- | --- | --- |
| event\_name | Stringa | Il tipo di conversione. Case-sensitive. I valori comuni includonoPurchase,LeadSubmitted, eViewContent. |
| event\_time | Numero | L'ora in cui è avvenuta la conversione, come timestamp Unix in secondi. Deve avvenire negli ultimi 7 giorni e non in futuro. |
| action\_source | Stringa | Deve essere business\_messaging. |
| messaging\_channel | Stringa | Il canale di messaggistica. Utilizza whatsapp. |
| user\_data | Oggetto | Informazioni utilizzate per abbinare l'evento al clic sull'annuncio. Consulta [Campi user\_data obbligatori](#conversions-api-event-user-data). |
### Campi user\_data obbligatori
La tabella seguente descrive i campi obbligatori nell'`user_data`oggetto.
| Campo | Tipo | Description |
| --- | --- | --- |
| whatsapp\_business\_account\_id | Stringa | L'ID numerico dell'account Meta WhatsApp aziendale (da Impostazioni Meta aziendali). |
| ctwa\_clid | Stringa | L'ID WhatsApp click-to-click contenuto nel webhook del messaggio in arrivo relativo alla conversazione iniziata con l'annuncio. Metaconvalida questo valore; non può essere fabbricato. |
**Importante**
Se includi informazioni di identificazione personale (PII)`user_data`, come indirizzi e-mail o numeri di telefono, devi fornire i valori come hash. SHA-256 Metarifiuta le PII senza hash. Il `ctwa_clid` valore non è sottoposto a hashing.
### L'oggetto custom\_data
Per `Purchase` gli eventi, è necessario includere l'`custom_data`oggetto con i seguenti campi:
| Campo | Tipo | Description |
| --- | --- | --- |
| currency | Stringa | Il codice valuta ISO 4217 (ad esempio,USD). |
| value | Numero | Il valore monetario della conversione. |
## Gestione degli errori
Poiché AWS End User Messaging Social inoltra i contenuti dell'evento aMeta, la maggior parte dei problemi relativi ai contenuti degli eventi si manifesta come un. `InvalidParametersException` Il messaggio di errore include il motivo segnalato, ad esempioMeta, da: un nome di evento non riconosciuto, un orario dell'evento al di fuori della finestra consentita, una valuta mancante per un acquisto, informazioni personali non crittografate o non valide. `ctwa_clid`
| Errore | Stato HTTP | Significato |
| --- | --- | --- |
| InvalidParametersException | 400 | Il contenuto della richiesta o dell'evento non era valido. Il messaggio di errore descrive il problema specifico. |
| ResourceNotFoundException | 404 | Impossibile trovare il WABA o il set di dati specificato. |
| AccessDeniedByMetaException | 403 | Metaha rifiutato la richiesta a causa delle autorizzazioni (ad esempio, il token di Meta accesso sottostante non ha l'autorizzazione richiesta o non è valido). |
| ThrottledRequestException | 429 | La frequenza delle richieste ha superato il limite consentito. Riprova con un backoff esponenziale. |
| DependencyException | 502 | Una dependency downstream () ha restituito un errore. Meta Riprovabile. |
| InternalServiceException | 500 | Si è verificato un errore interno. Riutilizzabile. |