Importation des segments - Amazon Pinpoint
Éléments à prendre en compte pour les segments importésFichiers de segmentsImportation d'un segmentAttributs pris en charge

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.

Importation des segments

Avec Amazon Pinpoint, vous pouvez définir un segment d'utilisateurs en important un fichier contenant des informations sur les utilisateurs qui appartiennent au segment. L'importation de segments est utile si vous définissez des segments d'utilisateurs en dehors d'Amazon Pinpoint mais que vous souhaitez impliquer vos utilisateurs dans des campagnes Amazon Pinpoint.

Contrairement aux segments dynamiques que vous créez avec le générateur de segments dans la console, un segment importé est un ensemble immuable de points de terminaison ou d'ID d'utilisateur :

Point de terminaison

Destination vers laquelle vous pouvez envoyer des messages (adresse e-mail, identifiant d'appareil mobile ou numéro de téléphone mobile, par exemple). Une définition de point de terminaison peut inclure des attributs qui décrivent l'utilisateur ou l'appareil auquel vous envoyez des messages. Elle peut également inclure un ID d'utilisateur.

Vous pouvez définir un segment en important une liste de définitions de points de terminaison. Amazon Pinpoint crée le segment et met à jour tous les points de terminaison que vous avez précédemment ajoutés à Amazon Pinpoint avec les nouvelles informations.

ID de l'utilisateur

ID qui représente un utilisateur individuel de votre public. L'ID doit être associé à un ou plusieurs points de terminaison. Par exemple, si une personne utilise votre application sur plusieurs appareils, votre application peut attribuer l'ID utilisateur de cette personne au point de terminaison de chaque appareil.

Vous pouvez définir un segment en important des ID utilisateur uniquement si vous avez ajouté les points de terminaison associés aux ID utilisateur à Amazon Pinpoint.

Un segment importé se compose de points de terminaison, d'ID d'utilisateur, ou d'une combinaison des deux. Lorsque vous utilisez Amazon Pinpoint pour envoyer un message au segment, les destinations potentielles incluent :

  • Chaque point de terminaison que vous répertoriez dans le fichier importé.

  • Chaque point de terminaison qui est associé à chaque ID utilisateur que vous répertoriez dans le fichier importé.

Lorsque vous créez un nouveau segment, vous pouvez utiliser un segment importé comme segment de base. Vous pouvez ensuite appliquer des filtres pour affiner le segment de base selon vos besoins.

Éléments à prendre en compte pour les segments importés

Tenez compte des facteurs suivants lorsque vous créez des segments importés :

  • Lorsque vous créez une campagne, vous devez choisir un segment. Lorsque vous choisissez un segment dynamique, Amazon Pinpoint fournit une estimation de la taille de ce segment. Toutefois, lorsque vous choisissez un segment importé, Amazon Pinpoint ne peut pas fournir d'estimation.

  • Si vous créez une campagne qui envoie des messages lorsque certains événements se produisent, vous ne pouvez pas utiliser des segments importés. Les campagnes basées sur des événements ne peuvent utiliser que des segments dynamiques. Pour plus d'informations sur la création de segments dynamiques, consultez Préparation des segments.

Fichiers de segments

Vous définissez les points de terminaison ou les ID d'utilisateur qui appartiennent à votre segment dans un fichier CSV (valeurs séparées par une virgule) ou un fichier JSON. Ensuite, vous importez le fichier dans Amazon Pinpoint pour créer le segment.

Lorsque vous importez un segment, prenez en considération les éléments suivants :

  • Amazon Pinpoint ne peut pas importer de fichiers compressés.

  • Les fichiers que vous importez doivent utiliser l'encodage de caractères UTF-8.

  • Si vous importez de nouveaux points de terminaison, les attributs Address et ChannelType sont obligatoires.

  • Si vous mettez à jour des points de terminaison existants, l'attribut Id est obligatoire pour chaque point de terminaison que vous souhaitez mettre à jour.

  • Vos définitions de point de terminaison ne peuvent inclure que certains attributs. Pour en obtenir la liste, veuillez consulter Attributs pris en charge. De plus, un nom d'attribut doit comporter 50 caractères ou moins. Une valeur d'attribut doit comporter 100 caractères ou moins.

Exemple de fichiers de segments

Les exemples de fichiers de cette section sont basés sur les données suivantes :

Exemple de valeurs d'attributs de point de terminaison
ChannelType Address Location.Country Demographic.Platform Demographic.Make Utilisateur. UserId
SMS +1604550182 CA Android LG example-user-id-1
APNS 1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f ETATS-UNIS iOS Apple example-user-id-2
EMAIL john.stiles@exemple.com ETATS-UNIS iOS Apple example-user-id-2
GCM 4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c CN Android Google example-user-id-3
EMAIL wang.xiulan@exemple.com CN Android OnePlus example-user-id-3

Chaque ligne de la table représente un seul point de terminaison. Notez que les ID d'utilisateur example-user-id-2 et example-user-id-3 sont attribués à deux points de terminaison chacun.

Exemple Fichier avec définitions de point de terminaison
CSV

Vous pouvez importer des points de terminaison définis dans un fichier CSV, comme dans l'exemple suivant :

ChannelType,Address,Location.Country,Demographic.Platform,Demographic.Make,User.UserId
SMS,+16045550182,CA,Android,LG,example-user-id-1
APNS,1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f,US,iOS,Apple,example-user-id-2
EMAIL,john.stiles@example.com,US,iOS,Apple,example-user-id-2
GCM,4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c,CN,Android,Google,example-user-id-3
EMAIL,wang.xiulan@example.com,CN,Android,OnePlus,example-user-id-3

La première ligne est l'en-tête, qui contient les attributs de point de terminaison. Pour obtenir une liste complète des attributs possibles, consultez Attributs pris en charge.

Les lignes suivantes définissent les points de terminaison en fournissant les valeurs de chaque attribut de l'en-tête.

Pour inclure une virgule ou des guillemets doubles dans une valeur, placez la valeur entre guillemets doubles, comme dans. "aaa,bbb"

Le fichier CSV ne peut pas contenir de sauts de ligne ni d'onglets. Si votre fichier contient des données comportant des sauts de ligne ou des tabulations, il se peut que les données qu'il contient ne soient pas importées ou que le processus d'importation échoue.

JSON

Vous pouvez importer des points de terminaison définis dans un fichier JSON séparé par des sauts de ligne. Dans ce cas, chaque ligne est un objet JSON complet qui contient une définition de point de terminaison, comme dans l'exemple suivant :

{"ChannelType":"SMS","Address":"+16045550182","Location":{"Country":"CA"},"Demographic":{"Platform":"Android","Make":"LG"},"User":{"UserId":"example-user-id-1"}}
{"ChannelType":"APNS","Address":"1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f","Location":{"Country":"US"},"Demographic":{"Platform":"iOS","Make":"Apple"},"User":{"UserId":"example-user-id-2"}}
{"ChannelType":"EMAIL","Address":"john.stiles@example.com","Location":{"Country":"US"},"Demographic":{"Platform":"iOS","Make":"Apple"},"User":{"UserId":"example-user-id-2"}}
{"ChannelType":"GCM","Address":"4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c","Location":{"Country":"CN"},"Demographic":{"Platform":"Android","Make":"Google"},"User":{"UserId":"example-user-id-3"}}
{"ChannelType":"EMAIL","Address":"wang.xiulan@example.com","Location":{"Country":"CN"},"Demographic":{"Platform":"Android","Make":"OnePlus"},"User":{"UserId":"example-user-id-3"}}

Pour obtenir une liste complète des attributs possibles, consultez Attributs pris en charge.

Exemple Fichier avec ID d'utilisateur
CSV

Vous pouvez également importer des ID utilisateur répertoriés dans un fichier CSV. Pour inclure une virgule ou des guillemets doubles dans une valeur, placez la valeur entre guillemets doubles, comme dans « aaa, bbb ».

Les sauts de ligne ne sont pas pris en charge dans une valeur du fichier CSV. Plusieurs ID utilisateur pour un seul point de terminaison doivent être saisis sur une seule ligne, chaque identifiant étant séparé par un espace, comme dans l'exemple suivant.

User.UserId
example-user-id-1 example-user-id-2 example-user-id-3

La première ligne est l'en-tête, qui doit contenir uniquement l'attribut User.UserId.

La ligne suivante répertorie chaque ID utilisateur appartenant au segment.

Comme vous le voyez dans l'exemple des définitions de point de terminaison, l'ID utilisateur example-user-id-1 est associé à un seul point de terminaison. Les ID d'utilisateur example-user-id-2 et example-user-id-3 sont associés chacun à deux points de terminaison. Par conséquent, le segment créé par l'importation de ce fichier peut être utilisé pour envoyer des messages jusqu'à cinq points de terminaison.

JSON

Vous pouvez aussi importer les ID d'utilisateur répertoriés dans un fichier JSON délimité par un caractère de nouvelle ligne, comme dans l'exemple suivant :

{"User":{"UserId":"example-user-id-1"}}
{"User":{"UserId":"example-user-id-2"}}
{"User":{"UserId":"example-user-id-3"}}

Comme vous le voyez dans l'exemple des définitions de point de terminaison, l'ID utilisateur example-user-id-1 est associé à un seul point de terminaison. Les ID d'utilisateur example-user-id-2 et example-user-id-3 sont associés chacun à deux points de terminaison. Par conséquent, le segment créé par l'importation de ce fichier peut être utilisé pour envoyer des messages jusqu'à cinq points de terminaison.

Importation d'un segment

Il existe deux manières d'importer des segments dans Amazon Pinpoint : vous pouvez charger des fichiers directement depuis votre ordinateur ou importer des fichiers stockés dans un compartiment Amazon S3.

Le chargement des fichiers depuis votre ordinateur est généralement la méthode d'importation des segments la plus simple, surtout si vous disposez déjà des données client sur votre ordinateur. Toutefois, vous ne pouvez importer que 10 fichiers à la fois et vous ne pouvez charger que des fichiers de moins de 1 gigaoctet (Go).

Si vous devez importer plus de 10 fichiers à la fois, ou si vous devez charger des fichiers supérieurs à 1 Go, vous devez importer des fichiers depuis Amazon S3. L'option d'importation Amazon S3 est également utile si vous avez déjà des processus qui envoient des fichiers de données clients à Amazon S3 pour les stocker.

Cette section inclut des procédures permettant d'importer des segments à l'aide de ces deux méthodes.

Vous pouvez créer des segments en chargeant jusqu'à 10 fichiers directement à partir de votre ordinateur. Les fichiers que vous chargez peuvent être au format JSON ou CSV. Vous pouvez charger des fichiers avec n'importe quelle combinaison de formats. Par exemple, vous pouvez charger un fichier JSON et trois fichiers CSV.

Pour importer un segment

  1. Ouvrez la console Amazon Pinpoint à l'adresse https://console.aws.amazon.com/pinpoint/.

  2. Sur la page All projects (Tous les projets), choisissez le projet auquel vous souhaitez ajouter le segment.

  3. Dans le volet de navigation, sélectionnez Segments.

  4. Choisissez Create a segment (Créer un segment).

  5. Sous Create a segment (Créer un segment), choisissez Import a segment (Importer un segment).

  6. Sous Import method (Méthode d'importation), choisissez Upload files from your computer (Charger les fichiers à partir de votre ordinateur).

  7. Sous Files to import (Fichiers à importer), sélectionnez Choose files (Choisir des fichiers). Sélectionnez le ou les fichiers que vous souhaitez importer.

    Note

    Vous pouvez également faire glisser des fichiers à partir de l'explorateur de fichiers de votre ordinateur et les déposer directement dans la zone Drop files here (Déposer les fichiers ici).

  8. Lorsque vous importez des fichiers vers Amazon Pinpoint, vous devez fournir un nom de segment pour chaque fichier que vous importez. Sous Segment names (Noms de segments), entrez un nom de segment pour chaque fichier que vous souhaitez importer, comme illustré dans l'image suivante.

    Image montrant la section des noms de segments dans la page de création de segment. Dans cet exemple, l'utilisateur a chargé deux fichiers : High Value Customers.csv et Top Users by Activity.json. Par défaut, Amazon Pinpoint attribue à chaque segment un nom qui est égal au nom du fichier, sans l'extension du nom de fichier.
    Note

    Par défaut, Amazon Pinpoint fournit un nom de segment identique au nom du fichier importé, mais sans l'extension du nom de fichier. Vous pouvez remplacer ces valeurs par défaut par n'importe quel nom.

    Vous pouvez utiliser le même nom pour plusieurs segments. Dans ce cas, Amazon Pinpoint crée un segment distinct pour chaque fichier et attribue un identifiant unique à chaque fichier. La date de création est également légèrement différente pour chaque fichier que vous importez. Vous pouvez utiliser ces facteurs pour faire une distinction entre les segments ayant le même nom.

  9. Lorsque vous avez terminé, choisissez Create segment (Créer un segment).

Avant d'utiliser cette procédure pour importer un segment, vous devez d'abord créer un compartiment Amazon S3 et charger votre fichier dans ce compartiment. Vous pouvez organiser les fichiers de différents segments en dossiers séparés. Lorsqu'Amazon Pinpoint importe les points de terminaison ou les identifiants utilisateur d'un segment, il inclut les fichiers de tous les dossiers et sous-dossiers qui appartiennent à l'emplacement Amazon S3 que vous avez spécifié.

Pour en savoir plus sur la création de compartiments et le chargement d'objets, consultez le Guide de l'utilisateur d'Amazon Simple Storage Service.

Amazon Pinpoint ne peut importer qu'un seul format de fichier (CSV ou JSON) par segment. Le chemin Amazon S3 que vous spécifiez ne doit donc contenir que des fichiers d'un seul type.

Pour importer un segment

  1. Ouvrez la console Amazon Pinpoint à l'adresse https://console.aws.amazon.com/pinpoint/.

  2. Sur la page All projects (Tous les projets), choisissez le projet auquel vous souhaitez ajouter le segment.

  3. Dans le volet de navigation, sélectionnez Segments.

  4. Choisissez Create a segment (Créer un segment).

  5. Sous Create a segment (Créer un segment), choisissez Import a segment (Importer un segment).

  6. Pour Segment name (Nom du segment), entrez le nom du segment afin qu'il soit facilement identifiable ultérieurement.

  7. Pour l'URL Amazon S3, entrez l'emplacement du compartiment Amazon S3 qui contient le fichier de votre segment. L'adresse du compartiment doit être au format suivant :

    s3://bucket-name/folder-name

    Amazon Pinpoint importe les fichiers depuis le chemin que vous avez indiqué et depuis tous les sous-dossiers de ce chemin.

  8. Pour le rôle IAM, effectuez l'une des étapes suivantes :

    • Si vous souhaitez qu'Amazon Pinpoint crée un rôle lui permettant de lire depuis un compartiment Amazon S3, choisissez Créer automatiquement un rôle. Ensuite, pour IAM role (Rôle IAM), entrez un nom pour le rôle que vous créez.

    • Si vous avez déjà créé un rôle IAM qui permet à Amazon Pinpoint de lire depuis un compartiment Amazon S3, choisissez Choisir un rôle existant. Ensuite, pour IAM Role (Rôle IAM), choisissez un rôle qui contient les autorisations appropriées.

    Si vous souhaitez créer vous-même le rôle IAM, consultez le rôle IAM pour l'importation de points de terminaison ou de segments dans le guide du développeur Amazon Pinpoint. Après avoir créé le rôle, indiquez-le dans la console Amazon Pinpoint.

  9. Sous Quel type de fichier importez-vous, choisissez Notation d'JavaScriptobjet (JSON) ou Valeurs séparées par des virgules (CSV), selon le format du fichier que vous avez chargé sur Amazon S3.

  10. Choisissez Create segment (Créer un segment).

Attributs pris en charge

Le tableau de cette section répertorie et décrit les attributs que vous pouvez spécifier dans les définitions de points de terminaison que vous importez dans Amazon Pinpoint. Si vous importez des segments à l'aide de fichiers CSV, les en-têtes du fichier doivent correspondre aux noms affichés dans la colonne Attribute (Attribut).

Pour les fichiers JSON, un point dans le nom de l'attribut indique que le nom qui suit le point est un objet imbriqué dans un objet parent avec un nom égal à la valeur précédant le point. Par exemple, un fichier JSON qui contient les attributs Demographic.Make et Demographic.Model possède la structure suivante :

{
...
"Demographic": {
  ...
  "Make":"Apple",
  "Model":"iPhone"
  ...
  }
...
}

La structure JSON complète ressemble beaucoup à l'exemple de demande de point de terminaison figurant dans la référence d'API Amazon Pinpoint. Cependant, les attributs du schéma de demande de point de terminaison ne sont pas tous pris en charge lorsque vous importez des segments, y compris EndpointStatus et EffectiveDate.

Pour qu'un champ personnalisé comporte plusieurs valeurs au format CSV, vous devez répliquer l'en-tête et conserver une valeur par en-tête. Par exemple :

...,User.UserId, User.UserAttributes.new_multi_field,User.UserAttributes.new_multi_field
...,example-user-id-2,test10,test20

Vous pouvez remplacer les noms des attributs affichés comme custom_attribute par n'importe quelle valeur. Par exemple, si vous souhaitez stocker les noms et prénoms des utilisateurs dans les attributs nommés FirstName et LastName, vous pouvez créer des attributs personnalisés nommés User.UserAttributes.FirstName et User.UserAttributes.LastName, respectivement. Un nom d'attribut peut contenir jusqu'à 50 caractères. Une valeur d'attribut peut contenir jusqu'à 100 caractères. Les noms d'attribut sont sensibles à la casse.

Dans JSON, l'attribut personnalisé doit être formaté à"Attributes":{"Ride":["Bus"]}.

Attribut Description
Address

Adresse de destination unique pour les messages ou les notifications push que vous envoyez au point de terminaison, par exemple, une adresse e-mail, un numéro de téléphone ou un jeton d'appareil.

Note

Si l'adresse du point de terminaison est un numéro de téléphone, vous devez le spécifier au format E.164. Pour plus d'informations sur le format E.164, voir E.164 sur Wikipedia.
Attributes.custom_attribute Attribut personnalisé décrivant le point de terminaison. Vous pouvez utiliser ce type d'attribut comme critère de sélection lorsque vous créez un segment. Vous pouvez remplacer custom_attribute par n'importe quelle valeur.
ChannelType Canal à utiliser lors de l'envoi de messages ou de notifications push au point de terminaison. Par exemple :

  • APNS— Pour un terminal qui peut recevoir des notifications push que vous envoyez via le canal du service Apple Push Notification (APNs) à des applications qui s'exécutent sur des appareils iOS.

  • EMAIL— Pour un terminal qui peut recevoir des e-mails.

  • GCM— Pour un terminal qui peut recevoir des notifications push que vous envoyez via le canal Firebase Cloud Messaging (FCM) à des applications qui s'exécutent sur des appareils Android.

  • SMS— Pour un terminal capable de recevoir des SMS.
Demographic.AppVersion Numéro de version de l'application associée au point de terminaison.
Demographic.Locale Les paramètres régionaux du point de terminaison, au format suivant : code ISO 639-1 alpha-2 suivi d'un trait de soulignement (_), suivi d'une valeur ISO 3166-1 alpha-2 . Par exemple, en_US est l’anglais pour les États-Unis.
Demographic.Make Fabricant du terminal de point de terminaison, comme apple ou samsung.
Demographic.Model Nom ou numéro du modèle du périphérique du point de terminaison, notamment iPhone ou SM-G900F.
Demographic.ModelVersion Version du modèle du terminal de point de terminaison.
Demographic.Platform Système d'exploitation du terminal de point de terminaison, notamment ios ou android.
Demographic.PlatformVersion Version du système d'exploitation sur le périphérique du point de terminaison.
Demographic.Timezone Fuseau horaire du point de terminaison, en tant que valeur de base de données tz. Par exemple, America/Los_Angeles pour Heure du Pacifique (Amérique du Nord).
Note

Les fuseaux horaires suivants ne sont plus pris en charge et sont automatiquement remappés vers les fuseaux horaires pris en charge.

Fuseau horaire Fuseau horaire remappé
Canada/East-Saskatchewan America/Managua
US/Pacific-New America/Los_Angeles
EffectiveDate Heure et date de la dernière mise à jour du point de terminaison, au format ISO 8601. Par exemple, 2019-08-23T10:54:35.220Z pour 10:54 UTC le 23 août 2019.
Id Identifiant unique du point de terminaison.
Location.City Ville où se trouve le point de terminaison.
Location.Country Code à deux lettres du pays ou de la région dans lequel/laquelle se trouve le point de terminaison, au format ISO 3166-1 alpha-2. Par exemple, US pour les États-Unis.
Location.Latitude Latitude du point de terminaison, arrondie à une décimale.
Location.Longitude Longitude du point de terminaison, arrondie à une décimale.
Location.PostalCode Code postal ou ZIP de la zone où se trouve le point de terminaison.
Location.Region Nom de la région, notamment un État ou une province, où se trouve le point de terminaison.
Metrics.custom_attribute Une métrique numérique personnalisée que votre application communique à Amazon Pinpoint pour le point de terminaison (par exemple, le nombre de sessions ou le nombre d'articles laissés dans un panier) à utiliser à des fins de segmentation. Vous pouvez remplacer custom_attribute par n'importe quelle valeur.

Ces valeurs personnalisées ne peuvent être que numériques. Comme ils sont numériques, Amazon Pinpoint peut y effectuer des opérations arithmétiques, telles que la moyenne ou la somme.
OptOut Indique si un utilisateur a choisi de ne pas recevoir de messages et de notifications push de votre part. Les valeurs acceptables sont les suivantes : ALL, l'utilisateur a choisi de ne pas recevoir de messages ou de notifications push ; ou NONE, l'utilisateur n’a pas refusé de recevoir tous les messages et notifications push.
RequestId Identifiant unique de la dernière demande de mise à jour du point de terminaison.
User.UserAttributes.custom_attribute Attribut personnalisé décrivant l'utilisateur. Vous pouvez remplacer custom_attribute par n'importe quelle valeur, par exemple FirstName ou Age.
User.UserId Un identifiant unique pour l'utilisateur.

Vous pouvez créer jusqu'à 250 attributs personnalisés pour les terminaux et les utilisateurs dans chaque projet. Pour plus d'informations, consultez les quotas Amazon Pinpoint dans le manuel Amazon Pinpoint Developer Guide.