انٹیگریشنز
Mailchimp
کنورٹ کرنے والے لوگوں کو Mailchimp آڈینس میں شامل کریں، ایونٹ اور مختصر لنک کے ٹیگز اور ایک ٹائم لائن ایونٹ کے ساتھ۔
Mailchimp انٹیگریشن منظور شدہ کنورژن کے پیچھے موجود شخص کو آپ کی Mailchimp آڈینس میں شامل کرتا ہے، انہیں کنورژن کی قسم اور انہیں لانے والے مختصر لنک سے ٹیگ کرتا ہے، اور ان کی پروفائل ٹائم لائن پر ایک کسٹم ایونٹ درج کرتا ہے۔ کلکس نہیں بھیجے جاتے: کلک میں ای میل پتہ نہیں ہوتا۔ Growth اور Ultimate پر دستیاب۔
آپ کو کیا چاہیے
- ایک Mailchimp API کلید (Profile → Extras → API keys → Create A Key)۔ یہ آپ کے ڈیٹا سینٹر پر ختم ہوتی ہے، مثلاً
-us21۔ - آڈینس ID (Audience → All contacts → Settings → Audience name and defaults)۔
- وہ کنورژنز جن میں
emailشامل ہو۔ اس کے بغیر کنورژنز چھوڑ دی جاتی ہیں۔
اسے Letlink سے جوڑیں
- Integrations → Mailchimp کھولیں۔ صرف مالکان اور ایڈمنز۔
- API کلید اور آڈینس ID پیسٹ کریں۔
- منتخب کریں کہ نئے رابطے کیسے شامل کیے جائیں: ڈبل آپٹ اِن (ڈیفالٹ — Mailchimp انہیں تصدیقی ای میل بھیجتا ہے اور تصدیق تک وہ زیرِ التوا رہتے ہیں)، براہِ راست سبسکرائب (صرف اگر آپ کے پاس پہلے سے ان کی رضامندی ہو)، یا ٹرانزیکشنل (آڈینس میں، لیکن مارکیٹنگ کے لیے نہیں)۔
- چاہیں تو ٹیگ پری فکس تبدیل کریں (ڈیفالٹ
letlink)، پھر محفوظ کریں۔
ہم کیا بھیجتے ہیں
ہر کنورژن پر Mailchimp کے بیچ اینڈ پوائنٹ (POST https://<dc>.api.mailchimp.com/3.0/batches) پر ایک ریکویسٹ، ممبر پر تین آپریشنز کے ساتھ، جسے چھوٹے حروف والی ای میل کے MD5 ہیش سے پہچانا جاتا ہے:
| آپریشن | یہ کیا کرتا ہے |
|---|---|
PUT /lists/<audience>/members/<hash> |
شخص کو آپ کے منتخب اسٹیٹس کے ساتھ شامل کرتا ہے، یا اگر وہ پہلے سے موجود ہو تو اپ ڈیٹ کرتا ہے۔ موجودہ ممبرز کا اسٹیٹس برقرار رہتا ہے۔ |
POST …/members/<hash>/tags |
ٹیگز <prefix>-<event> (sale، lead، signup یا آپ کے کسٹم ایونٹ کا نام) اور <prefix>-<short code> شامل کرتا ہے۔ |
POST …/members/<hash>/events |
ایونٹ <prefix>_<event> کو short_code، value، currency اور order_id پراپرٹیز کے ساتھ درج کرتا ہے۔ |
سیگمنٹس بنانے کے لیے ٹیگز استعمال کریں — مثلاً spring-sale کے ذریعے خریدنے والے سب لوگ — اور Customer Journey ٹرگر کرنے کے لیے ایونٹ۔
کچھ نہیں آ رہا — مجھے کیا چیک کرنا چاہیے؟
- Mailchimp بیچز فوراً قبول کرتا ہے اور انہیں بیک گراؤنڈ میں چلاتا ہے، اس لیے کسی ایک آپریشن میں خرابی (مثلاً غلط یا پہلے ان سبسکرائب شدہ پتہ) ہمیں واپس رپورٹ نہیں ہوتی۔ Audience → All contacts دیکھیں، اور مزید تفصیل کے لیے Mailchimp API میں بیچ کے نتائج دیکھیں۔
- ڈبل آپٹ اِن کے ساتھ، نئے لوگ تصدیقی ای میل پر کلک کرنے تک زیرِ التوا دکھائی دیتے ہیں۔
- Mailchimp بیچ میں آپریشنز کی ترتیب کی ضمانت نہیں دیتا۔ ممبر ہمیشہ اپنے ٹیگز کے ساتھ بنایا جاتا ہے؛ بالکل نئے شخص کے لیے، ٹائم لائن ایونٹ کبھی کبھار رہ سکتا ہے۔
401کا مطلب ہے کہ API کلید غلط ہے یا منسوخ کر دی گئی ہے؛ ہر کنورژن پر404کا مطلب عموماً یہ ہے کہ آڈینس ID غلط ہے۔