---
title: "Klaviyo کنیکٹر"
description: "Tajo کے ذریعے پروفائلز، ایونٹس، فہرستیں، سیگمنٹس، اور مہم ڈیٹا کو Brevo کے ساتھ سنک کرنے کے لیے مکمل Klaviyo انٹیگریشن گائیڈ۔"
url: https://tajo.io/ur/docs/connectors/marketing/klaviyo/
markdown: https://tajo.io/ur/docs/connectors/marketing/klaviyo.md
lang: ur-PK
robots: noindex
---

ابتدائی رسائی کی درخواست کریں

اپنا پہلا نام اور دفتری ای میل پتہ درج کریں۔ ہم Tajo تک رسائی کی درخواست کی تصدیق کے لیے ایک لنک ای میل کریں گے۔

# Klaviyo کنیکٹر

کنیکٹر کی حیثیت: زیرِ تیاری تیار ہو رہا ہے۔ ابھی تصدیق نہیں ہوئی۔

| ماخذ فیلڈ | منزل فیلڈ | نمونہ قدر |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

پلیٹ فارمز کے درمیان مارکیٹنگ ڈیٹا منتقل یا ہم آہنگ کرنے کے لیے Tajo کے ذریعے Klaviyo کو Brevo سے منسلک کریں۔ متحدہ ملٹی چینل مارکیٹنگ حکمت عملی کے لیے پروفائلز، ایونٹس، فہرستیں، سیگمنٹس، فلوز، اور مہم ڈیٹا سنک کریں۔

## جائزہ

| خاصیت | قدر |
| --- | --- |
| **پلیٹ فارم** | Klaviyo |
| **زمرہ** | مارکیٹنگ |
| **سیٹ اپ کی پیچیدگی** | درمیانی |
| **آفیشل انٹیگریشن** | نہیں |
| **سنک شدہ ڈیٹا** | پروفائلز، ایونٹس، فہرستیں، سیگمنٹس، مہمات |
| **دستیاب اسکلز** | 10 |
| **API معیار** | JSON:API |

## خصوصیات

- **پروفائل سنک** - Klaviyo اور Brevo کے درمیان گاہک پروفائلز کا دو طرفہ سنک
- **ایونٹ فارورڈنگ** - آٹومیشن ٹرگرز کے لیے Klaviyo ٹریک شدہ ایونٹس کو Brevo کو فارورڈ کریں
- **فہرست منتقلی** - Klaviyo فہرستوں کو Brevo رابطہ فہرستوں میں سنک کریں
- **سیگمنٹ سنک** - Klaviyo سیگمنٹس کو Brevo فہرستوں یا سیگمنٹس کے طور پر ایکسپورٹ کریں
- **فلو ڈیٹا ایکسپورٹ** - کراس پلیٹ فارم اینالیٹکس کے لیے فلو کارکردگی ڈیٹا pull کریں
- **مہم سنک** - Klaviyo اور Brevo چینلز پر مہمات کو ہم آہنگ کریں
- **Catalog سنک** - پلیٹ فارمز کے درمیان پروڈکٹ catalogs کو مرور کریں
- **Coupon انتظام** - coupon کوڈز اور استعمال ڈیٹا سنک کریں

## شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. API رسائی کے ساتھ Klaviyo اکاؤنٹ
2. مناسب اسکوپس کے ساتھ Private API Key
3. آپ کا Klaviyo Public API Key (6-character کمپنی ID)
4. API رسائی کے ساتھ Brevo اکاؤنٹ
5. API کریڈینشلز کے ساتھ Tajo اکاؤنٹ

## تصدیق

### Private API Key

Klaviyo سرور سائڈ تصدیق کے لیے اسکوپڈ رسائی کے ساتھ private API keys استعمال کرتا ہے۔ key کو `Authorization` ہیڈر میں سیٹ کریں:

```bash
curl https://a.klaviyo.com/api/profiles/ \
  -H "Authorization: Klaviyo-API-Key your-private-api-key" \
  -H "revision: 2026-01-15"
```

### API Key اسکوپس

اپنی private key بناتے وقت اسکوپس ترتیب دیں:

| اسکوپ | رسائی | تفصیل |
| --- | --- | --- |
| `profiles` | Read/Full | رابطہ پروفائلز تک رسائی |
| `events` | Read/Full | ٹریک شدہ ایونٹس تک رسائی |
| `lists` | Read/Full | رابطہ فہرستوں تک رسائی |
| `segments` | Read | سیگمنٹس تک رسائی |
| `campaigns` | Read | مہم ڈیٹا تک رسائی |
| `metrics` | Read | metric تعریفات تک رسائی |
| `flows` | Read | فلو configurations تک رسائی |
| `catalogs` | Read | پروڈکٹ catalogs تک رسائی |

### Public API Key

کلائنٹ سائڈ ٹریکنگ کے لیے، 6-character کمپنی ID استعمال کریں:

