Kitleye üye yükleme

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

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

1. operatingAccount tarafından Müşteri Eşleştirme Hizmet Şartları'nın kabul edildiğini onaylamak için termsOfService alanını customerMatchTermsOfServiceStatus değeri ACCEPTED olarak ayarlanmış bir TermsOfService mesajına ayarlayın.

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, iletişim bilgileri, IP adresi verileri veya her ikisini birden içeriyorsa compositeData alanını bir CompositeData nesnesine ayarlayın. İletişim bilgileri için userData alanını UserData nesnesi olarak ayarlayın ve kitle üyesinin her tanımlayıcısı için userIdentifiers listesine ayrı bir giriş ekleyin. IP adresi verileri için kitle üyesinin her IP adresi için ipData listesine bir IpData girişi 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ı bir MobileData mesajına ayarlayın. Kitle üyesinin her Mobile ID'si için mobileIds listesine ayrı bir giriş ekleyin.

   • Yükleme, kullanıcı kimlikleri içeriyorsa userIdData alanını bir UserIdData mesajına ayarlayın ve userId alanını kitle üyesinin kullanıcı kimliğine ayarlayın.

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 (compositeData, mobileData veya userIdData) sahip olmalıdır:

İletişim bilgileri

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

IP adresi verileri

{
  "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"
      }
    ]
  }
}

İletişim ve IP verileri

{
  "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"
      }
    ]
  }
}

Mobile ID'ler

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

User ID'ler

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