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łany plik zawiera informacje kontaktowe, ustaw pole compositeData na obiekt CompositeData, a pole userData na obiekt UserData. Dodaj osobny wpis na liście userIdentifiers dla każdego identyfikatora 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.

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 jednym żądaniu musi mieć ustawiony ten sam typ danych identyfikatora (compositeData, mobileData):

Informacje kontaktowe

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

Dokumenty Mobile ID

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