Bereik

Grow

Manage

Automate

Bereik

Grow

Manage

Automate

G

G

M

M

Aangepaste Product Catalogus Bron

Voeg uw eigen productcatalogus toe

Overzicht

Overzicht

Overzicht

In Bird kun je met behulp van een API-eindpunt een aangepaste productcatalogusbron maken. De API-respons moet voldoen aan een specifiek formaat dat productdetails, varianten, afbeeldingen en meer omvat. Hieronder staat een gids over hoe je je productcatalogusgegevens structureert en hoe je deze maakt met behulp van de API.

Aangepaste Productcatalogus Maken

U kunt naar de Marketing sectie van het Bird Platform navigeren en de volgende stappen volgen:

  • Navigeer naar Products > Klik op Create Catalog Source zoals hieronder weergegeven



  • Geef een naam en uw API URL op die de json voor uw producten bevat. U kunt naar het json-formaat verwijzen in de volgende secties van dit artikel. U kunt ook een authenticatiemethode definiëren als u dat wilt.

  • Schakel Auto-refresh in, die de catalogus bijwerkt als uw API wordt vernieuwd.


Zodra dit is ingesteld, zullen de Products verschijnen en kunt u deze producten in uw e-mailsjablonen gebruiken.

U kunt naar de Marketing sectie van het Bird Platform navigeren en de volgende stappen volgen:

  • Navigeer naar Products > Klik op Create Catalog Source zoals hieronder weergegeven



  • Geef een naam en uw API URL op die de json voor uw producten bevat. U kunt naar het json-formaat verwijzen in de volgende secties van dit artikel. U kunt ook een authenticatiemethode definiëren als u dat wilt.

  • Schakel Auto-refresh in, die de catalogus bijwerkt als uw API wordt vernieuwd.


Zodra dit is ingesteld, zullen de Products verschijnen en kunt u deze producten in uw e-mailsjablonen gebruiken.

U kunt naar de Marketing sectie van het Bird Platform navigeren en de volgende stappen volgen:

  • Navigeer naar Products > Klik op Create Catalog Source zoals hieronder weergegeven



  • Geef een naam en uw API URL op die de json voor uw producten bevat. U kunt naar het json-formaat verwijzen in de volgende secties van dit artikel. U kunt ook een authenticatiemethode definiëren als u dat wilt.

  • Schakel Auto-refresh in, die de catalogus bijwerkt als uw API wordt vernieuwd.


Zodra dit is ingesteld, zullen de Products verschijnen en kunt u deze producten in uw e-mailsjablonen gebruiken.

Product Catalog Source API-formaat

De reactie van het API-eindpunt moet een array van productobjecten zijn, elk met verschillende velden. Hier is de structuur en voorbeeldwaarden voor elk veld:

Vereiste Velden:

  • id (string): Een unieke identificator voor het product. Voorbeeld: "8890650190078"

  • name (string): De naam van het product. Voorbeeld: "My Test Product"

  • description (string): Een beschrijving van het product. Voorbeeld: "A cool product with lights available in different colors"

  • status (string): De huidige status van het product. De geldige waarden zijn:active: Het product is live en beschikbaar.archived: Het product is gearchiveerd.draft: Het product is een concept. Voorbeeld: "active"

  • created_at (string): De datum en tijd waarop het product is gemaakt, in ISO-8601 formaat. Voorbeeld: "2022-05-25T10:55:16+02:00"

  • updated_at (string): De datum en tijd waarop het product voor het laatst is bijgewerkt, in ISO-8601 formaat. Voorbeeld: "2022-05-25T10:55:16+02:00"

  • published_at (string): De datum en tijd waarop het product is gepubliceerd, in ISO-8601 formaat. Voorbeeld: "2022-05-25T10:55:16+02:00"

  • vendor (string): De naam van de leverancier van het product. Voorbeeld: "My Vendor"

  • deleted_at (string): De datum en tijd waarop het product is verwijderd (indien van toepassing), in ISO-8601 formaat. Voorbeeld: "2022-05-25T10:55:16+02:00" of een lege string "" als het product niet is verwijderd.

