IBM Unica emessage Version février Guide d'administration des s transactionnels

Transcription

1 IBM Unica emessage Version février 2014 Guide d'administration des s transactionnels

2 Important Avant d'utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant à la section «Remarques», à la page 43. Cette édition s'applique à la version d'ibm Unica emessage et à toutes les éditions et modifications ultérieures, sauf indication contraire dans les nouvelles éditions. LE PRESENT DOCUMENT EST LIVRE EN L'ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE CONTREFACON AINSI QU'EN CAS DE DEFAUT D'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE. Ce document est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. Les informations qui y sont fournies sont susceptibles d'être modifiées avant que les produits décrits ne deviennent eux-mêmes disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou services non annoncés dans ce pays. Cela ne signifie cependant pas qu'ils y seront annoncés. Pour plus de détails, pour toute demande d'ordre technique, ou pour obtenir des exemplaires de documents IBM, référez-vous aux documents d'annonce disponibles dans votre pays, ou adressez-vous à votre partenaire commercial. Vous pouvez également consulter les serveurs Internet suivants : v (serveur IBM en France) v (serveur IBM au Canada) v (serveur IBM aux Etats-Unis) Compagnie IBM France Direction Qualité 17, avenue de l'europe Bois-Colombes Cedex Copyright IBM France Tous droits réservés. Copyright IBM Corporation 1999, 2014.

3 Table des matières Avis aux lecteurs canadiens v Chapitre 1. A propos d'emessage et des s transactionnels Utilisation d'emessage pour envoyer des s transactionnels Fonctionnement de la messagerie transactionnelle dans emessage Comparaison entre le mailing transactionnel et le mailing standard Conception des messages pour la messagerie transactionnelle Informations sur le destinataire dans un transactionnel Suppression globale d' s et s transactionnels Pièces jointes aux s transactionnels Rôle des spécialistes du marketing par dans l' transactionnel Activation des mailings pour la prise en charge des s transactionnels Traitement des erreurs liées aux s transactionnels Rôle des développeurs d'applications dans la messagerie transactionnelle Chapitre 2. Intégration avec le service de messagerie transactionnelle d'emessage Identification des événements de transaction Accès aux données relatives aux destinataires Connexion au service TMS d'emessage Adresses TMS emessage Langage WSDL pour les s transactionnels d'emessage Spécification des données d'authentification pour la messagerie transactionnelle Pièces jointes dans les demandes d' transactionnel Construction d'une demande d' transactionnel 18 mailingcode audienceid Zones Codes de cible additionaloptions attachments trackingfields locale username password Chapitre 3. API du service de mailing transactionnel (TMS) d'emessage NameValuePair Response AdvisoryMessage Messages d'erreurs associés aux s transactionnels Annexe A. Echantillon de client utilisant le langage WSDL de première génération Annexe B. Echantillon de client utilisant le langage WSDL de deuxième génération Annexe C. Images transactionnelles dynamiques Utilisation d'images transactionnelles dynamiques dans les s transactionnels Définition d'un libellé pour les images transactionnelles dynamiques Spécification d'images transactionnelles dynamiques dans une demande d' transactionnel Comment contacter le support technique IBM Unica Remarques Marques Copyright IBM Corp. 1999, 2014 iii

4 iv IBM Unica emessage : Guide d'administration des s transactionnels

5 Avis aux lecteurs canadiens Le présent document a été traduit en France. Voici les principales différences et particularités dont vous devez tenir compte. Illustrations Les illustrations sont fournies à titre d'exemple. Certaines peuvent contenir des données propres à la France. Terminologie La terminologie des titres IBM peut différer d'un pays à l'autre. Reportez-vous au tableau ci-dessous, au besoin. IBM France ingénieur commercial agence commerciale ingénieur technico-commercial inspecteur IBM Canada représentant succursale informaticien technicien du matériel Claviers Les lettres sont disposées différemment : le clavier français est de type AZERTY, et le clavier français-canadien de type QWERTY. OS/2 et Windows - Paramètres canadiens Au Canada, on utilise : v les pages de codes 850 (multilingue) et 863 (français-canadien), v le code pays 002, v le code clavier CF. Nomenclature Les touches présentées dans le tableau d'équivalence suivant sont libellées différemment selon qu'il s'agit du clavier de la France, du clavier du Canada ou du clavier des États-Unis. Reportez-vous à ce tableau pour faire correspondre les touches françaises figurant dans le présent document aux touches de votre clavier. Copyright IBM Corp. 1999, 2014 v

6 Brevets Il est possible qu'ibm détienne des brevets ou qu'elle ait déposé des demandes de brevets portant sur certains sujets abordés dans ce document. Le fait qu'ibm vous fournisse le présent document ne signifie pas qu'elle vous accorde un permis d'utilisation de ces brevets. Vous pouvez envoyer, par écrit, vos demandes de renseignements relatives aux permis d'utilisation au directeur général des relations commerciales d'ibm, 3600 Steeles Avenue East, Markham, Ontario, L3R 9Z7. Assistance téléphonique Si vous avez besoin d'assistance ou si vous voulez commander du matériel, des logiciels et des publications IBM, contactez IBM direct au vi IBM Unica emessage : Guide d'administration des s transactionnels

