--- title: "Meta Ads کنیکٹر" description: "Tajo کے ذریعے Facebook اور Instagram اشتہاری آڈیئنسز، conversions، اور مہم ڈیٹا کو Brevo کے ساتھ سنک کرنے کے لیے مکمل Meta Ads انٹیگریشن گائیڈ۔" url: https://tajo.io/ur/docs/connectors/marketing/meta-ads/ markdown: https://tajo.io/ur/docs/connectors/marketing/meta-ads.md lang: ur-PK robots: noindex --- ابتدائی رسائی کی درخواست کریں اپنا پہلا نام اور دفتری ای میل پتہ درج کریں۔ ہم Tajo تک رسائی کی درخواست کی تصدیق کے لیے ایک لنک ای میل کریں گے۔ # Meta Ads کنیکٹر کنیکٹر کی حیثیت: منصوبہ بند ابھی تیار نہیں ہوا۔ Tajo آج یہ کنیکٹر نہیں چلاتا۔ | ماخذ فیلڈ | منزل فیلڈ | نمونہ قدر | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Custom Audiences کو ہم آہنگ کرنے، Conversions API کے ذریعے conversion ایونٹس امپورٹ کرنے، اور paid سوشل اشتہارات کو lifecycle مارکیٹنگ آٹومیشن سے جوڑنے کے لیے Tajo کے ذریعے Meta Ads (Facebook اور Instagram) کو Brevo سے منسلک کریں۔ ## جائزہ | خاصیت | قدر | | --- | --- | | **پلیٹ فارم** | Meta Ads (Facebook, Instagram, Messenger, WhatsApp) | | **زمرہ** | مارکیٹنگ | | **سیٹ اپ کی پیچیدگی** | جدید | | **آفیشل انٹیگریشن** | نہیں | | **سنک شدہ ڈیٹا** | آڈیئنسز، Conversions، مہمات، لیڈز | | **دستیاب اسکلز** | 8 | | **API ورژن** | v25.0 (Graph API) | ## خصوصیات - **Custom Audience سنک** - Brevo رابطہ فہرستوں کو Meta Custom Audiences کے طور پر اپ لوڈ کریں - **Conversions API (CAPI)** - درست attribution کے لیے سرور سائڈ conversion ایونٹس بھیجیں - **Lead form سنک** - Facebook Lead Ads سبمیشنز کو براہ راست Brevo رابطوں میں امپورٹ کریں - **مہم insights** - اشتہار کی کارکردگی کے میٹرکس کو Tajo dashboards میں pull کریں - **Lookalike audiences** - سنک شدہ Brevo سیگمنٹس سے Lookalike Audiences بنائیں - **Catalog سنک** - dynamic product ads کے لیے پروڈکٹ catalogs سنک کریں - **ملٹی پلیٹ فارم** - ایک واحد انٹیگریشن Facebook, Instagram, Messenger, اور WhatsApp اشتہارات کو cover کرتا ہے ## شرائط شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے: 1. Meta Business Manager اکاؤنٹ 2. Marketing API رسائی کے ساتھ Facebook ایپ 3. مناسب اجازتوں کے ساتھ System User 4. `ads_management` اور `ads_read` اجازتوں کے ساتھ Access Token 5. API رسائی کے ساتھ Brevo اکاؤنٹ 6. API کریڈینشلز کے ساتھ Tajo اکاؤنٹ ## تصدیق ### System User Access Token Meta سرور سے سرور انٹیگریشنز کے لیے System User tokens استعمال کرنے کی سفارش کرتا ہے۔ یہ tokens میعاد ختم نہیں ہوتے۔ ```bash # Required permissions for System User ads_management ads_read business_management leads_retrieval pages_read_engagement catalog_management ``` ### App سطح کی تصدیق ```bash curl -G "https://graph.facebook.com/v25.0/act_AD_ACCOUNT_ID/campaigns" \ -d "access_token=SYSTEM_USER_ACCESS_TOKEN" \ -d "fields=name,status,objective" ``` ## تشکیل ### بنیادی سیٹ اپ ```yaml connectors: meta_ads: enabled: true app_id: "your-facebook-app-id" app_secret: "your-facebook-app-secret" access_token: "your-system-user-access-token" ad_account_id: "act_123456789" business_id: "987654321" pixel_id: "111222333444" # Data sync options sync: custom_audiences: true conversions_api: true lead_forms: true campaign_insights: true # API version api_version: "v25.0" ``` ### Custom Audience تشکیل Brevo فہرستوں کو Meta Custom Audiences میں سنک کریں: ```yaml custom_audiences: enabled: true lists: - brevo_list_id: 5 audience_name: "All Customers" subtype: "CUSTOM" - brevo_list_id: 6 audience_name: "High LTV Customers" subtype: "CUSTOM" - brevo_list_id: 7 audience_name: "Recent Purchasers" subtype: "CUSTOM" # Matching fields match_keys: - EMAIL - PHONE - FN # First name - LN # Last name - CT # City - ST # State - ZIP - COUNTRY schedule: "daily" sync_mode: "mirror" ``` ### Conversions API تشکیل ```yaml conversions_api: enabled: true pixel_id: "111222333444" test_event_code: "" # Set for testing, clear for production events: - brevo_event: "order_completed" meta_event: "Purchase" value_field: "revenue" currency_field: "currency" - brevo_event: "cart_updated" meta_event: "AddToCart" - brevo_event: "customer_created" meta_event: "Lead" - brevo_event: "page_viewed" meta_event: "ViewContent" ``` ## API اینڈ پوائنٹس | طریقہ | اینڈ پوائنٹ | تفصیل | | --- | --- | --- | | `POST` | `/v25.0/act_{id}/customaudiences` | Custom Audience بنائیں | | `POST` | `/v25.0/{audience_id}/users` | Custom Audience میں صارفین شامل کریں | | `DELETE` | `/v25.0/{audience_id}/users` | Custom Audience سے صارفین ہٹائیں | | `POST` | `/v25.0/{pixel_id}/events` | Conversions API ایونٹس بھیجیں | | `GET` | `/v25.0/act_{id}/campaigns` | مہمات کی فہرست | | `GET` | `/v25.0/act_{id}/insights` | مہم insights حاصل کریں | | `GET` | `/v25.0/{form_id}/leads` | lead form سبمیشنز حاصل کریں | | `POST` | `/v25.0/act_{id}/adcreatives` | اشتہار creatives بنائیں | | `GET` | `/v25.0/{catalog_id}/products` | catalog پروڈکٹس کی فہرست | ## کوڈ کی مثالیں ### Meta Ads کنیکٹر کو انیشیلائز کریں ```javascript import { TajoClient } from '@tajo/sdk'; const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY }); // Connect Meta Ads account await tajo.connectors.connect('meta-ads', { appId: process.env.META_APP_ID, appSecret: process.env.META_APP_SECRET, accessToken: process.env.META_ACCESS_TOKEN, adAccountId: 'act_123456789', pixelId: '111222333444' }); ``` ### Conversions API ایونٹس بھیجیں ```javascript // Send a purchase event via Conversions API const response = await fetch( `https://graph.facebook.com/v25.0/${PIXEL_ID}/events`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ data: [{ event_name: 'Purchase', event_time: Math.floor(Date.now() / 1000), action_source: 'website', user_data: { em: [hashSHA256('jane@example.com')], ph: [hashSHA256('+15551234567')], fn: [hashSHA256('jane')], ln: [hashSHA256('kim')], client_ip_address: '192.168.1.1', client_user_agent: 'Mozilla/5.0...', fbc: 'fb.1.1234567890.AbCdEfG', // Click ID fbp: 'fb.1.1234567890.987654321' // Browser ID }, custom_data: { value: 89.99, currency: 'USD', content_ids: ['SKU-001'], content_type: 'product' } }], access_token: process.env.META_ACCESS_TOKEN }) } ); ``` ### Brevo فہرست سے Custom Audience سنک کریں ```javascript // Upload a Brevo contact list as a Meta Custom Audience await tajo.connectors.syncAudience('meta-ads', { brevoListId: 5, audienceName: 'High Value Customers', matchKeys: ['EMAIL', 'PHONE', 'FN', 'LN'], syncMode: 'mirror' }); ``` ### مہم Insights حاصل کریں ```javascript // Get campaign performance metrics const insights = await tajo.connectors.query('meta-ads', { resource: 'campaigns', fields: ['campaign_name', 'impressions', 'clicks', 'spend', 'actions', 'cost_per_action_type'], dateRange: { since: '2024-01-01', until: '2024-01-31' }, level: 'campaign' }); ``` ## شرح کی حدود | وسیلہ | حد | تفصیلات | | --- | --- | --- | | **Marketing API** | Tier پر مبنی | ایپ رسائی کی سطح اور خرچ پر مبنی | | **Custom Audience اپ لوڈز** | 700 درخواستیں/گھنٹہ | فی اشتہاری اکاؤنٹ | | **Conversions API** | 2,000 ایونٹس/سیکنڈ | فی pixel | | **Insights API** | 200 کالز/گھنٹہ | فی اشتہاری اکاؤنٹ | | **Lead retrieval** | 200 کالز/گھنٹہ | فی پیج | | **بیچ درخواستیں** | 50 درخواستیں/بیچ | فی بیچ کال | کاروباری تصدیق درکار مکمل Marketing API رسائی کے لیے Meta Business Manager میں کاروباری تصدیق درکار ہے۔ غیر تصدیق شدہ ایپس development mode تک محدود ہیں جس میں محدود شرح کی حدود ہیں۔ ## ٹربل شوٹنگ | مسئلہ | وجہ | حل | | --- | --- | --- | | `OAuthException` | Token میعاد ختم یا غلط | System User access token دوبارہ بنائیں | | کم Custom Audience میچ ریٹ | کم ڈیٹا کا معیار | تمام PII کو SHA-256 کے ساتھ hash کریں، متعدد match keys شامل کریں | | Conversions منسوب نہیں | غائب `fbc`/`fbp` پیرامیٹرز | cookies سے Facebook Click ID اور Browser ID منتقل کریں | | `RATE_LIMIT_REACHED` | بہت زیادہ API کالز | exponential backoff نافذ کریں، API رسائی tier چیک کریں | | Lead forms سنک نہیں ہو رہے | `leads_retrieval` اجازت غائب | System User میں اجازت شامل کریں | | ایونٹس test mode میں | `test_event_code` ابھی بھی سیٹ ہے | پروڈکشن کے لیے test event code ہٹائیں | ## بہترین طرز عمل 1. **System User tokens استعمال کریں** - System Users سرور انٹیگریشنز کے لیے مستحکم، غیر میعاد ختم ہونے والے tokens فراہم کرتے ہیں 2. **تمام PII کو hash کریں** - Meta کو بھیجنے سے پہلے تمام personally identifiable معلومات کو SHA-256 hash کریں 3. **CAPI اور Pixel دونوں بھیجیں** - deduplication کے ساتھ redundant ٹریکنگ کے لیے Conversions API اور Meta Pixel دونوں استعمال کریں 4. **Event IDs شامل کریں** - deduplication کو فعال کرنے کے لیے CAPI اور Pixel ایونٹس دونوں پر `event_id` سیٹ کریں 5. **`fbc` اور `fbp` منتقل کریں** - زیادہ سے زیادہ conversion attribution کے لیے Facebook Click ID اور Browser ID شامل کریں 6. **اپنے کاروبار کی تصدیق کریں** - مکمل API رسائی اور اعلی شرح کی حدود کے لیے کاروباری تصدیق مکمل کریں 7. **`test_event_code` استعمال کریں** - لائیو ہونے سے پہلے Events Manager میں Conversions API ایونٹس کا ٹیسٹ کریں ## سیکیورٹی - **System User tokens** - غیر ذاتی، کاروبار اسکوپڈ تصدیقی tokens - **SHA-256 hashing** - تمام PII Meta سرورز پر منتقل کرنے سے پہلے hash کیا جاتا ہے - **App Secret Proof** - تصدیقی سیکیورٹی کی اختیاری اضافی پرت - **کاروباری اسکوپنگ** - اجازتیں مخصوص اشتہاری اکاؤنٹس اور پیجز پر اسکوپڈ - **Meta کمپلائنس** - Meta Platform Terms اور اشتہاری پالیسیوں کے تابع - **ڈیٹا پروسیسنگ شرائط** - EU ڈیٹا کے لیے Meta کی Data Processing Terms لاگو ہوتی ہیں ## متعلقہ وسائل - [Google Ads کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/google-ads) - [Klaviyo کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/klaviyo) - [Brevo کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/brevo) - [گاہک سنک اسکل](https://tajo.io/ur/docs/skills/data-sync/customer-sync)