Loading

Come utilizzare AMPscript per l'integrazione di META WhatsApp in Salesforce Marketing Cloud

Data pubblicazione: Jan 23, 2025
Descrizione

L'articolo fornisce una guida completa sull'uso di AMPscript nei messaggi modello e sessione di WhatsApp in Marketing Cloud. Illustra come creare e approvare i messaggi modello WhatsApp in META, spiegando come utilizzare la sintassi Mustache per le variabili dinamiche e AMPscript nel campo Variable 1 per l'inserimento di dati.

Inoltre, spiega il ruolo delle estensioni dati di sistema nei journey con origini di immissione chat in entrata. Sottolinea l'importanza della logica AMPscript per identificare se un contatto è nuovo o attivo. La guida suggerisce di mantenere aggiornata l'estensione dati Master WhatsApp Subscription per gestire i dati di contatto.

Infine, viene illustrato un esempio di blocco AMPscript per la personalizzazione dei messaggi in base ai dati di contatto o ai valori predefiniti. La guida ha lo scopo di consentire agli addetti al marketing di utilizzare efficacemente AMPscript per la messaggistica personalizzata di WhatsApp in Marketing Cloud.

 

Nota: Sono stati condotti test approfonditi per garantire l'uso efficace di AMPscript nei messaggi modello e sessione di WhatsApp all'interno di Marketing Cloud. Tuttavia, si consiglia vivamente agli utenti di testare e verificare accuratamente la funzionalità di tutti i processi, sia prima che dopo la loro implementazione nel proprio ambiente. Se si verificano problemi durante il processo, potrebbe essere necessario disabilitare la soluzione per facilitare la risoluzione dei problemi. Dare sempre la priorità alla soddisfazione del cliente e rispettare le sue preferenze durante questo processo, assicurandosi che la messaggistica personalizzata migliori, senza interferire, l'esperienza del cliente.

Risoluzione

Utilizzo di AMPscript nei messaggi modello e sessione di WhatsApp

 

Parte I: Utilizzo di AMPscript nei messaggi modello di WhatsApp

Fase 1: Creare un messaggio modello

Iniziare creando un messaggio modello in META. Nel campo del corpo, utilizzare la sintassi Mustache per chiamare le variabili. Ad esempio:
 

Salve, qui c'è il tuo codice {{1}}. Divertiti e buona giornata.


Nel messaggio precedente, {{1}} viene utilizzato per inserire un codice univoco per ogni cliente, estratto da un'estensione dati. Una volta immessa una variabile, l'interfaccia utente richiede di fornire dati di esempio per ogni variabile. È possibile incrementare il numero nella sintassi Mustache per aggiungere altre variabili al messaggio di testo ({{2}}, {{3}}, {{4}} e così via). Utilizzare %%CODE%% come esempio di segnaposto per {{1}} per definire il tipo di dati che si intende inserire.
 

Fase 2: Inviare il messaggio modello

Dopo aver compilato i dettagli del messaggio, inviare il modello per l'approvazione.
 

Fase 3: Creare un modello di messaggistica chat

Dopo l'approvazione, passare a Content Builder e creare un nuovo modello di messaggistica chat. Scegliete il modello pre-approvato e selezionate la lingua preferita per il messaggio. Dovrebbe avere un aspetto simile a questo:
 

Salve, qui c'è il tuo codice ${1}. Divertiti e buona giornata.


Fase 4: Inserire l'AMPscript

Infine, inserire l'AMPscript desiderato nel campo Variable 1. Ecco un esempio di come si può fare:
 

%%[ var @code, @contactkey set @contactkey = [contactkey] set @code = Lookup('Stored_Codes','code','CONTACT_KEY',@contactkey) ]%% %=v(@code)=%%


Nota: è possibile visualizzare solo una funzione v() per variabile. Se è necessario visualizzare i dati di più origini in cui si trova la Variabile 1, utilizzare la funzione concat(). Ecco come:
 

%%[ var @firstName, @lastName, @fullName, @contactKey set @contactKey = [contactKey] set @firstName = Lookup('Contact_Data1','First_Name','Contact_Key',@contactKey) set @lastName = Lookup('Contact_Data2','Last_Name','Contact_Key',@contactKey) et @fullName = concat(@firstName, ' ', @lastName) ]%% %%=v(@fullName)=%%


Parte II: Utilizzo di AMPscript nei messaggi sessione di WhatsApp

 

Comprensione dei tipi di messaggio

Durante la creazione di un messaggio sessione, è possibile scegliere tra il tipo TEXT o MEDIA. Per utilizzare AMPscript, selezionare il tipo TEXT.
 

Comprensione delle estensioni dati di sistema

Quando si imposta un viaggio con un'origine di immissione chat in entrata, il sistema crea automaticamente un'estensione dati con i seguenti attributi:

  • Contactkey
  • MobileNumber
  • ChannelType
  • ChannelId
  • Keyword
 

Implementazione della logica AMPscript

Una buona pratica è quella di mantenere un'estensione dati Master WhatsApp Subscription. Questa estensione deve essere aggiornata ogni ora per conservare i contatti WhatsApp attivi più recenti e i loro dati personali. Ecco un esempio di implementazione della logica AMPscript:
 

%%[  /* Get the Mobile Number from the system data extension */  SET @mobile= AttributeValue("mobilenumber")  /* Check if the Mobile Number exists in the Master WhatsApp Subscription data extension */  SET @row = LookupRows("MasterWhatsAppSubscription", "phone", @mobile)  /* If Mobile Number is found, retrieve the name and country fields */ IF RowCount(@row) > 0 THEN SET @row = Row(@row, 1) SET @name = Field(@row, "Name")  SET @country = Field(@row, "Country")  ELSE /* If ContactKey not found, set some default values */ SET @name = "there"  SET @country = "unknown" ENDIF  /* Here's how you might craft a personalized session message */  SET @message = Concat("Hi, ", @name, ". We have some great deals in ", @country, " today.")  ]%%  %%=v(@message)=%%
 

Questo script cerca nella colonna Telefono nell'estensione dati Master WhatsApp Subscription. Se trova il numero di telefono, recupera il nome e il paese. In caso contrario, imposta i valori predefiniti. Poi crea un messaggio personalizzato utilizzando questi valori.
 

Comprendendo e attuando i passaggi descritti in questa guida, è possibile utilizzare AMPscript per migliorare la personalizzazione dei messaggi WhatsApp e offrire un'esperienza migliore ai propri clienti.

Numero articolo Knowledge

000395692

 
Caricamento
Salesforce Help | Article