Integrace s Klaviyo

Aplikace Skloňování jmen automaticky synchronizuje výsledky skloňování do Klaviyo profilů. Oslovení jsou pak dostupná jako profilové vlastnosti a lze je použít v libovolné Klaviyo šabloně, flow nebo kampani.

Předpoklady

Před nastavením integrace si připravte:

Public API Key — dostupný v Klaviyo v sekci Account → Settings → API Keys
Private API Key — vytvořte nový klíč se scopem Profiles: Full access ve stejné sekci

Nastavení integrace

V administraci Shopify otevřete aplikaci Skloňování jmen.
Přejděte do sekce Integrace.
Zadejte Klaviyo API klíč (public) a Klaviyo privátní API klíč z Klaviyo.
Klikněte na Připojit Klaviyo.

Po uložení bude aplikace synchronizovat oslovení do Klaviyo při každém zpracování zákazníka.

Synchronizované vlastnosti profilu

Po úspěšné integraci najdete v Klaviyo profilu zákazníka tyto vlastnosti:

Vlastnost Klaviyo	Popis	Příklad
`Czech addressing`	Kompletní oslovení (výsledek šablony)	`Jane Nováku`
`Czech first name addressing`	Křestní jméno v 5. pádu	`Jane`
`Czech last name`	Příjmení v 5. pádu	`Nováku`
`Gender`	Gramatický rod	`male`

Použití v Klaviyo šablonách

Základní oslovení

V Klaviyo email editoru použijte syntaxi pro profilové vlastnosti:

{% if person|lookup:'Czech addressing' %}
  {{ person|lookup:'Czech addressing'|default:'' }}
{% endif %}

Pokud vlastnost neexistuje (zákazník nebyl dosud zpracován aplikací), podmínka celý blok přeskočí a nezobrazí nic.

Oslovení s fallbackem

Pro případ, že vlastnost ještě není synchronizována:

{% if person|lookup:'Czech addressing' %}
  Dobrý den, {{ person|lookup:'Czech addressing' }},
{% else %}
  Dobrý den, {{ first_name }},
{% endif %}

Genderové oslovení

Použijte vlastnost Gender pro zobrazení různého textu mužům a ženám:

{% if person|lookup:'Gender' == 'male' %}
  Vážený pane {{ person|lookup:'Czech addressing'|default:first_name }},
{% elsif person|lookup:'Gender' == 'female' %}
  Vážená paní {{ person|lookup:'Czech addressing'|default:first_name }},
{% else %}
  Dobrý den, {{ person|lookup:'Czech addressing'|default:first_name }},
{% endif %}

Použití v subject line

Personalizujte i předmět emailu — Klaviyo podporuje Liquid v subject line:

{{ person|lookup:'Czech addressing'|default:first_name }}, váš balíček je na cestě

Výsledek: Jane Nováku, váš balíček je na cestě

Zpoždění synchronizace

Zpoždění se týká pouze nově vytvořených zákazníků. Aktualizace existujících zákazníků se synchronizují ve stejném časovém rámci.

Omezení integrace

Bez retry mechanismu — pokud synchronizace selže (výpadek Klaviyo API), data nejsou automaticky znovu odeslána. Zákazník bude aktualizován při příštím spuštění webhooku (tj. při další aktualizaci v Shopify).
Pouze nové a aktualizované zákazníky — historičtí zákazníci nejsou hromadně synchronizováni. Doplňují se postupně při každém nákupu nebo úpravě profilu.
Propojení přes email — synchronizace páruje Shopify zákazníka s Klaviyo profilem podle emailové adresy. Zákazníci bez emailu nejsou synchronizováni.

Ověření funkčnosti

Po nastavení integrace:

V administraci Shopify otevřete zákaznický profil a uložte ho (i bez změny).
Počkejte 5 minut.
V Klaviyo přejděte na Audience → Profiles a vyhledejte zákazníka.
Zkontrolujte, zda jsou u profilu přítomny vlastnosti Czech addressing, Czech first name addressing, Czech last name a Gender.

Segmentace v Klaviyo

Vlastnost Gender lze využít i pro segmentaci:

Segment žen: Gender is female
Segment mužů: Gender is male
Zákazníci s oslovením: Czech addressing is set

Tyto segmenty jsou pak použitelné pro cílení kampaní, A/B testy různých oslovení nebo pro flow s podmíněnými větvemi.

Potřebujete další pomoc? Napište nám na integrace@soundsgood.agency.