On this page

Guida all'Integrazione Shopify

Questa guida completa ti accompagna nell’integrazione di Tajo con il tuo negozio Shopify per sbloccare potenti funzionalità di coinvolgimento dei clienti, programmi fedeltà e automazione del marketing.

Panoramica

L’integrazione Tajo-Shopify ti consente di:

Sincronizzare i dati dei clienti automaticamente dal tuo negozio Shopify
Tracciare ordini e prodotti per il marketing personalizzato
Gestire programmi fedeltà con punti, livelli e premi
Automatizzare le campagne di marketing tramite Brevo (email, SMS, WhatsApp)
Segmentare i clienti per comportamento di acquisto e coinvolgimento
Recuperare i carrelli abbandonati con sequenze automatizzate

Prerequisiti

Prima di avviare l’integrazione, assicurati di avere:

Negozio Shopify su qualsiasi piano (Basic, Shopify, Advanced o Plus)
Account Tajo con un abbonamento attivo
Account Brevo (opzionale, per l’automazione del marketing)
Accesso amministratore al tuo negozio Shopify

Passo 1: Installa l’App Tajo

Dallo Shopify App Store

Vai allo Shopify App Store
Cerca “Tajo”
Fai clic su Aggiungi app
Esamina le autorizzazioni e fai clic su Installa app
Verrai reindirizzato alla procedura guidata di configurazione Tajo

Installazione Manuale

Se preferisci la configurazione manuale:

# Clona l'app Tajo per Shopify
git clone https://github.com/tajo/shopify-app.git

# Installa le dipendenze
cd shopify-app
npm install

# Configura l'ambiente
cp .env.example .env

Configura il file .env:

SHOPIFY_API_KEY=your_api_key
SHOPIFY_API_SECRET=your_api_secret
SHOPIFY_SCOPES=read_customers,write_customers,read_orders,read_products
TAJO_API_KEY=your_tajo_api_key
BREVO_API_KEY=your_brevo_api_key

Passo 2: Configura la Sincronizzazione Dati

Impostazioni Sincronizzazione Clienti

Nel tuo dashboard Tajo, configura quali dati clienti sincronizzare:

{
  "sync_settings": {
    "customers": {
      "enabled": true,
      "sync_frequency": "real-time",
      "fields": [
        "email",
        "first_name",
        "last_name",
        "phone",
        "orders_count",
        "total_spent",
        "tags"
      ]
    },
    "orders": {
      "enabled": true,
      "sync_frequency": "real-time",
      "include_line_items": true
    },
    "products": {
      "enabled": true,
      "sync_frequency": "hourly"
    }
  }
}

Passo 3: Configura il Programma Fedeltà

Regole Base dei Punti

const loyaltyConfig = {
  points_per_dollar: 1,
  tiers: [
    { name: "Bronze", min_points: 0, multiplier: 1.0 },
    { name: "Silver", min_points: 1000, multiplier: 1.5 },
    { name: "Gold", min_points: 5000, multiplier: 2.0 },
    { name: "Platinum", min_points: 10000, multiplier: 3.0 }
  ],
  welcome_bonus: 500,
  birthday_bonus: 250
};

Passo 4: Automazione Marketing con Brevo

Sequenza di Recupero Carrello Abbandonato

const cartRecovery = {
  trigger: "cart_abandoned",
  delay: "1 hour",
  sequence: [
    {
      channel: "email",
      template_id: 101,
      delay: "1h"
    },
    {
      channel: "sms",
      message: "Hai dimenticato qualcosa nel carrello! Completa l'acquisto e guadagna {{points}} punti.",
      delay: "24h",
      condition: "email_not_opened"
    }
  ]
};

Passo 5: Test e Monitoraggio

Checklist per i Test

Sincronizzazione Clienti: I nuovi clienti appaiono in Brevo
Sincronizzazione Ordini: Gli acquisti attivano gli eventi correttamente
Programma Fedeltà: I punti vengono assegnati e aggiornati
Campagne Email: Le email automatiche vengono inviate correttamente
Recupero Carrello: La sequenza di recupero funziona