7 Chapitre 1. A propos d'emessage et des s transactionnels Un transactionnel est un message électronique unique envoyé en réponse à une transaction spécifique et prédéterminée détectée dans vos systèmes d'applications. IBM propose le service Web hébergé TMS (Transactional Mailing Service, service de mailing transactionnel) d'emessage pour traiter les s transactionnels. Les spécialistes du marketing par travaillent avec les développeurs d'applications pour intégrer des systèmes de gestion des transactions d'entreprise au service TMS d'emessage. L'envoi d' s transactionnels vous permet de répondre automatiquement à un client spécifique ou à des activités orientées client avec un message personnalisé. Les s transactionnels ont tendance à être plus ouverts que les autres types d' marketing. Les destinataires du message sont plus enclins à ouvrir un relatif à une transaction qu'ils reconnaissent ou attendent qu'à ouvrir un non sollicité. Vous pouvez utiliser n'importe quel événement détecté dans vos systèmes d'applications pour déclencher un transactionnel. Par exemple, vous pouvez envoyer un transactionnel lorsqu'un individu s'abonne à votre bulletin mensuel ou demande des informations suite à une campagne de marketing par . Les rubriques suivantes proposent une présentation générale du service TMS d'emessage et des rôles joués par les spécialistes du marketing par et les développeurs d'applications lors de l'utilisation d' s transactionnels. v «Utilisation d'emessage pour envoyer des s transactionnels» v v «Rôle des spécialistes du marketing par dans l' transactionnel», à la page 8 «Rôle des développeurs d'applications dans la messagerie transactionnelle», à la page 11 Utilisation d'emessage pour envoyer des s transactionnels L'implémentation d'un système de messagerie transactionnelle requiert une collaboration entre les spécialistes du marketing par et les développeurs d'applications. Toutes les parties doivent connaître les systèmes et flux de travaux requis. Toute personne impliquée doit être familiarisée avec les différents rôles joués par chaque contributeur dans la mise en oeuvre d'un système de messagerie transactionnelle. L'utilisation d'emessage pour envoyer des s transactionnels fait appel aux activités et systèmes suivants. Identification des transactions qui requièrent une réponse automatique par L'équipe de marketing par détermine les types de transaction qui nécessitent une réponse automatique par . L' transactionnel est basé sur le contenu du message et sur les informations relatives au destinataire stockées dans un mailing emessage standard. Vous pouvez activer tous les mailings standard pour qu'ils Copyright IBM Corp. 1999,

8 prennent en charge les s transactionnels. Pour plus d'informations, voir «Activation des mailings pour la prise en charge des s transactionnels», à la page 9. Service TMS (Transactional Mailing Service) d'emessage IBM héberge le service TMS d'emessage en tant que service Web pour traiter automatiquement les demandes d' transactionnel. Développement de systèmes pour surveiller les transactions et demander des s transactionnels Les développeurs d'applications doivent créer une application client qui reçoit les notifications de transaction des systèmes métier et soumet les demandes de service Web (sous la forme de requêtes SOAP) au service TMS d'emessage. Les s transactionnels envoyés à l'aide d'emessage peuvent comporter des pièces jointes. Les demandes doivent comporter des données de personnalisation et le contenu des pièces jointes. Fonctionnement de la messagerie transactionnelle dans emessage Les spécialistes du marketing par utilisent Campaign et emessage pour configurer des messages et activer des mailings pour l'utilisation d' s transactionnels. Les développeurs d'applications créent un client de messagerie transactionnelle et l'intègrent aux autres systèmes d'applications. Le tableau ci-dessous décrit comment les systèmes IBM Unica Marketing installés localement et IBM Unica Hosted Services fonctionnent conjointement pour envoyer un transactionnel. 2 IBM Unica emessage : Guide d'administration des s transactionnels

9 Elément A IBM UnicaCampaign B C D E F Campaign fournit des interfaces pour composer des s, configurer des mailings et activer ces derniers pour qu'ils prennent en charge les s transactionnels. Mailing emessage La configuration du mailing fait référence à un document d' qui fournit le contenu du message, y compris les champs de personnalisation utilisés comme marques de réservation pour les données relatives aux destinataires. Vos systèmes métier et vos bases de données Différents systèmes d'applications et bases de données peuvent fournir les données de personnalisation et les informations sur les pièces jointes requises par un transactionnel. Vos systèmes de surveillance des transactions Les applications transactionnelles d'entreprise surveillent les systèmes d'applications pour détecter les types de transaction qui déclenchent un transactionnel. Vous pouvez utiliser quasiment toutes les activités métier pour déclencher un transactionnel. Les administrateurs système configurent les systèmes de surveillance pour détecter les transactions spécifiées et fournir les informations de personnalisation des s. Client local de messagerie transactionnelle Application client qui soumet les demandes de service Web au service TMS d'emessage. IBM met à la disposition des développeurs un langage WSDL à utiliser pour créer le client. Le client se trouve sur votre réseau local. Il ne fait pas partie du service TMS d'emessage. Service TMS d'emessage Service Web se trouvant dans IBM Unica Hosted Services. Le service reçoit et traite les demandes d' transactionnel du client local de messagerie transactionnelle. Activité associée 1 L'équipe de marketing par active un mailing (B) pour qu'il prenne en charge les s transactionnels. Vous pouvez activer tous les mailings standard pour qu'ils prennent en charge les s transactionnels. La configuration du mailing contient le code de mailing qu'emessage utilise pour identifier le mailing. Ce code est requis pour les demandes d' transactionnel. Les spécialistes du marketing par doivent communiquer le code de mailing aux développeurs d'applications qui créent le client local de messagerie transactionnelle (E). 2 Une transaction a lieu dans vos systèmes d'applications (C). La transaction est considérée comme étant un événement de transaction. Les spécialistes du marketing par et les développeurs d'applications se consultent au préalable pour identifier les données de personnalisation et les pièces jointes requises pour répondre à un événement de transaction. Le système de surveillance des transactions (D) effectue les tâches suivantes : v il détecte l'événement de transaction, v v il reconnaît que le type d'événement a été désigné comme un des types nécessitant une réponse par , il fournit les informations de personnalisation et le contenu des pièces jointes au client de messagerie transactionnelle (E). 3 Le client TMS fournit les données d'identification d'accès à IBM Unica Hosted Services dans une demande SOAP transmise à l'aide du protocole HTTPS au service TMS d'emessage (F). La demande spécifie le code de mailing emessage et les valeurs de toutes les zones de personnalisation contenues dans l' . La demande inclut également les pièces jointes, si nécessaire. 4 Le service TMS d'emessage vérifie la demande de service Web. Si la demande comporte toutes les informations requises, le service TMS d'emessage transfère la demande, pièces jointes comprises, à l'infrastructure de mailing emessage (G) pour qu'elle soit transmise. Si un problème survient au niveau du service TMS, un message d'erreur est envoyé à l'application client locale pour décrire l'incident. Chapitre 1. A propos d'emessage et des s transactionnels 3

