Segment Üyeleri

Üyeler ekranı, bir segmentin içindeki kişileri listeler. Statik segmentte üye eklediğiniz ve çıkardığınız yer de burasıdır.

Panelde nerede

Audience → Segments → bir segmente tıklayın → View Members (Üyeleri Gör; dinamik segment) ya da Manage Members (Üyeleri Yönet; statik segment). Sayfanın başlığı "Segment adı - Members" (Üyeler), altında "Bu segmentte N üye var" yazar; Back to Segment Settings (Segment Ayarlarına Dön) segment sayfasına döner.

Bu ekran hassas veri taşır: kişilerin kimliklerini gösterir. Listeyi görmek ve dışa aktarmak segment:view_members iznini ister; eklemek, çıkarmak ve toplu içe aktarmak segment:update iznini. admin rolünde ikisi de vardır; marketing rolünde yalnızca güncelleme izni vardır ve üye listesi 403 ile reddedilir. Segment listesi, sayılar ve gelir bu izne bağlı değildir.

Sütunlar

Sütun	Anlamı
Customer ID (Müşteri ID)	Sitenizde identify ile bildirdiğiniz kimlik. Selwise'da bu müşterinin bir profili varsa kimlik, profil sayfasına bağlanır (Müşteri Profili). Kimliği olmayan kişi için Anonymous visitor (Anonim ziyaretçi) yazar.
Visitor ID (Ziyaretçi ID)	Tarayıcının anonim kimliği. Hiç tarayıcısı bilinmeyen bir müşteri (ör. veri aktarımıyla gelen) için dahili bir anahtar kullanılır; bu anahtar veri sayılmadığından — görünür.
Added (Eklenme)	Kişinin segmente girdiği zaman. Üyeliği koruyan kişide bu tarih değişmez.
Expires (Bitiş)	Üyeliğin bitiş zamanı; süresiz üyelik için Never (Yok). Geçmiş bir tarih, üyeliğin dolduğunu gösterir.
Source (Kaynak)	Üyeliği kimin yazdığı: Rules (Kural), Rules (first computation) (Kural (ilk hesaplama)), Manual (Elle), Bulk import (Toplu içe aktarma), Scenario (Senaryo) ya da API. Tanınmayan bir değer olduğu gibi basılır.
Actions (İşlemler)	Yalnızca statik segmentte: üyeyi kaldır

Dinamik segmentin üyelerini kurallar yazar; bu ekranda eklenip çıkarılamaz ve sayfa bunu bir notla söyler ("Bu dinamik bir segment…"). Liste boşsa nedeni iki türlüdür: statik segmentte "Üye bulunamadı, yukarıdaki butonla üye ekleyin"; dinamik segmentte "Kurallara uyan kimse yok ya da üyeler henüz hesaplanmadı" — bkz. Dinamik Segmentler.

Liste, süresi dolmuş üyelikleri de gösterir; boyut sayısı ve hedefleme ise onları saymaz.

Arama ve sayfalar

Arama kutusu Visitor ID ve Customer ID içinde büyük küçük harfe bakmadan metin parçası arar. Her aramada ilk sayfaya dönülür. Liste en yeni üye üstte olacak şekilde 50'şer satır gösterilir; Previous (Önceki) ve Next (Sonraki) sayfalar arasında gezer, altta "Toplam kaydın şu aralığı gösteriliyor" yazar.

Dışa aktarma

Export (Dışa Aktar) düğmesi, ekrandaki 50 satırı değil segmentin tüm üyelerini CSV olarak indirir. Segment boşsa düğme pasiftir. Dosya segment-<segment kimliği>-members.csv adını taşır ve en yeni üye ilk satırda olacak şekilde sıralıdır.

visitorId,siteUserId,addedAt,expiresAt,source
v_5f9e01,24680,2026-10-03T11:40:00.000Z,2027-01-01T00:00:00.000Z,manual
v_8d1c2a,12345,2026-10-02T09:14:00.000Z,,rules
,67890,2026-10-02T09:14:00.000Z,,rules

• visitorId dahili anahtar taşıyan kişide boş yazılır.
• Tarihler UTC ve ISO 8601 biçimindedir; süresiz üyelikte expiresAt boştur.
• Bir hücre =, +, - ya da @ ile başlıyorsa e-tablo programı onu formül sanmasın diye başına ' konur.
• Dosya UTF-8 işaretiyle (BOM) başlar; Excel Türkçe karakterleri doğru açar.

Üst sınır: 100.000 satır. Daha büyük bir segmentte dosya en yeni 100.000 üyeyi içerir ve ekran bunu "Segmentte N üye var; dosya dışa aktarma sınırı nedeniyle yalnızca en yeni M üyeyi içeriyor" uyarısıyla söyler. Eksik bir listeyi tam sanmayın; sayıyı uyarıdaki toplamla karşılaştırın.

Üye ekleme

