انتقل إلى المحتوى
وثائق المطورالدعم طلب عرض توضيحي تسجيل الدخول
Pushwoosh.com

تكامل Marketo

يشرح هذا الدليل كيفية دمج Marketo مع Pushwoosh. ستتمكن من استخدام قناة اتصال إشعارات الويب كجزء من حملاتك التسويقية مع Marketo.

على سبيل المثال، تخيل أن مستخدمًا زار صفحتك المقصودة في Marketo ولكنه لم يتخذ أي إجراء هناك. ستتمكن من الوصول إلى هذا المستخدم بإشعار ويب كتذكير. يمكن أيضًا تخصيص إشعار الويب هذا ببيانات Marketo المسجلة لهذا المستخدم لتحقيق أقصى قدر من التفاعل!

1. إنشاء Service Worker

Anchor link to

اتبع هذا الدليل وقم بـ الخطوات المسبقة والخطوات 1 - 2.2.

بعد إكمال الخطوات المذكورة أعلاه، يجب أن يكون لديك ملفا manifest.json و pushwoosh-service-worker.js جاهزين.

انتقل إلى Marketo Design Studio. يمكن لـ Marketo فقط تحميل الملفات إلى مجلد الموارد، المجلد المسمى “Images and Files”. قم بتحميل manifest.json و pushwoosh-service-worker.js إلى هذا المجلد.

تحميل ملفات manifest.json و service worker إلى Marketo

2. إنشاء صفحة اشتراك الإشعارات

Anchor link to

كما ذكرنا أعلاه، يمكن لـ Marketo فقط تحميل الملفات إلى مجلد الموارد وهو مختلف عن نطاق الصفحات المقصودة. على سبيل المثال، إذا نقرت على أي ملف تم تحميله أعلاه وتحققت من عنوان URL الخاص به، فسترى شيئًا مثل “https://your-host-name.com/rs/765-IWA-819/images/pushwoosh-service-worker.js”. ومع ذلك، إذا نقرت على الصفحة المقصودة وتحققت من عنوان URL الخاص بها، فسيكون شيئًا مثل: “https://your-host-name.com/lp/765-IWA-819/pushwoosh-landing.html”. لاحظ الجزء “lp” في عناوين URL للصفحات المقصودة و “rs” في عناوين URL للسكريبت.

هذا يعني أننا بحاجة إلى تسجيل سكريبت Service Worker الخاص بنا في نطاق مختلف عن الصفحات المقصودة.

لتحقيق ذلك، سنقوم بتحميل صفحة اشتراك إشعارات خاصة إلى مجلد موارد Marketo ثم نفتحها من الصفحة المقصودة. لنقم بإنشاء صفحة الاشتراك هذه.

احصل على ملف push-subscription.html من الرابط التالي: https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-push-subscription-html

افتح الملف وقم بتغيير الأسطر التالية:

  • السطر 8 - قم بتغيير الرابط إلى عنوان URL لملف manifest.json الذي تم تحميله في الخطوة السابقة.
  • السطر 24 - قم بتغيير قيمة المعلمة scope إلى عنوان URL لمجلد الموارد الخاص بك (هذا هو المجلد حيث يوجد manifest.json).
  • السطر 20 - قم بتغيير قيمة المعلمة applicationCode إلى معرف تطبيق Pushwoosh الخاص بك.

لاحظ أن السكريبت يقوم أيضًا بربط إشعارات Pushwoosh التي تركز على المستخدم مع معرف العميل المحتمل (Lead Identifier) في Marketo: userId:leadId (السطر 26)

قم بتحميل الملف الناتج إلى مجلد “Images and Files”. الآن يجب أن يكون لديك هذه الملفات في المجلد:

الملفات التي تم تحميلها إلى مجلد الصور والملفات في Marketo

3. إنشاء صفحة مقصودة مع اشتراك الإشعارات

Anchor link to

احصل على ملف pushwoosh-template.html من الرابط التالي: https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-pushwoosh-template-html

