Shopify konnektor

Shopify konnektor

Csatlakoztasd a Shopify áruházadat a Brevóhoz a teljes ügyféladat-szinkronizációhoz, elhagyott kosár visszaszerzéséhez és automatizált marketingkampányokhoz.

Áttekintés

Funkciók

• Valós idejű ügyfél-szinkronizáció – Az ügyféladatok azonnal szinkronizálódnak a Brevo kapcsolatokba
• Rendeléskövetés – Rendelési események vásárlás utáni folyamatokhoz
• Termékkatalógus-szinkronizáció – Termékek ajánlásokhoz elérhetők
• Kosárelhagyás – Elhagyott kosarak követése és visszaszerzése
• Böngészési viselkedés – Oldalnézet- és termékérdeklődés-követés
• Több áruház támogatása – Több Shopify áruház csatlakoztatása

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Shopify áruházzal adminisztrátori hozzáféréssel
2. Egy Brevo fiókkal API-hozzáféréssel
3. Egy Tajo fiókkal

Telepítés

1. lehetőség: Shopify App Store (ajánlott)

1. Látogass el a Tajo alkalmazásra a Shopify App Store-ban
2. Kattints az „Add app” gombra
3. Add meg a kért jogosultságokat
4. Csatlakoztasd a Brevo fiókodat

2. lehetőség: Kézi telepítés

1. lépés: Shopify alkalmazás létrehozása

1. Menj a Shopify admin → Beállítások → Alkalmazások és értékesítési csatornák menüpontra
2. Kattints a „Develop apps” → „Create an app” gombra
3. Nevezd el „Tajo Integration”-nek

2. lépés: API hatókörök konfigurálása

Engedélyezd ezeket a hatóköröket:

read_customers
write_customers
read_orders
read_products
read_checkouts
write_script_tags

3. lépés: Az alkalmazás telepítése

# Using Tajo CLI
tajo connectors install shopify \
  --shop-url your-store.myshopify.com \
  --api-key $SHOPIFY_API_KEY \
  --api-secret $SHOPIFY_API_SECRET

4. lépés: Webhookok konfigurálása

A Tajo automatikusan regisztrálja ezeket a webhookokat:

Konfiguráció

Alapbeállítás

connectors:
  shopify:
    enabled: true
    shop_url: "your-store.myshopify.com"
    api_version: "2024-01"

    # Data sync options
    sync:
      customers: true
      orders: true
      products: true
      carts: true
      inventory: false  # Optional

    # List assignment
    lists:
      all_customers: 5
      buyers: 6
      abandoned_cart: 7

Mezőleképezés

Képezd le a Shopify mezőket a Brevo kapcsolat-attribútumokhoz:

Egyedi attribútum-leképezés

field_mapping:
  # Standard fields
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # E-commerce metrics
  orders_count: ORDER_COUNT
  total_spent: TOTAL_SPENT
  last_order_date: LAST_ORDER_DATE

  # Custom fields
  customer_type: CUSTOMER_TYPE
  preferred_language: LANGUAGE
  loyalty_tier: VIP_TIER

  # Computed fields
  average_order_value: AOV
  days_since_last_order: RECENCY

Termékszinkronizáció

Szinkronizáld a termékeket az e-mailes ajánlásokhoz:

sync:
  products:
    enabled: true
    include_variants: true
    include_images: true
    categories_as_tags: true

    # Filter products
    filter:
      status: active
      exclude_tags: ["hidden", "wholesale-only"]

Készletkövetés

Engedélyezd a készletszint-szinkronizációt:

sync:
  inventory:
    enabled: true
    low_stock_threshold: 10
    out_of_stock_events: true

Események

Ügyfélesemények

Rendelési események

Kosáresemények

Engedélyezett Skillek

A Shopify konnektor ezeket a Skilleket engedélyezi:

Kódpéldák

