Zasięg

Grow

Manage

Automate

Zasięg

Grow

Manage

Automate

G

G

M

M

Niestandardowy katalog produktów Source

Wprowadź swój 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 być zgodna z określonym formatem, który zawiera szczegóły produktów, warianty, obrazy i więcej. Poniżej znajduje się przewodnik, jak zorganizować dane katalogu produktów i jak go utworzyć za pomocą API.

Tworzenie Custom Product Catalog

Możesz przejść do sekcji Marketing na platformie Bird i postępować zgodnie z tymi krokami:

  • Przejdź do Products > Kliknij na Create Catalog Source jak pokazano poniżej



  • Podaj nazwę i swój API URL, który zawiera json dla Twoich produktów. Możesz odnieść się do formatu json w kolejnych sekcjach tego artykułu. Możesz również zdefiniować metodę uwierzytelniania, jeśli chcesz.

  • Włącz Auto-refresh, który aktualizuje katalog, jeśli Twój API zostanie zaktualizowany.


Gdy wszystko będzie skonfigurowane, zaczniesz widzieć pojawiające się Products i będziesz mógł używać tych produktów w swoich szablonach emaili.

Możesz przejść do sekcji Marketing na platformie Bird i postępować zgodnie z tymi krokami:

  • Przejdź do Products > Kliknij na Create Catalog Source jak pokazano poniżej



  • Podaj nazwę i swój API URL, który zawiera json dla Twoich produktów. Możesz odnieść się do formatu json w kolejnych sekcjach tego artykułu. Możesz również zdefiniować metodę uwierzytelniania, jeśli chcesz.

  • Włącz Auto-refresh, który aktualizuje katalog, jeśli Twój API zostanie zaktualizowany.


Gdy wszystko będzie skonfigurowane, zaczniesz widzieć pojawiające się Products i będziesz mógł używać tych produktów w swoich szablonach emaili.

Możesz przejść do sekcji Marketing na platformie Bird i postępować zgodnie z tymi krokami:

  • Przejdź do Products > Kliknij na Create Catalog Source jak pokazano poniżej



  • Podaj nazwę i swój API URL, który zawiera json dla Twoich produktów. Możesz odnieść się do formatu json w kolejnych sekcjach tego artykułu. Możesz również zdefiniować metodę uwierzytelniania, jeśli chcesz.

  • Włącz Auto-refresh, który aktualizuje katalog, jeśli Twój API zostanie zaktualizowany.


Gdy wszystko będzie skonfigurowane, zaczniesz widzieć pojawiające się Products i będziesz mógł używać tych produktów w swoich szablonach emaili.

Product Catalog Source API Format

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:

Wymagane Pola:

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

  • name (string): Nazwa produktu. Przykład: "My Test Product"

  • description (string): Opis produktu. Przykład: "A cool product with lights available in different colors"

  • status (string): Aktualny status produktu. Dostępne wartości to:active: Produkt jest dostępny.archived: Produkt jest zarchiwizowany.draft: Produkt jest szkicem. Przykład: "active"

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

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

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

  • vendor (string): Nazwa dostawcy produktu. Przykład: "My Vendor"

  • deleted_at (string): Data i czas 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że być używany do filtrowania i wyszukiwania produktów. Przykład: "color"

  • variants (array): Tablica wariantów produktu. Jeśli określone, 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 produktu. Jeśli określone, każdy obraz musi zawierać id, position, url, alt, width i height. Tablica variant_ids może również łączyć obrazy z określonymi 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 powiązanych z obrazem produktu.

Instrukcje krok po kroku dotyczące tworzenia źródła katalogu produktów Custom

  • Przygotuj Swoje Dane: Sformatuj odpowiedź swojego katalogu produktów zgodnie z powyższą strukturą. Upewnij się, że wszystkie wymagane pola są uwzględnione, a opcjonalne pola jak variants, images i url są dodane w razie potrzeby.

  • Utwórz Punkt Końcowy API: Użyj BirdCRM API do wysłania danych o produktach. Punkt końcowy oczekuje na odpowiedź zgodną z powyższą strukturą. Upewnij się, że dane są w prawidłowym formacie JSON.

  • Przetestuj Punkt Końcowy: Przed zintegrowaniem źródła katalogu produktów z twoim obiegiem pracy ważne jest, aby przetestować punkt końcowy API i zweryfikować, że dane są przetwarzane prawidłowo. To zapewnia, że wszystkie produkty i ich powiązane informacje (jak rodzaje i obrazy) są pobierane poprawnie.

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

Przykład Odpowiedzi 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 stworzyć i zarządzać niestandardowym źródłem katalogu produktów wewnątrz Bird. Upewnij się, że odpowiedź API spełnia wymagany format, a będziesz mógł płynnie zintegrować swoje produkty na platformie.


Połączmy Cię z ekspertem Bird.
Zobacz pełną moc Bird w 30 minut.

Przesyłając, zgadzasz się, że Bird może kontaktować się z Tobą w sprawie naszych produktów i usług.

Możesz zrezygnować z subskrypcji w dowolnym momencie. Zobacz Privacy Statement firmy Bird, aby uzyskać szczegóły dotyczące przetwarzania danych.

Company

Biuletyn

Bądź na bieżąco z Bird dzięki cotygodniowym aktualizacjom do Twojej skrzynki odbiorczej.

Połączmy Cię z ekspertem Bird.
Zobacz pełną moc Bird w 30 minut.

Przesyłając, zgadzasz się, że Bird może kontaktować się z Tobą w sprawie naszych produktów i usług.

Możesz zrezygnować z subskrypcji w dowolnym momencie. Zobacz Privacy Statement firmy Bird, aby uzyskać szczegóły dotyczące przetwarzania danych.

Company

Biuletyn

Bądź na bieżąco z Bird dzięki cotygodniowym aktualizacjom do Twojej skrzynki odbiorczej.

Połączmy Cię z ekspertem Bird.
Zobacz pełną moc Bird w 30 minut.

Przesyłając, zgadzasz się, że Bird może kontaktować się z Tobą w sprawie naszych produktów i usług.

Możesz zrezygnować z subskrypcji w dowolnym momencie. Zobacz Privacy Statement firmy Bird, aby uzyskać szczegóły dotyczące przetwarzania danych.

R

Reach

G

Grow

M

Manage

A

Automate

Company

Biuletyn

Bądź na bieżąco z Bird dzięki cotygodniowym aktualizacjom do Twojej skrzynki odbiorczej.