10 Elément G Infrastructure de mailing emessage Composants et serveurs emessage conservés dans des centres de données IBM qui assemblent et transmettent les s transactionnels à l'aide de SMTP. Activité associée 5 emessage transmet et procède au suivi d'un personnalisé unique adressé au destinataire identifié dans la demande d' . L'installation Campaign en local extrait le contact et les données de réponse et les stocke dans les tables système emessage. Comparaison entre le mailing transactionnel et le mailing standard emessage construit et envoie les s transactionnels différemment des s personnalisés standard. Dans le cas d'un mailing standard, le système traite potentiellement de grands volumes d' s personnalisés individuellement. Pour les s transactionnels, emessage effectue les mêmes opérations de personnalisation pour plusieurs demandes de service Web, mais chaque demande ne traite qu'un seul à la fois. Vous pouvez activer tous les mailings standard emessage pour qu'ils prennent en charge les s transactionnels. La plupart des fonctionnalités de mailing disponibles pour les mailings standard restent utilisables lorsque vous activez le mailing pour la prise en charge des s transactionnels. Les éléments de contenu disponibles dans un standard (les champs de personnalisation, le texte, les images, les fragments HTML et les liens hypertextes par exemple) sont également disponibles dans un transactionnel. Toutefois, certaines différences existent entre les fonctionnalités de mailing utilisables dans un standard et un transactionnel. Le tableau suivant compare les principales fonctionnalités disponibles dans les deux types de mailing. Fonctionnalité Mailing standard Mailing transactionnel Transmission de versions HTML, HTML et texte, et texte seul X X Table des listes cibles pour spécifier les données de personnalisation X La table des listes cibles contient toutes les données sur le destinataire utilisées pour personnaliser les s Non applicable. Peut être utilisée à des fins de test. Champs de personnalisation de la table des listes cibles X X Champs de personnalisation intégrés X X Champs de personnalisation fixes X X Contenu conditionnel X X Scriptage avancé des s X X Aperçu du message X X L'aperçu n'est pas disponible pour les pièces jointes. 4 IBM Unica emessage : Guide d'administration des s transactionnels

11 Fonctionnalité Mailing standard Mailing transactionnel Présentation des résultats du mailing dans les rapports X X standard sur les performances emessage Suivi des liens dans les s X X Suivi de l'id public comme attribut de contact X X Utilisation de zones personnalisées pour le suivi des contacts X X Paramètres d'url supplémentaires pour le suivi des liens X X Suppression globale d'adresses X Rapport de surveillance de la déliverabilité X Pièces jointes X Conception des messages pour la messagerie transactionnelle Chaque mailing que vous activez pour la prise en charge des s transactionnels doit faire référence à un document emessage. Tout document emessage créé pour être utilisé dans un mailing standard peut également être envoyé comme transactionnel. Le document emessage définit le contenu de l' , notamment le texte, les images, les liens et tout contenu additionnel. Il contient également les zones de personnalisation qui servent des marques de réservationpour les données spécifiques au destinataire de l' , notamment les adresses électroniques. Dans le cadre d'une demande d' transactionnel, le client local de messagerie transactionnelle fournit le code de mailing unique qui identifie le mailing. emessage se sert de ce code pour déterminer quel document d' il doit utiliser pour créer l' transactionnel. La demande d' transactionnel doit également fournir les valeurs requises pour remplir les zones de personnalisation du document emessage auquel le mailing fait référence. Si la demande ne contient pas toutes les valeurs de personnalisation requises, emessage ne traitera pas l' transactionnel et une erreur sera renvoyée par le système. Les spécialistes du marketing par et les développeurs d'applications doivent vérifier la conception de chaque message à l'avance pour s'assurer que la demande d' contient bien toutes les informations requises. Si la conception du document est modifiée, par exemple pour changer les informations de personnalisation du message, la conception de la demande d' transactionnel doit être mise à jour pour refléter la modification. Identification de l'expéditeur de l' transactionnel Le document d' utilisé dans un transactionnel doit contenir une adresse De qui apparaît au destinataire. Si vous indiquez l'adresse De dans un champ de personnalisation, le domaine de messagerie de l'adresse doit correspondre à celui enregistré auprès d'ibm pour votre compte emessage. Informations sur le destinataire dans un transactionnel Pour personnaliser les s transactionnels, vous devez fournir les informations relatives aux destinataires dans la demande de service Web que vous envoyez au service de mailing transactionnel (TMS). Contrairement aux autres formes d' s Chapitre 1. A propos d'emessage et des s transactionnels 5