```bash
curl -X POST "https://a.klaviyo.com/client/events/?company_id=COMPANY_ID" \
  -H "Content-Type: application/json" \
  -d '{"data": {...}}'
```

### OAuth (پارٹنر انٹیگریشنز)

Klaviyo tech پارٹنرز کے لیے OAuth کی حمایت کرتا ہے، بہتر سیکیورٹی اور شرح کی حدود فراہم کرتا ہے:

```bash
curl https://a.klaviyo.com/api/profiles/ \
  -H "Authorization: Bearer YOUR_OAUTH_TOKEN" \
  -H "revision: 2026-01-15"
```

## تشکیل

### بنیادی سیٹ اپ

```yaml
connectors:
  klaviyo:
    enabled: true
    private_api_key: "your-klaviyo-private-key"
    public_api_key: "XXXXXX"
    api_revision: "2026-01-15"

    # Data sync options
    sync:
      profiles: true
      events: true
      lists: true
      segments: true
      catalogs: false

    # Brevo list assignment
    lists:
      all_contacts: 20
      subscribers: 21
      high_value: 22
```

### پروفائل میپنگ

Klaviyo پروفائل خصوصیات کو Brevo رابطہ خصوصیات پر میپ کریں:

```yaml
profile_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone_number: SMS
  city: CITY
  region: REGION
  country: COUNTRY
  zip: ZIP
  organization: COMPANY
  title: JOB_TITLE

  # Custom properties
  lifetime_value: LTV
  total_orders: ORDER_COUNT
  last_order_date: LAST_ORDER_DATE
  preferred_channel: CHANNEL_PREF
```

### ایونٹ میپنگ

Klaviyo metrics کو Brevo ایونٹس پر میپ کریں:

```yaml
event_mapping:
  "Placed Order": "order_completed"
  "Ordered Product": "product_purchased"
  "Started Checkout": "checkout_started"
  "Added to Cart": "cart_updated"
  "Viewed Product": "product_viewed"
  "Subscribed to List": "customer_subscribed"
  "Received Email": "email_received"
  "Opened Email": "email_opened"
  "Clicked Email": "email_clicked"
```

## API اینڈ پوائنٹس

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `GET` | `/api/profiles/` | پروفائلز کی فہرست |
| `POST` | `/api/profiles/` | پروفائل بنائیں |
| `PATCH` | `/api/profiles/{id}/` | پروفائل اپ ڈیٹ کریں |
| `POST` | `/api/profile-merge/` | ڈپلیکیٹ پروفائلز ضم کریں |
| `GET` | `/api/events/` | ایونٹس کی فہرست |
| `POST` | `/api/events/` | ایونٹ بنائیں |
| `GET` | `/api/lists/` | تمام فہرستوں کی فہرست |
| `POST` | `/api/lists/{id}/relationships/profiles/` | فہرست میں پروفائلز شامل کریں |
| `GET` | `/api/segments/` | سیگمنٹس کی فہرست |
| `GET` | `/api/campaigns/` | مہمات کی فہرست |
| `GET` | `/api/flows/` | فلوز کی فہرست |
| `GET` | `/api/metrics/` | metrics کی فہرست |
| `POST` | `/api/metric-aggregates/` | metric aggregates کی کوئری |
| `GET` | `/api/catalog-items/` | catalog آئٹمز کی فہرست |

## کوڈ کی مثالیں

### Klaviyo کنیکٹر کو انیشیلائز کریں

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Klaviyo account
await tajo.connectors.connect('klaviyo', {
  privateApiKey: process.env.KLAVIYO_PRIVATE_KEY,
  publicApiKey: process.env.KLAVIYO_PUBLIC_KEY
});
```

### پروفائلز کو Brevo میں سنک کریں

```javascript
// Fetch Klaviyo profiles and sync to Brevo
const response = await fetch('https://a.klaviyo.com/api/profiles/', {
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Accept': 'application/vnd.api+json'
  }
});

const { data } = await response.json();

