Shopify конектор

Shopify конектор

Свържи магазина си в Shopify с Brevo за пълна синхронизация на клиентски данни, възстановяване на изоставени кошници и автоматизирани маркетингови кампании.

Преглед

Функции

• Синхронизация на клиенти в реално време – Клиентските данни се синхронизират мигновено към контактите в Brevo
• Проследяване на поръчки – Събития от поръчки за потоци след покупка
• Синхронизация на продуктовия каталог – Продуктите са налични за препоръки
• Изоставена кошница – Проследяване и възстановяване на изоставени кошници
• Browse поведение – Проследяване на показвания на страници и интерес към продукти
• Поддръжка на много магазини – Свързване на множество Shopify магазини

Предварителни условия

Преди да започнеш, увери се, че имаш:

1. Магазин в Shopify с администраторски достъп
2. Акаунт в Brevo с API достъп
3. Акаунт в Tajo

Инсталация

Опция 1: Shopify App Store (препоръчително)

1. Посети приложението Tajo в Shopify App Store
2. Щракни върху “Add app”
3. Предостави заявените разрешения
4. Свържи своя акаунт в Brevo

Опция 2: Ръчна инсталация

Стъпка 1: Създай Shopify приложение

1. Отиди в админ панела на Shopify → Settings → Apps and sales channels
2. Щракни върху “Develop apps” → “Create an app”
3. Наименувай го “Tajo Integration”

Стъпка 2: Конфигурирай API обхватите

Активирай тези обхвати:

read_customers
write_customers
read_orders
read_products
read_checkouts
write_script_tags

Стъпка 3: Инсталирай приложението

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

Стъпка 4: Конфигурирай уебхуците

Tajo автоматично регистрира тези уебхуци:

Конфигурация

Основна настройка

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

Мапване на полета

Мапвай полетата на Shopify към атрибутите на контактите в Brevo:

Мапване на персонализирани атрибути

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

Синхронизация на продукти

Синхронизирай продукти за имейл препоръки:

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

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

Проследяване на наличности

Активирай синхронизация на наличностите:

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

Събития

Клиентски събития

Събития от поръчки

Събития от кошницата

Активирани скилове

Конекторът за Shopify активира тези скилове:

Примери с код

Инициализация на конектора

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
});

Стартиране на първоначална синхронизация

// 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
// }

Проследяване на събития от кошницата

Добави скрипта на Tajo към темата на Shopify:

<!-- 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>

Персонализиран handler за уебхуци

// 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');
});

Мониторинг

Метрики в таблото

Наблюдавай връзката с Shopify в таблото на Tajo:

• Статус на синхронизация: Здраве на връзката в реално време
• Синхронизирани клиенти: Общ брой контакти от Shopify
• Проследени поръчки: Обработени събития от поръчки
• Възстановяване на кошница: Резултати от изоставени кошници
• Процент на грешките: Неуспешни опити за синхронизация

Логове на уебхуци

Виж статус на доставка на уебхуци:

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

История на синхронизацията

Провери историческите операции по синхронизация:

tajo connectors history shopify --limit 10

Отстраняване на проблеми

Чести проблеми

Режим за дебъг

Активирай подробно логване:

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

Тест на връзката

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

Добри практики

1. Започни с тестов магазин – Първо използвай development магазин
2. Стартирай първоначалната синхронизация в непиковите часове – Големите синхронизации могат да бъдат бавни
3. Мапвай персонализирани атрибути – Не разчитай само на мапванията по подразбиране
4. Активирай проследяването на кошница – Критично за възстановяване на изоставена кошница
5. Мониторирай здравето на уебхуците – Настрой известия за неуспешни доставки
6. Използвай пакетни импорти – За исторически данни над 10 000 записа

Сигурност

• OAuth 2.0 – Сигурна автентикация на база токени
• Верификация на уебхуци – Валидация на HMAC подпис
• Криптирано съхранение – API credentials са криптирани при съхранение
• Достъп с обхвати – Само минимално необходимите разрешения

Свързани ресурси

• WooCommerce конектор
• Customer Sync скил
• Abandoned Cart скил
• Brevo Contacts API