12 marketing personnalisés que vous envoyez via IBM Unica Hosted Services, les s transactionnels n'extraient pas les informations relatives aux destinataires depuis une table des listes cibles (OLT). Les spécialistes du marketing par et les concepteurs d'applications doivent s'assurer que le client local de messagerie transactionnelle fournit des valeurs pour remplir tous les champs de personnalisation utilisés dans l' transactionnel. Chaque demande de service Web fournit des informations d'adresse et de personnalisation spécifiques au destinataire du message. Vous pouvez activer un mailing standard existant pour envoyer des messages en tant qu' s transactionnels. Toutefois, il est inutile de référencer une table OLT pour que le mailing standard envoie l' transactionnel. Les informations relatives aux destinataires requises par l' transactionnel se trouvent déjà dans la demande de service Web. Concepts associés: Chapitre 2, «Intégration avec le service de messagerie transactionnelle d'emessage», à la page 13 «Construction d'une demande d' transactionnel», à la page 18 «Rôle des spécialistes du marketing par dans l' transactionnel», à la page 8 Champs de personnalisation utilisés dans les s transactionnels Le client local de messagerie transactionnelle identifie chaque champ de personnalisation comme paire nom-valeur distincte dans la demande de service Web qui est envoyée au service de mailing transactionnel hébergé. L'application client doit fournir le nom de chaque champ de personnalisation contenu dans le message électronique. Elle doit également pouvoir accéder aux systèmes d'applications et aux bases de données qui contiennent les valeurs de personnalisation requises. Le mailing que vous activez pour la prise en charge des s transactionnels doit faire référence à un document . Ce document indique la structure et le contenu de l' transactionnel. Il fournit également le nom des champs de personnalisation qui sont inclus dans le message. Les champs de personnalisation sont ajoutés au document en tant que marques de réservation qui acceptent des informations spécifiques sur le destinataire d' lorsque le service de mailing assemble et transmet le message. L'onglet de récapitulatif des mailings comporte un champ intitulé Complétez la liste de champs pour ce mailing permettant d'identifier les champs de personnalisation inclus dans le document auquel fait référence le mailing. La demande de service Web doit contenir les informations relatives à chaque champ de la liste. Les noms des champs de personnalisation qui figurent dans la demande de service Web doivent être identiques à ceux qui figurent dans le document. En outre, la demande de service Web doit fournir les données requises pour exécuter le message, notamment les valeurs associées à chaque champ de personnalisation inclus dans le message. L'équipe de marketing par doit consulter les développeurs d'applications pour identifier et localiser toutes les informations devant être fournies par le client d' transactionnel. 6 IBM Unica emessage : Guide d'administration des s transactionnels

13 Le service de mailing transactionnel évalue chaque demande de service Web pour déterminer si elle contient toutes les paires nom-valeur requises pour l' transactionnel. La demande échoue si les noms de champs de personnalisation, les valeurs ou les types de données ne correspondent pas aux informations requises pour l' . Concepts associés: «Rôle des spécialistes du marketing par dans l' transactionnel», à la page 8 Champs de personnalisation pour le suivi supplémentaire des liens ou des contacts dans les s transactionnels Si vous avez demandé à IBM d'effectuer un suivi supplémentaire des liens et des contacts, chaque demande d' transactionnel doit inclure le nom et la valeur des champs de personnalisation utilisés pour le suivi supplémentaire. La demande de service Web d' transactionnel doit inclure des paramètres spécifiant le nom et la valeur des champs de personnalisation de suivi. L'équipe de marketing par doit fournir aux développeurs d'applications les informations suivantes : v Noms des champs de personnalisation de suivi v Types de données et valeurs attendus pour les champs de personnalisation v Restrictions liées au format ou à la longueur emessage ne valide pas l'unicité des zones que vous indiquez pour le suivi supplémentaire. Pour distinguer les données du suivi supplémentaire pour les s transactionnels des données collectées pour les s standard, établissez des procédures internes ou des conventions d'attribution de nom pour vous assurer de l'unicité des noms de champs de personnalisation. Evitez de spécifier le même nom de champ de personnalisation pour le suivi des liens ou des contacts dans les mailings standard et les mailings transactionnels. Suppression globale d' s et s transactionnels IBM Unica emessage n'applique pas les suppressions globales d'adresses aux demandes d' transactionnel. Pour éviter d'enfreindre les lois relatives à la distribution d' s indésirables, telles que la loi CAN-SPAM, vous devez configurer vos systèmes transactionnels pour qu'ils prennent en compte des adresses ne devant pas recevoir d' s. Empêcher la transmission d' s transactionnels à des adresses incorrectes ou non abonnées peut également permettre d'éviter des problèmes de déliverabilité générés par des destinataires marquant l' transactionnel comme étant indésirable. Pièces jointes aux s transactionnels Le service TMS d'emessage prend en charge les fichiers associés à des s transactionnels. En attachant des fichiers à un transactionnel, vous pouvez fournir au destinataire du message des informations personnalisées supplémentaires. Par exemple, vous pouvez envoyer un transactionnel pour confirmer l'achat Chapitre 1. A propos d'emessage et des s transactionnels 7

