Przesyłanie informacji o członkach do grupy odbiorców

Prześlij członków do grupy odbiorców kierowania na listę klientów, wysyłając an IngestAudienceMembersRequest.

Aby skonfigurować i wysłać żądanie, wykonaj te czynności:

1. Ustaw pole termsOfService na TermsOfService wiadomość z polem customerMatchTermsOfServiceStatus ustawionym na ACCEPTED, aby potwierdzić, że operatingAccount zaakceptowało Warunki korzystania z usługi kierowania na listę klientów.

2. W przypadku każdego elementu AudienceMember na liście audienceMembers ustaw pole danych na podstawie typu danych, które zawiera przesłany plik:

   • Jeśli przesłany plik zawiera informacje kontaktowe, dane adresu IP, lub oba te typy danych, ustaw pole compositeData na obiekt CompositeData. W przypadku informacji kontaktowych ustaw pole userData na obiekt UserData i dodaj osobny wpis na liście userIdentifiers dla każdego identyfikatora odbiorcy. W przypadku danych adresu IP dodaj IpData wpis na ipData liście dla każdego adresu IP odbiorcy.

     Chociaż pole userData jest nadal obsługiwane, zalecamy używanie pola compositeData aby zapewnić, że integracja będzie przygotowana na przyszłe ulepszenia. Więcej informacji znajdziesz w artykule Dane złożone.

   • Jeśli przesłany plik zawiera identyfikatory (dokumentów) Mobile ID, ustaw pole mobileData na wiadomość MobileData. Dodaj osobny wpis na liście mobileIds dla każdego dokumentu Mobile ID odbiorcy.

   • Jeśli przesłany plik zawiera identyfikatory użytkowników, ustaw pole userIdData na wiadomość UserIdData i ustaw pole userId na identyfikator użytkownika odbiorcy.

3. Wyślij dane kierowania na listę klientów, wykonując czynności opisane w sekcji Wysyłanie informacji o członkach grupy odbiorców.

Przykładowi odbiorcy

Z przykładów poniżej dowiesz się, jak utworzyć strukturę obiektu AudienceMember dla każdego typu danych członka. Każdy element AudienceMember w jednym żądaniu musi mieć ten sam typ zestawu danych identyfikatora (compositeData, mobileData lub userIdData):

Informacje kontaktowe

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

Dane adresu 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"
      }
    ]
  }
}

Dane kontaktowe i adres 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"
      }
    ]
  }
}

Identyfikatory Mobile ID

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

Identyfikatory użytkowników

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