Reach

Grow

Manage

Automate

Reach

Grow

Manage

Automate

G

G

M

M

Custom Product Catalog Source

Porta il tuo catalogo prodotti

Panoramica

Panoramica

Panoramica

In Bird, puoi creare una fonte personalizzata di catalogo prodotti utilizzando un endpoint API. La risposta API deve rispettare un formato specifico che include dettagli del prodotto, varianti, immagini e altro. Di seguito è riportata una guida su come strutturare i dati del tuo catalogo prodotti e su come crearlo utilizzando l'API.

Creare Custom Product Catalog

Puoi navigare nella sezione Marketing della piattaforma Bird e seguire questi passaggi:

  • Vai a Products > Clicca su Create Catalog Source come mostrato sotto



  • Fornisci un nome e la tua API URL che contiene il json per i tuoi prodotti. Puoi consultare il formato json nelle seguenti sezioni di questo articolo. Puoi anche definire un metodo di autenticazione se desideri.

  • Abilita Auto-refresh che aggiorna il catalogo se la tua API viene aggiornata.


Una volta configurato, inizierai a vedere i Products mostrarsi e sarai in grado di utilizzare questi prodotti nei tuoi modelli di email.

Puoi navigare nella sezione Marketing della piattaforma Bird e seguire questi passaggi:

  • Vai a Products > Clicca su Create Catalog Source come mostrato sotto



  • Fornisci un nome e la tua API URL che contiene il json per i tuoi prodotti. Puoi consultare il formato json nelle seguenti sezioni di questo articolo. Puoi anche definire un metodo di autenticazione se desideri.

  • Abilita Auto-refresh che aggiorna il catalogo se la tua API viene aggiornata.


Una volta configurato, inizierai a vedere i Products mostrarsi e sarai in grado di utilizzare questi prodotti nei tuoi modelli di email.

Puoi navigare nella sezione Marketing della piattaforma Bird e seguire questi passaggi:

  • Vai a Products > Clicca su Create Catalog Source come mostrato sotto



  • Fornisci un nome e la tua API URL che contiene il json per i tuoi prodotti. Puoi consultare il formato json nelle seguenti sezioni di questo articolo. Puoi anche definire un metodo di autenticazione se desideri.

  • Abilita Auto-refresh che aggiorna il catalogo se la tua API viene aggiornata.


Una volta configurato, inizierai a vedere i Products mostrarsi e sarai in grado di utilizzare questi prodotti nei tuoi modelli di email.

Catalogo Prodotti Source API Format

La risposta dall'endpoint API dovrebbe essere un array di oggetti prodotto, ciascuno contenente diversi campi. Ecco la struttura e i valori di esempio per ciascun campo:

Campi Obbligatori:

  • id (stringa): Un identificatore univoco per il prodotto. Esempio: "8890650190078"

  • name (stringa): Il nome del prodotto. Esempio: "My Test Product"

  • description (stringa): Una descrizione del prodotto. Esempio: "Un prodotto fantastico con luci disponibili in diversi colori"

  • status (stringa): Lo stato attuale del prodotto. I valori validi sono:active: Il prodotto è attivo e disponibile.archived: Il prodotto è archiviato.draft: Il prodotto è una bozza. Esempio: "active"

  • created_at (stringa): La data e l'ora in cui il prodotto è stato creato, in formato ISO-8601. Esempio: "2022-05-25T10:55:16+02:00"

  • updated_at (stringa): La data e l'ora in cui il prodotto è stato aggiornato l'ultima volta, in formato ISO-8601. Esempio: "2022-05-25T10:55:16+02:00"

  • published_at (stringa): La data e l'ora in cui il prodotto è stato pubblicato, in formato ISO-8601. Esempio: "2022-05-25T10:55:16+02:00"

  • vendor (stringa): Il nome del fornitore del prodotto. Esempio: "My Vendor"

  • deleted_at (stringa): La data e l'ora in cui il prodotto è stato cancellato (se applicabile), in formato ISO-8601. Esempio: "2022-05-25T10:55:16+02:00" o una stringa vuota "" se il prodotto non è stato cancellato.

Campi Opzionali:

  • url (stringa): L'URL del prodotto. Esempio: "https://www.myproduct.com"

  • type (stringa): Il tipo di prodotto, che può essere utilizzato per filtrare e cercare i prodotti. Esempio: "color"

  • variants (array): Un array di varianti del prodotto. Se specificato, ciascuna variante deve includere id, name, sku, e prezzo.

Esempio:

[
  {
    "id": "44775891271934",
    "name": "Colorful",
    "price": 13.37,
    "sku": "BIRD",
    "price_currency": "EUR"
  }
]
  • images (array): Un array di immagini del prodotto. Se specificato, ciascuna immagine deve includere id, position, url, alt, width e height. L'array variant_ids può anche collegare le immagini a varianti specifiche del prodotto.

[
  {
    "id": "41083401765118",
    "position": 1,
    "url": "https://images.com/s/files/1/0640/9021/0558/files/61dJSqBcgeL._AC_SX679.jpg?v=1709712277",
    "alt": "Product Image",
    "width": 679,
    "height": 1071,
    "variant_ids": [
      44775891271934
    ]
  }
]

variant_ids (array): Un array di ID variante associati all'immagine del prodotto.

Istruzioni dettagliate per creare una sorgente personalizzata per il catalogo prodotti

  • Prepara i tuoi dati: Format your product catalog response according to the structure outlined above. Ensure all required fields are included, and optional fields like variants, images, and url are added as needed.

  • Crea l'Endpoint API: Usa l'API BirdCRM per inviare i dati del prodotto. L'endpoint si aspetta una risposta che aderisce alla struttura menzionata sopra. Assicurati che i dati siano in un formato JSON valido.

  • Testa l'Endpoint: Prima di integrare la fonte del catalogo prodotti nel tuo flusso di lavoro, è importante testare l'API endpoint per verificare che i dati vengano elaborati correttamente. Ciò garantisce che tutti i prodotti e le loro informazioni correlate (come varianti e immagini) vengano recuperati correttamente.

  • Monitora e Manutieni: Una volta creata la fonte del catalogo prodotti, puoi monitorarne le prestazioni attraverso le funzionalità di reporting di BirdCRM. Se hai bisogno di aggiornare i dettagli di un prodotto o aggiungere nuovi prodotti, basta aggiornare i dati utilizzando l'API.

Esempio di risposta API:

[[
  {
    "id": "66f120f8001c1da060fa157d",
    "name": "Test Product",
    "description": "Test Description",
    "status": "active",
    "created_at": "2024-09-23T08:06:15.017Z",
    "updated_at": "2024-09-23T08:06:10.779Z",
    "published_at": "2024-09-23T08:06:15.017Z",
    "vendor": "Bird",
    "deleted_at": "",
    "url": "https://www.myproduct.com",
    "variants": [
      {
        "id": "0",
        "name": "Test Product Variant 1",
        "price": 459,
        "sku": "test-sku-1",
        "price_currency": "EUR"
      }
    ],
    "images": [
      {
        "id": "000",
        "position": 1,
        "url": "https://framerusercontent.com/images/zASPV0YuKuzbu1t0zakhflD2Y.png",
        "alt": "bird",
        "width": 768,
        "height": 432,
        "variant_ids": [0]
      }
    ]
  }
]


Seguendo questi passaggi, puoi creare e gestire una fonte di catalogo prodotti personalizzata all'interno di Bird. Assicurati che la risposta dell'API aderisca al formato richiesto in modo da poter integrare i tuoi prodotti nella piattaforma senza problemi.


Connettiamoci con un esperto di Bird.
Scopri tutta la potenza del Bird in 30 minuti.

Inviando, accetti che Bird possa contattarti riguardo ai nostri prodotti e servizi.

Puoi annullare l'iscrizione in qualsiasi momento. Consulta la Informativa sulla Privacy di Bird per i dettagli sul trattamento dei dati.

Azienda

Newsletter

Rimani aggiornato con Bird attraverso aggiornamenti settimanali nella tua inbox.

Connettiamoci con un esperto di Bird.
Scopri tutta la potenza del Bird in 30 minuti.

Inviando, accetti che Bird possa contattarti riguardo ai nostri prodotti e servizi.

Puoi annullare l'iscrizione in qualsiasi momento. Consulta la Informativa sulla Privacy di Bird per i dettagli sul trattamento dei dati.

Azienda

Newsletter

Rimani aggiornato con Bird attraverso aggiornamenti settimanali nella tua inbox.

Connettiamoci con un esperto di Bird.
Scopri tutta la potenza del Bird in 30 minuti.

Inviando, accetti che Bird possa contattarti riguardo ai nostri prodotti e servizi.

Puoi annullare l'iscrizione in qualsiasi momento. Consulta la Informativa sulla Privacy di Bird per i dettagli sul trattamento dei dati.

R

Raggiungi

G

Grow

M

Manage

A

Automate

Azienda

Newsletter

Rimani aggiornato con Bird attraverso aggiornamenti settimanali nella tua inbox.