Tajo memindahkan data Shopify ke Brevo dengan dua cara. Aplikasi Shopify Tajo memproses webhook Shopify begitu tiba. Aturan sinkronisasi disetujui manusia, satu arah, berjalan dalam batch, dan dicatat dari awal hingga akhir. Artikel ini menjelaskan keduanya, apa yang tidak termasuk di dalamnya, dan beberapa hal yang ditulis kembali oleh aplikasi Shopify Tajo ke Shopify.
Pemeriksaan cepat Artikel ini mengasumsikan Anda telah menghubungkan Shopify dan Brevo serta mempublikasikan setidaknya satu aturan sinkronisasi. Jika belum, mulailah dengan menghubungkan Tajo ke Shopify.
Saat Event Terjadi: Aplikasi Shopify Tajo
Aplikasi Shopify Tajo berlangganan webhook Shopify dan memproses masing-masing begitu tiba. Perubahan pelanggan dan produk menunggu sekitar empat detik terlebih dahulu. Pelanggan, pesanan, checkout, produk, koleksi, dan tingkat stok sampai ke Brevo dengan cara ini, bersama event seperti order_paid dan cart_abandoned. Panduan integrasi Shopify mencantumkan setiap topik dan apa yang ditulisnya ke Brevo.
Bentuk Sebuah Aturan Sinkronisasi
Sebuah aturan sinkronisasi adalah definisi yang telah ditinjau dan disetujui tentang apa yang berpindah dan bagaimana caranya. Agen membangunnya dari deskripsi Anda, dan seseorang menyetujuinya. Sebuah aturan memiliki empat bagian yang dapat Anda periksa di halamannya di bawah Connections > Syncs and mappings:
| Bagian | Fungsinya |
|---|---|
| Pemetaan kolom | Setiap kolom sumber, kolom Brevo tempat kolom itu ditulis, dan transformasi apa pun di antaranya |
| Ekspresi filter | Dievaluasi per catatan; catatan yang tidak cocok akan dilewati |
| Cursor | Melacak sejauh mana sinkronisasi telah berjalan, sehingga setiap proses melanjutkan dari titik terakhir proses sebelumnya |
| Riwayat proses | Setiap proses, dengan catatan yang dibaca, ditulis, dan gagal, beserta durasi dan status |
Aturan sinkronisasi memindahkan data satu arah: dari sumber Anda ke Brevo. Aturan ini tidak pernah menulis ke Shopify. Aplikasi Shopify Tajo memang menulis beberapa hal kembali ke Shopify, seperti pembatalan persetujuan dan tag tingkat loyalitas. Penjelasan izin Shopify mencantumkan setiap penulisan dan kapan terjadinya.
Kapan Aturan Sinkronisasi Berjalan
Aturan sinkronisasi berjalan dalam batch. Aturan sinkronisasi kontak berjalan setiap 15 menit secara default. Aturan Shopify orders → Brevo orders yang aktif dan sudah dipublikasikan juga berjalan setiap 15 menit, tetapi hanya dengan filter opt-in pemasaran pembeli dari template. Aturan yang filternya sudah diedit hanya berjalan saat Anda memulainya. Proses terjadwal pertama aturan pesanan dimulai beberapa menit sebelum saat itu dan tidak mengirim pesanan yang lebih lama. Setiap proses berikutnya mengirim pesanan yang diperbarui sejak proses sebelumnya. Pesanan lama masuk ke Brevo hanya saat Anda menjalankan aturan sendiri. Halaman aturan yang aktif memiliki tombol Test run (1 batch), dan agen Sync Operator menjalankan aturan aktif saat Anda memintanya. Proses batch inilah yang membuat setiap penulisan dapat ditinjau, dianggarkan, dan dapat diatribusikan ke proses tertentu.
Setiap proses membaca catatan baru dan yang berubah sejak cursor, menerapkan filter, memetakan kolom, dan menulis ke Brevo. Catatan proses menunjukkan dengan tepat berapa banyak catatan yang dibaca, ditulis, dan gagal.
Jaminan Tata Kelola
Persetujuan (consent) default menolak
Aturan yang menulis data pribadi ke Brevo tidak dapat dipublikasikan tanpa filter persetujuan dan supresi. Saat proses berjalan, kontak yang ditulis ke audiens pemasaran tanpa persetujuan yang dapat dibuktikan akan ditolak. Ketika persetujuan tidak dapat dipastikan, Tajo menolak penulisan alih-alih menebak. Mode kegagalannya selalu “terlalu berhati-hati”, tidak pernah “terlalu banyak mengirim”.
Proses Bersifat Idempoten
Setiap penulisan membawa kunci yang diturunkan dari catatan sumber. Kunci ini berupa hash, sehingga tidak memuat data pribadi. Menjalankan ulang sinkronisasi atas catatan yang sama, setelah kegagalan, jeda, atau secara manual, tidak menciptakan penulisan ganda.
Semuanya Diaudit
Publikasi sebuah aturan, persetujuan yang dibatalkan, dan jeda otomatis dicatat di Activity. Setiap keputusan persetujuan membawa alasan tertulis. Setiap proses dicatat dalam riwayat proses aturan. Persetujuan yang mengesahkan sebuah publikasi terikat pada digest dari aturan persis yang dipratinjau. Mengedit aturan mengembalikannya ke draf dan membuat persetujuan tersebut tidak berlaku, sehingga yang berjalan selalu adalah apa yang telah disahkan.
Kegagalan Menjeda Aturan
Jika lima proses berturut-turut gagal, circuit breaker secara otomatis menjeda aturan dan menampilkan kesalahan terakhir di halaman aturan. Perbaiki penyebabnya, lalu publikasikan ulang untuk melanjutkan. Proses yang gagal sebagian melaporkan jumlah kegagalannya, sehingga Anda dapat melihat dengan tepat apa yang tidak berhasil.
Bagaimana Berhenti Berlangganan Dihormati
- Ketika kontak berhenti berlangganan melalui tautan di footer email Brevo, penolakan tersebut dicatat pada kontak, dan Brevo mengecualikan mereka dari kampanye berikutnya.
- Dalam sinkronisasi pelanggan secara batch, aplikasi Shopify Tajo membandingkan waktu persetujuan di Shopify dengan waktu berhenti berlangganan di Brevo dan mempertahankan yang lebih baru.
- Perubahan persetujuan yang datang dari Shopify sebagai webhook ditulis ke Brevo sebagaimana dilaporkan Shopify.
- Jika kontak tersebut berlangganan di Shopify, aplikasi Shopify Tajo menandainya berhenti berlangganan di Shopify juga. Event Brevo hanya memindahkan pelanggan dari berlangganan ke berhenti berlangganan. Aplikasi ini tidak pernah membuat siapa pun berlangganan, jadi berlangganan di Brevo tidak mengubah Shopify.
Data Apa yang Tersedia
Aplikasi Shopify Tajo mengirim kontak, pesanan, event pesanan dan keranjang, katalog produk, serta stok. Apa yang dikirim sebuah aturan sinkronisasi bergantung pada pemetaan kolomnya. Untuk pelanggan Shopify, templat memetakan kolom identitas, total pengeluaran, jumlah pesanan, tag, dan opt-in ke atribut kontak Brevo yang dapat Anda gunakan dalam segmen dan kampanye. Pemetaan pasti untuk ruang kerja Anda tidak disembunyikan dalam sebuah deskripsi: buka aturan sinkronisasi dan baca tabel pemetaan kolom. Tabel itulah jawaban yang berlaku untuk pertanyaan “apa yang disinkronkan”.
Yang Belum Dilakukan Tajo Hari Ini
Bersikap jelas soal batasan ini lebih penting daripada daftar fitur yang panjang:
- Tidak ada aturan sinkronisasi dua arah. Aturan sinkronisasi hanya menulis ke Brevo. Penulisan oleh aplikasi Shopify sendiri ke Shopify (pembatalan persetujuan, metafield keterlibatan dan loyalitas Brevo, tag tingkat loyalitas) tercantum di penjelasan izin Shopify.
- Tidak ada aturan sinkronisasi real-time. Aturan sinkronisasi berjalan dalam batch. Hanya sinkronisasi webhook dari aplikasi Shopify Tajo yang bekerja begitu event tiba.
- Tidak ada tombol stok kembali tersedia. Aplikasi menjaga stok produk tetap mutakhir di Brevo dan mengirim event
back_in_stockkepada pembeli yang meminta diberi tahu. Permintaan itu harus berasal dari storefront Anda: aplikasi tidak menambahkan tombol “Notify me” ke tema Anda.
Jika salah satu batasan ini menghalangi kasus penggunaan Anda, sampaikan ke tim; prioritas akses awal dibentuk justru oleh masukan semacam ini.
Di Mana Melihat Data Anda
- Di Tajo: buka aturan sinkronisasi di bawah Connections > Syncs and mappings untuk riwayat proses, posisi cursor, dan jumlah per proses. Activity mencatat publikasi dan jeda otomatis.
- Di Brevo: buka Contacts dan periksa atribut kontak mana pun untuk memastikan kolom yang dipetakan terisi. Bangun segmen berdasarkan atribut tersebut untuk penargetan.
Pemecahan Masalah
- Kontak tidak muncul di Brevo: periksa proses terbaru aturan untuk kegagalan dan statusnya (aturan yang dijeda tidak berjalan). Lihat kontak hilang di Brevo.
- Proses gagal berulang kali: circuit breaker akan menjeda aturan dan menampilkan kesalahan terakhir. Lihat data tidak sinkron.
- Kontak duplikat: penulisan bersifat idempoten per catatan sumber, tetapi duplikat yang sudah ada sebelumnya di Brevo tetap ada. Lihat kontak duplikat.
Pertanyaan Umum
Bisakah saya mempercepat sinkronisasi? Halaman aturan yang aktif memiliki tombol Test run (1 batch). Untuk perubahan saat terjadi, sinkronisasi webhook dari aplikasi Shopify Tajo sudah mencakup pelanggan, pesanan, checkout, produk, dan stok.
Apa yang terjadi jika proses gagal di tengah jalan? Proses melaporkan jumlah kegagalannya, cursor hanya maju sejauh yang telah diproses, dan proses berikutnya akan mencakup ulang area itu dengan aman; kunci idempotensi mencegah duplikasi.
Bisakah saya mengubah apa yang disinkronkan? Ya. Minta agen untuk mengubah pemetaan kolom atau filter aturan. Perubahan ini mengembalikan aturan ke draf, dan aturan harus melalui pratinjau dan persetujuan lagi sebelum berjalan kembali.
Mengapa aturan saya menjeda dirinya sendiri? Kegagalan proses yang berturut-turut memicu circuit breaker. Halaman aturan menunjukkan jumlah kegagalan dan kesalahan terakhir; perbaiki masalahnya dan publikasikan ulang.
Artikel Terkait
- Hubungkan Tajo ke Shopify
- Dasar-dasar segmentasi
- Pemecahan masalah: data tidak sinkron
- Pemecahan masalah: kontak hilang di Brevo