Lead Ads API: leadgen hodisasidan CRM'gacha
Lead Ads — Instagram yoki Facebook ichida to'ldiriladigan lead formasi. Forma yuborilgach, Meta endpointingizga faqat identifikatorlardan iborat leadgen webhookini yuboradi. Socialift SDK bilan backendingiz imzoni tekshiradi (verify_request), javoblarni fb.lead() orqali oladi, normallashtiradi va leadni CRM API'si orqali yozadi — hodisa kelishi bilanoq.
Yangilangan:
Lead Ads integratsiyasi nima uchun kerak?
Meta Lead Ads formalari to'ldirilgan leadlarni reklama kabinetida saqlaydi va ularni CSV sifatida qo'lda yuklab olish mumkin. Integratsiya bu qadamni yo'q qiladi: backendingiz leadgen webhookini qabul qilib, har bir leadni forma yuborilgandan keyin tez orada CRM'ga yozadi. Farq javob vaqtida — kunlik eksport kutilmaydi.
Qo'lda yuklab olishning ikki kamchiligi bor. Birinchisi — kechikish: kuniga bir marta eksport qilinsa, lead o'rtacha yarim kun kutadi va raqobatchi allaqachon qo'ng'iroq qilgan bo'ladi. Ikkinchisi — 90 kunlik chegara: Meta faqat oxirgi 90 kunda yuborilgan leadlarni yuklab olishga ruxsat beradi, o'tkazib yuborilgan eksport ma'lumot yo'qotilishiga olib kelishi mumkin.
Integratsiya orqali kelgan leadda forma ID'si, kampaniya konteksti va to'ldirilgan javoblar birga keladi — CRM'da lead manbasi bo'yicha to'g'ri hisobot qurish mumkin bo'ladi.
Leadni reklamadan CRM'gacha olib borish
Formani yarating
Facebook yoki Instagram reklamasida lead formasi tuziladi. Savollar tarkibi keyinchalik CRM maydonlariga moslanadi.
Ruxsatlarni so'rang
leads_retrieval, pages_show_list, pages_read_engagement, pages_manage_ads, pages_manage_metadata (webhook uchun) va ads_management (reklama maydonlari) ruxsatlarini so'rang. Boshqalarning sahifalari uchun App Review orqali Advanced Access kerak.
leadgen webhookiga obuna bo'ling
App Dashboard'da Page obyektining leadgen maydoniga obuna bo'ling, so'ng ilovani har bir sahifaga o'rnating: fb.subscribe_page(page_id, page_token, fields=["leadgen"]).
Lead mazmunini oling
Hodisada faqat identifikatorlar keladi (leadgen_id, form_id, page_id, ad_id). fb.lead(leadgen_id, page_token) ni chaqiring — u javoblari normallashtirilgan Lead obyektini qaytaradi (socialift.leads.normalize).
CRM'ga yozing va biriktiring
Kodingiz leadni CRM API'si orqali yaratadi, form_id va kampaniyani manba sifatida saqlaydi va menejerga biriktiradi. Socialift'da tayyor CRM konnektori yo'q.
SDK nima beradi va backendingiz nima qiladi
Hodisa asosida
Hodisa forma yuborilgach tez orada keladi — kunlik eksport kutilmaydi.
To'liq forma javoblari
Faqat ID emas, foydalanuvchi yozgan barcha maydonlar bilan.
Imzo tekshiruvi
verify_request Meta'ning X-Hub-Signature-256 imzosini xom tanaga qarab tekshiradi — soxta leadgen hodisasi API so'rovidan oldin rad etiladi.
Dedupe kaliti
Meta hodisa ID bermaydi va webhookni qayta yuborishi mumkin; dedupe_key() bazangizdagi unikal ustun uchun barqaror kalit (leadgen_id) yasaydi.
Ikki tomonda qayta urinish
Meta yetkazilmagan webhookni 36 soatgacha qayta yuboradi; SDK API chaqiruvlari 429/5xx da eksponensial backoff bilan takrorlanadi. CRM'ga qayta yozish — navbatingiz ishi.
Manba konteksti
Forma va sahifa identifikatorlari lead bilan birga keladi — atribusiya saqlanadi.
Lead oqimini loyihalashda e'tibor bering
- Forma savollarini CRM maydonlariga oldindan moslang — keyin o'zgartirish qiyin bo'ladi.
- Bir odam ikki marta forma to'ldirishi mumkin: telefon yoki email bo'yicha birlashtirish qoidasini yozing.
- Test leadlarini alohida belgilang, aks holda hisobot buziladi.
- Lead kelgan vaqt va birinchi javob vaqtini saqlang — bu asosiy KPI.
- Ruxsat bekor qilinsa lead oqimi to'xtaydi: bu holatni monitoring qiling.
- Sahifa admini Leads Access Manager'ni sozlagan bo'lsa, tokeni ishlatilayotgan foydalanuvchiga ruxsat bering — aks holda fb.lead() rad etiladi.
Ko'p so'raladigan savollar
Instagram leadlarini avtomatik yig'ish mumkinmi?
Ha. Instagram Lead Ads bog'langan Facebook sahifasi orqali ishlaydi, shuning uchun Meta leadgen hodisasini shu sahifa uchun yuboradi. Backendingiz javoblarni fb.lead() bilan oladi (leads_retrieval va sahifa ruxsatlari) va leadni CRM'ga yozadi.
Lead Ads bilan CSV eksporti o'rtasidagi farq nima?
CSV — qo'lda va kechikish bilan, Meta esa faqat oxirgi 90 kundagi leadlarni yuklab olishga ruxsat beradi. Integratsiya har bir leadni hodisa kelishi bilan oladi. Bundan tashqari CSV'da dublni va test leadlarini ajratish qo'lda bajariladi.
Lead Ads API uchun qanday ruxsatlar kerak?
Leadlarni o'qish uchun leads_retrieval, sahifalar uchun pages_show_list, pages_read_engagement va pages_manage_ads, webhook obunasi uchun pages_manage_metadata, reklama maydonlari uchun ads_management. Ilovada roli yo'q odamlarning sahifalari uchun App Review orqali Advanced Access kerak.
Socialift leadni CRM'ga o'zi yuboradimi?
Yo'q, CRM'ga yozish sizning backendingizda: SDK imzoni tekshiradi, lead javoblarini oladi va normallashtiradi. Socialift'da amoCRM, Bitrix24 yoki boshqa CRM uchun tayyor konnektor yo'q. Kabinetda ulangan sahifalar leadlari Playground'dagi GET /crm/leads da ko'rinadi.
Bepul oyda SDK'ning Lead Ads metodlari ishlaydimi?
Ha. Birinchi 30 kun token SDK'ning barcha imkoniyatlarini ochadi, jumladan lead_forms, leads, lead va ad_context. Keyin token balansdan 30 kunlik davrlarga uzaytiriladi va imkoniyatlar token rejasiga bog'liq bo'ladi — aniq ro'yxatni kabinetdagi «Tekshirish va muhitlar» ko'rsatadi. Kabinet Playground'i rejadan qat'i nazar ishlaydi.
Manbalar
Bog'liq sahifalar
Leadlarni yo'qotishni to'xtating
Token oling, sahifangizni ulang va lead metodlarini Playground'da sinab ko'ring.
Bepul token olish →