{"id":15538,"date":"2025-09-18T13:00:18","date_gmt":"2025-09-18T12:00:18","guid":{"rendered":"https:\/\/help.expertsender.com\/?post_type=ecdp&p=15538"},"modified":"2026-03-09T10:13:09","modified_gmt":"2026-03-09T09:13:09","slug":"eksport-klientow-z-wybranego-segmentu","status":"publish","type":"ecdp","link":"https:\/\/help.expertsender.com\/pl\/ecdp\/eksport-klientow-z-wybranego-segmentu\/","title":{"rendered":"Klienci \u2013 eksport z wybranego segmentu"},"content":{"rendered":"\n

Z pomoc\u0105 tych metod wyeksportujesz wybrane dane klient\u00f3w znajduj\u0105cych si\u0119 w dowolnym segmencie.<\/p>\n\n\n\n

<\/div>\n\n\n\n

POST \u2013 zlecenie eksportu danych<\/h2>\n\n\n\n

Ta metoda umo\u017cliwia zlecenie eksportu danych. W odpowiedzi otrzymujesz status zlecenia oraz exportId<\/strong> potrzebny do pobrania danych.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Endpoint <\/strong><\/h3>\n\n\n\n

POST exports\/customers<\/p>\n\n\n\n

Host:<\/strong> https:\/\/api.ecdp.app<\/p>\n\n\n\n

<\/div>\n\n\n\n

Parametry zapytania<\/strong><\/h3>\n\n\n\n
Parametr<\/strong><\/strong><\/td>Lokalizacja<\/strong><\/td>Typ<\/strong><\/td>Wymagany<\/strong><\/td>Opis<\/strong><\/strong><\/td><\/tr>
x-api-key<\/strong><\/td>header<\/td>string<\/td>tak<\/td>tw\u00f3j klucz API, kt\u00f3ry znajdziesz w Ustawienia > API.<\/strong><\/td><\/tr>
Content-Type: application\/json  <\/td>header<\/td>string<\/td>tak<\/td>Wskazuje, w jakim formacie wysy\u0142ane jest zapytanie. Bez tej informacji API mo\u017ce nie odczyta\u0107 Twojego \u017c\u0105dania poprawnie.<\/td><\/tr>
segmentId<\/td>body<\/td>integer($int32)<\/td>tak<\/td>ID segmentu, z kt\u00f3rego chcesz wyeksportowa\u0107 dane klient\u00f3w. ID segmentu znajdziesz w ECDP > Klienci > Segmentacja > kolumna \u201eID\u201d.<\/td><\/tr>
systemAttributes<\/td>body<\/td>string<\/td>nie<\/td>cechy systemowe. Zobacz tabel\u0119 System attribute item.<\/strong><\/td><\/tr>
customAttributes<\/td>body<\/td>string<\/td>nie<\/td>cechy klienta. <\/strong>Zobacz tabel\u0119 Custom attribute item.<\/strong><\/td><\/tr>
consents<\/td>body<\/td>string<\/td>nie<\/td>Zgody udzielone przez klienta. Zobacz tabel\u0119 Consent item.<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
\n
\n
\n <\/svg> <\/div>\n
\n
\n

Parametry systemAttributes<\/strong>, customAttributes<\/strong> oraz consents<\/strong> nie s\u0105 wymagane, jednak zapytanie zostanie odrzucone, je\u015bli nie wype\u0142nisz przynajmniej jednego pola.<\/p>\n <\/div>\n <\/div>\n <\/div>\n<\/div>\n\n\n\n

<\/div>\n\n\n\n
<\/div>\n\n\n\n

System attribute item<\/h4>\n\n\n\n
Parametr<\/strong><\/strong><\/td>Lokalizacja<\/strong><\/td>Typ<\/strong><\/td>Wymagany<\/strong><\/td>Opis<\/strong><\/strong><\/td><\/tr>
name<\/td>body<\/td>string<\/td>nie<\/td>nazwa cechy systemowej <\/u><\/strong>https:\/\/help.expertsender.com\/pl\/ecdp\/dodawanie-cech-klientow-i-zgod\/.<\/td><\/tr>
all<\/td>body<\/td>boolean<\/td>nie<\/td>Pozwala na eksport wszystkich cech. Wpisz true<\/u>, je\u015bli chcesz wyeksportowa\u0107 wszystkie cechy. W innym pr<\/strong>zypadku zostaw puste pole.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n

Custom attribute item<\/h4>\n\n\n\n
Parametr<\/strong><\/strong><\/td>Lokalizacja<\/strong><\/td>Typ<\/strong><\/td>Wymagany<\/strong><\/td>Opis<\/strong><\/strong><\/td><\/tr>
id<\/td>body<\/td>Integer($int32)<\/td>nie<\/td>ID cechy klienta. S\u0105 to cechy, kt\u00f3re nadajesz samodzielnie w ECDP > Ustawienia > Klienci > Cechy klient\u00f3w.<\/td><\/tr>
name<\/td>body<\/td>string<\/td>nie<\/td>Nazwa cechy.<\/td><\/tr>
all<\/td>body<\/td>boolean<\/td>nie<\/td>Pozwala na eksport wszystkich cech. Wpisz true<\/u>, je\u015bli chcesz wyeksportowa\u0107 wszystkie cechy. W innym przypadku zostaw puste pole.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n

Consent item<\/h4>\n\n\n\n
Parametr<\/strong><\/strong><\/td>Lokalizacja<\/strong><\/td>Typ<\/strong><\/strong><\/td>Wymagany<\/strong><\/td>Opis<\/strong><\/strong><\/td><\/tr>
id<\/td> body<\/td>Integer($int32)<\/td>nie<\/td>ID zgody. Znajdziesz je w ECDP > Ustawienia > Zgody > Zgody.<\/td><\/tr>
name<\/td>body<\/td>string<\/td>nie<\/td>Nazwa zgody.<\/td><\/tr>
all<\/td>body<\/td>boolean<\/td>nie<\/td>Pozwala na eksport wszystkich cech. Wpisz true<\/u>, je\u015bli chcesz wyeksportowa\u0107 wszystkie cechy. W innym przypadku zostaw puste pole.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n

Jak obs\u0142ugujemy zduplikowane pola?<\/h4>\n\n\n\n

Je\u015bli w zapytaniu poprosisz jednocze\u015bnie o wszystkie cechy (u\u017cywaj\u0105c ‘all: true’) i wska\u017cesz kilka konkretnych cech z tej samej grupy, wyeksportujemy po prostu wszystkie cechy. System zignoruje nadmiarowe informacje, aby unikn\u0105\u0107 duplikat\u00f3w.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Przyk\u0142adowe zapytania<\/h3>\n\n\n\n

Eksport danych wszystkich klient\u00f3w z wybranego segmentu<\/strong><\/p>\n\n\n\n

Eksportujesz dane klient\u00f3w z segmentu o ID 1 obejmuj\u0105ce wszystkie cechy systemowe, klienta oraz zgody.<\/p>\n\n\n\n

Tre\u015b\u0107 zapytania:<\/p>\n\n\n\n

<\/path><\/path><\/svg><\/span>
{<\/span><\/span>\n\u00a0 <\/span>"<\/span>segmentId<\/span>"<\/span>:<\/span> <\/span>1<\/span>,<\/span><\/span>\n\u00a0 <\/span>"<\/span>data<\/span>"<\/span>:<\/span> <\/span>{<\/span><\/span>\n\u00a0\u00a0\u00a0 <\/span>"<\/span>customAttributes<\/span>"<\/span>:<\/span> <\/span>[<\/span><\/span>\n\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>{<\/span>"<\/span>all<\/span>"<\/span>:<\/span> <\/span>true}<\/span><\/span>\n\u00a0\u00a0\u00a0 <\/span>],<\/span><\/span>\n\u00a0\u00a0\u00a0 <\/span>"<\/span>systemAttributes<\/span>"<\/span>:<\/span> <\/span>[<\/span><\/span>\n\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>{<\/span>"<\/span>all<\/span>"<\/span>:<\/span> <\/span>true}<\/span><\/span>\n\u00a0\u00a0\u00a0 <\/span>],<\/span><\/span>\n\u00a0\u00a0\u00a0 <\/span>"<\/span>consents<\/span>"<\/span>:<\/span> <\/span>[<\/span><\/span>\n\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>{<\/span>"<\/span>all<\/span>"<\/span>:<\/span> <\/span>true}<\/span><\/span>\n\u00a0\u00a0\u00a0 <\/span>]<\/span><\/span>\n\u00a0 <\/span>}<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/div>\n\n\n\n
Eksport z segmentu klient\u00f3w z wybranymi cechami<\/strong><\/strong><\/p>\n\n\n\n
Eksportujesz dane klient\u00f3w z segmentu o ID 158 obejmuj\u0105ce:<\/p>\n\n\n\n
    \n
  • custom attribute o nazwie zgoda konkurs<\/strong><\/li>\n\n\n\n
  • system attribute o nazwie Email<\/strong><\/li>\n\n\n\n
  • system attribute o ID 4<\/strong><\/li>\n\n\n\n
  • zgodzie o ID 6<\/strong><\/li>\n\n\n\n
  • zgodzie o nazwie consent<\/strong><\/li>\n<\/ul>\n\n\n\n
    Tre\u015b\u0107 zapytania:<\/p>\n\n\n\n
    <\/path><\/path><\/svg><\/span>
    {<\/span><\/span>\n\u00a0 <\/span>"<\/span>segmentId<\/span>"<\/span>:<\/span> <\/span>158<\/span>,<\/span><\/span>\n\u00a0 <\/span>"<\/span>data<\/span>"<\/span>:<\/span> <\/span>{<\/span><\/span>\n\u00a0\u00a0\u00a0 <\/span>"<\/span>customAttributes<\/span>"<\/span>:<\/span> <\/span>[<\/span><\/span>\n\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>{<\/span>"<\/span>name<\/span>"<\/span>:<\/span> <\/span>"<\/span>contest consent<\/span>"<\/span>}<\/span><\/span>\n\u00a0\u00a0\u00a0 <\/span>],<\/span><\/span>\n\u00a0\u00a0\u00a0 <\/span>"<\/span>systemAttributes<\/span>"<\/span>:<\/span> <\/span>[<\/span><\/span>\n\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>{<\/span>"<\/span>name<\/span>"<\/span>:<\/span> <\/span>"<\/span>Email<\/span>"<\/span>},<\/span><\/span>\n\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>{<\/span>"<\/span>id<\/span>"<\/span>:<\/span> <\/span>4<\/span>}<\/span><\/span>\n\u00a0\u00a0\u00a0 <\/span>],<\/span><\/span>\n\u00a0\u00a0\u00a0 <\/span>"<\/span>consents<\/span>"<\/span>:<\/span> <\/span>[<\/span><\/span>\n\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>{<\/span>"<\/span>id<\/span>"<\/span>:<\/span> <\/span>6<\/span>},<\/span><\/span>\n\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>{<\/span>"<\/span>name<\/span>"<\/span>:<\/span> <\/span>"<\/span>consent<\/span>"<\/span>}<\/span><\/span>\n\u00a0\u00a0\u00a0 <\/span>]<\/span><\/span>\n\u00a0 <\/span>}<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
    <\/div>\n\n\n\n
    Eksport z segmentu klient\u00f3w ze wszystkimi cechami w\u0142asnymi i jedn\u0105 systemow\u0105<\/strong><\/strong><\/p>\n\n\n\n
    Eksportujesz dane klient\u00f3w z segmentu o ID 12, obejmuj\u0105ce:<\/p>\n\n\n\n
      \n
    • wszystkie custom attributes<\/li>\n\n\n\n
    • jeden system attribute o nazwie ID<\/li>\n<\/ul>\n\n\n\n
      Tre\u015b\u0107 zapytania:<\/p>\n\n\n\n
      <\/path><\/path><\/svg><\/span>
      {<\/span><\/span>\n\u00a0 <\/span>"<\/span>segmentId<\/span>"<\/span>:<\/span> <\/span>12<\/span>,<\/span><\/span>\n\u00a0 <\/span>"<\/span>data<\/span>"<\/span>:<\/span> <\/span>{<\/span><\/span>\n\u00a0\u00a0 <\/span>"<\/span>customAttributes<\/span>"<\/span>:<\/span> <\/span>[<\/span><\/span>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>{<\/span>"<\/span>all<\/span>"<\/span>:<\/span> <\/span>true}<\/span><\/span>\n\u00a0\u00a0 <\/span>],<\/span><\/span>\n\u00a0\u00a0 <\/span>"<\/span>systemAttributes<\/span>"<\/span>:<\/span> <\/span>[<\/span><\/span>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>{<\/span>"<\/span>name<\/span>"<\/span>:<\/span> <\/span>"<\/span>ID<\/span>"<\/span>}<\/span><\/span>\n\u00a0\u00a0 <\/span>]<\/span><\/span>\n\u00a0 <\/span>}<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
      <\/div>\n\n\n\n
      Odpowiedzi<\/h3>\n\n\n\n
      200: Success<\/strong><\/p>\n\n\n\n
      Po przes\u0142aniu zapytania otrzymasz odpowied\u017a zawieraj\u0105c\u0105 exportId<\/strong> oraz status zlecenia eksportu. Status Queued <\/strong>oznacza, \u017ce przyj\u0119te zlecenie czeka w kolejce na realizacj\u0119.<\/p>\n\n\n\n
      Przyk\u0142adowa odpowied\u017a:<\/p>\n\n\n\n
      <\/path><\/path><\/svg><\/span>
      {<\/span><\/span>\n\u00a0 <\/span>"<\/span>exportId<\/span>"<\/span>:<\/span> <\/span>"<\/span>12<\/span>"<\/span>,<\/span><\/span>\n\u00a0 <\/span>"<\/span>status<\/span>"<\/span>:<\/span> <\/span>"<\/span>Queued<\/span>"<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
      <\/div>\n\n\n\n
      401: Unauthorized<\/strong><\/p>\n\n\n\n
      W \u017c\u0105daniu brakowa\u0142o klucza API lub prosisz o dost\u0119p do informacji, do kt\u00f3rych nie masz uprawnie\u0144.<\/p>\n\n\n\n
      <\/div>\n\n\n\n
      GET \u2013 odpytanie o wynik eksportu<\/h2>\n\n\n\n
      Metoda GET umo\u017cliwia pobranie danych klient\u00f3w. Otrzymasz link do pobrania pliku w formacie CSV lub pliku z surowymi danymi.<\/p>\n\n\n\n
      <\/div>\n\n\n\n
      Endpoint <\/strong><\/h3>\n\n\n\n
      Gdy eksport danych si\u0119 zako\u0144czy, mo\u017cesz pobra\u0107 dwa rodzaje plik\u00f3w:<\/p>\n\n\n\n