G

G

M

M

Niestandardowy katalog źródłowy produktu

Przynieś własny katalog produktów

Przegląd

Przegląd

Przegląd

W Bird możesz stworzyć niestandardowe źródło katalogu produktów za pomocą punktu końcowego API. Odpowiedź API musi przestrzegać określonego formatu, który zawiera szczegóły produktów, warianty, obrazy i nie tylko. Poniżej znajduje się przewodnik, jak zbudować dane swojego katalogu produktów i jak stworzyć go za pomocą API.

Tworzenie niestandardowego katalogu produktów

Możesz przejść do sekcji Marketing na platformie Bird i wykonać następujące kroki:

  • Przejdź do Produkty > Kliknij na Utwórz źródło katalogu jak pokazano poniżej



  • Podaj nazwę i swój adres URL API, który zawiera json dla twoich produktów. Możesz odnosić się do formatu json w poniższych sekcjach tego artykułu. Możesz także zdefiniować metodę autoryzacji, jeśli chcesz.

  • Włącz automatyczne odświeżanie, które aktualizuje katalog, jeśli twoje API zostanie odświeżone.


Po skonfigurowaniu tego zaczniesz widzieć produkty, które się pojawiają i będziesz mógł używać tych produktów w swoich szablonach e-mail.

Możesz przejść do sekcji Marketing na platformie Bird i wykonać następujące kroki:

  • Przejdź do Produkty > Kliknij na Utwórz źródło katalogu jak pokazano poniżej



  • Podaj nazwę i swój adres URL API, który zawiera json dla twoich produktów. Możesz odnosić się do formatu json w poniższych sekcjach tego artykułu. Możesz także zdefiniować metodę autoryzacji, jeśli chcesz.

  • Włącz automatyczne odświeżanie, które aktualizuje katalog, jeśli twoje API zostanie odświeżone.


Po skonfigurowaniu tego zaczniesz widzieć produkty, które się pojawiają i będziesz mógł używać tych produktów w swoich szablonach e-mail.

Możesz przejść do sekcji Marketing na platformie Bird i wykonać następujące kroki:

  • Przejdź do Produkty > Kliknij na Utwórz źródło katalogu jak pokazano poniżej



  • Podaj nazwę i swój adres URL API, który zawiera json dla twoich produktów. Możesz odnosić się do formatu json w poniższych sekcjach tego artykułu. Możesz także zdefiniować metodę autoryzacji, jeśli chcesz.

  • Włącz automatyczne odświeżanie, które aktualizuje katalog, jeśli twoje API zostanie odświeżone.


Po skonfigurowaniu tego zaczniesz widzieć produkty, które się pojawiają i będziesz mógł używać tych produktów w swoich szablonach e-mail.

Format API źródła katalogu produktów

Odpowiedź z punktu końcowego API powinna być tablicą obiektów produktów, z których każdy zawiera kilka pól. Oto struktura i przykładowe wartości dla każdego pola:

Pola wymagane:

  • id (string): Unikalny identyfikator produktu.Przykład: "8890650190078"

  • name (string): Nazwa produktu.Przykład: "Mój produkt testowy"

  • description (string): Opis produktu.Przykład: "Fajny produkt z lampkami dostępny w różnych kolorach"

  • status (string): Aktualny status produktu. Ważne wartości to:active: Produkt jest aktywny i dostępny.archived: Produkt jest zarchiwizowany.draft: Produkt jest w wersji roboczej.Przykład: "active"

  • created_at (string): Data i godzina utworzenia produktu, w formacie ISO-8601.Przykład: "2022-05-25T10:55:16+02:00"

  • updated_at (string): Data i godzina ostatniej aktualizacji produktu, w formacie ISO-8601.Przykład: "2022-05-25T10:55:16+02:00"

  • published_at (string): Data i godzina publikacji produktu, w formacie ISO-8601.Przykład: "2022-05-25T10:55:16+02:00"

  • vendor (string): Nazwa dostawcy produktu.Przykład: "Mój dostawca"

  • deleted_at (string): Data i godzina usunięcia produktu (jeśli dotyczy), w formacie ISO-8601.Przykład: "2022-05-25T10:55:16+02:00" lub pusty ciąg "", jeśli produkt nie został usunięty.

Pola opcjonalne:

  • url (string): URL produktu.Przykład: "https://www.myproduct.com"

  • type (string): Typ produktu, który można używać do filtrowania i wyszukiwania produktów.Przykład: "kolor"

  • variants (array): Tablica wariantów produktu. Jeśli jest określona, każdy wariant musi zawierać id, name, sku i cenę.

Przykład:

[
  {
    "id": "44775891271934",
    "name": "Colorful",
    "price": 13.37,
    "sku": "BIRD",
    "price_currency": "EUR"
  }
]

  • images (array): Tablica obrazów produktów. Jeśli jest określona, każdy obraz musi zawierać id, position, url, alt, width i height. Tablica variant_ids może również łączyć obrazy z konkretnymi wariantami produktu.

[
  {
    "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): Tablica identyfikatorów wariantów związanych z obrazem produktu.

Krok po kroku instrukcje dotyczące tworzenia niestandardowego katalogu produktów

  • Przygotuj swoje dane: Sformatuj odpowiedź z katalogu produktów zgodnie ze strukturą opisaną powyżej. Upewnij się, że wszystkie wymagane pola są uwzględnione, a opcjonalne pola takie jak variants, images i url są dodawane w razie potrzeby.

  • Utwórz punkt końcowy API: Użyj API BirdCRM do wysłania danych o produktach. Punkt końcowy oczekuje odpowiedzi, która przestrzega opisaną powyżej strukturę. Upewnij się, że dane są w poprawnym formacie JSON.

  • Przetestuj punkt końcowy: Zanim zintegrujesz źródło katalogu produktów z własnym przepływem pracy, ważne jest, aby przetestować punkt końcowy API, aby zweryfikować, czy dane są przetwarzane poprawnie. Zapewnia to, że wszystkie produkty i związane z nimi informacje (takie jak warianty i obrazy) są pobierane poprawnie.

  • Monitoruj i utrzymuj: Gdy źródło katalogu produktów zostanie utworzone, możesz monitorować jego wydajność za pomocą funkcji raportowania BirdCRM. Jeśli musisz zaktualizować szczegóły dotyczące produktów lub dodać nowe produkty, po prostu zaktualizuj dane za pomocą API.

Przykładowa odpowiedź 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]
      }
    ]
  }
]


Postępując zgodnie z tymi krokami, możesz utworzyć i zarządzać niestandardowym źródłem katalogu produktów w Bird. Upewnij się, że odpowiedź API przestrzega wymaganego formatu, a będziesz mógł bezproblemowo zintegrować swoje produkty z platformą.


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

Kompletna platforma oparta na sztucznej inteligencji, która rośnie wraz z Twoim biznesem.

Skontaktuj się z działem sprzedaży

Zacznij za darmo

© 2025 Bird

Skontaktuj się z pomocą techniczną

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

Kompletna platforma oparta na sztucznej inteligencji, która rośnie wraz z Twoim biznesem.

Skontaktuj się z działem sprzedaży

Zacznij za darmo

© 2025 Bird

Skontaktuj się z pomocą techniczną

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

Kompletna platforma oparta na sztucznej inteligencji, która rośnie wraz z Twoim biznesem.

Skontaktuj się z działem sprzedaży

Zacznij za darmo

© 2025 Bird

Skontaktuj się z pomocą techniczną