G

G

M

M

Catalogo Prodotti Personalizzati

Porta il tuo catalogo prodotti

Panoramica

Panoramica

Panoramica

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

Creazione di un catalogo prodotti personalizzato

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

  • Naviga su Prodotti > Fai clic su Crea Catalogo Sorgente come mostrato di seguito



  • Fornisci un nome e il tuo URL API che contiene il json per i tuoi prodotti. Puoi fare riferimento al formato json nelle seguenti sezioni di questo articolo. Puoi anche definire un metodo di autenticazione se lo desideri.

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


Una volta che questo è impostato, inizierai a vedere i Prodotti apparire e sarai in grado di utilizzare questi prodotti nei tuoi modelli di email.

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

  • Naviga su Prodotti > Fai clic su Crea Catalogo Sorgente come mostrato di seguito



  • Fornisci un nome e il tuo URL API che contiene il json per i tuoi prodotti. Puoi fare riferimento al formato json nelle seguenti sezioni di questo articolo. Puoi anche definire un metodo di autenticazione se lo desideri.

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


Una volta che questo è impostato, inizierai a vedere i Prodotti apparire e sarai in grado di utilizzare questi prodotti nei tuoi modelli di email.

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

  • Naviga su Prodotti > Fai clic su Crea Catalogo Sorgente come mostrato di seguito



  • Fornisci un nome e il tuo URL API che contiene il json per i tuoi prodotti. Puoi fare riferimento al formato json nelle seguenti sezioni di questo articolo. Puoi anche definire un metodo di autenticazione se lo desideri.

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


Una volta che questo è impostato, inizierai a vedere i Prodotti apparire e sarai in grado di utilizzare questi prodotti nei tuoi modelli di email.

Formato dell'API di origine del catalogo prodotti

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

Campi richiesti:

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

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

  • description (stringa): Una descrizione del prodotto. Esempio: "Un prodotto interessante con luci disponibile 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'orario in cui il prodotto è stato creato, nel formato ISO-8601. Esempio: "2022-05-25T10:55:16+02:00"

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

  • published_at (stringa): La data e l'orario in cui il prodotto è stato pubblicato, nel 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'orario in cui il prodotto è stato eliminato (se applicabile), nel formato ISO-8601. Esempio: "2022-05-25T10:55:16+02:00" o una stringa vuota "" se il prodotto non è stato eliminato.

Campi facoltativi:

  • 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 di prodotto. Se specificato, ogni 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, ogni immagine deve includere id, position, url, alt, width e height. L'array variant_ids può anche collegare immagini a specifiche varianti di 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 di varianti associati all'immagine del prodotto.

Istruzioni passo-passo per creare una fonte di catalogo prodotti personalizzato

  • 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: Use the BirdCRM API to send the product data. The endpoint expects a response that adheres to the structure mentioned above. Ensure that the data is in a valid JSON format.

  • Testa l'endpoint: Before integrating the product catalog source into your workflow, it’s important to test the API endpoint to verify that the data is being processed correctly. This ensures that all products and their related information (like variants and images) are being pulled correctly.

  • Monitora e mantieni: Once the product catalog source is created, you can monitor its performance through BirdCRM’s reporting features. If you need to update any product details or add new products, simply update the data using the 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 sorgente di catalogo prodotti personalizzata all'interno di Bird. Assicurati che la risposta API aderisca al formato richiesto, e potrai integrare i tuoi prodotti nella piattaforma senza problemi.


A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

Contatta le vendite

Inizia gratis

© 2025 Uccello

Contatta il supporto

A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

Contatta le vendite

Inizia gratis

© 2025 Uccello

Contatta il supporto

A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

Contatta le vendite

Inizia gratis

© 2025 Uccello

Contatta il supporto