ConverlayConverlay

उपयोगकर्ताओं की पहचान करना

वर्तमान विज़िटर को ग्राहक डेटा के साथ जोड़ने के लिए converlay.identify() का उपयोग करें। यह Meta CAPI और TikTok इवेंट एपीआई जैसे विज्ञापन प्लेटफार्मों पर मैच दरों में सुधार करता है।

API

identify()
converlay.identify({
  customerId: 'cust_12345',
  email: 'jane@example.com',
  phone: '+15551234567',
  firstName: 'Jane',
  lastName: 'Doe',
})

डेटा फ़ील्ड को पहचानें

मैदानप्रकारविवरण
customerIdstringआपकी आंतरिक ग्राहक आईडी
emailstringग्राहक का ईमेल पता
phonestringफ़ोन नंबर (ई.164 प्रारूप अनुशंसित)
firstNamestringग्राहक का पहला नाम
lastNamestringग्राहक का अंतिम नाम

पीआईआई हैशिंग

सभी व्यक्तिगत पहचान योग्य जानकारी (ईमेल, फोन, नाम) को सादे पाठ में Converlay संग्रह समापन बिंदु पर भेजा जाता है, फिर विज्ञापन प्लेटफ़ॉर्म पर अग्रेषित करने से पहले सर्वर पर SHA-256 के साथ हैश किया जाता है। हैशिंग से पहले देश-विशिष्ट सामान्यीकरण (लोअरकेसिंग, व्हाइटस्पेस ट्रिमिंग, फ़ोन फ़ॉर्मेटिंग) लागू किया जाता है।

कब कॉल करना है इसकी पहचान करें

  • लॉगिन के बाद - जैसे ही ग्राहक प्रमाणित करता है
  • चेकआउट पर - जब शिपिंग/बिलिंग जानकारी उपलब्ध हो
  • ऑन अकाउंट पेज - जब ग्राहक अपनी प्रोफ़ाइल देखता या अपडेट करता है

पहचान डेटा वर्तमान सत्र के लिए बना रहता है। बाद की track() कॉल में पहचाने गए उपयोगकर्ता का डेटा स्वचालित रूप से शामिल होगा।

उदाहरण

लॉगइन करने के बाद

typescript
async function handleLogin(email, password) {
  const user = await api.login(email, password)

  // Identify after login
  converlay.identify({
    customerId: user.id,
    email: user.email,
    firstName: user.firstName,
    lastName: user.lastName,
  })
}

चेकआउट पूरा होने पर

typescript
function onCheckoutComplete(order) {
  // Identify + track purchase
  converlay.identify({
    customerId: order.customerId,
    email: order.email,
    phone: order.phone,
    firstName: order.shippingAddress.firstName,
    lastName: order.shippingAddress.lastName,
  })

  converlay.track('purchase', {
    ecommerce: {
      transaction_id: order.id,
      value: order.total,
      currency: order.currency,
      items: order.lineItems.map(item => ({
        item_id: item.variantId,
        item_name: item.title,
        price: item.price,
        quantity: item.quantity,
      })),
    },
  })
}