Utilizzo dei dati degli oggetti di marketing nei messaggi

Identificatori di campo

Ogni oggetto di marketing ha un identificatore univoco, costituito dal nome API dell'oggetto seguito da __mo. Ad esempio, se il nome API di un oggetto di marketing è CustomerRewardMembers, l'identificatore univoco dell'oggetto di marketing è CustomerRewardMembers__mo.

I campi dell'oggetto marketing hanno identificatori che terminano con __c. Ad esempio, se il nome API di un campo in un oggetto marketing è RewardsPoints, l'identificatore del campo è RewardsPoints__c.

Utilizzare questi identificatori con la funzione AMPscript Lookup() o l'helper QueryFirst Handlebars per recuperare i dati da un oggetto di marketing.

Dati del grafico dati

È anche possibile recuperare i campi dal grafico dei dati per il proprio account. Un grafico dei dati contiene attributi che è possibile utilizzare per personalizzare i messaggi. Ogni account o unità operativa Marketing Cloud Next ha un grafico dei dati predefinito. L'identificatore di un campo del grafico dati è $dataGraph. seguito dal nome del campo. Ad esempio, per fare riferimento al campo Email nel grafico dei dati, utilizzare $dataGraph.Email__c. Per ulteriori informazioni sui Grafici dati in Marketing Cloud Next, vedere Impostazione delle funzioni di personalizzazione in Marketing Cloud Next.

Esempio di utilizzo

Si supponga ad esempio di avere un oggetto marketing denominato CustomerRewardMembers, che contiene i dati di questa tabella:

Se si desidera che il messaggio includa il saldo dei punti premio dell'abbonato, specificare l'identificatore dell'oggetto dati (CustomerRewardMembers__mo) e l'identificatore della colonna da restituire (RewardsPoints__c). Quindi, incrociare gli indirizzi email nell'oggetto marketing (EmailAddress__c) con gli indirizzi email di destinazione nel grafico dei dati ($dataGraph.Email__c). Il codice AMPscript è simile a questo esempio:

%%[
SET @points = Lookup(
    CustomerRewardMembers__mo, 
    RewardsPoints__c, 
    EmailAddress__c, 
    $dataGraph.Email__c)
]%% 
  
<p>Your reward points balance is %%=v(@points)=%%!</p>

In alternativa, per visualizzare questo contenuto utilizzando Manubri, utilizzare questo esempio:

{{set points=(
  get 
    (queryFirst 
      type="MO" 
      object="CustomerRewardMembers__mo" 
      EmailAddress__c=$dataGraph.Email__c
    ) 
    "RewardsPoints__c"
)}}

<p>Your reward points balance is {{points}}!</p>

Con questo codice, l'email di Michael Chen dice "Il saldo dei punti premio è 3420!" e l'email di Myali Brown dice "Il saldo dei punti premio è 2150!"

Anteprima e test del contenuto dei messaggi

Prima di pubblicare un messaggio email contenente codice AMPscript o Handlebars, visualizzarlo in anteprima e testarlo per assicurarsi che il codice generi il risultato atteso. Verificare che i dati corretti compaiano per più destinatari e che il contenuto venga visualizzato correttamente. Per ulteriori informazioni, vedere Creazione di un'email nella visualizzazione codice in Marketing Cloud Next.