# 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.

Sayfa: https://lintelagency.com/tr/kaynaklar/graphql/musteri-segmenti-uyeleri

## 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.

## Bilgiler

- **API:** Admin GraphQL API
- **İşlemler:** customerSegmentMembers, customerSegmentMembersQueryCreate, customerSegmentMembersQuery
- **Erişim yetkisi:** read_customers
- **API sürümü:** 2026-10
- **Son kontrol:** 2 Kasım 2026

## Nasıl kullanılır

1. Segment ID’sini, her segmentin adını ve sorgusunu listeleyen segments sorgusuyla bulun.
2. SegmentMembers’ı first: 100 ile gönderin ve hasNextPage true olduğu sürece after: endCursor ile sayfalayın.
3. 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.
4. Üye ID’lerini müşterileri etiketlemek, kod göndermek ya da e-posta aracınıza aktarmak için kullanın.

## Kod

### segment-members.graphql

```graphql
query 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

```json
{
  "segmentId": "gid://shopify/Segment/1234567890",
  "first": 100,
  "after": null
}
```

### segment-members.response.json

```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.graphql

```graphql
mutation StartMembersQuery($input: CustomerSegmentMembersQueryInput!) {
  customerSegmentMembersQueryCreate(input: $input) {
    customerSegmentMembersQuery {
      id
      done
      currentCount
    }
    userErrors {
      code
      field
      message
    }
  }
}
```

### members-query-create.variables.json

```json
{
  "input": {
    "query": "number_of_orders >= 3 AND email_subscription_status = 'SUBSCRIBED'"
  }
}
```

### members-query-create.response.json

```json
{
  "data": {
    "customerSegmentMembersQueryCreate": {
      "customerSegmentMembersQuery": {
        "id": "gid://shopify/CustomerSegmentMembersQuery/1234567890",
        "done": false,
        "currentCount": 0
      },
      "userErrors": []
    }
  }
}
```

## 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.

## 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

- [customerSegmentMembers](https://shopify.dev/docs/api/admin-graphql/latest/queries/customerSegmentMembers)
- [Segment query language](https://shopify.dev/docs/api/shopifyql/segment-query-language-reference)

## İlgili içerikler

- [Siparişlere, müşterilere ya da ürünlere toplu etiket ekleme](https://lintelagency.com/tr/kaynaklar/graphql/toplu-etiket-ekleme)
- [Toplu indirim kodu ekleme](https://lintelagency.com/tr/kaynaklar/graphql/toplu-indirim-kodu-olusturma)
- [Sonuçları cursor ile sayfalama](https://lintelagency.com/tr/kaynaklar/graphql/cursor-ile-sayfalama)

Lisans: MIT. Kendi mağazanızda da müşteri işlerinizde de ücretsiz kullanabilirsiniz.