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

Aby przesłać członków do grupy odbiorców kierowania na listę klientów, wyślij 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, ustaw pole compositeData na obiekt CompositeData i ustaw jego userData na UserData obiekt. Dodaj osobny wpis na liście userIdentifiers dla każdego identyfikatora odbiorcy.

     Chociaż pole userData jest nadal obsługiwane, zalecamy używanie pola compositeData aby zapewnić, że integracja jest 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.

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

Przykładowi odbiorcy

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

Informacje kontaktowe

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

Identyfikatory Mobile ID

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