Amplitude: تتبع الحدث
استخدم Amplitude: تتبع الحدث لإرسال حدث واحد إلى مشروع Amplitude من خطوة في الرحلة، من خلال HTTP API V2، مع الخصائص التي تدرجها.
يقوم Pushwoosh بتعيين insert_id الخاص بـ Amplitude لك من المسافر وهذه الخطوة. هذا يعني أن المسافر نفسه الذي يمر عبر هذه النقطة مرتين، على سبيل المثال في دورة ثانية من رحلة متكررة، يتم تسجيله كحدث واحد مكرر في Amplitude، وليس اثنين.
الاستخدامات النموذجية:
- تسجيل معالم الرحلة: أرسل حدثًا عندما يصل المسافر إلى خطوة، بحيث يظهر بجانب أحداث منتجك في مسارات Amplitude.
- تغذية مسار متعدد القنوات: سجل معالم الدفع أو البريد الإلكتروني أو الرسائل القصيرة جنبًا إلى جنب مع الأحداث داخل التطبيق للحصول على عرض مسار واحد في Amplitude.
- تتبع رحلة متكررة بأمان: يعني إلغاء التكرار المدمج أن المسافر الذي يعود عبر هذه الخطوة لا يزال يُسجل كحدث واحد، وليس عدة أحداث.
تكوين النقطة
Anchor link to- اسحب Amplitude: تتبع الحدث من قسم التكاملات إلى لوحة الرسم.
- انقر نقرًا مزدوجًا على النقطة وأدخل اسم الخطوة.
- في مفتاح API، أدخل مفتاح API للمشروع من Amplitude: الإعدادات > المشاريع > مشروعك > عام. يتم تخزينه مقنعًا، مثل رأس سري لـ webhook. لا يعرضه Pushwoosh أو يعيده أبدًا بمجرد حفظه، ولا يظهر أبدًا في الطلب المخزن للنقطة أو في سجل المكالمات.
- في نقطة نهاية Amplitude، اختر المنطقة التي تم إنشاء مشروع Amplitude فيها:
api2.amplitude.comلمشروع أمريكي،api.eu.amplitude.comلمشروع أوروبي. يتم رفض مفتاح من منطقة من قبل الأخرى.
- في اسم الحدث، أدخل الحدث كما يجب أن يظهر في Amplitude، على سبيل المثال
journey_welcome_push_sent. يأخذ نفس وحدات الماكرو مثل خصائص الحدث.
- في خصائص الحدث، أضف صفًا واحدًا لكل خاصية لإرسالها مع الحدث. أدخل اسم الخاصية والقيمة. يجب أن تكون الأسماء غير فارغة وفريدة. القيمة التي هي ماكرو مسافر واحد تحتفظ بنوعها الخاص في Amplitude (
{{tag:Age}}يصل كرقم،{{tag:Trial Ends}}كتاريخ). يتم إرسال أي نص آخر كسلسلة نصية. تستخدم وحدات الماكرو نفس الصيغة مثل نص Webhook. أو انقر فوق إدراج قيمة ديناميكية لاختيار سمة أنتجتها خطوة سابقة في هذه الرحلة، على سبيل المثال استجابة LLM أو قيمة Webhook معينة.
- انقر فوق حفظ.
الاستجابة
Anchor link toيستمر المسافر إلى أي خطوة تقوم بتوصيلها بعد ذلك على لوحة الرسم.
السمات بعد تشغيل الخطوة
Anchor link to| السمة | ما تحتويه |
|---|---|
amplitude_events_ingested | عدد الأحداث التي استوعبها Amplitude |
كيفية استخدامه في الخطوات اللاحقة
Anchor link toلقد استمر المسافر بالفعل إلى الخطوة التالية بغض النظر عن هذه السمة. احفظها في Tag باستخدام تحديث ملف تعريف المستخدم إذا كنت بحاجة إلى تأكيد استيعاب الحدث أو التفرع بناءً عليه باستخدام تقسيم الشرط.
الإخفاقات والاستجابات غير المتوقعة
Anchor link toيؤدي الطلب الفاشل إلى إسقاط المسافر من الرحلة. راجع الأخطاء والطلبات الفاشلة.
سيناريو مثال: تسجيل إرسالات الرحلة في مسار Amplitude
Anchor link toيريد فريق أن يظهر إرسال ترحيبي في نفس مسار Amplitude مثل أحداث منتجاتهم الأخرى.
- أضف Amplitude: تتبع الحدث عند النقطة في الرحلة التي يجب أن ينطلق فيها الحدث. اضبط اسم الحدث على
journey_welcome_push_sent. - انقر فوق حفظ.
بمجرد تشغيل هذا، يظهر الإرسال في Amplitude بجانب بقية أحداث المنتج، بحيث يعكس المسار الصورة الكاملة بدلاً من فجوة حيث لا تبلغ خطوة الرحلة.