Reach

Grow

Manage

Automate

Reach

Grow

Manage

Automate

G

G

M

M

Sumber Katalog Produk Kustom

Masukkan katalog produk Anda sendiri

Ikhtisar

Ikhtisar

Ikhtisar

Di Bird, Anda dapat membuat sumber katalog produk kustom menggunakan endpoint API. Respons API harus mengikuti format khusus yang mencakup detail produk, varian, gambar, dan lain-lain. Di bawah ini adalah panduan tentang cara menyusun data katalog produk Anda dan cara membuatnya menggunakan API.

Membuat Custom Product Catalog

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

  • Navigate to Products > Click on Create Catalog Source seperti yang ditunjukkan di bawah ini



  • Provide a name and your API URL yang memiliki json untuk produk Anda. Anda dapat merujuk pada format json di bagian berikut dari artikel ini. Anda juga dapat menentukan metode otentikasi jika Anda mau.

  • Aktifkan Auto-refresh yang memperbarui katalog jika API Anda diperbarui.


Setelah ini disiapkan, 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 berikut:

  • Navigate to Products > Click on Create Catalog Source seperti yang ditunjukkan di bawah ini



  • Provide a name and your API URL yang memiliki json untuk produk Anda. Anda dapat merujuk pada format json di bagian berikut dari artikel ini. Anda juga dapat menentukan metode otentikasi jika Anda mau.

  • Aktifkan Auto-refresh yang memperbarui katalog jika API Anda diperbarui.


Setelah ini disiapkan, 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 berikut:

  • Navigate to Products > Click on Create Catalog Source seperti yang ditunjukkan di bawah ini



  • Provide a name and your API URL yang memiliki json untuk produk Anda. Anda dapat merujuk pada format json di bagian berikut dari artikel ini. Anda juga dapat menentukan metode otentikasi jika Anda mau.

  • Aktifkan Auto-refresh yang memperbarui katalog jika API Anda diperbarui.


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

Product Catalog Sumber API Format

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

Bidang Wajib:

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

  • name (string): Nama produk. Contoh: "My Test Product"

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

  • status (string): Status produk saat ini. Nilai yang valid adalah:active: Produk saat ini tayang dan tersedia.archived: Produk diarsipkan.draft: Produk dalam bentuk 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 penjual produk. Contoh: "My Vendor"

  • 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.

Bidang Opsional:

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

  • type (string): Jenis produk, yang dapat digunakan untuk pemfilteran dan pencarian produk. Contoh: "color"

  • variants (array): Array dari 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): Array dari 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): Array dari id varian yang berhubungan dengan gambar produk.

Instruksi 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 bidang yang diperlukan disertakan, dan bidang opsional seperti variants, images, dan url ditambahkan sesuai kebutuhan.

  • Buat API Endpoint: Gunakan BirdCRM API untuk mengirim data produk. Endpoint ini mengharapkan respons yang sesuai dengan struktur yang disebutkan di atas. Pastikan data 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 diproses dengan benar. Ini memastikan bahwa semua produk dan informasi terkaitnya (seperti varian dan gambar) ditarik dengan benar.

  • Pantau dan Pertahankan: 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 khusus dalam Bird. Pastikan bahwa respons API memenuhi format yang diperlukan, dan Anda akan dapat mengintegrasikan produk Anda ke dalam platform dengan lancar.


Mari hubungkan Anda dengan pakar Bird.
Lihat kekuatan penuh dari Bird dalam 30 menit.

Dengan mengirimkan, Anda setuju Bird dapat menghubungi Anda tentang produk dan layanan kami.

Anda dapat berhenti berlangganan kapan saja. Lihat Pernyataan Privasi Bird untuk detail tentang pemrosesan data.

Perusahaan

Newsletter

Tetap terinformasi dengan Bird melalui pembaruan mingguan ke kotak masuk Anda.

Mari hubungkan Anda dengan pakar Bird.
Lihat kekuatan penuh dari Bird dalam 30 menit.

Dengan mengirimkan, Anda setuju Bird dapat menghubungi Anda tentang produk dan layanan kami.

Anda dapat berhenti berlangganan kapan saja. Lihat Pernyataan Privasi Bird untuk detail tentang pemrosesan data.

Perusahaan

Newsletter

Tetap terinformasi dengan Bird melalui pembaruan mingguan ke kotak masuk Anda.

Mari hubungkan Anda dengan pakar Bird.
Lihat kekuatan penuh dari Bird dalam 30 menit.

Dengan mengirimkan, Anda setuju Bird dapat menghubungi Anda tentang produk dan layanan kami.

Anda dapat berhenti berlangganan kapan saja. Lihat Pernyataan Privasi Bird untuk detail tentang pemrosesan data.

R

Reach

G

Grow

M

Manage

A

Automate

Perusahaan

Newsletter

Tetap terinformasi dengan Bird melalui pembaruan mingguan ke kotak masuk Anda.