EcomSolveBD

· বাংলাদেশ সময়

Laravel ইন্টিগ্রেশন

Laravel শপ EcomSolveBD-তে কানেক্ট করুন

মালিক ড্যাশবোর্ডে Custom / Headless কানেক্ট করেন। ডেভেলপার Laravel প্যাকেজ বসান। পাঁচ ধাপেই শেষ।

কানেক্ট করলে যা পাবেন

অর্ডার এক জায়গায়

Laravel চেকআউটের অর্ডার ড্যাশবোর্ডে আসবে — কনফার্ম, কুরিয়ার, প্রফিট একসাথে।

ভিজিটর ও অ্যাট্রিবিউশন

কে কোন অ্যাড থেকে এসেছে — ট্র্যাকিং অটো চলে।

অ্যাডস ও GA4

Meta / TikTok / Google Ads পাঠানো SaaS থেকে। GA4-এ শুধু Measurement ID।

স্ট্যাটাস ও ফিড

স্ট্যাটাস দুই দিকে সিঙ্ক। Meta / TikTok / Google ক্যাটালগ XML রেডি।

ধাপে ধাপে সেটআপ

১–৩ আপনি করতে পারবেন। ৪ ডেভেলপার। ৫ একসাথে টেস্ট।

  1. অ্যাকাউন্ট খুলুন

    আপনি
    • ecomsolvebd.com এ রেজিস্টার / লগইন করুন
    • ড্যাশবোর্ডে ঢুকুন
  2. Custom / Headless → Laravel

    আপনি
    • Integrations → Custom / Headless খুলুন
    • Laravel package সিলেক্ট করুন
    • শপ URL দিন — যেমন https://myshop.com
    • চাইলে GA4 ID (G-…) দিন
    • Connect Laravel চাপুন

    সফল হলে Tracking Merchant ID ও Webhook Secret দেখাবে। Secret এখনই কপি করে রাখুন।

  3. ডেভেলপারকে পাঠান

    আপনি
    • Tracking Merchant ID
    • Webhook Secret
    • লাইভ শপ URL
  4. সাইটে প্যাকেজ বসান

    ডেভেলপার
    • composer require ecomsolvebd/laravel-tracker
    • php artisan vendor:publish --tag=ecomsolvebd-config
    • Blade <head>-এ @ecomsolvebdGtag ও @ecomsolvebdTracker
    • .env-এ MERCHANT_KEY + WEBHOOK_SECRET (+ API_BASE)
    • চেকআউট সফল হলে OrderWebhookPoster::postOrder()

    প্যাকেজ ≥ v1.0.8 সুপারিশ। স্ট্যাটাস, ফিড, ফানেল অটো-বাইন্ড সব প্যাকেজেই থাকে।

    ECOMSOLVEBD_API_BASE=https://api.ecomsolvebd.com
    ECOMSOLVEBD_MERCHANT_KEY=…
    ECOMSOLVEBD_WEBHOOK_SECRET=…
    ECOMSOLVEBD_GA4_MEASUREMENT_ID=G-…   # optional
    
    # Blade <head>
    @ecomsolvebdGtag
    @ecomsolvebdTracker
  5. টেস্ট করুন

    দুজনে
    • শপ হোম খুলে Events-এ page_view দেখুন
    • টেস্ট অর্ডার → Dashboard → Orders
    • SaaS-এ স্ট্যাটাস বদলান → Laravel অ্যাডমিনে চেক
    • https://yoursite.com/feed/products.xml খুলুন

আরও ফিচার

অর্ডার স্ট্যাটাস

EcomSolveBD ও Laravel অ্যাডমিন একে অপরের সাথে স্ট্যাটাস সিঙ্ক করে।

  • · SaaS → Laravel: অটো (প্যাকেজ)
  • · Laravel অ্যাডমিন → SaaS: অটো (v1.0.8+)
  • · Dashboard Create Order → Laravel অ্যাডমিন: v1.0.9+ (`POST /ecomsolvebd/order-create`)
  • · ম্যাপ: pending · confirmed · delivered · cancelled · returned

প্রোডাক্ট ফিড

চারটা পাবলিক XML — Woo-এর মতো। প্রোডাক্ট এডিট Laravel-এই থাকে।

  • /feed/products.xmlEcomSolveBD ক্যাটালগ
  • /feed/facebook.xmlMeta ক্যাটালগ
  • /feed/tiktok.xmlTikTok ক্যাটালগ (RSS/XML)
  • /feed/google.xmlGoogle Merchant

First-party ট্র্যাকিং

ব্রাউজার ইভেন্ট আপনার ডোমেইন দিয়ে যায় — অ্যাড ব্লকারে কম হারায়।

  • · ডিফল্ট Auto: /ecomsolvebd/collect প্রক্সি
  • · Integrations → Laravel → CNAME সেট → Verify DNS
  • · Verify হলে tracking.yourdomain.com ব্যবহার হয়

ফানেল ইভেন্ট

প্যাকেজ v1.0.8+: সাধারণ শপে অনেক ইভেন্ট অটো। কাস্টম checkout-এ এক লাইন helper যথেষ্ট।

কীইভেন্টকে
পেজ ভিউpage_viewঅটো
প্রোডাক্ট / কার্ট / চেকআউট শুরুview_item · add_to_cart · view_cart · begin_checkoutঅটো (কাস্টম শপে ম্যানুয়াল)
চেকআউট ফর্ম ও ফিল্ডcheckout_form_* · phone_number_added · …Helper একবার
অর্ডার (অ্যাডস Purchase নয়)server webhookLaravel সার্ভার অটো
// কাস্টম চেকআউট — একবার
window.esbBindCheckoutForm('#checkout-form');

// বা ইনপুটে
// data-esb-track="phone_number_added"
window.esbTrack?.('add_to_cart', {
  ecommerce: {
    currency: 'BDT',
    value: 999,
    items: [{ item_id: '1', item_name: 'Item', price: 999, quantity: 1 }],
  },
});

অ্যাডস Purchase ব্রাউজার থেকে নয় — অর্ডার webhook → SaaS-এ ship / Send purchase।

সাধারণ প্রশ্ন

কোডিং জানি না — পারব?
হ্যাঁ। ধাপ ১–৩ আপনি করবেন। ধাপ ৪ ডেভেলপারকে দিবেন।
প্রোডাক্ট EcomSolveBD থেকে এডিট হবে?
না। প্রোডাক্ট Laravel অ্যাডমিনেই ম্যানেজ করবেন।
অর্ডার কীভাবে আসে?
চেকআউট সফল হলে সার্ভার webhook — ব্রাউজার purchase ইভেন্ট নয়। Dashboard Create Order (v1.0.9+) Laravel অ্যাডমিনেও যায়।
Secret হারিয়ে গেলে?
Integrations → Laravel আবার Connect করুন, নতুন Secret কপি করুন।

সমস্যা হলে

page_view আসছে না

@ecomsolvebdTracker আছে কিনা, Merchant Key মিলেছে কিনা, অ্যাড ব্লকার বন্ধ করে দেখুন।

অর্ডার আসছে না

আগে Connect Laravel করুন। Secret মিলিয়ে webhook লগ চেক করুন।

স্ট্যাটাস আপডেট হচ্ছে না

base URL HTTPS সঠিক কিনা, প্যাকেজ আপডেট, order_number মিলছে কিনা দেখুন।

সাহায্য লাগলে

শপ URL + স্ক্রিনশট + এরর মেসেজ পাঠান।

· বাংলাদেশ সময়