Federated Data Access (FDA)

Utilisez le connecteur FDA (Federated Data Access) pour connecter Campaign à une ou plusieurs bases de données externes et traiter les informations stockées dans celles-ci sans affecter vos données provenant des bases cloud de Campaign. Vous pouvez ensuite accéder à des données externes sans modifier la structure des données Adobe Campaign.

REMARQUE

Les bases de données compatibles avec FDA sont répertoriées dans la Matrice de compatibilité.

L'option FDA de Campaign permet d'étendre votre modèle de données dans une base de données tierce. Le module détecte automatiquement la structure des tables ciblées et utilise les données provenant des sources SQL.

Des autorisations spécifiques sont requises sur Adobe Campaign et sur la base de données externe pour interagir ensemble. En savoir plus dans cette section.

Bonnes pratiques et limites

  • Optimiser la personnalisation d'un e-mail avec des données externes

    Vous pouvez prétraiter la personnalisation des messages dans un workflow dédié. Pour ce faire, utilisez l'option Préparer les données de personnalisation avec un workflow, disponible dans l'onglet Analyse des propriétés de la diffusion.

    Cette option permet, lors de l'analyse de la diffusion, de créer et d'exécuter automatiquement un workflow qui stocke toutes les données liées à la cible dans une table temporaire, notamment les données issues des tables liées dans une base de données externe.

    Cette option améliore considérablement les performances lors de l'exécution de l'étape de personnalisation.

  • Limites de FDA

    L'option FDA est utilisée pour manipuler les données des bases de données externes en mode batch dans les workflows. Pour éviter les problèmes de performance, il n'est pas recommandé d'utiliser le module FDA dans le cadre d'opérations unitaires, par exemple : personnalisation, interaction, messagerie en temps réel, etc.

    Evitez autant que possible les opérations nécessitant d'utiliser à la fois la base Adobe Campaign et la base externe. Pour cela, vous pouvez :

    • exporter les données de la base Adobe Campaign vers la base externe et effectuer les opérations uniquement depuis la base externe avant de réimporter les résultats dans Adobe Campaign.

    • collecter les données de la base externe dans Adobe Campaign et effectuer les opérations localement.

    Si vous souhaitez effectuer de la personnalisation dans vos diffusions à l'aide des données de la base externe, collectez les données à utiliser dans un workflow afin de les rendre disponibles dans une table temporaire. Utilisez alors les données de la table temporaire pour personnaliser votre diffusion.

    L'option FDA est assujettie aux limitations du système de la base de données externe que vous utilisez.

Étapes de configuration

Pour configurer l'accès à une base de données externe avec FDA, les étapes de configuration sont les suivantes :

  1. En tant qu'utilisateur Adobe Managed Services, contactez Adobe pour installer les pilotes sur votre instance Campaign.
  2. Une fois les pilotes installés, configurez le compte externe correspondant à votre base de données sur le serveur Adobe Campaign et testez le compte externe. En savoir plus
  3. Créez le schéma de la base de données externe dans Adobe Campaign. Il est ainsi possible d'identifier la structure des données de la base de données externe. En savoir plus
  4. Si nécessaire, créez un mapping de ciblage à partir du schéma créé précédemment. Ceci est nécessaire si les destinataires de vos diffusions proviennent de la base de données externe. Cette implémentation s'accompagne de limitations liées à la personnalisation des messages. En savoir plus

Compte externe de base de données externe

Vous devez créer un compte externe spécifique pour connecter votre instance Campaign à votre base de données externe.

Pour ce faire, procédez comme suit :

  1. Dans l'Explorateur Campaign, acédez à Administration > >Plateforme > >Comptes externes.

  2. Cliquez sur Nouveau.

    REMARQUE

    Pour qu'il soit actif, l'option Activé doit être cochée. Si nécessaire, désélectionnez ces option pour désactiver l'accès à cette base de données sans supprimer son paramétrage.

  3. Sélectionnez Base de données externe en tant que Type de compte externe.

  4. Sélectionnez votre base de données externe dans la liste déroulante et configurez le compte externe. Vous devez indiquer les informations suivantes :

    • Serveur : URL du serveur

    • Compte : nom de l'utilisateur

    • Mot de passe : mot de passe du compte utilisateur

    • Base de données : nom de la base de données

  5. Cliquez sur l'onglet Paramètres, puis sur le bouton Déployer les fonctions pour créer des fonctions.

  6. Une fois les paramètres renseignés, cliquez sur le bouton Tester la connexion pour les valider.

  7. Pour permettre à Adobe Campaign d'accéder à cette base, vous devez déployer les fonctions SQL. Cliquez sur l'onglet Paramètres puis sur le bouton Déployer les fonctions.