Optionele Velden:

  • url (string): De product-URL. Voorbeeld: "https://www.myproduct.com"

  • type (string): Het producttype, dat kan worden gebruikt voor het filteren en zoeken van producten. Voorbeeld: "color"

  • variants (array): Een array van productvarianten. Indien gespecificeerd, moet elke variant id, name, sku, en prijs bevatten.

Voorbeeld:

[
  {
    "id": "44775891271934",
    "name": "Colorful",
    "price": 13.37,
    "sku": "BIRD",
    "price_currency": "EUR"
  }
]
  • images (array): Een array van productafbeeldingen. Indien gespecificeerd, moet elke afbeelding id, position, url, alt, width, en height bevatten. De variant_ids array kan ook afbeeldingen koppelen aan specifieke productvarianten.

[
  {
    "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): Een array van variant-id's die aan de productafbeelding zijn gekoppeld.

Stapsgewijze instructies voor het maken van een Custom Product Catalog Source

  • Bereid uw gegevens voor: Formatteer uw productcatalogusreactie volgens de hierboven beschreven structuur. Zorg ervoor dat alle verplichte velden zijn opgenomen en voeg optionele velden zoals varianten, afbeeldingen en url toe indien nodig.

  • Maak het API-eindpunt: Gebruik de BirdCRM API om de productgegevens te verzenden. Het eindpunt verwacht een reactie die voldoet aan de hierboven genoemde structuur. Zorg ervoor dat de gegevens in een geldig JSON-formaat zijn.

  • Test het eindpunt: Voordat u de bron van de productcatalogus in uw workflow integreert, is het belangrijk om het API-eindpunt te testen om te verifiëren dat de gegevens correct worden verwerkt. Dit zorgt ervoor dat alle producten en hun gerelateerde informatie (zoals varianten en afbeeldingen) correct worden opgehaald.

  • Monitoren en onderhouden: Zodra de bron van de productcatalogus is gemaakt, kunt u de prestaties ervan monitoren via de rapportagefuncties van BirdCRM. Als u productdetails moet bijwerken of nieuwe producten wilt toevoegen, werk dan eenvoudig de gegevens bij met behulp van de API.

Voorbeeld API-reactie:

[[
  {
    "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]
      }
    ]
  }
]


Door deze stappen te volgen, kunt u een aangepaste productcatalogusbron maken en beheren binnen Bird. Zorg ervoor dat de API-reactie voldoet aan het vereiste formaat, en u kunt uw producten naadloos integreren in het platform.


Meer Handleidingen

Verken aanvullende video's en stapsgewijze handleidingen om u te helpen vooruit te komen.

Laten we je in contact brengen met een Bird-expert.
Bekijk de volledige kracht van de Bird in 30 minuten.

Door te verzenden, ga je ermee akkoord dat Bird contact met je mag opnemen over onze producten en diensten.

U kunt zich op elk moment afmelden. Zie Bird's Privacyverklaring voor details over gegevensverwerking.

Nieuwsbrief

Blijf op de hoogte met Bird via wekelijkse updates in je inbox.

Laten we je in contact brengen met een Bird-expert.
Bekijk de volledige kracht van de Bird in 30 minuten.

Door te verzenden, ga je ermee akkoord dat Bird contact met je mag opnemen over onze producten en diensten.

U kunt zich op elk moment afmelden. Zie Bird's Privacyverklaring voor details over gegevensverwerking.

Nieuwsbrief

Blijf op de hoogte met Bird via wekelijkse updates in je inbox.

Laten we je in contact brengen met een Bird-expert.
Bekijk de volledige kracht van de Bird in 30 minuten.

Door te verzenden, ga je ermee akkoord dat Bird contact met je mag opnemen over onze producten en diensten.

U kunt zich op elk moment afmelden. Zie Bird's Privacyverklaring voor details over gegevensverwerking.

R

Bereik

G

Grow

M

Manage

A

Automate

Nieuwsbrief

Blijf op de hoogte met Bird via wekelijkse updates in je inbox.