Bir segmentteki müşterileri listeleme
customerSegmentMembers ile bir müşteri segmentinin üyelerini sayfalayın ya da customerSegmentMembersQueryCreate ile anlık bir segment sorgusu çalıştırın.
- API
- Admin GraphQL API
- İşlemler
- customerSegmentMembers, customerSegmentMembersQueryCreate, customerSegmentMembersQuery
- Erişim yetkisi
- read_customers
- API sürümü
- 2026-10
- Son kontrol
Kısaca
Bir segmentteki müşterileri listelemek için customerSegmentMembers’ı segmentId ile sorgulayın ve first ile after kullanarak sayfalayın; totalCount segmentin büyüklüğünü verir. Bir segment sorgusunu kaydetmeden denemek için number_of_orders >= 3 gibi bir ShopifyQL koşuluyla customerSegmentMembersQueryCreate’i başlatın, done true olunca ID’sini queryId olarak customerSegmentMembers’a verin. İkisi de read_customers ister.
Nasıl kullanılır
- Segment ID’sini, her segmentin adını ve sorgusunu listeleyen segments sorgusuyla bulun.
- SegmentMembers’ı first: 100 ile gönderin ve hasNextPage true olduğu sürece after: endCursor ile sayfalayın.
- Kaydedilmemiş bir koşul için StartMembersQuery’yi gönderin, done olana kadar customerSegmentMembersQuery(id)’yi sorgulayın, ardından customerSegmentMembers(queryId: …) çalıştırın.
- Üye ID’lerini müşterileri etiketlemek, kod göndermek ya da e-posta aracınıza aktarmak için kullanın.
Kod
segment-members.graphqlquery SegmentMembers($segmentId: ID!, $first: Int!, $after: String) {
customerSegmentMembers(segmentId: $segmentId, first: $first, after: $after) {
totalCount
edges {
node {
id
displayName
numberOfOrders
amountSpent {
amount
currencyCode
}
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
segment-members.variables.json{
"segmentId": "gid://shopify/Segment/1234567890",
"first": 100,
"after": null
}
segment-members.response.json{
"data": {
"customerSegmentMembers": {
"totalCount": 1842,
"edges": [
{
"node": {
"id": "gid://shopify/CustomerSegmentMember/1111111111",
"displayName": "Ada Example",
"numberOfOrders": "7",
"amountSpent": {
"amount": "642.50",
"currencyCode": "EUR"
}
}
}
],
"pageInfo": {
"hasNextPage": true,
"endCursor": "eyJsYXN0X2lkIjoxMTExMTExMTExfQ=="
}
}
}
}
members-query-create.graphqlmutation StartMembersQuery($input: CustomerSegmentMembersQueryInput!) {
customerSegmentMembersQueryCreate(input: $input) {
customerSegmentMembersQuery {
id
done
currentCount
}
userErrors {
code
field
message
}
}
}
members-query-create.variables.json{
"input": {
"query": "number_of_orders >= 3 AND email_subscription_status = 'SUBSCRIBED'"
}
}
members-query-create.response.json{
"data": {
"customerSegmentMembersQueryCreate": {
"customerSegmentMembersQuery": {
"id": "gid://shopify/CustomerSegmentMembersQuery/1234567890",
"done": false,
"currentCount": 0
},
"userErrors": []
}
}
}
Lintel tarafından yazıldı. MIT lisansı: kendi mağazanızda da müşteri işlerinizde de ücretsiz kullanabilirsiniz.
Sınırlar ve özel durumlar
- Bu bağlantıda nodes yok, edges var: edges[].node okuyun.
- Segment sorguları admin arama sözdizimini değil, Shopify’ın segment sorgu dilini kullanır.
- E-posta ve telefon gibi iletişim alanları korunan müşteri verisidir; seçmeden önce erişim izni alın.
- numberOfOrders UnsignedInt64 tipindedir ve metin olarak döner.
Sık sorulan sorular
- Bir Shopify müşteri segmenti API ile nasıl dışa aktarılır?
- customerSegmentMembers’ı segment ID’siyle sayfalayın ve her üyeyi dosyanıza ya da aracınıza yazın.
- Segment kaydetmeden bir segment sorgusu çalıştırabilir miyim?
- Evet. customerSegmentMembersQueryCreate bir koşulu asenkron çalıştırır; bittiğinde ID’sini queryId olarak verin.
- Segment sorguları hangi yetkiyi ister?
- read_customers. segmentCreate ile segment oluşturmak için write_customers gerekir.
Shopify belgeleri
- Gösterilen tarihte, 2026-10 sürümünün Admin veya Storefront API şemasıyla doğrulandı. İstek adresinizdeki sürümü kontrol edin.
- Örneklerdeki ID’ler ve mağaza adresleri yer tutucudur. Kendi değerlerinizle değiştirin.
- Admin API çağrıları uygulamanızdan bir erişim anahtarı (access token) ister. Admin API anahtarını asla vitrine ya da temaya koymayın.
- MIT lisansı. Kodu kendi mağazanızda da müşteri işlerinizde de kullanabilirsiniz.
Mağazanız için kurulmasını, test edilmesini ve bakımını isterseniz: API entegrasyonları.