Vous pouvez définir des tablespaces de travail spécifiques pour les tables et pour les index dans l'onglet Paramètres.

Pour Snowflake, le connecteur prend en charge les options suivantes :

Option Description
workschema Schéma de base de données à utiliser pour les tables de travail.
warehouse Nom de l'entrepôt par défaut à utiliser. Il remplace la valeur par défaut de l'utilisateur.
TimeZoneName Vide par défaut. C'est le fuseau horaire système du serveur applicatif Campaign Classic qui est utilisé. Il est possible d'utiliser cette option pour forcer le paramètre de session TIMEZONE.
Pour plus d'informations à ce sujet, consultez cette page.
WeekStart Paramètre de session WEEK_START. Par défaut, cette valeur est définie sur 0.
Pour plus d'informations à ce sujet, consultez cette page.
UseCachedResult Paramètre de session USE_CACHED_RESULTS. Par défaut, cette valeur est définie sur TRUE. Il est possible d'utiliser cette option pour désactiver les résultats de Snowflake mis en mémoire cache.
Pour plus d'informations à ce sujet, voir cette page.

Création du schéma de données

Pour créer le schéma de la base externe dans Adobe Campaign, procédez comme suit :

  1. Cliquez sur le bouton Nouveau au-dessus de la liste des schémas de données et sélectionnez Accéder à des données externes.

  2. Saisissez le nom du schéma et sa description, puis sélectionnez le compte externe permettant la connexion à la base de données. Vous avez ainsi accès à la liste des tables disponibles dans la base externe. Sélectionnez la table contenant les données à collecter.

  3. Cliquez sur OK pour valider. Adobe Campaign détecte automatiquement la structure de la table sélectionnée et génère le schéma logique. Veuillez noter qu'Adobe Campaign ne génère pas de liens.

  4. Cliquez sur Enregistrer pour en valider la création.

Définir le mapping de ciblage

Vous pouvez définir un mapping sur les données d'une table externe.

Pour cela, une fois que le schéma de la table externe a été créé, vous devez créer un nouveau mapping de diffusion afin d'utiliser les données contenues dans cette table en tant que cible des actions de diffusions.

Pour ce faire, procédez comme suit :

  1. Accédez à Administration > Gestion de campagne > Mappings de ciblage à partir de l'explorateur Adobe Campaign.

  2. Créez un nouveau mapping de ciblage et sélectionnez le schéma que vous venez de créer comme dimension de ciblage.

  3. Indiquez les champs où sont stockées les informations nécessaires à la diffusion (nom, prénom, e-mail, adresse postale, etc.).

  4. Indiquez les paramètres relatifs au stockage des informations, et notamment le suffixe des schémas d'extension, afin de les identifier facilement.

    Vous pouvez choisir de stocker ou non les exclusions (excludelog), avec les messages (broadlog) ou dans une table distincte.

    Vous pouvez également gérer ou non le tracking pour ce mapping de diffusion (trackinglog).

  5. Sélectionnez ensuite les extensions qui seront prises en compte. Le type d'extension dépend des paramètres et options de votre plateforme (consultez votre contrat de licence).

    Cliquez sur le bouton Enregistrer pour lancer la création du mapping de diffusion : toutes les tables liées sont créées automatiquement, selon les paramètres sélectionnés.

Autorisations

Des autorisations spécifiques sont requises sur Adobe Campaign et sur la base de données externe pour interagir ensemble.

Tout d'abord, afin qu'un utilisateur puisse effectuer des opérations sur une base externe via FDA, l'opérateur doit disposer d'un droit nommé spécifique dans Adobe Campaign.

  1. Sélectionnez le nœud Administration > Gestion des accès > Droits nommés de l'explorateur Adobe Campaign.

  2. Créez un nouveau droit en indiquant le libellé de votre choix.

  3. Saisissez le nom du droit nommé au format user:base@server, où :

    • user est le nom de l'utilisateur dans la base de données externe
    • base est le nom de la base de données externe
    • server est le nom du serveur de la base de données externe
  4. Enregistrez le droit nommé puis associez-le à l'opérateur de votre choix à partir du nœud Administration > Gestion des accès > Opérateurs de l'explorateur Adobe Campaign.

Ensuite, pour traiter les données contenues dans une base de données externe, l'opérateur Adobe Campaign doit au minimum avoir les autorisation en écriture sur cette base de données, afin de permettre la création des tables de travail. Ces tables sont automatiquement supprimées par Adobe Campaign.