14 d'un billet de concert et utiliser les pièces jointes pour fournir un ticket imprimable et un plan de la salle. Vous ne pouvez pas utiliser de pièces jointes pour les mailings standard. Lorsque vous activez un mailing pour la prise en charge d' s transactionnels, vous devez spécifier combien de pièces jointes vous souhaitez envoyer avec l' . emessage fixe des limites concernant la taille de chaque pièce jointe et la taille totale de toutes les pièces jointes. La demande d' transactionnel soumise au service TMS d'emessage doit fournir le contenu du document, ainsi que des informations sur chaque document joint. L'équipe de marketing par doit collaborer avec les développeurs d'applications pour fournir les informations suivantes pour chaque pièce jointe : v Nom de fichier de la pièce jointe v Type de contenu MIME du fichier v Contenu du fichier La méthode utilisée pour inclure les pièces jointes dépend du langage de programmation et des outils de développement utilisés par les développeurs d'applications. Pour plus d'informations sur la manière de spécifier le contenu joint, voir «Pièces jointes dans les demandes d' transactionnel», à la page 17. Concepts associés: «Pièces jointes dans les demandes d' transactionnel», à la page 17 «Spécification d'images transactionnelles dynamiques dans une demande d' transactionnel», à la page 39 Analyse anti-virus des pièces jointes Le service TMS d'emessage n'analyse pas les pièces jointes pour rechercher d'éventuels virus informatiques ou autres types de logiciel malveillant. Vous êtes chargé de vous assurer qu'aucun des fichiers associés aux s transactionnels ne contient de code malveillant. Rôle des spécialistes du marketing par dans l' transactionnel L'utilisation d'emessage pour envoyer des s transactionnels requiert une préparation en amont et une coordination entre l'équipe de marketing par et les développeurs d'applications responsables de vos systèmes transactionnels d'entreprise. Le tableau suivant répertorie les activités généralement effectuées par un spécialiste du marketing par pour préparer un mailing d'envoi d' s transactionnels. Activité Identifiez le type de transaction qui déclenchera une demande d' transactionnel. Description Assurez-vous auprès de l'équipe chargée du développement des applications que les systèmes transactionnels peuvent détecter l'événement de transaction devant déclencher l' . 8 IBM Unica emessage : Guide d'administration des s transactionnels

15 Activité Composez et publiez le document emessage à utiliser pour le mailing transactionnel. Configurez le mailing standard que vous envisagez d'activer pour la prise en charge des s transactionnels. Dans la configuration, indiquez si l' transactionnel comporte des pièces jointes. Identifiez tous les champs de personnalisation utilisés dans le document. L'onglet du mailing comporte la liste des champs de personnalisation utilisés dans le document. Indiquez les noms et les définitions des champs de personnalisation aux développeurs d'applications. Indiquez aux développeurs d'applications le code du mailing que vous envisagez d'activer pour la prise en charge des s transactionnels. Déterminez si l' transactionnel comporte des fichiers associés. Si vous utilisez des images transactionnelles dynamiques, ajoutez des marques de réservation pour les pièces jointes dans le document d' qui définit l' transactionnel. Activez le mailing pour la prise en charge des s transactionnels, en utilisant les liens de l'onglet du mailing. Assurez-vous que les développeurs ont terminé de configurer le client local de messagerie transactionnelle avant d'activer le mailing pour la prise en charge des s transactionnels. Description Composez un document emessage pour l' transactionnel, comme vous le feriez pour tout autre document emessage. Référencez le document que vous avez créé pour l' transactionnel. Si vous incluez des pièces jointes, spécifiez-en le nombre. Les développeurs d'applications doivent configurer le client de messagerie transactionnelle pour fournir les informations de personnalisation. Chaque demande d' transactionnel doit spécifier les noms et les valeurs des champs de personnalisation (sous la forme de paires nom-valeur ainsi que les types de données requis. Les développeurs ont besoin de cette information pour identifier le mailing pour le service TMS d'emessage. Consultez les développeurs d'applications au sujet du nombre et de la taille des fichiers associés. Mettez-vous d'accord sur les étiquettes à utiliser pour identifier les images transactionnelles dynamiques. Le service TMS d'emessage commence à accepter les demandes d' immédiatement après que vous avez activé le mailing pour la prise en charge des s transactionnels. Concepts associés: «Informations sur le destinataire dans un transactionnel», à la page 5 «Champs de personnalisation utilisés dans les s transactionnels», à la page 6 Activation des mailings pour la prise en charge des s transactionnels Les s transactionnels sont basés sur des mailings standard ayant été activés pour la prise en charge des s transactionnels. Pour procéder à cette activation, vous utilisez l'onglet de récapitulatif des mailings de Campaign. Consultez la page Mailings emessage pour savoir quels mailings sont activés pour la prise en charge des s transactionnels. Chapitre 1. A propos d'emessage et des s transactionnels 9

