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. Sur chaque AudienceMember de la audienceMembers liste, définissez le champ de données en fonction du type de données que la importation contient :

   • Si l'importation contient des coordonnées, des données d'adresse IP, ou les deux, définissez le champ compositeData sur un CompositeData objet. Pour les coordonnées, définissez le champ userData sur un UserData objet et ajoutez une entrée distincte dans la liste userIdentifiers pour chaque identifiant du membre de l'audience. Pour les données d'adresse IP, ajoutez une IpData entrée dans la ipData liste pour chaque adresse IP 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 ID mobiles, définissez le mobileData champ sur un MobileData message. Ajoutez une entrée distincte dans la liste mobileIds pour chaque ID mobile du membre de l'audience.

   • Si l'importation contient des ID utilisateur, définissez le userIdData champ sur un UserIdData message, puis définissez son userId champ sur l'ID utilisateur du membre de l'audience.

3. Envoyez les données de ciblage par liste de clients en suivant la procédure décrite 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, ou userIdData) :

Coordonnées

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

Données d'adresse IP

{
  "compositeData": {
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

Coordonnées et données d'adresse IP

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    },
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

ID mobiles

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

ID utilisateur

{
  "userIdData": {
    "userId": "user_987654321"
  }
}