Utilizar datos de objetos de marketing en mensajes

Identificadores de campo

Cada objeto de marketing tiene un identificador exclusivo, que consiste en el nombre de API para el objeto seguido de __mo. Por ejemplo, si el nombre de API de un objeto de marketing es CustomerRewardMembers, el identificador exclusivo para el objeto de marketing es CustomerRewardMembers__mo.

Los campos del objeto de marketing tienen identificadores que terminan con __c. Por ejemplo, si el nombre de API para un campo en un objeto de marketing es RewardsPoints, el identificador para el campo es RewardsPoints__c.

Utilice estos identificadores con la función AMPscript Lookup() o el ayudante Handlebars QueryFirst para recuperar datos de un objeto de marketing.

Datos de gráficos de datos

También puede recuperar campos del gráfico de datos para su cuenta. Un gráfico de datos contiene atributos que puede utilizar para personalizar sus mensajes. Cada cuenta o unidad comercial de Marketing Cloud Next tiene un gráfico de datos predeterminado. El identificador de un campo de gráfico de datos es $dataGraph. seguido del nombre del campo. Por ejemplo, para hacer referencia al campo Email en su gráfico de datos, utilice $dataGraph.Email__c. Para obtener más información sobre Gráficos de datos en Marketing Cloud Next, consulte Configurar funciones de personalización en Marketing Cloud Next.

Ejemplo de uso

Como ejemplo, supongamos que tiene un objeto de marketing denominado CustomerRewardMembers, que contiene los datos de esta tabla:

Si desea que su mensaje incluya el saldo de puntos de recompensa del suscriptor, especifique el identificador del objeto de datos (CustomerRewardMembers__mo) y el identificador de la columna a devolver (RewardsPoints__c). A continuación, haga referencia cruzada a las direcciones de correo electrónico en el objeto de marketing (EmailAddress__c) con las direcciones de correo electrónico de destino en su gráfico de datos ($dataGraph.Email__c). El código AMPscript se parece a este ejemplo:

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

De manera alternativa, para representar este contenido utilizando Manillares, utilice este ejemplo:

{{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 este código en vigor, el correo electrónico de Michael Chen dice “¡Su saldo de puntos de recompensa es 3420!” y el correo electrónico de Myali Brown dice “¡Su saldo de puntos de recompensa es 2150!”

Vista previa y contenido de mensajes de prueba

Antes de publicar un correo electrónico que contiene código AMPscript o Handlebars, realice una vista previa y pruébelo para asegurarse de que su código produce el resultado esperado. Verifique que los datos correctos aparecen para varios destinatarios y que su contenido se representa correctamente. Para obtener más información, consulte Crear un correo electrónico en vista de código en Marketing Cloud Next.