// Each profile follows JSON:API format
// {
//   "type": "profile",
//   "id": "01ABCDEF",
//   "attributes": {
//     "email": "jane@example.com",
//     "first_name": "Jane",
//     "last_name": "Kim",
//     "phone_number": "+15551234567",
//     "properties": { "lifetime_value": 450.00 }
//   }
// }
```

### ایونٹ بنائیں

```javascript
// Track an event in Klaviyo (forwarded to Brevo via Tajo)
await fetch('https://a.klaviyo.com/api/events/', {
  method: 'POST',
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Content-Type': 'application/vnd.api+json',
    'Accept': 'application/vnd.api+json'
  },
  body: JSON.stringify({
    data: {
      type: 'event',
      attributes: {
        metric: {
          data: { type: 'metric', attributes: { name: 'Placed Order' } }
        },
        profile: {
          data: { type: 'profile', attributes: { email: 'jane@example.com' } }
        },
        properties: {
          OrderId: 'ORD-1234',
          Value: 89.99,
          Items: [
            { ProductName: 'Widget Pro', Price: 89.99, Quantity: 1 }
          ]
        },
        value: 89.99
      }
    }
  })
});
```

### Metric Aggregates کی کوئری

```javascript
// Get aggregate metric data for reporting
await fetch('https://a.klaviyo.com/api/metric-aggregates/', {
  method: 'POST',
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Content-Type': 'application/vnd.api+json'
  },
  body: JSON.stringify({
    data: {
      type: 'metric-aggregate',
      attributes: {
        metric_id: 'METRIC_ID',
        measurements: ['count', 'sum_value'],
        interval: 'day',
        filter: ['greater-or-equal(datetime,2024-01-01)',
                 'less-than(datetime,2024-02-01)']
      }
    }
  })
});
```

## شرح کی حدود

| تصدیق | برسٹ حد | مستحکم حد |
| --- | --- | --- |
| **Private API Key** | 75 درخواستیں/سیکنڈ | 700 درخواستیں/منٹ |
| **OAuth** | 150 درخواستیں/سیکنڈ | 1,500 درخواستیں/منٹ |
| **Client API** | 100 درخواستیں/سیکنڈ | N/A |
| **بلک آپریشنز** | 10 درخواستیں/سیکنڈ | 100 درخواستیں/منٹ |

API Revision درکار

تمام Klaviyo API درخواستوں کو `revision` ہیڈر کو درست API ورژن تاریخ پر سیٹ کرنا ضروری ہے (مثلاً `2026-01-15`)۔ اس ہیڈر کے بغیر درخواستیں مسترد کر دی جائیں گی۔

## ٹربل شوٹنگ

| مسئلہ | وجہ | حل |
| --- | --- | --- |
| `400 Bad Request` | غلط یا غائب API key | تصدیق کریں کہ private API key درست ہے |
| `403 Forbidden` | ناکافی اسکوپ | چیک کریں کہ API key اسکوپس مطلوبہ اجازتوں سے ملتے ہیں |
| غائب `revision` ہیڈر | ہیڈر سیٹ نہیں | تمام درخواستوں میں `revision: 2026-01-15` شامل کریں |
| پروفائل نہیں ملا | غلط شناخت کنندہ | lookups کے لیے ای میل کے بجائے Klaviyo profile ID استعمال کریں |
| ایونٹس سنک نہیں ہو رہے | غلط metric نام | Klaviyo میں متعین کردہ exact metric ناموں سے ملائیں |
| `429 Too Many Requests` | شرح کی حد سے تجاوز | exponential backoff نافذ کریں، اعلی حدود کے لیے OAuth پر غور کریں |
| JSON:API فارمیٹ کی غلطیاں | غلط content type | Content-Type اور Accept ہیڈرز کے لیے `application/vnd.api+json` استعمال کریں |

## بہترین طرز عمل

1. **JSON:API فارمیٹ استعمال کریں** - تمام درخواست اور جواب payloads کے لیے JSON:API specification کی پیروی کریں
2. **revision ہیڈر سیٹ کریں** - ہمیشہ `revision` ہیڈر کو تازہ ترین API ورژن تاریخ کے ساتھ شامل کریں
3. **sparse fieldsets استعمال کریں** - payload سائز کم کرنے کے لیے `?fields[profile]=email,first_name` کے ساتھ صرف ضروری فیلڈز کی درخواست کریں
4. **تعلقات کا فائدہ اٹھائیں** - ایک ہی درخواست میں متعلقہ resources حاصل کرنے کے لیے JSON:API `include` پیرامیٹر استعمال کریں
5. **cursor pagination استعمال کریں** - بڑے نتیجہ سیٹس کو `page[cursor]` پیرامیٹر کے ساتھ navigate کریں
6. **بلک آپریشنز نافذ کریں** - بیچ پروفائل امپورٹس اور ایونٹ تخلیق کے لیے بلک اینڈ پوائنٹس استعمال کریں
7. **اعلی حدود کے لیے OAuth استعمال کریں** - OAuth تصدیق private keys سے 2x زیادہ شرح کی حدود فراہم کرتی ہے

## سیکیورٹی

- **Private API key اسکوپس** - فی resource قسم گرانولر Read/Full رسائی کنٹرول
- **OAuth سپورٹ** - پارٹنر انٹیگریشنز کے لیے محفوظ token پر مبنی تصدیق
- **Public key isolation** - کلائنٹ سائڈ keys صرف create-only آپریشنز تک محدود
- **TLS 1.2+** - تمام API مواصلات ٹرانزٹ میں انکرپٹڈ
- **SOC 2 Type II** - Klaviyo SOC 2 Type II سرٹیفائیڈ ہے
- **GDPR کمپلائنس** - پروفائل حذف درخواستوں کے لیے Data Privacy API

## متعلقہ وسائل

- [Brevo کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/brevo)
- [Google Ads کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/google-ads)
- [Meta Ads کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/meta-ads)
- [گاہک سنک اسکل](https://tajo.io/ur/docs/skills/data-sync/customer-sync)