Shopify Bağlayıcısı

Eksiksiz müşteri verisi senkronizasyonu, terk edilmiş sepet kurtarma ve otomatik pazarlama kampanyaları için Shopify mağazanızı Brevo’ya bağlayın.

Genel Bakış

Özellikler

• Gerçek zamanlı müşteri senkronizasyonu - Müşteri verileri anında Brevo kişilerine senkronize edilir
• Sipariş takibi - Satın alma sonrası akışlar için sipariş olayları
• Ürün kataloğu senkronizasyonu - Öneriler için ürünler kullanılabilir
• Sepet terki - Terk edilmiş sepetleri takip edin ve kurtarın
• Gezinme davranışı - Sayfa görüntüleme ve ürün ilgi takibi
• Çoklu mağaza desteği - Birden fazla Shopify mağazasını bağlayın

Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. Yönetici erişimine sahip bir Shopify mağazası
2. API erişimi olan bir Brevo hesabı
3. Bir Tajo hesabı

Yükleme

Seçenek 1: Shopify App Store (Önerilen)

1. Shopify App Store’daki Tajo uygulamasını ziyaret edin
2. “Add app” düğmesine tıklayın
3. İstenen izinleri verin
4. Brevo hesabınızı bağlayın

Seçenek 2: Manuel Yükleme

Adım 1: Bir Shopify Uygulaması Oluştur

1. Shopify yöneticinize → Settings → Apps and sales channels bölümüne gidin
2. “Develop apps” → “Create an app” tıklayın
3. Adını “Tajo Integration” koyun

Adım 2: API Kapsamlarını Yapılandır

Şu kapsamları etkinleştirin:

read_customers
write_customers
read_orders
read_products
read_checkouts
write_script_tags

Adım 3: Uygulamayı Yükle

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

Adım 4: Webhook’ları Yapılandır

Tajo bu webhook’ları otomatik olarak kaydeder:

Yapılandırma

Temel Kurulum

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

Alan Eşleme

Shopify alanlarını Brevo kişi özniteliklerine eşleyin:

Özel Öznitelik Eşleme

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

Ürün Senkronizasyonu

E-posta önerileri için ürünleri senkronize edin:

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

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

Envanter Takibi

Stok seviyesi senkronizasyonunu etkinleştirin:

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

Olaylar

Müşteri Olayları

Sipariş Olayları

Sepet Olayları

Etkinleştirilen Yetenekler

Shopify bağlayıcısı şu yetenekleri etkinleştirir:

Kod Örnekleri

Bağlayıcıyı Başlat

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

İlk Senkronizasyonu Çalıştır

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

Sepet Olaylarını Takip Et

Tajo betiğini Shopify temanıza ekleyin:

<!-- 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.example.com/shopify.js"></script>

Özel Webhook İşleyici

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

İzleme

Pano Metrikleri

Tajo panosunda Shopify bağlantınızı izleyin:

• Senkronizasyon Durumu: Gerçek zamanlı bağlantı sağlığı
• Senkronize Edilen Müşteriler: Shopify’dan toplam kişiler
• Takip Edilen Siparişler: İşlenen sipariş olayları
• Sepet Kurtarma: Terk edilmiş sepet performansı
• Hata Oranı: Başarısız senkronizasyon denemeleri

Webhook Günlükleri

Webhook teslimat durumunu görüntüleyin:

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

Senkronizasyon Geçmişi

Geçmiş senkronizasyon işlemlerini kontrol edin:

tajo connectors history shopify --limit 10

Sorun Giderme

Sık Karşılaşılan Sorunlar

Hata Ayıklama Modu

Ayrıntılı günlüklemeyi etkinleştirin:

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

Bağlantıyı Test Et

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

En İyi Uygulamalar

1. Test mağazasıyla başlayın - Önce bir geliştirme mağazası kullanın
2. İlk senkronizasyonu mesai dışı saatlerde çalıştırın - Büyük senkronizasyonlar yavaş olabilir
3. Özel öznitelikleri eşleyin - Yalnızca varsayılan eşlemelere güvenmeyin
4. Sepet takibini etkinleştirin - Terk edilmiş sepet kurtarma için kritik
5. Webhook sağlığını izleyin - Başarısız teslimatlar için uyarılar kurun
6. Toplu içe aktarma kullanın - 10.000’den fazla kayıt için geçmiş veriler

Güvenlik

• OAuth 2.0 - Güvenli belirteç tabanlı kimlik doğrulama
• Webhook doğrulama - HMAC imza doğrulaması
• Şifreli depolama - API kimlik bilgileri durağan halde şifrelenir
• Kapsamlandırılmış erişim - Yalnızca minimum gerekli izinler

İlgili Kaynaklar

• WooCommerce Bağlayıcısı
• Müşteri Senkronizasyon Yeteneği
• Terk Edilmiş Sepet Yeteneği
• Brevo Kişiler API’si