التكاملات
Mailchimp
أضف من يُكملون التحويل إلى جمهور في Mailchimp، موسومين بالحدث والرابط القصير، مع حدث في المخطط الزمني.
يضيف تكامل Mailchimp الشخص صاحب التحويل المعتمد إلى جمهورك في Mailchimp، ويَسِمه بنوع التحويل والرابط القصير الذي جلبه، ويسجّل حدثًا مخصصًا في المخطط الزمني لملفه. لا تُرسل النقرات: فالنقرة لا تحمل عنوان بريد إلكتروني. متاح في Growth وUltimate.
ما تحتاجه
- مفتاح API من Mailchimp (Profile → Extras → API keys → Create A Key). ينتهي بمركز البيانات الخاص بك، مثل
-us21. - معرّف الجمهور (Audience → All contacts → Settings → Audience name and defaults).
- التحويلات التي تتضمن
email. يتم تخطي التحويلات التي لا تتضمنه.
اربطه بـ Letlink
- افتح التكاملات ← Mailchimp. للمالكين والمسؤولين فقط.
- الصق مفتاح API ومعرّف الجمهور.
- اختر طريقة إضافة جهات الاتصال الجديدة: double opt-in (الافتراضي — يرسل لهم Mailchimp رسالة تأكيد ويبقون معلّقين حتى يؤكدوا)، أو الاشتراك المباشر (فقط إن كانت لديك موافقتهم بالفعل)، أو transactional (ضمن الجمهور، لكن لا يمكن استهدافهم تسويقيًا).
- يمكنك اختياريًا تغيير بادئة الوسم (الافتراضية
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 إن احتجت إلى التفاصيل.
- مع double opt-in، يظهر الأشخاص الجدد كـ معلّقين حتى ينقروا على رسالة التأكيد.
- لا يضمن Mailchimp ترتيب العمليات داخل الدفعة. يُنشأ العضو دائمًا مع وسومه؛ أما الشخص الجديد تمامًا فقد يُتخطّى حدث المخطط الزمني الخاص به أحيانًا.
- الرمز
401يعني أن مفتاح API خاطئ أو أُلغي؛ والرمز404على كل تحويل يعني غالبًا أن معرّف الجمهور خاطئ.