Statik segmentte Add Member (Üye Ekle) üç alanlı bir pencere açar:

Alan	Zorunlu mu	Anlamı
Visitor ID (Ziyaretçi ID)	evet, en fazla 100 karakter	Üyeliğin anahtarı. Aynı kimlik zaten listedeyse yeni satır açılmaz, mevcut satır güncellenir.
Site User ID (Site Kullanıcı ID)	hayır, en fazla 255 karakter	identify ile bildirilen müşteri kimliği
Expires At (optional) (Bitiş Tarihi (isteğe bağlı))	hayır	Bu tarihten sonra kişi segmentte sayılmaz

Kimlikler hakkında ve yalnızca müşteri kimliği biliniyorsa ne yapacağınız için Statik Segmentler sayfasına bakın. Hata pencerenin içinde yazılır; alan sınırları kutunun altında görünür.

Toplu içe aktarma

Bulk Import (Toplu İçe Aktar) bir metin kutusu açar; her satıra bir üye yazılır ya da yapıştırılır:

visitor_123,12345
visitor_456
visitor_789,67890

Satır biçimi visitorId,siteUserId şeklindedir; siteUserId isteğe bağlıdır. Kurallar:

• Başlık satırı yazmayın. visitorId,siteUserId gibi bir satır, "visitorId" adında bir üye olarak aktarılır.
• Dosya yükleme yoktur: CSV'nizi bir e-tabloda iki sütuna indirip kopyalayarak kutuya yapıştırın. Alan değerleri tırnak içine alınmaz; virgül içeren bir kimlik desteklenmez.
• Boş satırlar atlanır. Ziyaretçi kimliği boş ya da 100 karakterden, müşteri kimliği 255 karakterden uzun satırlar, satır numarasıyla birlikte kutunun altında listelenir; hiçbiri düzeltilmeden Import Members (Üyeleri İçe Aktar) düğmesi açılmaz. Ekran ilk 5 sorunlu satırı yazar, kalanı "…ve sorunlu N satır daha" diye özetler.
• Bir içe aktarmada en fazla 10.000 satır olur; fazlası bölünerek aktarılır.
• Bu penceredeki satırlarla bitiş tarihi verilemez; süreli üyelik için tek tek ekleyin ya da API'yi kullanın.
• Aynı ziyaretçi kimliği iki kez geçerse ya da listede zaten varsa satır güncellenir.

Sonuçta "İçe aktarma tamamlandı: N eklendi, M atlandı" yazar. "Eklendi", yazılan ya da güncellenen satırdır; "atlandı" ise veritabanının kabul etmediği satırdır. Aktarılan üyeler Bulk import kaynağıyla yazılır.

Üye kaldırma

Satırın sonundaki çöp kutusu simgesi, onaydan sonra üyeyi segmentten çıkarır. Kaldırma, üyeliğin ziyaretçi kimliğiyle eşleşen satırını siler. Hedeflemede etkisi, tarayıcıların 5 dakikalık önbelleği kadar gecikebilir.

API

Ekranın kullandığı uçlar, panelin oturumuyla çağrılır (mağaza anahtarıyla çağrılamaz); aşağıdaki yollar API köküne göre verilmiştir.

İşlem	Uç	Gövde / sorgu	İzin
Listele	GET /segments/:id/members	limit (1 ile 100, varsayılan 50), offset, search	segment:view_members
Dışa aktar	GET /segments/:id/members/export	yok	segment:view_members
Ekle	POST /segments/:id/members	visitorId, siteUserId, expiresAt (ISO 8601), metadata	segment:update
Toplu ekle	POST /segments/:id/members/bulk	members: dizi, her biri visitorId, siteUserId, expiresAt	segment:update
Kaldır	DELETE /segments/:id/members/:visitorId	yok	segment:update

Yanıtlar:

{ "members": [ { "id": "…", "visitorId": "v_8d1c2a", "siteUserId": "12345", "siteUserProfileId": null, "addedAt": "2026-10-02T09:14:00.000Z", "expiresAt": null, "source": "manual" } ], "total": 1 }

{ "success": true, "added": 98, "skipped": 2, "message": "Added 98 members, skipped 2" }

• Ekleme, toplu ekleme ve kaldırma yalnızca statik segmentte çalışır; dinamik segmentte 400 ("Can only add members to static segments") döner.
• 10.000'den fazla üyeli toplu istek 400 ve SEGMENT_BULK_TOO_MANY koduyla reddedilir; yanıt max ve count değerlerini taşır.
• Dışa aktarma yanıtı X-Selwise-Export-Truncated (true ya da false), X-Selwise-Export-Row-Limit ve X-Total-Count başlıklarını taşır. Dosya kesildiyse X-Total-Count segmentin gerçek üye sayısıdır.
• Segment bulunamazsa 404, hesapta Audience modülü yoksa 402, izin yoksa 403 döner.