ConverlayConverlay

प्रतिक्रिया एकीकरण

@converlay/sdk/react प्रवेश बिंदु रिएक्ट अनुप्रयोगों के लिए एक ConverlayProvider घटक और एक useConverlay() हुक प्रदान करता है। रिएक्ट 18 या बाद के संस्करण की आवश्यकता है।

कन्वरलेप्रदाता

Converlay इंस्टेंस को अपने घटक ट्री में उपलब्ध कराने के लिए प्रदाता के साथ अपना एप्लिकेशन लपेटें।

ConverlayProvider props
<ConverlayProvider
  shopDomain="my-store.myshopify.com"  // Required
  autoPageView={true}                   // Auto page_view on mount
  debug={false}                         // Console logging
  endpoint="..."                        // Custom endpoint
  consent={{ analytics: true, marketing: true }}
>
  {children}
</ConverlayProvider>

कन्वरले() का उपयोग करें

किसी भी चाइल्ड कंपोनेंट से Converlay इंस्टेंस तक पहुंचें।

useConverlay() hook
'use client'

import { useConverlay } from '@converlay/sdk/react'

function ProductPage({ product }) {
  const { track, identify, setConsent, flush, destroy } = useConverlay()

  useEffect(() => {
    track('view_item', {
      ecommerce: {
        items: [{
          item_id: product.id,
          item_name: product.title,
          price: product.price,
          quantity: 1,
        }],
      },
    })
  }, [product.id])

  return <div>{/* ... */}</div>
}

हुक पूर्ण ConverlayInstance लौटाता है:

  • track(eventName, properties?)
  • identify(data)
  • setConsent(consent)
  • flush()
  • destroy()

फ्रेमवर्क सेटअप

Next.js ऐप राउटर

ग्राहक घटक आवश्यक है

प्रदाता को क्लाइंट घटक ('use client') में होना चाहिए। एक अलग Providers घटक बनाएं और इसे अपने रूट लेआउट में आयात करें।

Next.js App Router
// app/providers.tsx
'use client'

import { ConverlayProvider } from '@converlay/sdk/react'

export function Providers({ children }: { children: React.ReactNode }) {
  return (
    <ConverlayProvider
      shopDomain="my-store.myshopify.com"
      autoPageView={true}
    >
      {children}
    </ConverlayProvider>
  )
}

// app/layout.tsx
import { Providers } from './providers'

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        <Providers>{children}</Providers>
      </body>
    </html>
  )
}

Next.js पेज राउटर

Next.js Pages Router
// pages/_app.tsx
import { ConverlayProvider } from '@converlay/sdk/react'

export default function App({ Component, pageProps }) {
  return (
    <ConverlayProvider
      shopDomain="my-store.myshopify.com"
      autoPageView={true}
    >
      <Component {...pageProps} />
    </ConverlayProvider>
  )
}

Shopify हाइड्रोजन

Hydrogen (Remix)
// app/root.tsx
import { ConverlayProvider } from '@converlay/sdk/react'

export default function App() {
  return (
    <ConverlayProvider
      shopDomain="my-store.myshopify.com"
      autoPageView={true}
    >
      <Outlet />
    </ConverlayProvider>
  )
}

मार्ग परिवर्तन ट्रैकिंग

यदि autoPageView true है, तो SDK माउंट पर एक बार page_view सक्रिय करता है। क्लाइंट-साइड नेविगेशन (एसपीए) के लिए, एक रूट ट्रैकर जोड़ें:

Route tracker
'use client'

import { usePathname } from 'next/navigation'
import { useConverlay } from '@converlay/sdk/react'
import { useEffect } from 'react'

export function RouteTracker() {
  const pathname = usePathname()
  const { track } = useConverlay()

  useEffect(() => {
    track('page_view')
  }, [pathname])

  return null
}