Importer des membres dans une audience

Importez des membres dans une audience de ciblage par liste de clients en envoyant un IngestAudienceMembersRequest.

Pour configurer et envoyer la requête, procédez comme suit :

1. Définissez le champ termsOfService sur un TermsOfService message avec customerMatchTermsOfServiceStatus défini sur ACCEPTED pour confirmer que le operatingAccount a accepté les conditions d'utilisation du ciblage par liste de clients.

2. Pour chaque AudienceMember de la liste audienceMembers, définissez le champ de données en fonction du type de données que contient l' importation :

   • Si l'importation contient des coordonnées, définissez le compositeData champ sur un CompositeData objet, et définissez son userData champ sur un UserData objet. Ajoutez une entrée distincte dans la liste userIdentifiers pour chaque identifiant du membre de l'audience.

     Bien que userData soit toujours accepté, nous vous recommandons d'utiliser compositeData pour vous assurer que votre intégration est prête pour les améliorations futures. Pour en savoir plus, consultez Données composites.

   • Si l'importation contient des Mobile ID, définissez le mobileData champ sur un MobileData message. Ajoutez une entrée distincte dans la liste mobileIds pour chaque Mobile ID du membre de l'audience.

3. Envoyez les données de ciblage par liste de clients en suivant les étapes décrites dans Envoyer des membres de l'audience.

Exemples de membres de l'audience

Les exemples suivants montrent comment structurer un AudienceMember objet pour chaque type de données de membre. Chaque AudienceMember d'une même requête doit avoir le même type d'ensemble de données d'ID set (compositeData, mobileData) :

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    }
  }
}

{
  "mobileData": {
    "mobileIds": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}