16 Vous pouvez activer tous les mailings emessage pour la prise en charge des s transactionnels. La demande d' transactionnel échoue si vous n'avez pas mis à jour la configuration du mailing pour permettre l'envoi d' s transactionnels. Toutefois, même après avoir activé un mailing pour qu'il envoie des messages personnalisés comme s transactionnels, vous pouvez exécuter le même mailing de manière standard pour réaliser une campagne de mailing impliquant un grand nombre de messages. Chaque demande d' transactionnel doit inclure le code de mailing qui identifie le mailing. Lorsque vous activez un mailing pour qu'il prenne en charge les s transactionnels, notez le code de mailing et donnez-le aux développeurs d'applications responsables de la configuration du client local de l' transactionnel. Si vous joignez des fichiers à des s transactionnels, la configuration du mailing doit spécifier le nombre de pièces jointes. Chaque transactionnel reçoit le nombre de pièces jointes indiqué. Le nombre indiqué dans la configuration du mailing doit correspondre à celui configuré dans la demande de service Web soumise au service TMS d'emessage. Les fichiers associés ne sont envoyés qu'avec un transactionnel. emessage ne prend pas en charge l'envoi de pièces jointes lorsque vous exécutez un mailing standard, même si ce mailing est également activé pour la prise en charge des s transactionnels. Vous pouvez désactiver la prise en charge des s transactionnels par le mailing à tout moment. Par exemple, vous devez la désactiver pour changer la configuration du mailing. Le service TMS d'emessage n'accepte pas les demandes d' transactionnel tant que la prise en charge des s transactionnels a été désactivée pour le mailing. Avant d'activer un mailing pour la prise en charge des s transactionnels, nous vous recommandons de tester intégralement le mailing et d'afficher un aperçu du document emessage auquel le mailing fait référence. Assurez-vous que le mailing et le message répondent à vos attentes et à vos objectifs métier. Modification des mailings activés pour la prise en charge des s transactionnels Pour modifier un mailing activé pour la prise en charge des s transactionnels, vous devez commencer par désactiver cette prise en charge. Après avoir modifié le mailing, vous devez réactiver la prise en charge des s transactionnels. Au cours de ce processus, le service TMS d'emessage ne répond pas aux demandes transactionnelles pour le mailing désactivé. Les systèmes locaux qui surveillent les événements de transaction doivent être conçus pour enregistrer temporairement les demandes d' jusqu'à ce que vous ayez réactivé le mailing pour la prise en charge des s transactionnels. Traitement des erreurs liées aux s transactionnels Parfois, un transactionnel n'est pas transmis comme prévu. L'incident peut être dû à des problèmes de configuration de l' ou à des problèmes temporaires liés aux ressources de mailing. Si le service TMS d'emessage détermine qu'un problème existe, le service Web renvoie un code d'erreur de recommandation au client local de messagerie transactionnelle. Le client local de messagerie transactionnelle est responsable de la gestion des erreurs. Les développeurs d'applications doivent concevoir le client pour qu'il reconnaisse les messages d'erreur renvoyés par le service TMS d'emessage. Pour 10 IBM Unica emessage : Guide d'administration des s transactionnels

17 obtenir la liste des codes d'erreur du service TMS d'emessage, voir «Messages d'erreurs associés aux s transactionnels», à la page 25. Toutes les parties doivent être préparées à répondre à des problèmes imprévus. Si les incidents sont liés à la configuration du mailing ou à la conception des messages, les développeurs d'applications peuvent faire appel à l'équipe de marketing par pour les résoudre. Rôle des développeurs d'applications dans la messagerie transactionnelle Les développeurs d'applications créent le client local de messagerie transactionnelle qui soumet les demandes d' transactionnel au service TMS d'ibm Unica emessage. Le client local de messagerie transactionnelle traite chaque transactionnel en transmettant une demande SOAP au service TMS d'emessage via une connexion HTTPS. IBM met à la disposition des développeurs un langage WSDL pour concevoir la demande de service Web. Pour plus d'informations sur le langage WSDL, voir «Langage WSDL pour les s transactionnels d'emessage», à la page 15. La création du client local de messagerie transactionnelle requiert une coordination entre l'équipe de développeurs d'applications responsable des systèmes de transaction de l'entreprise et l'équipe de marketing par . Cette dernière doit fournir des informations sur les s transactionnels et les pièces jointes qui doivent être envoyés. Le tableau suivant répertorie les activités devant être effectuées par les développeurs d'applications. Activité Construisez les systèmes de surveillance des transactions requis pour détecter les types d'événement de transaction qui déclenchent un transactionnel. Codez ou configurez une application client local de messagerie transactionnelle pour se connecter au service TMS d'emessage et soumettre des demandes d' transactionnel en réponse aux événements de transaction spécifiés. Le client doit pouvoir fournir des données d'identification d'accès pour votre compte de messagerie électronique hébergé. Structurez les demandes de service Web pour fournir les informations de personnalisation sous la forme de paires "nom-valeur". La demande doit également préciser le type de données pour chaque champ de personnalisation. Consultez l'équipe de marketing par pour déterminer si l'envoi de pièces jointes d' est requis. Description Consultez l'équipe de marketing par pour déterminer quelles activités métier ou client sont susceptibles d'être des événements de transaction déclencheurs. Pour vous aider, consultez le langage WSDL et les échantillons de client de messagerie transactionnelle proposés par IBM. IBM met à disposition un langage WSDL mis à jour comme modèle de client de messagerie transactionnelle pouvant traiter les pièces jointes des s. Les versions antérieures du langage WSDL ne prennent pas en charge les pièces jointes. Chapitre 1. A propos d'emessage et des s transactionnels 11

