G

G

M

M

Katalog Produk Kustom Sumber

Bawa katalog produk Anda sendiri

Ikhtisar

Ikhtisar

Ikhtisar

Di Bird, Anda dapat membuat sumber katalog produk kustom menggunakan titik akhir API. Respons API harus mematuhi format tertentu yang mencakup detail produk, varian, gambar, dan lainnya. Di bawah ini adalah panduan tentang cara menyusun data katalog produk Anda dan cara membuatnya menggunakan API.

Membuat Katalog Produk Kustom

Anda dapat menavigasi ke bagian Pemasaran di Platform Bird dan mengikuti langkah-langkah ini:

  • Navigasi ke Produk > Klik pada Buat Sumber Katalog seperti yang ditunjukkan di bawah



  • Berikan nama dan URL API Anda yang memiliki json untuk produk Anda. Anda dapat merujuk ke format json di bagian berikut dari artikel ini. Anda juga dapat mendefinisikan metode otentikasi jika Anda mau.

  • Aktifkan Pembaruan Otomatis yang memperbarui katalog jika API Anda diperbarui.


Setelah ini diatur, Anda akan mulai melihat Produk muncul dan Anda akan dapat menggunakan produk ini dalam template email Anda.

Anda dapat menavigasi ke bagian Pemasaran di Platform Bird dan mengikuti langkah-langkah ini:

  • Navigasi ke Produk > Klik pada Buat Sumber Katalog seperti yang ditunjukkan di bawah



  • Berikan nama dan URL API Anda yang memiliki json untuk produk Anda. Anda dapat merujuk ke format json di bagian berikut dari artikel ini. Anda juga dapat mendefinisikan metode otentikasi jika Anda mau.

  • Aktifkan Pembaruan Otomatis yang memperbarui katalog jika API Anda diperbarui.


Setelah ini diatur, Anda akan mulai melihat Produk muncul dan Anda akan dapat menggunakan produk ini dalam template email Anda.

Anda dapat menavigasi ke bagian Pemasaran di Platform Bird dan mengikuti langkah-langkah ini:

  • Navigasi ke Produk > Klik pada Buat Sumber Katalog seperti yang ditunjukkan di bawah



  • Berikan nama dan URL API Anda yang memiliki json untuk produk Anda. Anda dapat merujuk ke format json di bagian berikut dari artikel ini. Anda juga dapat mendefinisikan metode otentikasi jika Anda mau.

  • Aktifkan Pembaruan Otomatis yang memperbarui katalog jika API Anda diperbarui.


Setelah ini diatur, Anda akan mulai melihat Produk muncul dan Anda akan dapat menggunakan produk ini dalam template email Anda.

Format API Sumber Katalog Produk

Respons dari endpoint API harus berupa array objek produk, masing-masing berisi beberapa field. Berikut adalah struktur dan contoh nilai untuk setiap field:

Field yang Diperlukan:

  • id (string): Pengidentifikasi unik untuk produk.Contoh: "8890650190078"

  • name (string): Nama produk.Contoh: "Produk Uji Saya"

  • description (string): Deskripsi produk.Contoh: "Produk keren dengan lampu tersedia dalam berbagai warna"

  • status (string): Status terkini dari produk. Nilai yang valid adalah:active: Produk sedang aktif dan tersedia.archived: Produk diarsipkan.draft: Produk adalah draft.Contoh: "active"

  • created_at (string): Tanggal dan waktu ketika produk dibuat, dalam format ISO-8601.Contoh: "2022-05-25T10:55:16+02:00"

  • updated_at (string): Tanggal dan waktu ketika produk terakhir diperbarui, dalam format ISO-8601.Contoh: "2022-05-25T10:55:16+02:00"

  • published_at (string): Tanggal dan waktu ketika produk diterbitkan, dalam format ISO-8601.Contoh: "2022-05-25T10:55:16+02:00"

  • vendor (string): Nama vendor produk.Contoh: "Vendor Saya"

  • deleted_at (string): Tanggal dan waktu ketika produk dihapus (jika berlaku), dalam format ISO-8601.Contoh: "2022-05-25T10:55:16+02:00" atau string kosong "" jika produk belum dihapus.

Field Opsional:

  • url (string): URL produk.Contoh: "https://www.myproduct.com"

  • type (string): Tipe produk, yang dapat digunakan untuk memfilter dan mencari produk.Contoh: "color"

  • variants (array): Sebuah array varian produk. Jika ditentukan, setiap varian harus mencakup id, name, sku, dan harga.

Contoh:

[
  {
    "id": "44775891271934",
    "name": "Colorful",
    "price": 13.37,
    "sku": "BIRD",
    "price_currency": "EUR"
  }
]
  • images (array): Sebuah array gambar produk. Jika ditentukan, setiap gambar harus mencakup id, position, url, alt, width, dan height. Array variant_ids juga dapat menghubungkan gambar ke varian produk tertentu.

[
  {
    "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): Sebuah array id varian yang terkait dengan gambar produk.

Petunjuk Langkah-Demi-Langkah untuk Membuat Sumber Katalog Produk Kustom

  • Siapkan Data Anda: Format respons katalog produk Anda sesuai dengan struktur yang diuraikan di atas. Pastikan semua field yang diperlukan disertakan, dan field opsional seperti variants, images, dan url ditambahkan sesuai kebutuhan.

  • Buat Endpoint API: Gunakan API BirdCRM untuk mengirim data produk. Endpoint mengharapkan respons yang mengikuti struktur yang disebutkan di atas. Pastikan bahwa data berada dalam format JSON yang valid.

  • Uji Endpoint: Sebelum mengintegrasikan sumber katalog produk ke dalam alur kerja Anda, penting untuk menguji endpoint API untuk memverifikasi bahwa data sedang diproses dengan benar. Ini memastikan bahwa semua produk dan informasi terkait mereka (seperti variasi dan gambar) ditarik dengan benar.

  • Monitor dan Pemeliharaan: Setelah sumber katalog produk dibuat, Anda dapat memantau kinerjanya melalui fitur pelaporan BirdCRM. Jika Anda perlu memperbarui detail produk atau menambahkan produk baru, cukup perbarui data menggunakan API.

Contoh Respons 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]
      }
    ]
  }
]


Dengan mengikuti langkah-langkah ini, Anda dapat membuat dan mengelola sumber katalog produk kustom dalam Bird. Pastikan bahwa respons API mengikuti format yang diperlukan, dan Anda akan dapat mengintegrasikan produk Anda ke dalam platform dengan lancar.


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

Platform AI-native lengkap yang dapat berkembang seiring dengan bisnis Anda.

© 2025 Burung

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

Platform AI-native lengkap yang dapat berkembang seiring dengan bisnis Anda.

© 2025 Burung