Les autorisations suivantes sont nécessaires :

  • CONNECT : connexion à la base distante
  • READ Data : accès en lecture aux tables contenant les données du client
  • READ 'MetaData' : accès aux catalogues de données du serveur afin d'obtenir la structure des tables
  • LOAD : chargement en masse dans des tables de travail (opération nécessaire lorsque l'on travaille sur des collections et des jointures)
  • CREATE/DROP pour TABLE/INDEX/PROCEDURE/FUNCTION (uniquement pour les tables de travail générées par Adobe Campaign)
  • EXPLAIN (recommandé) : pour la surveillance des performances en cas de problème
  • WRITE Data (selon le scénario d'intégration)

L'administrateur de la base de données doit mettre en correspondance ces droits avec les droits spécifiques à chaque moteur de base de données, comme spécifié ci-dessous.

Snowflake Amazon Redshift
Connexion à une base de données distante Privilèges USAGE ON WAREHOUSE, USAGE ON DATABASE et USAGE ON SCHEMA Création d'un utilisateur lié au compte AWS
Création de tables Privilège CREATE TABLE ON SCHEMA Privilège CREATE
Création d'index N/A Privilège CREATE
Création de fonctions Privilège CREATE FUNCTION ON SCHEMA Privilège USAGE ON LANGUAGE plpythonu pour pouvoir appeler des scripts Python externes
Création de procédures N/A Privilège python USAGE ON LANGUAGE pour pouvoir appeler des scripts Python externes
Suppression d'objets (tables, index, fonctions, procédures) Propriété de l'objet Être propriétaire de l'objet ou être un super-utilisateur
Surveillance des exécutions Privilège MONITOR sur l'objet requis Aucun privilège requis pour utiliser la commande EXPLAIN
Écriture de données Privilèges INSERT et/ou UPDATE (selon l'opération d'écriture) Privilèges INSERT et UPDATE
Chargement de données dans des tables Privilèges CREATE STAGE ON SCHEMA, SELECT et INSERT sur la table ciblée Privilèges SELECT et INSERT
Accès aux données clientes Privilège(s) SELECT sur (FUTURE) TABLE(S) ou VIEW(S) Privilège SELECT
Accès aux métadonnées Privilège SELECT sur INFORMATION_SCHEMA SCHEMA Privilège SELECT

Utiliser des données externes dans un workflow

Une fois le schéma de données créé, les données peuvent être traitées dans les workflows Adobe Campaign.

Plusieurs activités permettent d'interagir avec les données d'un base externe :

  • Filtrer sur les données externes : l'activité de requête permet d'ajouter des données externes et de les utiliser dans les paramètres de filtrage définis.

  • Créer des sous-ensembles : l'activité de partage vous permet de créer des sous-ensembles. Vous pouvez utiliser des données externes pour définir les critères de filtrage à utiliser.

  • Charger la base de données externe : vous pouvez utiliser les données externes dans l'activité Chargement (SGBD).

  • Ajouter des informations et des liens : l'activité Enrichissement permet d'ajouter des données supplémentaires à la table de travail du workflow et de créer des liens vers une table externe. Dans ce contexte, elle peut utiliser des données provenant d'une base de données externe.

Vous pouvez également définir directement une connexion à une base de données externe à partir de ces activités de workflow, pour une utilisation temporaire. Dans ce cas, elle sera stockée dans une base externe locale, réservée à une utilisation dans un workflow en cours. Elle ne sera pas enregistrée sur les comptes externes.

ATTENTION

Ce type de configuration ne doit être utilisé que temporairement pour collecter des données. La configuration du compte externe doit être préférée pour toute autre utilisation.

Par exemple, dans l'activité Requête, vous pouvez définir une connexion temporaire à une base externe comme suit :

  1. Ouvrez l'activité et cliquez sur le lien Ajouter des données…
  2. Sélectionnez les options des Données externes.
  3. Choisissez l'option En définissant localement la source de données.
  4. Sélectionnez le moteur de la base de données cible dans la liste déroulante. Saisissez le nom du serveur et renseignez les paramètres d'authentification. Indiquez également le nom de la base de données externe.
  5. Sélectionnez la table où sont stockées les données. Vous pouvez saisir le nom de la table directement dans le champ correspondant ou cliquer sur l'icône d'édition pour accéder à la liste des tables de la base de données.
  6. Cliquez sur le bouton Ajouter pour définir un ou plusieurs champs de réconciliation entre les données de la base externe et celles de la base Adobe Campaign. Les icônes Editer l'expression des colonnes Champ distant et Champ local permettent d'accéder à la liste des champs de chacune des tables.
  7. Au besoin, indiquez une condition de filtrage et le mode de tri des données.
  8. Sélectionnez les données additionnelles à collecter dans la base externe. Pour cela, double-cliquez sur le ou les champs à ajouter afin de les afficher parmi les Colonnes de sortie.
  9. Cliquez sur le bouton Terminer pour valider ce paramétrage.

Sur cette page