Learning Objectives /Objectifs de formation
After completing this unit, you’ll be able to: /Une fois cette unite terminée, vous pourrez :
- Explain the differences between the Marketing Cloud REST and SOAP APIs. /Expliquer les différences entre les API Marketing Cloud REST et SOAP.
- Describe how you can use the Marketing Cloud SDKs./Décrire comment utiliser les SDK Marketing Cloud.
- Name the Marketing Cloud programmatic languages. /Nommer les langages de programmation Marketing Cloud.
Introduction /Introduction
So you’re a Marketing Cloud developer. Whether you’ve been doing this a while, or learning it for the first time, we want to introduce you to the wealth of tools at your fingertips for extending the power of Marketing Cloud. /Vous êtes donc un développeur Marketing Cloud. Que vous ayez fait cela pendant un certain temps ou que vous l’ayez appris pour la première fois, nous voulons vous présenter la richesse des outils à portée de main pour étendre la puissance de Marketing Cloud.
Trailblazers like you are making a huge impact with Salesforce customers around the globe—whether you’re a consultant doing custom development for multiple customers, or an in-house developer creating custom solutions for your employer. /Les pionniers comme vous ont un impact énorme sur les clients Salesforce du monde entier, que vous soyez un consultant réalisant un développement personnalisé pour plusieurs clients ou un développeur interne créant des solutions personnalisées pour votre employeur.
From SDKs to APIs, we’ll give you enough information in this module to get started with Marketing Cloud development, so you’re ready to use the tools you need for your next project. /Des SDK aux API, nous vous donnerons suffisamment d’informations dans ce module pour commencer le développement de Marketing Cloud, vous êtes donc prêt à utiliser les outils dont vous avez besoin pour votre prochain projet.
Note /rEMARQUE
Want to meet more Trailblazers? Check out their stories on Trailhead. /Vous voulez rencontrer plus de pionniers? Découvrez leurs histoires sur Trailhead.
Marketing Cloud APIs /APIs Marketing Cloud
Ready to get started with Marketing Cloud APIs? In this module, we assume you understand the basics about APIs (application programming interfaces) and how they are used for communication between two different software applications. /Prêt à démarrer avec les API Marketing Cloud? Dans ce module, nous supposons que vous comprenez les bases des API (interfaces de programmation d’applications) et comment elles sont utilisées pour la communication entre deux applications logicielles différentes.
If you haven’t worked with APIs before, that’s okay. In this badge, we’re looking at the Marketing Cloud APIs at a high level, so you can understand their differences and how you can use them. /Si vous n’avez jamais travaillé avec des API auparavant, aucun problème. Dans ce badge, nous examinons les API Marketing Cloud à un niveau élevé, afin que vous puissiez comprendre leurs différences et comment les utiliser.
So let’s dive into Marketing Cloud APIs. The first thing to know is that Marketing Cloud offers two APIs: REST (Representational State Transfer) and SOAP (Simple Object Access Protocol). Both of these APIs are used for distinct purposes. /Plongeons-nous donc dans les API Marketing Cloud. La première chose à savoir est que Marketing Cloud propose deux API: REST (Representational State Transfer) et SOAP (Simple Object Access Protocol). Ces deux API sont utilisées à des fins distinctes.
The REST API exposes broader access to Marketing Cloud capabilities. The SOAP API provides comprehensive access to most email functionality. These two APIs share a common authentication mechanism based on OAuth 2. Let’s take a closer look at each. /L’API REST offre un accès plus large aux fonctionnalités de Marketing Cloud. L’API SOAP offre un accès complet à la plupart des fonctionnalités de messagerie. Ces deux API partagent un mécanisme d’authentification commun basé sur OAuth 2. Examinons chacune de plus près
REST API /API REST
The REST API for Marketing Cloud is a great way to share assets from your internal databases or applications with your Marketing Cloud account. /L’API REST de Marketing Cloud est un excellent moyen de partager des créas de vos bases de données ou applications internes avec votre compte Marketing Cloud.
Here are some examples of what you can do: /Voici quelques exemples de ce que vous pouvez faire:
| Marketing Cloud REST API | What you use it for… |
|---|---|
| API Marketing Cloud REST | À quoi vous servira t-il … |
| Content Builder | Share marketing content, such as emails, images, text, and other documents. |
| Générateur de contenu | Partagez du contenu marketing, comme des e-mails, des images, du texte et d’autres documents. |
| Event Notification Service | Receive notifications when certain events occur in Marketing Cloud. You can be notified when customers request password resets, get order confirmations, log in using two-factor authentication, and other events. |
| Service de notification d’événements | Recevez des notifications lorsque certains événements se produisent dans Marketing Cloud. Vous pouvez être averti lorsque les clients demandent la réinitialisation du mot de passe, obtiennent des confirmations de commande, se connectent à l’aide de l’authentification à deux facteurs et d’autres événements. |
| Journey Builder | Create event-driven, responsive campaigns to distribute across any channel (online and offline), at any time and at any frequency. |
| Journey Builder | Créez des campagnes réactives axées sur les événements pour les diffuser sur n’importe quel canal (en ligne et hors ligne), à tout moment et à n’importe quelle fréquence. |
| GroupConnect Chat Messaging | Send real-time event-based messages to your users in Facebook Messenger and LINE. |
| Messagerie de discussion GroupConnect | Envoyez des messages événementiels en temps réel à vos utilisateurs via Facebook Messenger et LINE. |
| MobileConnect API | Subscribe mobile numbers to a short code using one of three SMS opt-in variations. |
| API MobileConnect | Abonnez les numéros de téléphone mobile à un code court en utilisant l’une des trois variantes d’activation par SMS. |
| Personalization Builder | Update the data used to provide Einstein recommendations, manage consumer privacy requests, and easily download large reports. |
| Générateur de personnalisation | Mettez à jour les données utilisées pour fournir des recommandations Einstein, gérer les demandes de confidentialité des consommateurs et télécharger facilement des rapports volumineux. |
| Transactional Messaging | Send personalized, transactional email messages to your customers. |
| Messagerie transactionnelle | Envoyez des e-mails transactionnels personnalisés à vos clients. |
All new Marketing Cloud technologies implement REST API, so this is an important one to familiarize yourself with. Here are a few important things to note about the Marketing Cloud REST API: /Toutes les nouvelles technologies de Marketing Cloud implémentent l’API REST, c’est donc un élément important dont il faut vous familiariser avec. Voici quelques points importants à noter sur l’API REST Marketing Cloud:
- The REST API uses JSON (JavaScript Object Notation) request and response bodies and resource endpoints to support multi-channel use. /L’API REST utilise des corps de requête et de réponse JSON (JavaScript Object Notation) et des points de terminaison de ressource pour prendre en charge l’utilisation multicanal.
- Most REST calls are synchronous. /La plupart des appels REST sont synchrones.
- Timeout values are 120 seconds for non-tracking operations and 300 seconds for tracking and data retrieve operations. /Les valeurs d’expiration sont de 120 secondes pour les opérations sans suivi et de 300 secondes pour les opérations de suivi et de récupération de données.
- The maximum payload of any call is four megabytes. /La charge utile maximale de tout appel est de quatre mégaoctets.
SOAP API /API SOAP
As you know, SOAP APIs provide a means for applications on different operating systems, technologies, and languages to communicate using only XML. /Comme vous le savez, les API SOAP permettent aux applications sur différents systèmes d’exploitation, technologies et langages de communiquer en utilisant uniquement XML.
You can use the Marketing Cloud SOAP API for managing things such as tracking data, subscribers and lists, automations, content, and most other email activities. /Vous pouvez utiliser l’API SOAP de Marketing Cloud pour gérer des éléments tels que les données de suivi, les abonnés et les listes, les automatisations, le contenu et la plupart des autres activités de messagerie.
Here’s some examples of what you can do: /Voici quelques exemples de ce que vous pouvez faire:
| Web Services SOAP API | What you use it for… |
|---|---|
| API SOAP des services Web | À quoi vous servira t-il … |
| Send Email | Schedule and send emails, identifying message recipients using dynamic, rule-based segmentation of lists, events and profiles. |
| Envoyer un e-mail | Planifiez et envoyez des e-mails, identifiez les destinataires des messages à l’aide d’une segmentation dynamique, basée sur des règles, des listes, des événements et des profils. |
| Tracking | Retrieve tracking data and use it to create reports and dashboards to see how your customers view and respond to your data. |
| Suivi | Récupérez les données de suivi et utilisez-les pour créer des rapports et des tableaux de bord pour voir comment vos clients voient et répondent à vos données. |
| Subscribers and lists | Retrieve subscribers for a list or lists for a subscriber. |
| Abonnés et listes | Récupérez les abonnés pour une liste ou des listes pour un abonné. |
| Automations | Define an activity using an automation in Automation Studio. |
| Automatismes | Définissez une activité à l’aide d’une automatisation dans Automation Studio. |
| Triggered Send | Create a triggered email send. |
| Envoi déclenché | Créez un envoi d’e-mail déclenché. |
Keep these things in mind when using the Marketing Cloud SOAP API: /Gardez ces éléments à l’esprit lorsque vous utilisez l’API SOAP Marketing Cloud:
- The SOAP API uses SOAP envelopes to pass information between you and Marketing Cloud. /L’API SOAP utilise des enveloppes SOAP pour transmettre des informations entre vous et Marketing Cloud.
- We recommend a limit of no more than 2000 per minute for SOAP calls. /Nous recommandons une limite maximale de 2000 par minute pour les appels SOAP.
- Support may request your SOAP envelope to troubleshoot issues. /Le support peut demander votre enveloppe SOAP pour résoudre les problèmes.
Marketing Cloud SDKs /SDK Marketing Cloud
Looking for SDKs (Software Development Kits) to develop custom applications you can use with Marketing Cloud? You’re in luck! Marketing Cloud SDKs provide a cross-functional framework around the SOAP and REST APIs, allowing you to integrate APIs using native language code libraries. /Vous recherchez des SDK (kits de développement logiciel) pour développer des applications personnalisées que vous pouvez utiliser avec Marketing Cloud? Vous êtes chanceux! Les SDK Marketing Cloud fournissent un cadre interfonctionnel autour des API SOAP et REST, vous permettant d’intégrer des API à l’aide de bibliothèques de code en langue native.
The Marketing Cloud platform SDKs use both the SOAP and REST APIs to provide agnostic protocol interfaces and automated token management. In addition to SDKs for the Marketing Cloud platform, we offer SDKs for MobilePush and Content Builder. /Les SDK de la plateforme Marketing Cloud utilisent à la fois les API SOAP et REST pour fournir des interfaces de protocole agnostiques et une gestion automatisée des jetons. En plus des SDK pour la plateforme Marketing Cloud, nous proposons des SDK pour MobilePush et Content Builder.
We currently offer six platform SDKs: C#, Java, Node, PHP, Python, and Ruby. Check out example code for a few of these: /Nous proposons actuellement six SDK de plate-forme: C #, Java, Node, PHP, Python et Ruby. Découvrez un exemple de code pour certains d’entre eux:
| Platform | Code Sample of the SDK being used to retrieve all lists in an account /Exemple de code du SDK utilisé pour récupérer toutes les listes d’un compte |
|---|---|
| C# SDK | using FuelSDK; |
| PHP SDK | require('sdk/ET_Client.php'); |
| Python SDK | import ET_Client |
| Ruby SDK | require 'fuelsdk' |
We also provide SDKs for iOS and Android to use with MobilePush, a Marketing Cloud product that allows you to create and send targeted push messages based on cross-channel consumer data to encourage app usage. /Nous fournissons également des SDK pour iOS et Android à utiliser avec MobilePush, un produit Marketing Cloud qui vous permet de créer et d’envoyer des messages push ciblés basés sur les données des consommateurs cross-canal pour encourager l’utilisation de l’application.
The Salesforce Marketing Cloud SDKs, excluding the MobilePush and Content Builder SDKs, are community-supported projects. The SDK source code, samples, and documentation are publicly available on Github to use as-is or fork and modify for your needs. We invite everyone in the community to collaborate with us on Github and submit pull requests to help improve the source code and samples. /Les SDK Salesforce Marketing Cloud, à l’exception des SDK MobilePush et Content Builder, sont des projets pris en charge par la communauté. Le code source, les exemples et la documentation du SDK sont accessibles au public sur Github pour être utilisés tels quels ou fork et les modifier selon vos besoins. Nous invitons tous les membres de la communauté à collaborer avec nous sur Github et à soumettre des demandes d’extraction pour améliorer le code source et les exemples.
Marketing Cloud Programmatic Languages /Langages programmatiques Marketing Cloud
Marketing Cloud offers custom scripting languages to personalize landing pages, create applications, construct cross-channel templates or layouts, and work with messaging functions on the Marketing Cloud platform. /Marketing Cloud propose des langages de script personnalisés pour personnaliser les pages de destination, créer des applications, créer des modèles ou des mises en page multicanaux et utiliser des fonctions de messagerie sur la plateforme Marketing Cloud.
AMPscript
AMPscript is a scripting language that you can embed within HTML emails, text emails, landing pages, SMS messages, and push notifications from MobilePush. Do you want a message to display customized text to the recipient? /AMPscript est un langage de script que vous pouvez intégrer dans des e-mails HTML, des e-mails texte, des pages de destination, des messages SMS et des notifications push de MobilePush. Voulez-vous qu’un message affiche un texte personnalisé pour le destinataire?
For example, “Thanks for your purchase, Ted, you earned 1,000 points as a Gold subscriber!” AMPscript is your answer for personalization. Marketing Cloud processes the AMPscript calls at the time of send. /Par exemple, «Merci pour votre achat, Ted, vous avez gagné 1 000 points en tant qu’abonné Gold!» AMPscript est votre réponse pour la personnalisation. Marketing Cloud traite les appels AMPscript au moment de l’envoi.
Server-Side JavaScript (SSJS)
Marketing Cloud uses JavaScript code processed by Marketing Cloud servers. Instead of using the browser to render the JavaScript on the client-side computer, Marketing Cloud executes the JavaScript on the server when rendering. While you can duplicate the functionality of AMPscript using SSJS, SSJS doesn’t work with the Document Object Model (DOM) and doesn’t function with exterior libraries. /Marketing Cloud utilise du code JavaScript traité par les serveurs Marketing Cloud. Au lieu d’utiliser le navigateur pour rendre le JavaScript sur l’ordinateur côté client, Marketing Cloud exécute le JavaScript sur le serveur lors du rendu. Bien que vous puissiez dupliquer la fonctionnalité d’AMPscript à l’aide de SSJS, SSJS ne fonctionne pas avec le modèle d’objet de document (DOM) et ne fonctionne pas avec les bibliothèques extérieures.
In other words, you can use these functions to modify Marketing Cloud content, but not browser-based things like JavaScript. Instead, use libraries provided by Marketing Cloud to create SSJS that works. These libraries also allow updates to SSJS, while maintaining previous versions, to avoid breaking preexisting code. /En d’autres termes, vous pouvez utiliser ces fonctions pour modifier le contenu Marketing Cloud, mais pas les choses basées sur un navigateur comme JavaScript. Utilisez plutôt les bibliothèques fournies par Marketing Cloud pour créer SSJS qui fonctionne. Ces bibliothèques permettent également des mises à jour de SSJS, tout en conservant les versions précédentes, pour éviter de casser le code préexistant.
Wondering whether to use AMPscript or SSJS? Consider this: /Vous vous demandez s’il faut utiliser AMPscript ou SSJS? Lisez ceci:
- AMPscript is the preferred language for personalizing message content. It simply and efficiently handles inline personalization or simple IF ELSE statements. /AMPscript est la langue préférée pour personnaliser le contenu des messages. Il gère simplement et efficacement la personnalisation en ligne ou les simples instructions IF ELSE.
- AMPscript works better than SSJS for use cases where each subscriber needs to see unique content. /AMPscript fonctionne mieux que SSJS pour les cas d’utilisation où chaque abonné a besoin de voir un contenu unique.
- AMPscript has a shorter learning curve than SSJS for users new to scripting languages in general./
- A great number of people already know JavaScript and can immediately apply that knowledge to Marketing Cloud. /AMPscript a une courbe d’apprentissage plus courte que SSJS pour les utilisateurs nouveaux dans les langages de script en général.
- Most users can handle the tasks they need to perform using AMPscript. /La plupart des utilisateurs peuvent gérer les tâches dont ils ont besoin pour effectuer en utilisant AMPscript.
We recommend that you exclusively use AMPscript or Platform object server-side JavaScript functions in email messages and reserve your use of Core library server-side JavaScript to landing pages and applications where AMPscript doesn’t provide appropriate functions. /Nous vous recommandons d’utiliser exclusivement les fonctions JavaScript côté serveur AMPscript ou Platform Platform dans les e-mails et de réserver votre utilisation du JavaScript côté serveur de la bibliothèque principale aux pages de destination et aux applications où AMPscript ne propose pas de fonctions appropriées.
Guide Template Language (GTL)
GTL provides a declarative syntax used for creating personalized, dynamic, data-driven messages, as well as constructing cross-channel templates and layouts. /GTL fournit une syntaxe déclarative utilisée pour créer des messages personnalisés, dynamiques et basés sur les données, ainsi que pour construire des modèles et des mises en page multicanaux.
GTL uses the widely adopted Handlebars and Mustache template languages and provides additional functionality, while simplifying how users interact with content and data to help them quickly build personalized Journey messages. /GTL utilise les langages de modèles de guidon et de moustache largement adoptés et fournit des fonctionnalités supplémentaires, tout en simplifiant la façon dont les utilisateurs interagissent avec le contenu et les données pour les aider à créer rapidement des messages Journey personnalisés.
GTL works with JSON data sources supplied by script or by a REST API service. Guide can also access specified lists and data extensions within a Marketing Cloud account. /GTL fonctionne avec des sources de données JSON fournies par script ou par un service API REST. Guide peut également accéder aux listes et extensions de données spécifiées dans un compte Marketing Cloud.
Resources /Ressources
- AMPscript Syntax Guide
- Digging Deeper into Oauth 2.0 in Salesforce
- GitHub Repository – Salesforce Marketing Cloud Platform
- Guide Template Language
- Intro to Marketing Cloud APIs
- Introduction to Programmatic Marketing Content
- Introduction to SDKs
- Server-Side JavaScript
- Your Subdomain and Your Tenant’s Endpoints
