--- title: "Konektor Klaviyo" description: "Kompletní průvodce integrací Klaviyo pro synchronizaci profilů, událostí, seznamů, segmentů a dat kampaní s Brevo přes Tajo." url: https://tajo.io/cz/docs/connectors/marketing/klaviyo/ markdown: https://tajo.io/cz/docs/connectors/marketing/klaviyo.md lang: cs-CZ robots: noindex --- Požádejte o přednostní přístup Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo. # Konektor Klaviyo Stav konektoru: Ve vývoji Vzniká. Zatím neověřeno. | Zdrojové pole | Cílové pole | Ukázková hodnota | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Propojte Klaviyo s Brevo přes Tajo pro migraci nebo synchronizaci marketingových dat mezi platformami. Synchronizujte profily, události, seznamy, segmenty, toky a data kampaní pro sjednocenou vícekanálovou marketingovou strategii. ## Přehled | Vlastnost | Hodnota | | --- | --- | | **Platforma** | Klaviyo | | **Kategorie** | Marketing | | **Složitost nastavení** | Střední | | **Oficiální integrace** | Ne | | **Synchronizovaná data** | Profily, Události, Seznamy, Segmenty, Kampaně | | **Dostupné dovednosti** | 10 | | **Standard API** | JSON:API | ## Funkce - **Synchronizace profilů** – Obousměrná synchronizace zákaznických profilů mezi Klaviyo a Brevo - **Přeposílání událostí** – Přeposílejte sledované události Klaviyo do Brevo pro spouštěče automatizací - **Migrace seznamů** – Synchronizujte seznamy Klaviyo do seznamů kontaktů Brevo - **Synchronizace segmentů** – Exportujte segmenty Klaviyo jako seznamy nebo segmenty Brevo - **Export dat toků** – Stahujte data výkonu toků pro cross-platformní analytiku - **Synchronizace kampaní** – Koordinujte kampaně napříč kanály Klaviyo a Brevo - **Synchronizace katalogu** – Zrcadlete produktové katalogy mezi platformami - **Správa kuponů** – Synchronizujte kódy kuponů a data využití ## Předpoklady Než začnete, ujistěte se, že máte: 1. Účet Klaviyo s přístupem k API 2. Soukromý API klíč s příslušnými rozsahy 3. Veřejný API klíč Klaviyo (6-znakové ID společnosti) 4. Účet Brevo s přístupem k API 5. Účet Tajo s API přihlašovacími údaji ## Ověření ### Soukromý API klíč Klaviyo používá soukromé API klíče s vymezeným přístupem pro ověřování na straně serveru. Nastavte klíč v hlavičce `Authorization`: ```bash curl https://a.klaviyo.com/api/profiles/ \ -H "Authorization: Klaviyo-API-Key your-private-api-key" \ -H "revision: 2026-01-15" ``` ### Rozsahy API klíčů Nakonfigurujte rozsahy při vytváření soukromého klíče: | Rozsah | Přístup | Popis | | --- | --- | --- | | `profiles` | Čtení/Plný | Přístup k profilům kontaktů | | `events` | Čtení/Plný | Přístup ke sledovaným událostem | | `lists` | Čtení/Plný | Přístup k seznamům kontaktů | | `segments` | Čtení | Přístup k segmentům | | `campaigns` | Čtení | Přístup k datům kampaní | | `metrics` | Čtení | Přístup k definicím metrik | | `flows` | Čtení | Přístup ke konfiguracím toků | | `catalogs` | Čtení | Přístup k produktovým katalogům | ### Veřejný API klíč Pro sledování na straně klienta používejte 6-znakové ID společnosti: ```bash curl -X POST "https://a.klaviyo.com/client/events/?company_id=COMPANY_ID" \ -H "Content-Type: application/json" \ -d '{"data": {...}}' ``` ### OAuth (Partnerské integrace) Klaviyo podporuje OAuth pro technologické partnery, nabízí vylepšenou bezpečnost a limity rychlosti: ```bash curl https://a.klaviyo.com/api/profiles/ \ -H "Authorization: Bearer YOUR_OAUTH_TOKEN" \ -H "revision: 2026-01-15" ``` ## Konfigurace ### Základní nastavení ```yaml connectors: klaviyo: enabled: true private_api_key: "your-klaviyo-private-key" public_api_key: "XXXXXX" api_revision: "2026-01-15" # Možnosti synchronizace dat sync: profiles: true events: true lists: true segments: true catalogs: false # Přiřazení seznamů Brevo lists: all_contacts: 20 subscribers: 21 high_value: 22 ``` ### Mapování profilů Mapujte vlastnosti profilů Klaviyo na atributy kontaktů Brevo: ```yaml profile_mapping: email: email first_name: FIRSTNAME last_name: LASTNAME phone_number: SMS city: CITY region: REGION country: COUNTRY zip: ZIP organization: COMPANY title: JOB_TITLE # Vlastní vlastnosti lifetime_value: LTV total_orders: ORDER_COUNT last_order_date: LAST_ORDER_DATE preferred_channel: CHANNEL_PREF ``` ### Mapování událostí Mapujte metriky Klaviyo na události Brevo: ```yaml event_mapping: "Placed Order": "order_completed" "Ordered Product": "product_purchased" "Started Checkout": "checkout_started" "Added to Cart": "cart_updated" "Viewed Product": "product_viewed" "Subscribed to List": "customer_subscribed" "Received Email": "email_received" "Opened Email": "email_opened" "Clicked Email": "email_clicked" ``` ## Koncové body API | Metoda | Koncový bod | Popis | | --- | --- | --- | | `GET` | `/api/profiles/` | Výpis profilů | | `POST` | `/api/profiles/` | Vytvoření profilu | | `PATCH` | `/api/profiles/{id}/` | Aktualizace profilu | | `POST` | `/api/profile-merge/` | Sloučení duplicitních profilů | | `GET` | `/api/events/` | Výpis událostí | | `POST` | `/api/events/` | Vytvoření události | | `GET` | `/api/lists/` | Výpis všech seznamů | | `POST` | `/api/lists/{id}/relationships/profiles/` | Přidání profilů do seznamu | | `GET` | `/api/segments/` | Výpis segmentů | | `GET` | `/api/campaigns/` | Výpis kampaní | | `GET` | `/api/flows/` | Výpis toků | | `GET` | `/api/metrics/` | Výpis metrik | | `POST` | `/api/metric-aggregates/` | Dotaz na agregáty metrik | | `GET` | `/api/catalog-items/` | Výpis položek katalogu | ## Příklady kódu ### Inicializace konektoru Klaviyo ```javascript import { TajoClient } from '@tajo/sdk'; const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY }); // Připojení účtu Klaviyo await tajo.connectors.connect('klaviyo', { privateApiKey: process.env.KLAVIYO_PRIVATE_KEY, publicApiKey: process.env.KLAVIYO_PUBLIC_KEY }); ``` ### Synchronizace profilů do Brevo ```javascript // Načtení profilů Klaviyo a synchronizace do Brevo const response = await fetch('https://a.klaviyo.com/api/profiles/', { headers: { 'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`, 'revision': '2026-01-15', 'Accept': 'application/vnd.api+json' } }); const { data } = await response.json(); // Každý profil následuje formát JSON:API // { // "type": "profile", // "id": "01ABCDEF", // "attributes": { // "email": "jane@example.com", // "first_name": "Jane", // "last_name": "Kim", // "phone_number": "+15551234567", // "properties": { "lifetime_value": 450.00 } // } // } ``` ### Vytvoření události ```javascript // Sledování události v Klaviyo (přeposíláno do Brevo přes Tajo) await fetch('https://a.klaviyo.com/api/events/', { method: 'POST', headers: { 'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`, 'revision': '2026-01-15', 'Content-Type': 'application/vnd.api+json', 'Accept': 'application/vnd.api+json' }, body: JSON.stringify({ data: { type: 'event', attributes: { metric: { data: { type: 'metric', attributes: { name: 'Placed Order' } } }, profile: { data: { type: 'profile', attributes: { email: 'jane@example.com' } } }, properties: { OrderId: 'ORD-1234', Value: 89.99, Items: [ { ProductName: 'Widget Pro', Price: 89.99, Quantity: 1 } ] }, value: 89.99 } } }) }); ``` ### Dotaz na agregáty metrik ```javascript // Načtení agregovaných dat metrik pro reporting await fetch('https://a.klaviyo.com/api/metric-aggregates/', { method: 'POST', headers: { 'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`, 'revision': '2026-01-15', 'Content-Type': 'application/vnd.api+json' }, body: JSON.stringify({ data: { type: 'metric-aggregate', attributes: { metric_id: 'METRIC_ID', measurements: ['count', 'sum_value'], interval: 'day', filter: ['greater-or-equal(datetime,2024-01-01)', 'less-than(datetime,2024-02-01)'] } } }) }); ``` ## Omezení rychlosti | Ověření | Burst limit | Steady limit | | --- | --- | --- | | **Soukromý API klíč** | 75 požadavků/s | 700 požadavků/min | | **OAuth** | 150 požadavků/s | 1 500 požadavků/min | | **Client API** | 100 požadavků/s | N/A | | **Hromadné operace** | 10 požadavků/s | 100 požadavků/min | Vyžadována revize API Všechny požadavky Klaviyo API vyžadují hlavičku `revision` nastavenou na platné datum verze API (např. `2026-01-15`). Požadavky bez této hlavičky budou odmítnuty. ## Řešení problémů | Problém | Příčina | Řešení | | --- | --- | --- | | `400 Bad Request` | Neplatný nebo chybějící API klíč | Ověřte, zda je soukromý API klíč správný | | `403 Forbidden` | Nedostatečný rozsah | Zkontrolujte, zda rozsahy API klíče odpovídají požadovaným oprávněním | | Chybějící hlavička `revision` | Hlavička není nastavena | Přidejte `revision: 2026-01-15` ke všem požadavkům | | Profil nenalezen | Nesprávný identifikátor | Používejte ID profilu Klaviyo, nikoli e-mail, pro vyhledávání | | Události se nesynchronizují | Nesprávný název metriky | Shodujte přesné názvy metrik definované v Klaviyo | | `429 Too Many Requests` | Překročen limit rychlosti | Implementujte exponenciální zpětné odběrání, zvažte OAuth pro vyšší limity | | Chyby formátu JSON:API | Nesprávný typ obsahu | Používejte `application/vnd.api+json` pro hlavičky Content-Type a Accept | ## Osvědčené postupy 1. **Používejte formát JSON:API** – Dodržujte specifikaci JSON:API pro všechny payloady požadavků a odpovědí 2. **Nastavte hlavičku revize** – Vždy zahrňte hlavičku `revision` s nejnovějším datem verze API 3. **Používejte řídké sady polí** – Požadujte pouze potřebná pole pomocí `?fields[profile]=email,first_name` pro snížení velikosti payloadu 4. **Využívejte vztahy** – Používejte parametr `include` JSON:API pro načtení příbuzných zdrojů v jediném požadavku 5. **Používejte kurzorové stránkování** – Procházejte velké sady výsledků pomocí parametru `page[cursor]` 6. **Implementujte hromadné operace** – Používejte hromadné koncové body pro dávkové importy profilů a vytváření událostí 7. **Používejte OAuth pro vyšší limity** – Ověřování OAuth poskytuje 2x vyšší limity rychlosti než soukromé klíče ## Zabezpečení - **Rozsahy soukromého API klíče** – Granulární řízení přístupu pro čtení/plný přístup na typ zdroje - **Podpora OAuth** – Bezpečné ověřování na základě tokenů pro partnerské integrace - **Izolace veřejného klíče** – Klíče na straně klienta omezeny pouze na operace vytváření - **TLS 1.2+** – Veškerá API komunikace šifrovaná při přenosu - **SOC 2 Type II** – Klaviyo je certifikováno podle SOC 2 Type II - **Soulad s GDPR** – Data Privacy API pro žádosti o smazání profilu ## Související zdroje - [Konektor Brevo](https://tajo.io/cz/docs/connectors/marketing/brevo) - [Konektor Google Ads](https://tajo.io/cz/docs/connectors/marketing/google-ads) - [Konektor Meta Ads](https://tajo.io/cz/docs/connectors/marketing/meta-ads) - [Dovednost synchronizace zákazníků](https://tajo.io/cz/docs/skills/data-sync/customer-sync)