Importer les données d'utilisation vers CRM via DataPrep

Importer les données d'utilisation vers CRM via DataPrep

Cette page a été traduite à l'aide d'outils d'IA et peut contenir des erreurs. Pour les détails les plus précis et à jour, veuillez consulter la version anglaise originale.
Ce guide vous aidera à configurer un pipeline pour extraire les données brutes de votre application ou site web, les nettoyer et les organiser avec DataPrep afin de les importer dans votre compte CRM.

Importer les données vers DataPrep

Pour transférer les données d'une source quelconque vers DataPrep en vue de leur manipulation et de leur importation ultérieure dans CRM, suivez les étapes décrites ci-dessous :
  1. Connectez-vous à votre compte DataPrep.
  2. Pour créer une nouvelle connexion, accédez à Pipelines → + Créer un nouveau et nommez le nouveau pipeline. Vous pouvez également ouvrir le pipeline existant dans votre espace de travail et le modifier
  3. Cliquez sur Ajouter les données et sélectionnez la source de données. Par exemple, si votre source de données est une URL provenant de Google Analytics, sélectionnez URL.
  4. Pour configurer la connexion URL, entrez le nom de votre ensemble de données. Si vous avez créé un nouveau pipeline, modifiez la méthode API en POST ; sinon, laissez la méthode API en GET. Entrez l'URL de la requête. Pour savoir où trouver l'URL de la requête, cliquez sur ici.
  5. Dans le champ Ajouter le corps de la requête, cliquez sur le signe plus.
6. Ajoutez le corps de la requête en vous inspirant du modèle ci-dessous et structurez-le en fonction des exemples qui suivent. Toutes les clés mentionnées dans l'exemple de corps de requête sont obligatoires.

Idea
Exemple de corps de requête
{

"limit": [max_results],

"dimensions": [

{

"name": "eventName"

},

{

"name": "dateHour"

},

{

"name": "customUser:[uniqueUserID]"

}

],

"dateRanges": [

{

"startDate": "[start_date]",

"endDate": "[end_date]"

}

],

"keepEmptyRows": false],

"orderBys": [

{

"desc": [false],

"dimension": {

"dimensionName": "[dayHour]",

"orderType": "NUMERIC]"

}

}

]

}

]
}


Descriptions des champs : Toutes les clés

  1. limit (obligatoire) :
    Définit le nombre maximal d'enregistrements à retourner. Par exemple, « limit » : 100 retournera jusqu'à 100 enregistrements. La limite recommandée est 1 000 000.
    1. Type : Entier
  2. uniqueUserID :
    Spécifie la clé particulière utilisée pour identifier l'enregistrement utilisateur dans CRM, comme l'ID d'enregistrement CRM ou l'ID de messagerie.
    1. Exemple : « user_uid »
    2. Type : Tableau d'objets
  3. dateRanges :
    Spécifie la plage de dates pour la requête de données. Vous devez fournir une startDate et une endDate pour la plage que vous souhaitez récupérer. La endDate correspond à la date d'aujourd'hui et la startDate peut être 365daysAgo, 180daysAgo ou 90daysAgo. Les données les plus récentes sont plus utiles pour les modèles IA.
    1. Exemple : « startDate » : « 365daysAgo », « endDate » : « 2024-04-06 »
    2. Type : Tableau d'objets
    3. Remarque : Utilisez des formats de date relatifs (par exemple, « 365daysAgo ») ou des dates spécifiques au format AAAA-MM-JJ.
  4. keepEmptyRows :
    Si la valeur est false, les lignes sans données sont exclues.
    1. Exemple : « keepEmptyRows » : false
    2. Valeur par défaut : true (si omis)
    3. Type : Booléen
  5. orderBys
    Définit l'ordre de tri des données. Vous pouvez trier les résultats en fonction d'une dimension ou d'une métrique.
    1. Exemple : « desc » : true effectue un tri en ordre décroissant, « dimension » : { « dimensionName » : « dateHour », « orderType » : « NUMERIC » } effectue un tri en fonction d'une dimension numérique.
    2. Type : tableau d'objets
    3. Remarque : vous pouvez personnaliser le tableau orderBys pour définir plusieurs préférences de tri.
7. Accédez à l'onglet Headers ci-dessous. Ajoutez le type de contenu sous Keys. Basculez vers l'onglet Authorization, choisissez la Authorization méthode, remplissez les autres détails, et cliquez sur Authenticate.

8. Basculez vers Authorization, choisissez la Authorization méthode, remplissez les autres détails, et cliquez sur Authenticate.
Lorsque l'importation des données est réussie, vous avez créé une nouvelle connexion.

Définir l'ensemble de règles

1. Cliquez sur l'icône plus bleue à côté de l'étape intermédiaire et sélectionnez pour insérer un ensemble de règles. L'ajout d'un ensemble de règles facilite le prétraitement des données.

2. Sur la page qui s'affiche, cliquez sur l'icône Ensemble de règles, surlignée en jaune.
3. Définissez l'ensemble de règles comme dans l'image ci-dessous.

Complétez votre pipeline

Maintenant que vos données ont été préparées pour être traitées conformément à l'ensemble de règles donné, l'étape suivante consiste à compléter votre pipeline en choisissant votre destination d'exportation.

1. Sur la même page, cliquez sur Ajouter une destination dans le coin supérieur droit et choisissez Zoho CRM comme destination et remplissez les autres champs.

2. Remplissez les champs de configuration.
3. Cliquez sur Enregistrer.

Votre pipeline est maintenant complet et ressemble à l'image ci-dessous.

Correspondance de cible

L'étape suivante est la Correspondance de cible, où la mise en correspondance des noms de colonnes de la base de données importée avec les champs du module CRM choisi a lieu.
1. Accédez à Préparer les données à nouveau et cliquez sur l'Correspondance de cible icône. Sélectionnez Afficher la cible dans le coin supérieur droit.

2. Les colonnes marquées d'une croix rouge indiquent une non-correspondance des noms de colonnes et doivent être renommées. Cliquez sur la croix et sélectionnez le nom de colonne pertinent pour mapper la colonne avec celui-ci. Mappez toutes les colonnes de la même manière.


3. Si la marque rouge devient jaune et affiche le message ci-dessous, cliquez dessus jusqu'à ce qu'elle devienne automatiquement verte, comme indiqué dans l'image ci-dessous.


4. Répétez cette opération pour les autres colonnes ayant des croix rouges.
5. L'étape finale consiste à revenir au pipeline et à cliquer sur Exécuter pour lancer l'exportation.
Les données exportées seront automatiquement importées dans le module CRM choisi.

Pour importer des données d'utilisation vers CRM directement à partir de n'importe quel outil d'analyse, consultez ici.