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 è:
Un cliente fa clic sul tuo annuncio «Click to WhatsApp" Meta e inizia una conversazione con la tua attività.
Il messaggio in entrata arriva nella destinazione dell'evento configurata (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.Quando si verifica una conversione (ad esempio, il cliente effettua un acquisto), l'applicazione chiama
SendWhatsAppConversionEventconctwa_clidi dettagli dell'evento.AWS End User Messaging Social inoltra l'evento all'API Meta Conversions per l'attribuzione.
ctwa_clidÈ incluso nell'referraloggetto 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'referraloggetto. Trasmettilo in ogni evento user_data di conversione che invii per questa conversazione. Per ulteriori informazioni sul webhook di riferimento, consulta i componenti Webhooks
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_cliddal 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 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 \ --idwaba-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'SendWhatsAppConversionEventAPI. 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
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 \ --idwaba-id\ --dataset-iddataset-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 richiesticustom_data.
aws socialmessaging send-whatsapp-conversion-event \ --region us-east-1 \ --idwaba-id\ --dataset-iddataset-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'dataarray 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 \ --idwaba-id\ --dataset-iddataset-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
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. |
Campi user_data obbligatori
La tabella seguente descrive i campi obbligatori nell'user_dataoggetto.
| 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_dataoggetto 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. |
