G

G

M

M

Source de catalogue de produits personnalisés

Amenez votre propre catalogue de produits

Aperçu

Aperçu

Aperçu

Dans Bird, vous pouvez créer une source de catalogue de produits personnalisée en utilisant un point de terminaison API. La réponse de l'API doit respecter un format spécifique qui inclut les détails des produits, les variantes, les images, et plus encore. Ci-dessous se trouve un guide sur la manière de structurer vos données de catalogue de produits et de les créer en utilisant l'API.

Création de Custom Product Catalog

Vous pouvez naviguer vers la section Marketing de la plateforme Bird et suivre ces étapes :

  • Accédez à Produits > Cliquez sur Créer une Source de Catalogue comme indiqué ci-dessous



  • Fournissez un nom et votre URL API qui contient le json pour vos produits. Vous pouvez vous référer au format json dans les sections suivantes de cet article. Vous pouvez également définir une méthode d'authentification si vous le souhaitez.

  • Activez l'actualisation automatique qui met à jour le catalogue si votre API est actualisée.


Une fois cela configuré, vous commencerez à voir les produits apparaître et vous pourrez utiliser ces produits dans vos modèles d'e-mails.

Vous pouvez naviguer vers la section Marketing de la plateforme Bird et suivre ces étapes :

  • Accédez à Produits > Cliquez sur Créer une Source de Catalogue comme indiqué ci-dessous



  • Fournissez un nom et votre URL API qui contient le json pour vos produits. Vous pouvez vous référer au format json dans les sections suivantes de cet article. Vous pouvez également définir une méthode d'authentification si vous le souhaitez.

  • Activez l'actualisation automatique qui met à jour le catalogue si votre API est actualisée.


Une fois cela configuré, vous commencerez à voir les produits apparaître et vous pourrez utiliser ces produits dans vos modèles d'e-mails.

Vous pouvez naviguer vers la section Marketing de la plateforme Bird et suivre ces étapes :

  • Accédez à Produits > Cliquez sur Créer une Source de Catalogue comme indiqué ci-dessous



  • Fournissez un nom et votre URL API qui contient le json pour vos produits. Vous pouvez vous référer au format json dans les sections suivantes de cet article. Vous pouvez également définir une méthode d'authentification si vous le souhaitez.

  • Activez l'actualisation automatique qui met à jour le catalogue si votre API est actualisée.


Une fois cela configuré, vous commencerez à voir les produits apparaître et vous pourrez utiliser ces produits dans vos modèles d'e-mails.

Produit Catalog Source API Format

La réponse du point de terminaison de l'API doit être un tableau d'objets produit, chacun contenant plusieurs champs. Voici la structure et les valeurs d'exemple pour chaque champ :

Champs Requis :

  • id (string) : Un identifiant unique pour le produit. Exemple : "8890650190078"

  • name (string) : Le nom du produit. Exemple : "My Test Product"

  • description (string) : Une description du produit. Exemple : "A cool product with lights available in different colors"

  • status (string) : Le statut actuel du produit. Les valeurs valides sont :active : Le produit est en ligne et disponible.archived : Le produit est archivé.draft : Le produit est un brouillon. Exemple : "active"

  • created_at (string) : La date et l'heure de création du produit, au format ISO-8601. Exemple : "2022-05-25T10:55:16+02:00"

  • updated_at (string) : La date et l'heure de la dernière mise à jour du produit, au format ISO-8601. Exemple : "2022-05-25T10:55:16+02:00"

  • published_at (string) : La date et l'heure de publication du produit, au format ISO-8601. Exemple : "2022-05-25T10:55:16+02:00"

  • vendor (string) : Le nom du fournisseur du produit. Exemple : "My Vendor"

  • deleted_at (string) : La date et l'heure de suppression du produit (si applicable), au format ISO-8601. Exemple : "2022-05-25T10:55:16+02:00" ou une chaîne vide "" si le produit n'a pas été supprimé.

Champs Optionnels :

  • url (string) : L'URL du produit. Exemple : "https://www.myproduct.com"

  • type (string) : Le type de produit, qui peut être utilisé pour filtrer et rechercher des produits. Exemple : "color"

  • variants (array) : Un tableau de variantes de produit. Si spécifié, chaque variante doit inclure id, name, sku, et le prix.

Exemple :

[
  {
    "id": "44775891271934",
    "name": "Colorful",
    "price": 13.37,
    "sku": "BIRD",
    "price_currency": "EUR"
  }
]
  • images (array) : Un tableau d'images de produit. Si spécifié, chaque image doit inclure id, position, url, alt, width, et height. Le tableau variant_ids peut également lier des images à des variantes de produit spécifiques.

[
  {
    "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 tableau d'ids de variantes associés à l'image du produit.

Instructions étape par étape pour créer une source de catalogue de produit personnalisé

  • Préparez Vos Données : Formatez votre réponse du catalogue produit selon la structure décrite ci-dessus. Assurez-vous que tous les champs requis sont inclus, et que les champs optionnels comme variants, images, et url sont ajoutés si nécessaire.

  • Créez le Point de Terminaison de l'API : Utilisez l'API BirdCRM pour envoyer les données produits. Le point de terminaison attend une réponse conforme à la structure mentionnée ci-dessus. Assurez-vous que les données sont dans un format JSON valide.

  • Testez le Point de Terminaison : Avant d'intégrer la source du catalogue produit dans votre flux de travail, il est important de tester le point de terminaison API pour vérifier que les données sont correctement traitées. Cela garantit que tous les produits et leurs informations connexes (comme les variantes et les images) sont bien extraits.

  • Surveillez et Maintenez : Une fois la source du catalogue produit créée, vous pouvez surveiller ses performances via les fonctionnalités de reporting de BirdCRM. Si vous avez besoin de mettre à jour des détails produits ou d'ajouter de nouveaux produits, mettez simplement à jour les données en utilisant l'API.

Exemple de Réponse 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]
      }
    ]
  }
]


En suivant ces étapes, vous pouvez créer et gérer une source de catalogue produit personnalisée au sein de Bird. Assurez-vous que la réponse de l'API respecte le format requis, et vous pourrez intégrer vos produits à la plateforme sans problème.


Connectons-vous avec un expert Bird.
Découvrez toute la puissance du Bird en 30 minutes.

En soumettant, vous acceptez que Bird puisse vous contacter au sujet de nos produits et services.

Vous pouvez vous désabonner à tout moment. Consultez la Déclaration de confidentialité de Bird pour plus de détails sur le traitement des données.

Company

Newsletter

Restez à jour avec Bird grâce aux mises à jour hebdomadaires dans votre boîte de réception.

Connectons-vous avec un expert Bird.
Découvrez toute la puissance du Bird en 30 minutes.

En soumettant, vous acceptez que Bird puisse vous contacter au sujet de nos produits et services.

Vous pouvez vous désabonner à tout moment. Consultez la Déclaration de confidentialité de Bird pour plus de détails sur le traitement des données.

Company

Newsletter

Restez à jour avec Bird grâce aux mises à jour hebdomadaires dans votre boîte de réception.

Connectons-vous avec un expert Bird.
Découvrez toute la puissance du Bird en 30 minutes.

En soumettant, vous acceptez que Bird puisse vous contacter au sujet de nos produits et services.

Vous pouvez vous désabonner à tout moment. Consultez la Déclaration de confidentialité de Bird pour plus de détails sur le traitement des données.

R

Atteindre

G

Grow

M

Manage

A

Automate

Company

Newsletter

Restez à jour avec Bird grâce aux mises à jour hebdomadaires dans votre boîte de réception.