18 Activité En coordination avec l'équipe de marketing par , identifiez les sources de la personnalisation requise par les s transactionnels et les pièces jointes. Concevez et codez la gestion des erreurs En coordination avec l'équipe de marketing par , testez l'intégration du client local de messagerie transactionnelle avec le service TMS d'emessage. Description Le client de messagerie transactionnelle doit pouvoir se connecter aux systèmes d'applications et aux bases de données qui fournissent les valeurs de personnalisation de la demande d' transactionnel. Codez le client pour qu'il gère les erreurs signalées par le service TMS d'emessage. Incluez des fonctions pour notifier les administrateurs si le client ne peut pas se connecter ou si les demandes de service Web échouent. Pour plus d'informations sur les codes d'erreur renvoyés par le service TMS d'emessage, voir «AdvisoryMessage», à la page 24. Les spécialistes du marketing par doivent activer les mailings pour tester les s transactionnels et spécifier les adresses électroniques de test. Les développeurs d'applications doivent élaborer des moyens pour simuler les événements de transaction cibles et indiquer la transaction et les informations de personnalisation attendues au client local de messagerie transactionnelle. 12 IBM Unica emessage : Guide d'administration des s transactionnels

19 Chapitre 2. Intégration avec le service de messagerie transactionnelle d'emessage Le système de mailing transactionnel (TMS) d'emessage est un service Web hébergé faisant partie d'ibm Unica Hosted Services. Les développeurs d'applications doivent collaborer avec les spécialistes du marketing par de votre organisation pour créer les applications client requises pour intégrer vos systèmes transactionnels avec le service TMS d'emessage. Ces applications client initient chaque transactionnel en transmettant une demande SOAP au service TMS d'emessage via une connexion HTTPS. Les applications client qui soumettent la demande d' transactionnel doivent être en mesure d'effectuer les actions suivantes : v Identifier les transactions qui déclenchent l' transactionnel v v v v v Se connecter aux bases de données marketing qui contiennent les données utilisées pour personnaliser l' Initier la demande d' transactionnel sous la forme d'une demande SOAP Fournir les données d'identification pour accéder au service TMS d'emessage via une connexion sécurisée Fournir des informations sur le message, notamment le contenu des pièces jointes Gérer les messages d'erreur renvoyés par le service TMS d'emessage Toutes les actions requises pour l' transactionnel doivent être effectuées sans intervention manuelle. IBM met à la disposition des développeurs un langage WSDL pour les aider à concevoir des appels de service Web automatisés transmis au service TMS d'emessage. Pour plus d'informations sur le langage WSDL, voir «Langage WSDL pour les s transactionnels d'emessage», à la page 15. Concepts associés: «Informations sur le destinataire dans un transactionnel», à la page 5 Identification des événements de transaction Les développeurs d'applications doivent concevoir le client local de messagerie transactionnelle pour qu'il interagisse avec les systèmes de surveillance des transactions utilisés par votre organisation. Le client doit recevoir des notifications de transaction et distinguer le type d'événement de transaction que le système de gestion des transactions signale. Un événement de transaction peut être n'importe quelle action détectée par votre système de gestion des transactions. Par exemple, il peut s'agir d'un achat, d'une demande de service émise par un client, d'une demande d'informations ou d'un changement intervenant dans le statut d'un compte client. Généralement, votre organisation marketing détermine les types d'événement de transaction qui justifient une demande d' transactionnel ainsi que le contenu du message envoyé en réponse. Chaque événement de transaction nécessite l'envoi d'une demande d' transactionnel distincte au service TMS d'emessage. Copyright IBM Corp. 1999,

20 Accès aux données relatives aux destinataires Pour personnaliser les s transactionnels, le client local de messagerie transactionnelle doit accéder aux systèmes d'applications et aux bases de données pouvant fournir les données spécifiques aux destinataires devant figurer dans l' transactionnel. Les développeurs d'applications doivent collaborer avec l'équipe de marketing par pour identifier les champs de personnalisation utilisés dans l' auxquels font référence les mailings activés pour la prise en charge des s transactionnels. L'onglet de récapitulatif des mailings d'emessage contient un lien permettant d'accéder à la liste des champs de personnalisation utilisés dans l' . Les champs de personnalisation sont des marques de réservation pour les informations spécifiques au destinataire de l' . Ces informations sont fournies par les systèmes d'applications et les bases de données gérés par votre organisation. Le client local de messagerie transactionnelle doit pouvoir accéder à ces systèmes et extraire les données utilisées comme valeurs de ces champs de personnalisation. Concepts associés: «Construction d'une demande d' transactionnel», à la page 18 Chapitre 3, «API du service de mailing transactionnel (TMS) d'emessage», à la page 23 Connexion au service TMS d'emessage Vous devez concevoir le client local de messagerie transactionnelle pour qu'il se connecte automatiquement au centre de données IBM affecté à votre compte de messagerie électronique hébergé. Le client doit pouvoir fournir les données d'authentification appropriées dans la demande de service Web. Pour plus d'informations sur le centre de données à indiquer, voir «Adresses TMS emessage». Pour plus d'informations sur la façon de fournir les données d'authentification, voir «Spécification des données d'authentification pour la messagerie transactionnelle», à la page 16. Adresses TMS emessage IBM a établi des domaines de messagerie réservés au traitement des s transactionnels. Vous devez configurer vos applications de messagerie transactionnelle pour qu'elles demandent l'accès à IBM Unica Hosted Services en utilisant le domaine approprié. Le domaine que vous devez utiliser dépend du centre de données IBM qui traite votre demande. Pour traiter les s transactionnels via le centre de données IBM pour l'amérique du Nord, configurez une connexion au domaine tms-emus.unicaondemand.com. Pour traiter les s transactionnels via le centre de données IBM pour le Royaume-Uni, configurez une connexion au domaine tms-emeu.unicaondemand.com. 14 IBM Unica emessage : Guide d'administration des s transactionnels

