Kitleye üye yükleme

IngestAudienceMembersRequest göndererek Müşteri Eşleştirme kitlesine üye yükleyin.

İsteği yapılandırmak ve göndermek için aşağıdaki adımları tamamlayın:

  1. termsOfService alanını, customerMatchTermsOfServiceStatus alanı ACCEPTED olarak ayarlanmış bir TermsOfService mesajı olarak ayarlayın. Bu mesaj, operatingAccount kullanıcısının kullanıcısının Müşteri Eşleştirme Hizmet Şartları'nı kabul ettiğini onaylar.

  2. audienceMembers listesindeki her AudienceMember için veri alanını, yüklemenin içerdiği veri türüne göre ayarlayın:

    • Yükleme işleminde iletişim bilgileri varsa compositeData alanını CompositeData nesnesi olarak ayarlayın ve userData alanını UserData nesnesi olarak ayarlayın. Kitle üyesinin her tanımlayıcısı için userIdentifiers listesine ayrı bir giriş ekleyin.

      userData hâlâ destekleniyor olsa da entegrasyonunuzun gelecekteki iyileştirmelere hazır olmasını sağlamak için compositeData kullanmanızı öneririz. Ayrıntılar için Bileşik veriler bölümüne bakın.

    • Yükleme mobil kimlikler içeriyorsa mobileData alanını MobileData mesajı olarak ayarlayın. Kitle üyesinin her mobil kimliği için mobileIds listesine ayrı bir giriş ekleyin.

  3. Kitle üyelerini gönderme bölümündeki adımları uygulayarak Müşteri Eşleştirme verilerini gönderin.

Örnek kitle üyeleri

Aşağıdaki örneklerde, her üye verisi türü için bir AudienceMember nesnesinin nasıl yapılandırılacağı gösterilmektedir. Tek bir istekteki her AudienceMember, aynı türde kimlik verisi kümesine sahip olmalıdır (compositeData, mobileData):

İletişim bilgileri

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

Mobil kimlikler

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