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

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

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

1. Ustaw pole termsOfService na wiadomość TermsOfService z polem customerMatchTermsOfServiceStatus ustawionym na ACCEPTED, aby potwierdzić, że operatingAccount zaakceptował 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 przesyłany plik:

   • Jeśli przesyłane dane zawierają informacje kontaktowe, dane adresów IP lub oba te rodzaje 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 o adresach IP dodaj wpis IpData na liście ipData dla każdego adresu IP odbiorcy.

     Chociaż userData jest nadal obsługiwany, zalecamy używanie compositeData, aby integracja była przygotowana na przyszłe ulepszenia. Więcej informacji znajdziesz w sekcji Dane złożone.

   • Jeśli przesyłany plik zawiera identyfikatory urządzeń mobilnych, ustaw pole mobileData na komunikat MobileData. Dodaj osobny wpis na liście mobileIds dla każdego dokumentu Mobile ID odbiorcy.

   • Jeśli przesyłany plik zawiera identyfikatory użytkowników, ustaw pole userIdData na komunikat UserIdData, a pole userId na identyfikator użytkownika będącego odbiorcą.

3. Wyślij dane dotyczące kierowania na listę klientów, wykonując czynności opisane w sekcji Wysyłanie danych o odbiorcach.

Przykładowi odbiorcy

Poniższe przykłady pokazują, jak utworzyć obiekt AudienceMember dla każdego typu danych użytkownika. Każdy element AudienceMember w pojedynczym żądaniu musi mieć ustawiony ten sam typ 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"
      }
    ]
  }
}

Dokumenty Mobile ID

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

Identyfikatory użytkowników

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