> ## Documentation Index
> Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Asiakasryhmä

> Yhteisten ominaisuuksien perusteella koottu asiakasjoukko, jolle voit kohdistaa kampanjoita ja räätälöityjä kokemuksia.

## Määritelmä

<Snippet file="definitions/fi/customer-group-definition.mdx" />

TWICEssä ei ole erillistä **ryhmäobjektia**. Asiakassegmentointi toteutetaan **asiakastunnisteilla**. ”Asiakasryhmä” on nimetty tunniste, jota käytät uudelleen julkaisussa, kassalla, raportoinnissa ja työnkuluissa. Tunnisteet ovat tasarakenteisia ja vapaamuotoisia, ne lisätään käsin ja ne toimivat samalla tavalla koko alustalla.

## Missä sitä käytetään?

* Tukkuasiakkaiden laskuttaminen eri hinnalla kuin vähittäisasiakkaiden
* Listauksen rajaaminen niin, että vain henkilökunta tai jäsenet näkevät sen
* Kassan kenttien piilottaminen tai näyttäminen asiakastyypin mukaan
* Työnkulun käynnistäminen, kun tietyllä tunnisteella merkitty asiakas tekee tilauksen
* Liikevaihdon, asiakaspysyvyyden ja tilaustiheyden raportointi segmenteittäin
* Segmentin joukkosähköposti tai vienti

## Keskeiset ominaisuudet

### Tunnisteet

Tunniste on asiakkaaseen liitetty merkkijonomuotoinen nimilappu. Tunnisteet ovat tasarakenteisia — hierarkiaa tai ylä- ja alatasoja ei ole. Suunnittele tunnisteiden nimet huolella: lyhyet, pienaakkosiset ja väliviivalliset arvot (`wholesale`, `vip`, `corporate-acme`, `staff`) näkyvät hyvin suodattimissa ja pysyvät toimivina, kun segmenttejä tulee lisää.

