Shopify کنیکٹر

مکمل گاہک ڈیٹا سنکرونائزیشن، ترک شدہ کارٹ بحالی، اور خودکار مارکیٹنگ مہمات کے لیے اپنے Shopify اسٹور کو Brevo سے منسلک کریں۔

جائزہ

خصوصیات

• ریئل ٹائم گاہک سنک - گاہک کا ڈیٹا فوری طور پر Brevo رابطوں میں سنک ہوتا ہے
• آرڈر ٹریکنگ - خریداری کے بعد کے فلوز کے لیے آرڈر ایونٹس
• پروڈکٹ کیٹلاگ سنک - سفارشات کے لیے پروڈکٹس دستیاب
• کارٹ ترک کرنا - ترک شدہ کارٹس کو ٹریک اور بحال کریں
• براؤز رویہ - پیج ویو اور پروڈکٹ دلچسپی کی ٹریکنگ
• ملٹی اسٹور سپورٹ - متعدد Shopify اسٹورز کو منسلک کریں

شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. ایڈمن رسائی کے ساتھ Shopify اسٹور
2. API رسائی کے ساتھ Brevo اکاؤنٹ
3. Tajo اکاؤنٹ

انسٹالیشن

آپشن 1: Shopify App Store (تجویز کردہ)

1. Shopify App Store میں Tajo ایپ پر جائیں
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
// }

کارٹ ایونٹس ٹریک کریں

اپنی Shopify تھیم میں Tajo اسکرپٹ شامل کریں:

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

کسٹم Webhook ہینڈلر

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

نگرانی

ڈیش بورڈ میٹرکس

Tajo ڈیش بورڈ میں اپنے Shopify کنکشن کی نگرانی کریں:

• سنک اسٹیٹس: ریئل ٹائم کنکشن کی صحت
• سنک شدہ گاہک: Shopify سے کل رابطے
• ٹریک شدہ آرڈرز: پروسیس شدہ آرڈر ایونٹس
• کارٹ ریکوری: ترک شدہ کارٹ کی کارکردگی
• خرابی کی شرح: ناکام سنک کوششیں

Webhook لاگز

ویب ہُک ڈیلیوری اسٹیٹس دیکھیں:

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. ٹیسٹ اسٹور سے شروع کریں - پہلے ڈویلپمنٹ اسٹور استعمال کریں
2. ابتدائی سنک غیر کام کے اوقات میں چلائیں - بڑے سنک سست ہو سکتے ہیں
3. کسٹم خصوصیات میپ کریں - صرف طے شدہ میپنگز پر انحصار نہ کریں
4. کارٹ ٹریکنگ فعال کریں - ترک شدہ کارٹ کی بحالی کے لیے اہم
5. Webhook کی صحت کی نگرانی کریں - ناکام ڈیلیوریوں کے لیے الرٹس ترتیب دیں
6. بیچ امپورٹس استعمال کریں - 10,000 سے زیادہ ریکارڈز کے تاریخی ڈیٹا کے لیے

سیکیورٹی

• OAuth 2.0 - محفوظ ٹوکن پر مبنی تصدیق
• Webhook تصدیق - HMAC دستخط کی توثیق
• انکرپٹڈ اسٹوریج - API اسناد آرام کے وقت انکرپٹڈ
• اسکوپڈ رسائی - صرف کم از کم درکار اجازتیں

متعلقہ وسائل

• WooCommerce کنیکٹر
• گاہک سنک اسکل
• ترک شدہ کارٹ اسکل
• Brevo Contacts API