21 Si vous ne savez pas quel centre de données IBM utiliser pour traiter vos s transactionnels, contactez le support technique. Pour plus d'informations de contacts, voir «Comment contacter le support technique IBM Unica», à la page 41. Langage WSDL pour les s transactionnels d'emessage IBM propose deux versions de langage WSDL pour concevoir les applications accédant au service TMS d'emessage. Le choix du langage WSDL dépend de si vous envisagez d'utiliser ou non des pièces jointes dans vos s et de la manière dont l'application client fournit les données d'identification d'accès. La première génération de langage WSDL ne prend pas en charge l'utilisation de pièces jointes avec les s transactionnels. Vous devez modifier l'en-tête SOAP pour fournir les données d'identification permettant d'accéder à IBM Unica Hosted Services. Pour plus de détails sur le langage WSDL de première génération, voir «Langage WSDL de première génération». Utilisez le langage WSDL de deuxième génération si vous envisagez de joindre des documents aux s transactionnels ou de soumettre les données d'identification d'accès sous la forme de paramètres dans la demande de service Web. Pour plus de détails sur le langage WSDL de deuxième génération, voir «Langage WSDL de deuxième génération». Langage WSDL de première génération Le langage WSDL de première génération décrit comment construire une interface avec le service TMS d'emessage. Il ne décrit pas comment joindre des documents et décrit une méthode pour accéder à IBM Unica Hosted Services qui requiert la modification de l'en-tête SOAP. Le langage WSDL de première génération est disponible dans le répertoire examples/tmsclient/conf de votre installation locale d'emessage. IBM fournit un exemple de la façon de créer le client local de messagerie transactionnelle à l'aide du langage WSDL de première génération. Tâches associées: «Ajout des données d'identification d'accès dans l'en-tête SOAP», à la page 16 Référence associée: Annexe A, «Echantillon de client utilisant le langage WSDL de première génération», à la page 29 Langage WSDL de deuxième génération Le langage WSDL de deuxième génération décrit comment construire une interface avec le service TMS d'emessage qui prenne en charge les pièces jointes d' . Ce langage WSDL décrit également comment spécifier les données d'identification d'accès sous la forme de paramètres dans la demande de service Web plutôt qu'en modifiant l'en-tête SOAP. Le langage WSDL de deuxième génération peut être téléchargé depuis le centre de données IBM qu'ibm vous a demandé d'utiliser pour vous connecter au service TMS d'emessage. L'URL pour le téléchargement est la suivante : <URL pour se connecter au service TMS>/emessageds/services/TMS?wsdl Chapitre 2. Intégration avec le service de messagerie transactionnelle d'emessage 15

22 IBM fournit un exemple pour créer le client local de messagerie transactionnelle en utilisant le langage WSDL de deuxième génération. Pour consulter cet exemple, voir Annexe B, «Echantillon de client utilisant le langage WSDL de deuxième génération», à la page 33 Remarque : Si vous avez déjà construit un client de messagerie transactionnelle en utilisant le langage WSDL de première génération, vous devez recompiler le code si vous passez à un client basé sur la deuxième génération. Spécification des données d'authentification pour la messagerie transactionnelle Le client local de messagerie transactionnelle doit pouvoir spécifier les données d'authentification requises pour se connecter automatiquement au service TMS d'emessage. Lorsqu'une demande d' transactionnel est émise, les applications transactionnelles doivent fournir les données d'authentification pour accéder à IBM Unica Hosted Services. Vous pouvez spécifier ces données soit en modifiant l'en-tête SOAP, soit en les transmettant sous la forme de paramètres dans la demande de service Web SOAP. Le nom d'utilisateur et le mot de passe que le client doit fournir dans la demande SOAP sont ceux affectés à votre compte emessage. Si vous ne les connaissez pas, prenez contact avec les individus responsables de la gestion de votre compte dans votre organisation ou contactez le support technique IBM Unica. Pour plus d'informations de contacts, voir «Comment contacter le support technique IBM Unica», à la page 41. Pour plus d'informations sur les comptes de messagerie électronique hébergés et sur l'établissement des connexions à IBM Unica Hosted Services, consultez le guide de démarrage et d'administration d'ibm Unica emessage. Ajout des données d'identification d'accès dans l'en-tête SOAP Toute demande de service Web transmise au service TMS d'emessage doit comporter un nom d'utilisateur et un mot de passe. Une des méthodes permettant d'accéder au service TMS d'emessage consiste à modifier l'en-tête SOAP de la demande de service Web pour inclure les données d'identification d'accès à IBM Unica Hosted Services. Vous ne pouvez pas utiliser cette méthode si vous envisagez d'utiliser des pièces jointes dans vos s transactionnels. Avant de commencer Avant toute chose, procurez-vous le nom d'utilisateur et le mot de passe créés pour votre compte de messagerie électronique hébergé IBM Unica emessage. Pourquoi et quand exécuter cette tâche Le nom d'utilisateur et le mot de passe que vous ajoutez à l'en-tête SOAP doivent être ceux créés pour votre compte de messagerie électronique hébergé IBM Unica emessage, comme indiqué ci-après. Les exemples de code suivants sont basés sur une bibliothèque SOAP Axis2. String username = "<nom d utilisateur de votre compte Unica emessage>"; String password = "<mot de passe de votre compte Unica emessage>"; 16 IBM Unica emessage : Guide d'administration des s transactionnels