| Ominaisuus                | Tyyppi    | Kuvaus                                                                                                                                                        |
| :------------------------ | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`                      | String    | Tunnisteen yksilöivä tunnus                                                                                                                                   |
| `value`                   | String    | Tunnisteen nimi, joka näkyy hallinnassa ja jota käytetään ehdoissa                                                                                            |
| `scope`                   | Enum      | Resurssityyppi, johon tunniste kohdistuu — `customers` asiakastunnisteille. Muut kohdealueet (`inventory`, `catalog`, `orders`) merkitsevät muita resursseja. |
| `createdAt` / `updatedAt` | Timestamp | Milloin tunniste luotiin ja milloin sitä viimeksi muutettiin                                                                                                  |

### Attribuutit vs. tunnisteet

| Taso            | Käyttötarkoitus                                                                                                                                   |
| :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Tunnisteet**  | Asiakkaalle käsin lisättävät nimilaput (esim. `vip`, `wholesale`, `staff`) — käytetään kaikkialla, missä segmentointi ohjaa toimintaa.            |
| **Attribuutit** | Asiakkaan rakenteiset kentät, joilla on tyypitetty arvo (esim. `company`, `vat_id`, `tier`) — näkyvät hallinnassa ja käytettävissä suodattimissa. |

”Ryhmään” kuuluminen määritellään **käsin**: työntekijä (tai API-integraatiosi) asettaa tunnisteen asiakastietueelle. Sääntömoottoria, joka lisäisi tai poistaisi tunnisteita automaattisesti, ei ole.

## Suhteet

* Tunniste liitetään [asiakasprofiiliin](/docs/fi/concepts/customers/customer-profiles).
* Listauksen [hintataulukko](/docs/fi/concepts/catalog/price-tables) voi kohdistua yhteen tai useampaan tunnisteeseen, jolloin vastaava asiakas näkee eri hinnan.
* [Listauksen](/docs/fi/concepts/catalog/listings) julkaisuasetuksilla näkyvyys voidaan rajata tunnistettuihin segmentteihin.
* [Työnkulku](/docs/fi/workflows) voi haarautua asiakkaan tunnisteiden perusteella.
* [Asiakastaulukossa](/docs/fi/customers/overview) voi suodattaa, ryhmitellä ja viedä tietoja tunnisteen mukaan.

## Elinkaari

### Missä asiakasryhmiin viitataan

Asiakastunnisteet näkyvät kaikkialla, missä TWICEn pitää muuttaa toimintaansa yleisön mukaan:

<AccordionGroup>
  <Accordion title="Hinnoittelu ja alennukset">
    Hintataulukot **eivät** rajaudu asiakastunnisteiden mukaan — hinnoittelu ei vaihtele asiakasryhmittäin. Asiakaskohtaiseen hinnoitteluun käytä sen sijaan **alennuskoodia**, joka kohdistetaan tunnistettuun segmenttiin.
  </Accordion>

  <Accordion title="Julkaisu ja kanavanäkyvyys">
    Listauksen **Publishing**-välilehden **Customer tags** -kortilla voit rajata listauksen tiettyihin tunnistettuihin segmentteihin. `staff`-merkinnällä varustettu listaus näkyy kassalla vain asiakkaille, joilla on kyseinen tunniste.

    Tämä on hyödyllistä henkilökunnan vuokrauksissa, sisäisissä esittelyvälineissä ja vain jäsenille tarkoitetuissa listauksissa.
  </Accordion>

  <Accordion title="Kassaprosessit">
    Yhdistä tunnisteet ja vaaditut [dokumentit](/docs/fi/concepts/customers/customer-profiles) omiin prosesseihisi — vahvista esimerkiksi `wholesale`-tunnisteella merkityn asiakkaan tilaukset vasta, kun allekirjoitettu sopimus on tallessa.
  </Accordion>

  <Accordion title="Työnkulut ja automaatio">
    [Työnkulut](/docs/fi/workflows) voivat haarautua asiakastunnisteiden perusteella — lähetä esimerkiksi laajennettu tervetuloviesti, kun `wholesale`-asiakas tekee ensimmäisen tilauksensa, tai ilmoita myyjälle, kun `corporate-account-acme`-varaus saapuu.
  </Accordion>

  <Accordion title="Raportointi ja viennit">
    Asiakastaulukkoa voi suodattaa ja ryhmitellä tunnisteen mukaan. Tilausraportteja voi suodattaa niiden tunnisteiden perusteella, jotka asiakkaalla oli tilaushetkellä, joten voit analysoida liikevaihtoa, asiakaspysyvyyttä ja tilaustiheyttä segmenteittäin.
  </Accordion>
</AccordionGroup>

### Tunnisteiden luokittelu ja hallinta

Muutama käytännön sääntö, joilla tunnisteet pysyvät hyödyllisinä katalogin kasvaessa:

| Käytäntö                                              | Miksi                                                                                                                                  |
| :---------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------- |
| Käytä pienaakkosia ja väliviivoja                     | Näkyy hyvin suodattimissa ja välttää epäjohdonmukaiset osumat.                                                                         |
| Käytä etuliitteitä toisiinsa liittyvissä tunnisteissa | `tier-bronze`, `tier-silver`, `tier-gold` on helpompi silmäillä kuin `bronze`, `silver`, `gold`.                                       |
| Pidä tunnisteiden määrä pienenä                       | Sadat tunnisteet hidastavat hallinnan suodattimia. Suosi harvempia ja laajempia segmenttejä.                                           |
| Varaa tekniset tunnisteet                             | Tunnisteita kuten `staff` tai `test-account` saa asettaa vain hallinnasta, eikä niitä näytetä asiakkaille.                             |
| Dokumentoi tunnisteesi                                | Pidä sisäistä muistiinpanoa siitä, mitä kukin tunniste ohjaa (näkyvyys, alennukset, työnkulut), jotta segmentit pysyvät ennakoitavina. |

Tunnisteiden muutokset kirjataan asiakkaan [tapahtumalokiin](/docs/fi/concepts/admin/activity-logs), joten näet, milloin ja miksi tunniste lisättiin tai poistettiin.

## Usein kysytyt kysymykset

<AccordionGroup>
  <Accordion title="Onko olemassa ryhmäobjektia, jota voi kysellä suoraan?">
    Ei. ”Ryhmä” on tunniste itse. Kysele asiakkaita `tag`-kentän perusteella tai hae asiakastaulukko tunnisteella suodatettuna.
  </Accordion>

  <Accordion title="Voiko asiakas kuulua useampaan ryhmään?">
    Kyllä. Asiakkaalla voi olla useita tunnisteita samanaikaisesti. Hinnoittelumoottori ja julkaisusäännöt päättävät kumpikin omalla tavallaan, miten ne yhdistetään — katso hintataulukoiden etusijajärjestys.
  </Accordion>

  <Accordion title="Voiko tunnisteita lisätä automaattisesti?">
    Ei. Tunnisteille ei ole sääntömoottoria — ne lisätään ja poistetaan käsin hallinnassa tai API:n kautta. Automatisoi tunnisteiden lisäys omasta integraatiostasi `customers`- ja `tags`-päätepisteiden avulla.
  </Accordion>

  <Accordion title="Voinko antaa yksittäiselle asiakkaalle erikoishinnan?">
    Et hintataulukoiden kautta — hinnoittelu ei rajaudu asiakastunnisteisiin. Luo sen sijaan **alennuskoodi** neuvotellulle hinnalle ja rajaa se kyseiseen asiakkaaseen tai tunnistettuun segmenttiin.
  </Accordion>
</AccordionGroup>

<Note>
  Tunnisteet ovat tasarakenteinen, vapaamuotoinen lista — hierarkiaa ei ole. Suunnittele tunnisteiden nimet huolella: lyhyet, pienaakkosiset ja väliviivalliset arvot (esim. `wholesale-tier-1`) näkyvät hyvin suodattimissa ja pysyvät toimivina, kun segmenttejä tulee lisää.
</Note>

## Kehittäjän viitetiedot

Asiakassegmentit perustuvat `tags`-resurssiin. Hallitse tunnisteita `tags`-päätepisteillä ja liitä ne asiakkaisiin `customers`-päätepisteillä.

<Card title="API: Tags" icon="code" href="https://server.twicecommerce.com/api/internal">
  Avaa päätepiste API-viitteessä.
</Card>

## Aiheeseen liittyvät

<CardGroup cols={2}>
  <Card title="Asiakasprofiilit" icon="user" href="/docs/fi/concepts/customers/customer-profiles">
    Tietue, johon tunniste liitetään.
  </Card>

  <Card title="Hintataulukot" icon="table" href="/docs/fi/concepts/catalog/price-tables">
    Uudelleenkäytettävä listausten hinnoittelu (ei asiakaskohtainen).
  </Card>

  <Card title="Listaukset" icon="list" href="/docs/fi/concepts/catalog/listings">
    Tunnisteisiin perustuva näkyvyys ja julkaisu.
  </Card>

  <Card title="Työnkulut" icon="diagram-project" href="/docs/fi/workflows">
    Tunnisteisiin perustuva automaatio.
  </Card>
</CardGroup>