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, définissez le champ compositeData sur un objet CompositeData et définissez son champ userData sur un objet UserData. 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 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.

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) :

Coordonnées

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

Mobile ID

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