افتح الملف وقم بتغيير الأسطر التالية:

  • السطر 47 - قم بتغيير قيمة المعلمة scope إلى عنوان URL لمجلد الموارد الخاص بك.
  • السطر 65 - قم بتغيير الرابط إلى عنوان URL لملف push-subscription.html الذي تم تحميله في الخطوة السابقة.
  • السطر 43 - قم بتغيير قيمة المعلمة applicationCode إلى معرف تطبيق Pushwoosh الخاص بك.

هذا السكريبت، مثل السابق، يقوم أيضًا بربط إشعارات Pushwoosh التي تركز على المستخدم مع معرف العميل المحتمل في Marketo: userId:leadId (السطر 49)

الآن اذهب إلى قسم “Templates” في صفحات Marketo المقصودة، قم بإنشاء القالب (يسمى “pushwoosh-template” في لقطة الشاشة أدناه) وانسخ والصق محتويات الملف الناتج هناك.

إنشاء قالب pushwoosh-template في قسم قوالب Marketo

الآن لنقم بإنشاء صفحة مقصودة جديدة بناءً على هذا القالب.

إنشاء صفحة مقصودة جديدة بناءً على قالب pushwoosh

في مثالنا، لإظهار إمكانيات تكامل Pushwoosh مع أتمتة حملات Marketo، ولأجل البساطة، سنضيف رابطًا بسيطًا إلى الصفحة المقصودة. سنقوم بإنشاء حملة ستقوم بتشغيل إشعار دفع شخصي عندما ينقر المستخدم على هذا الرابط.

سنستخدم نفس عنوان URL الخاص بالصفحة المقصودة.

<a href="https://na-ab24.marketo.com/lp/765-IWA-819/pushwoosh-landing.html">Send me an Offer!</a>
صفحة مقصودة مع رابط لعرض إشعار الدفع

4. إنشاء Webhook لـ Pushwoosh

Anchor link to

اذهب إلى قسم “Admin” في Marketo وقم بإنشاء Webhook جديد بالمعلمات التالية:

الصق الكود التالي كقالب.

{
        "request": {
            "application": "ENTER_YOUR_PUSHWOOSH_APP_ID",
            "auth": "ENTER_YOUR_PUSHWOOSH_API_TOKEN_HERE",
            "notifications": [{
                "send_date": "now",
                "ignore_user_timezone": true,
                "content": "لدينا عرض جديد لك!",
                "users" : ["{{lead.Id:default="ABCD-EFGH"}}"]
            }]
        }
    }

لاحظ أننا نستخدم معرف العميل المحتمل في Marketo (Marketo Lead ID) للإشارة إلى المستخدم في Pushwoosh. شاهد المزيد حول إشعارات الدفع التي تركز على المستخدم هنا.

تكوين Webhook في قسم الإدارة في Marketo

في مثالنا البسيط جدًا، نستخدم رسالة دفع ثابتة. ومع ذلك، يمكنك استخدام جميع وظائف createMessage

لتخصيص إشعار الدفع، يمكنك استخدام Preset من Pushwoosh وتمرير القيم من Marketo في معلمات “dynamic_content_placeholders” لاستدعاء /createMessage لتخصيص الإشعار.

5. التكامل مع حملة Marketo الآلية

Anchor link to

اذهب إلى قسم “Marketing Activities” في Marketo وقم بإنشاء حملة.

لمثالنا، سنقوم بتشغيل الحملة عندما ينقر المستخدم على رابط (الذي أنشأناه قبل خطوتين) في صفحتنا المقصودة.

تكوين المشغل لحدث نقر المستخدم في حملة Marketo

ب. حدد Webhook “send_push” في قسم “Flow”

اختيار Webhook send_push في قسم تدفق الحملة
  • الآن افتح عنوان URL للصفحة المقصودة
  • انقر على زر “Yes, I Want” لفتح مربع حوار اشتراك الإشعارات
  • اشترك في إشعارات الدفع
  • انقر على رابط “Send me an Offer!”

لقد حصلت على إشعار الدفع الآلي من Marketo!

تم إرسال إشعار الدفع الآلي من Marketo بنجاح