Questa azione assegna un coupon a un cliente quando succede qualcosa in un altro strumento: un acquisto in Shopify, l'ingresso in un segmento o il clic su un'email in Klaviyo, o un evento nel tuo sistema.

Prima di iniziare, crea il coupon in JeriCommerce e copia il suo Campaign slug. Tutti e tre i canali lo usano per sapere quale coupon assegnare.

Cosa succede

  • Il cliente riceve un codice dallo sconto del coupon: il prossimo codice del gruppo che hai caricato, oppure un nuovo codice Shopify monouso se lo sconto crea codici Shopify su richiesta.
  • Il cliente riceve un'email con il codice e una notifica wallet con il messaggio del coupon.
  • Un evento Coupon assigned con il code viene inviato al tuo webhook degli eventi.
  • Puoi sostituire titolo e testo del coupon per questo cliente, per esempio per aggiungere il suo nome. Le statistiche del coupon continuano a funzionare come sempre.

Il coupon non viene assegnato quando:

  • Il coupon è inattivo, terminato o eliminato.
  • Il cliente l'ha già ricevuto tutte le volte che il coupon consente.

Se lo sconto del coupon esaurisce i codici, JeriCommerce disattiva il coupon e le assegnazioni successive vengono saltate finché non aggiungi codici e lo riattivi. Tieni d'occhio i codici rimasti quando assegni i coupon in automatico.

Configurazione

Usa l'azione Assign a coupon di JeriCommerce in qualsiasi workflow di Shopify Flow.

1

Scegli un trigger Shopify

In Shopify apri Flow, crea un workflow e scegli il trigger che deve inviare il coupon.

Configurazione del trigger per assegnare un coupon in Shopify Flow
Scegli l'evento che avvia il workflow
2

Aggiungi l'azione e compila i campi

Aggiungi Assign a coupon e compila:

  • Email: l'email del cliente. Usa Add variable per sceglierla dal trigger.
  • Coupon slug: il Campaign slug del coupon in JeriCommerce.
  • Title e Content (facoltativi): sostituiscono titolo e testo del coupon per questo cliente.
Configurazione dell'azione per assegnare un coupon in Shopify Flow
Inserisci l'email del cliente e il campaign slug
3

Attiva il workflow

Salva e attiva il workflow. Il coupon viene assegnato ogni volta che scatta il trigger.

Il coupon viene assegnato mentre il workflow è in corso. Se non può essere assegnato, il passaggio fallisce e il motivo compare nella cronologia delle esecuzioni del workflow.

Aggiungi un'azione Webhook al tuo flusso Klaviyo. Compila il generatore qui sotto e copia ogni valore nelle impostazioni del webhook.

I tuoi dati

Lo trovi in Settings > Technical > Program Information.

Creane una in Settings > Technical > API Keys. Resta nel tuo browser.

Dettagli dell’azione

Copia il Campaign slug del coupon in Loyalty > Coupons.

Sostituisce il titolo del coupon per questo cliente.

Sostituisce il testo del coupon per questo cliente.

Copia e incolla in Klaviyo

Impostazioni del webhook
URL di destinazione
https://api.jericommerce.com/v1/programs/your-program-slug/coupon/assign
Header
Key
api-key
Value
your-api-key
Corpo JSON
[
  {
    "email": "{{ person.email|default:'' }}",
    "slug": ""
  }
]

Usa le variabili di Klaviyo nel titolo o nel contenuto per personalizzare il coupon, per esempio "{{ person.first_name }}, here is a gift for your loyalty".

Configurazione del webhook in Klaviyo
Configurazione del webhook in Klaviyo

I webhook di Klaviyo vengono messi in coda: JeriCommerce assegna il coupon qualche secondo dopo e Klaviyo non viene informato se l'assegnazione viene saltata.

POST https://api.jericommerce.com/v1/programs/{program_slug}/coupon/assign

Invia la tua chiave API nell'header api-key. Consulta Autenticazione tramite API. Il corpo è un array di massimo 100 elementi:

[
  {
    "email": "customer@example.com",
    "slug": "welcome-coupon",
    "header": "Ana, here is a gift for your loyalty"
  }
]
Campo Tipo Obbligatorio Note
email string Sì Email di un cliente già presente nel programma.
slug string Sì Il Campaign slug del coupon.
header string No Sostituisce il titolo del coupon per questo cliente.
body string No Sostituisce il testo del coupon per questo cliente.

L'API risponde 201 con un corpo vuoto non appena la richiesta è valida e assegna il coupon qualche secondo dopo. Le assegnazioni saltate non vengono segnalate. Consulta gli endpoint in coda.

Codice Stato Significato
MAX_ITEMS_PER_REQUEST_EXCEEDED 400 L'array ha più di 100 elementi.
Errori di validazione 400 email o slug mancano.

Crea una richiesta pronta all'uso con i tuoi valori:

I tuoi dati

Lo trovi in Settings > Technical > Program Information.

Creane una in Settings > Technical > API Keys. Resta nel tuo browser.

Dettagli dell’azione

Copia il Campaign slug del coupon in Loyalty > Coupons.

Sostituisce il titolo del coupon per questo cliente.

Sostituisce il testo del coupon per questo cliente.

La tua richiesta

curl --request POST \
  --url 'https://api.jericommerce.com/v1/programs/your-program-slug/coupon/assign' \
  --header 'api-key: your-api-key' \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "email": "customer@example.com",
    "slug": ""
  }
]'

Incollalo in un terminale per testare la richiesta con il tuo programma.