Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Connexion à Adobe Analytics Adobe Analytics est une plateforme d’analyse de données robuste qui collecte des données à partir d’expériences numériques multicanales prenant en charge le parcours client et qui fournit des outils pour analyser les données. Il s’agit d’une plateforme couramment utilisée par les spécialistes du marketing et les analystes commerciaux à des fins d’analytique métier. Si vous êtes un utilisateur d'Adobe Analytics, vous pouvez vous connecter AWS Glue à votre compte Adobe Analytics. Vous pouvez ensuite utiliser Adobe Analytics comme source de données dans vos tâches ETL. Exécutez ces tâches pour transférer des données entre Adobe Analytics et AWS des services ou d'autres applications prises en charge. **Topics** + [AWS Glue support pour Adobe Analytics](adobe-analytics-support.md) + [Politiques contenant les opérations API pour la création et l’utilisation des connexions](adobeanalytics-configuring-iam-permissions.md) + [Configuration d’Adobe Analytics](adobeanalytics-configuring.md) + [Configuration des connexions Adobe Analytics](adobeanalytics-configuring-connections.md) + [Lecture à partir d’entités Adobe Analytics](adobeanalytics-reading-from-entities.md) + [Options de connexion Adobe Analytics](adobeanalytics-connection-options.md) + [Création d’un compte Adobe Analytics](adobeanalytics-create-account.md) + [Limitations](adobeanalytics-connector-limitations.md) # AWS Glue support pour Adobe Analytics AWS Glue prend en charge Adobe Analytics comme suit : **Prise en charge en tant que source ?** Oui. Vous pouvez utiliser les tâches AWS Glue ETL pour interroger les données d'Adobe Analytics. **Prise en charge en tant que cible ?** Non. **Versions d’API Adobe Analytics prises en charge** v2.0 # Politiques contenant les opérations API pour la création et l’utilisation des connexions L'exemple de politique suivant décrit les AWS autorisations requises pour créer et utiliser des connexions. Si vous créez un rôle, créez une politique contenant les éléments suivants : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "glue:ListConnectionTypes", "glue:DescribeConnectionType", "glue:RefreshOAuth2Tokens", "glue:ListEntities", "glue:DescribeEntity" ], "Resource": "*" } ] } ``` ------ Si vous ne voulez pas utiliser la méthode ci-dessus, vous pouvez également utiliser les politiques IAM gérées suivantes : + [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Accorde l'accès aux ressources dont AWS Glue les différents processus ont besoin pour s'exécuter en votre nom. Ces ressources incluent AWS Glue Amazon S3, IAM, CloudWatch Logs et Amazon EC2. Si vous suivez la convention de dénomination des ressources spécifiée dans cette politique, AWS Glue les processus disposent des autorisations requises. Cette politique est généralement attachée aux rôles spécifiés lorsque vous définissez les crawlers, les tâches et les points de terminaison de développement. + [ AWSGlueConsoleFullAccess ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Accorde un accès complet aux AWS Glue ressources lorsqu'une identité à laquelle la politique est attachée utilise la console AWS de gestion. Si vous suivez la convention de dénomination pour les ressources spécifiées dans la politique, les utilisateurs bénéficient des capacités totales de la console. Cette politique s'applique généralement aux utilisateurs de la AWS Glue console. # Configuration d’Adobe Analytics Avant de pouvoir AWS Glue effectuer un transfert depuis Adobe Analytics, vous devez satisfaire aux exigences suivantes : ## Configuration requise + Vous disposez d’un compte Adobe Analytics avec adresse e-mail et mot de passe. Pour plus d’informations sur la création d’un compte, consultez [Creating a Adobe Analytics account](adobeanalytics-create-account.md). + Votre compte Adobe Analytics est activé pour accéder à l’API. L’accès à l’API est activé par défaut pour les éditions Select, Prime et Ultimate. Si vous répondez à ces exigences, vous êtes prêt à vous connecter AWS Glue à votre compte Adobe Analytics. Pour les connexions classiques, vous n’avez rien d’autre à faire dans Adobe Analytics. # Configuration des connexions Adobe Analytics Adobe Analytics prend en charge le type d’autorisation `AUTHORIZATION_CODE` pour `OAuth2`. Ce type d’autorisation est considéré comme `OAuth` tridimensionnel, car il repose sur la redirection des utilisateurs vers le serveur d’autorisation tiers pour authentifier l’utilisateur. Les utilisateurs peuvent choisir de créer leur propre application connectée dans Adobe Analytics et de fournir leur propre identifiant client et leur propre secret client lors de la création de connexions via la AWS Glue console. Dans ce scénario, ils seront toujours redirigés vers Adobe Analytics pour se connecter et autoriser AWS Glue à accéder à leurs ressources. Ce type d’autorisation donne lieu à un jeton d’actualisation et à un jeton d’accès. Le jeton d’accès est de courte durée et peut être actualisé automatiquement sans interaction de l’utilisateur à l’aide du jeton d’actualisation. [Pour consulter la documentation publique d'Adobe Analytics sur la création d'une application connectée pour le OAuth flux AUTHORIZATION\$1CODE, consultez Adobe Analytics. APIs](https://adobedocs.github.io/analytics-2.0-apis/) Pour configurer une connexion Adobe Analytics : 1. Dans AWS Secrets Manager, créez un secret avec les informations suivantes : Pour l’application connectée gérée par le client : le secret doit contenir le secret du consommateur de l’application connectée avec `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` comme clé. **Note** Il est indispensable de créer un secret par connexion dans AWS Glue. 1. Dans AWS Glue Studio, créez une connexion sous **Connexions de données** en suivant les étapes ci-dessous : 1. Lorsque vous sélectionnez un **type de connexion**, sélectionnez Adobe Analytics. 1. Indiquez l’`x_api_key, instanceUrl` d’Adobe Analytics à laquelle vous souhaitez vous connecter. 1. Sélectionnez le rôle IAM pour lequel AWS Glue vous pouvez assumer et qui dispose des autorisations nécessaires pour effectuer les actions suivantes : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "secretsmanager:DescribeSecret", "secretsmanager:GetSecretValue", "secretsmanager:PutSecretValue", "ec2:CreateNetworkInterface", "ec2:DescribeNetworkInterfaces", "ec2:DeleteNetworkInterface" ], "Resource": "*" } ] } ``` ------ 1. Sélectionnez celui `secretName` que vous souhaitez utiliser pour cette connexion AWS Glue afin d'y placer les jetons. 1. Sélectionnez les options réseau si vous souhaitez utiliser votre réseau. 1. Accordez au rôle IAM associé à votre AWS Glue travail l'autorisation de lire`secretName`. # Lecture à partir d’entités Adobe Analytics **Conditions préalables** Un objet Adobe Analytics à partir duquel vous souhaitez lire. Reportez-vous au tableau des entités prises en charge ci-dessous pour vérifier les entités disponibles. **Entités prises en charge** | Entité | Peut être filtré | Limit prise en charge | Order by prise en charge | Select prise en charge\$1 | Partitionnement pris en charge | | --- | --- | --- | --- | --- | --- | | Annotation | Oui | Oui | Oui | Oui | Non | | Calculated Metrics | Oui | Oui | Oui | Oui | Non | | Calculated Metrics Function | Oui | Non | Non | Oui | Non | | Component Metadata Shares | Oui | Oui | Non | Oui | Non | | Date Ranges | Oui | Oui | Non | Oui | Non | | Dimensions | Oui | Non | Non | Oui | Non | | Métriques | Oui | Non | Non | Oui | Non | | Projets | Oui | Non | Non | Oui | Non | | Reports Top Item | Oui | Oui | Non | Oui | Non | | Segments | Oui | Oui | Oui | Oui | Non | | Usage Logs | Oui | Oui | Non | Oui | Non | **Exemple** ``` adobeAnalytics_read = glueContext.create_dynamic_frame.from_options( connection_type="adobeanalytics", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "annotation/ex*****", "API_VERSION": "v2.0" }) ``` **Détails des entités et des champs Adobe Analytics** + [Annotations](https://adobedocs.github.io/analytics-2.0-apis/#/Annotations) + [Calculated Metrics](https://adobedocs.github.io/analytics-2.0-apis/#/Calculated%20Metrics) + [Component Meta Data](https://adobedocs.github.io/analytics-2.0-apis/#/Component%20Meta%20Data) + [Date Ranges](https://adobedocs.github.io/analytics-2.0-apis/#/Date%20Ranges) + [Dimensions](https://adobedocs.github.io/analytics-2.0-apis/#/Dimensions) + [Métriques](https://adobedocs.github.io/analytics-2.0-apis/#/Metrics) + [Projects](https://adobedocs.github.io/analytics-2.0-apis/#/Projects) + [Rapports](https://adobedocs.github.io/analytics-2.0-apis/#/Reports) + [Segments](https://adobedocs.github.io/analytics-2.0-apis/#/Segments) + [Utilisateurs](https://adobedocs.github.io/analytics-2.0-apis/#/Users) + [Usage Logs](https://adobedocs.github.io/analytics-2.0-apis/#/Usage%20Logs) # Options de connexion Adobe Analytics Les options de connexion pour Adobe Analytics sont les suivantes : + `ENTITY_NAME`(Chaîne) - (Obligatoire) Utilisé pour la lecture/l’écriture. Le nom de votre objet dans Adobe Analytics. + `API_VERSION`(Chaîne) - (Obligatoire) Utilisé pour la lecture/l’écriture. Version d’API Rest Adobe Analytics que vous souhaitez utiliser. Par exemple : v2.0. + `X_API_KEY`(Chaîne) - (Obligatoire) Utilisé pour la lecture/l’écriture. Il est nécessaire d’authentifier le développeur ou l’application qui envoie des demandes à l’API. + `SELECTED_FIELDS`(Liste) - Par défaut : vide (SELECT \$1). Utilisé pour la lecture. Colonnes que vous souhaitez sélectionner pour l’objet. + `FILTER_PREDICATE`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Doit être au format SQL Spark. + `QUERY`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Requête Spark SQL complète. # Création d’un compte Adobe Analytics 1. Inscrivez-vous au programme de partenaire d’échange en accédant au [programme Adobe Partner](https://partners.adobe.com/exchangeprogram/creativecloud.html). 1. Choisissez **Rejoindre le programme d’échange**. 1. Inscrivez-vous ou créez un compte en utilisant votre adresse e-mail professionnelle. 1. Dans la boîte à suggestions, sélectionnez l’entreprise appropriée qui possède un abonnement à un produit Adobe Analytics. 1. Assurez-vous que le compte est enregistré auprès d’une organisation valide (dans la liste disponible) disposant d’un abonnement Adobe Analytics actif. 1. Après l’approbation de l’administration de l’entreprise, activez votre compte en cliquant sur le lien contenu dans l’e-mail d’approbation. **Vérifiez si le compte que vous avez créé a accès au service Adobe Analytics.** 1. Connectez-vous à [Adobe Admin Console](https://adminconsole.adobe.com/). 1. Vérifiez le nom de l’organisation dans le coin supérieur droit de la page pour vous assurer que vous vous êtes connecté à la bonne entreprise. 1. Sélectionnez **Produits** et vérifiez si Adobe Analytics est disponible. **Note** Si aucune organisation n'est disponible, ou si le produit Adobe Analytics est grisé ou n'est pas disponible, il est probable que votre compte n'est pas associé à une organisation n' and/or ayant aucun abonnement Adobe Analytics actif. Contactez votre administrateur système pour demander l’accès à ce service pour votre compte. **Création d’un projet et d’informations d’identification `OAuth2.0`** 1. Connectez-vous au compte Adobe Analytics sur lequel vous souhaitez créer [l'application OAuth 2.0](https://developer.adobe.com/developer-console/docs/guides/services/services-add-api-oauth/). 1. Sélectionnez **Projet**, puis **Créer un projet**. 1. Pour ajouter un projet, sélectionnez **Ajouter au projet**, puis **API**. 1. Sélectionnez l’**API Adobe Analytics**. 1. Sélectionnez **OAUTH** comme authentification utilisateur. 1. Sélectionnez **Web** en tant que `OAUTH` et indiquez l’URI de redirection. Pour l’URI de redirection et son modèle, consultez ce qui suit : + URI de redirection par défaut `OAuth 2.0` : l’URI de redirection par défaut est l’URL de la page à laquelle Adobe accèdera pendant le processus d’authentification. Par exemple, `https://ap-southeast-2.console.aws.amazon.com/appflow/oauth` + OAuth Modèle d'URI de redirection 2.0 — Un modèle d'URI de redirection est un chemin d'URI (ou une liste de chemins séparés par des virgules) vers lequel Adobe peut être redirigé (si demandé) une fois le flux de connexion terminé. Par exemple, `https://ap-southeast-2\\.console\\.aws\\.amazon\\.com` 1. Ajoutez les portées suivantes : + `openid` + `read_organizations` + `additional_info.projectedProductContext` + `additional_info.job_function` 1. Choisissez **Enregistrer les informations d’identification**. 1. Une fois l’application créée, copiez les valeurs `Client ID` et `Client Secret` dans un fichier texte. # Limitations Les restrictions du connecteur Adobe Analytics sont les suivantes : + Adobe Analytics ne prend pas en charge le partitionnement basé sur les champs et basé sur les enregistrements. Le partitionnement basé sur les champs n’est pas pris en charge, car vous ne pouvez pas interroger les champs que vous partitionnez. Le partitionnement basé sur les enregistrements ne peut pas être pris en charge, car il n’existe aucune disposition permettant d’obtenir un « décalage » pour la pagination. + Dans l’entité `Report Top Item`, les paramètres de requête `startDate` et `endDate` ne fonctionnent pas comme prévu. La réponse n’est pas filtrée en fonction de ces paramètres, ce qui entraîne des problèmes avec le filtre et le flux incrémentiel pour cette entité. + Pour les entités `Annotation`, `Calculated Metrics`, `Calculated Metrics Function`, `Date Ranges`, `Dimension`, `Metric`, `Project`, `Report Top Items` et `Segment`, le paramètre de requête `locale` indique la langue à utiliser pour les sections localisées des réponses et ne filtre pas les enregistrements. Par exemple, `locale="ja_JP"` affichera les données en japonais. + Entité `Report Top Item` : le filtre est activé et les champs `dateRange` et `lookupNoneValues` ne fonctionnent pas actuellement. + Entité `Segment` : avec une valeur de filtre `includeType=“templates”`, les filtres sur les autres champs ne fonctionnent pas. + Entité `Date Range` : le filtre sur le champ `curatedRsid` ne fonctionne pas. + Entité `Metric entity` : le filtre sur un champ segmentable avec une valeur « false » donne un résultat à la fois pour une valeur true et une valeur false.