A konnektor inicializálása

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Shopify store
await tajo.connectors.connect('shopify', {
  shopUrl: 'your-store.myshopify.com',
  apiKey: process.env.SHOPIFY_API_KEY,
  apiSecret: process.env.SHOPIFY_API_SECRET
});

Kezdeti szinkronizáció futtatása

// Full historical sync
await tajo.connectors.sync('shopify', {
  type: 'full',
  resources: ['customers', 'orders', 'products'],
  since: '2023-01-01'
});

// Check sync status
const status = await tajo.connectors.status('shopify');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   customersCount: 15420,
//   ordersCount: 8234,
//   productsCount: 342
// }

Kosáresemények követése

Add hozzá a Tajo scriptet a Shopify témádhoz:

<!-- Add to theme.liquid before </head> -->
{% if customer %}
<script>
  window.tajoConfig = {
    customerId: "{{ customer.id }}",
    customerEmail: "{{ customer.email }}",
    customerName: "{{ customer.first_name }}"
  };
</script>
{% endif %}
<script src="https://cdn.tajo.io/shopify.js"></script>

Egyedi webhook-kezelő

// Handle Shopify webhooks manually
app.post('/webhooks/shopify', async (req, res) => {
  const hmac = req.get('X-Shopify-Hmac-SHA256');

  // Verify webhook signature
  if (!verifyShopifyWebhook(req.body, hmac)) {
    return res.status(401).send('Unauthorized');
  }

  const topic = req.get('X-Shopify-Topic');

  // Forward to Tajo
  await tajo.connectors.handleWebhook('shopify', {
    topic,
    payload: req.body
  });

  res.status(200).send('OK');
});

Monitorozás

Dashboard mérőszámok

Kövesd a Shopify kapcsolatodat a Tajo dashboardon:

• Szinkronizációs állapot: Valós idejű kapcsolat állapota
• Szinkronizált ügyfelek: Összes kapcsolat a Shopify-ból
• Követett rendelések: Feldolgozott rendelési események
• Kosár-visszaszerzés: Elhagyott kosár teljesítménye
• Hibaarány: Sikertelen szinkronizációs kísérletek

Webhook naplók

Tekintsd meg a webhook-kézbesítési állapotot:

tajo connectors logs shopify --type webhook --last 24h

Szinkronizációs előzmények

Ellenőrizd a korábbi szinkronizációs műveleteket:

tajo connectors history shopify --limit 10

Hibaelhárítás

Gyakori problémák

Hibakeresési mód

Engedélyezd a részletes naplózást:

connectors:
  shopify:
    debug: true
    log_level: verbose
    log_webhooks: true

Kapcsolat tesztelése

tajo connectors test shopify
# ✓ API connection successful
# ✓ Webhooks registered
# ✓ Products accessible
# ✓ Customers readable
# ✓ Orders readable

Legjobb gyakorlatok

1. Kezdd tesztáruházzal – Először használj fejlesztői áruházat
2. Futtasd a kezdeti szinkronizációt munkaidőn kívül – A nagy szinkronizációk lassúak lehetnek
3. Képezz le egyedi attribútumokat – Ne támaszkodj csak az alapértelmezett leképezésekre
4. Engedélyezd a kosárkövetést – Kritikus az elhagyott kosár visszaszerzéséhez
5. Figyeld a webhookok állapotát – Állíts be riasztásokat a sikertelen kézbesítésekhez
6. Használj kötegelt importokat – 10 000 rekord feletti történeti adatokhoz

Biztonság

• OAuth 2.0 – Biztonságos token alapú hitelesítés
• Webhook-ellenőrzés – HMAC aláírás-validáció
• Titkosított tárolás – Az API hitelesítő adatok nyugalmi állapotban titkosítva
• Hatókör-alapú hozzáférés – Csak a minimálisan szükséges jogosultságok

Kapcsolódó források

• WooCommerce konnektor
• Ügyfél-szinkronizáció Skill
• Elhagyott kosár Skill
• Brevo Contacts API