BigCommerce Konektor

BigCommerce Konektor

Povežite svoju BigCommerce trgovinu s Brevom putem Taja za potpunu sinkronizaciju e-commerce podataka. Sinkronizirajte kupce, narudžbe, proizvode i događaje košarice za pokretanje ciljanih marketinških kampanja, oporavka napuštenih košarica i automatizacija nakon kupnje.

Pregled

Značajke

• Sinkronizacija kupaca - Sinkronizacija podataka o kupcima u stvarnom vremenu s Brevo kontaktima
• Praćenje narudžbi - Događaji životnog ciklusa narudžbi za tokove marketinga nakon kupnje
• Sinkronizacija kataloga proizvoda - Sinkronizacija proizvoda za e-mail preporuke i dinamički sadržaj
• Napuštanje košarice - Praćenje i oporavak napuštenih košarica automatiziranim e-mailovima
• Podrška za više web-trgovina - Povežite više BigCommerce web-trgovina
• Ažuriranja putem webhookova - Ažuriranja podataka u stvarnom vremenu putem BigCommerce webhookova
• Prilagođena polja - Mapiranje BigCommerce prilagođenih polja na Brevo atribute kontakata
• Praćenje zaliha - Sinkronizacija razina zaliha za obavijesti o ponovnoj dostupnosti

Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. BigCommerce trgovinu s pristupom vlasnika ili administratora
2. BigCommerce API račun s odgovarajućim OAuth opsezima
3. Vaš Store Hash (pronađen u URL-u vaše trgovine ili API vjerodajnicama)
4. Brevo račun s API pristupom
5. Tajo račun s API vjerodajnicama

Autentifikacija

Vjerodajnice API računa

BigCommerce koristi OAuth-based API račune. Kreirajte ih u vašoj BigCommerce upravljačkoj ploči pod Postavke > API > API Računi.

Primit ćete:

• Client ID - Identifikator vaše aplikacije
• Client Secret - Tajna vaše aplikacije (pohranite sigurno)
• Access Token - Koristi se za API autentifikaciju
• Store Hash - Vaš jedinstveni identifikator trgovine

curl https://api.bigcommerce.com/stores/{store_hash}/v3/catalog/products \
  -H "X-Auth-Token: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"

Potrebni OAuth opsezi

Konfiguracija

Osnovna konfiguracija

connectors:
  bigcommerce:
    enabled: true
    store_hash: "your-store-hash"
    access_token: "your-access-token"
    client_id: "your-client-id"

    # Opcije sinkronizacije podataka
    sync:
      customers: true
      orders: true
      products: true
      carts: true
      inventory: false

    # Dodjela Brevo popisa
    lists:
      all_customers: 40
      buyers: 41
      abandoned_cart: 42

Mapiranje polja kupaca

Mapirajte polja kupaca BigCommercea na Brevo atribute:

customer_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS
  company: COMPANY

  # Polja adrese
  addresses[0].city: CITY
  addresses[0].state: STATE
  addresses[0].country: COUNTRY
  addresses[0].zip: ZIP

  # E-commerce metrike
  orders_count: ORDER_COUNT
  total_spent: TOTAL_SPENT
  date_created: SIGNUP_DATE

  # Grupa kupaca
  customer_group_id: CUSTOMER_GROUP

Konfiguracija webhookova

webhooks:
  - scope: "store/customer/created"
    destination: "customer_created"
  - scope: "store/customer/updated"
    destination: "customer_updated"
  - scope: "store/order/created"
    destination: "order_placed"
  - scope: "store/order/updated"
    destination: "order_updated"
  - scope: "store/order/statusUpdated"
    destination: "order_status_changed"
  - scope: "store/cart/created"
    destination: "cart_created"
  - scope: "store/cart/updated"
    destination: "cart_updated"
  - scope: "store/cart/abandoned"
    destination: "cart_abandoned"
  - scope: "store/inventory/updated"
    destination: "inventory_changed"

API krajnje točke

Primjeri koda

Inicijalizacija BigCommerce konektora

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

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

// Povežite BigCommerce trgovinu
await tajo.connectors.connect('bigcommerce', {
  storeHash: process.env.BC_STORE_HASH,
  accessToken: process.env.BC_ACCESS_TOKEN,
  clientId: process.env.BC_CLIENT_ID
});

Dohvaćanje i sinkronizacija kupaca

// Dohvatite kupce iz BigCommercea
const response = await fetch(
  `https://api.bigcommerce.com/stores/${STORE_HASH}/v3/customers?limit=250`,
  {
    headers: {
      'X-Auth-Token': ACCESS_TOKEN,
      'Content-Type': 'application/json'
    }
  }
);

const { data, meta } = await response.json();
// data: [{ id, email, first_name, last_name, phone, ... }]
// meta.pagination: { total, count, per_page, current_page, total_pages }

Rukovanje webhook događajima

// Handler za BigCommerce webhookove
app.post('/webhooks/bigcommerce', async (req, res) => {
  const { scope, store_id, data } = req.body;

  // Verificirajte da webhook dolazi iz vaše trgovine
  if (store_id !== process.env.BC_STORE_HASH) {
    return res.status(401).send('Unauthorized');
  }

  // Proslijedite Taju
  await tajo.connectors.handleWebhook('bigcommerce', {
    topic: scope,
    payload: data
  });

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

Sinkronizacija kataloga proizvoda

// Potpuna sinkronizacija kataloga proizvoda
await tajo.connectors.sync('bigcommerce', {
  type: 'full',
  resources: ['products'],
  includeVariants: true,
  includeImages: true
});

// Provjera statusa sinkronizacije
const status = await tajo.connectors.status('bigcommerce');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   customersCount: 8200,
//   ordersCount: 4500,
//   productsCount: 620
// }

Ograničenja brzine

Dodatna ograničenja:

Rješavanje problema

Preporučene prakse

1. Koristite V3 API gdje je moguće - V3 API nudi bolju paginaciju, filtriranje i JSON odgovore
2. Pratite zaglavlja ograničenja brzine - Pratite X-Rate-Limit-Requests-Left kako biste izbjegli prekoračenje limita
3. Registrirajte webhookove za sinkronizaciju u stvarnom vremenu - Koristite webhookove umjesto anketiranja za ažuriranja kupaca i narudžbi
4. Skupna ažuriranja kupaca - Koristite V3 skupne krajnje točke za kupce za velike sinkronizacije podataka
5. Uključite varijante u sinkronizaciju proizvoda - Sinkronizacija varijanti proizvoda za točno praćenje zaliha
6. Postavite webhookove za napuštene košarice - Kritično za automatizaciju e-maila za oporavak košarice
7. Koristite paginaciju - Uvijek paginirajte krajnje točke za popise; maks. 250 zapisa po stranici

Sigurnost

• OAuth autentifikacija tokenom - Siguran API pristup temeljen na tokenu
• Opsežene dozvole - API računi ograničeni na specifične opsege podataka
• Samo HTTPS - Sva API komunikacija šifrirana putem TLS-a
• Verifikacija webhookova - Verificirajte izvor webhookova koristeći store hash
• PCI DSS usklađenost - BigCommerce sigurno rukuje podacima o plaćanju
• SOC 2 Type II - BigCommerce platforma je SOC 2 certificirana

Povezani resursi

• Shopify Konektor
• WooCommerce Konektor
• Vještina sinkronizacije korisnika
• Vještina napuštene košarice