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ı tamamlayı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, yüklemenin içerdiği veri türüne göre veri alanını 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ı için compositeData kullanmanızı öneririz. Ayrıntılar için Bileşik veriler başlıklı makaleyi inceleyin.

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

   • Yükleme kullanıcı kimlikleri içeriyorsa userIdData alanını UserIdData mesajı olarak ayarlayın ve userId alanını kitle üyesinin kullanıcı kimliği olarak 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 sahip olmalıdır (compositeData, mobileData veya userIdData):

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

Kişi 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"
  }
}