Importer des membres dans une audience

Importez des membres dans une audience de ciblage par liste de clients en envoyant une requête IngestAudienceMembersRequest.

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

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

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

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

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

Exemples de membres de l'audience

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

Coordonnées

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

Données de l'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 de propriété intellectuelle

{
  "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"
      }
    ]
  }
}

Mobile ID

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

ID utilisateur

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