Developer Page Specifications
Analytics Events
GA4 / GTM event taxonomy. 10 listing + 6 details events with property contracts + KPI derivations.
مكتمل
تصنيف أحداث GA4 / GTM لـ Opportunity Radar. كل الأحداث تُطلق جانب-العميل عبر خدمة التحليلات. كل حدث يَشمل مجموعة قياسية من الخصائص (opportunity_id، opportunity_slug، opportunity_status، country، stage، sector، source_page) — خصائص إضافية مُتَخَصِّصة-بالحدث موثّقة لكل حدث.
أحداث صفحة القائمة
- opportunity_listing_view
- يُطلَق عند أول رسم لصفحة القائمة. خصائص إضافية: { result_count، active_filters_count، active_status_tab }.
- opportunity_filter_click
- يُطلَق عند تغيير الفلتر. خصائص إضافية: { filter_type (country|type|stage|sector|status)، filter_value، was_added (bool، false = تمت إزالته) }.
- opportunity_search
- يُطلَق بعد بحث debounced (300ms). خصائص إضافية: { query، result_count }. يُطلَق فقط حين طول الاستعلام ≥ 2.
- opportunity_sort_change
- يُطلَق عند تغيير منسدلة الفرز. خصائص إضافية: { sort_from، sort_to }.
- opportunity_card_view
- IntersectionObserver: يُطلَق حين كرت يَدخل الـ viewport. خصائص إضافية: { position_in_list، viewed_at_ms_since_listing_load }.
- opportunity_card_click
- يُطلَق عند نقر الكرت (CTA View Opportunity، ليس Apply). خصائص إضافية: { position_in_list، dwell_time_ms }.
- opportunity_apply_click
- يُطلَق حين "Apply via Official Source" يُنقَر. خصائص إضافية: { source_section ('card'|'details_header'|'details_apply_box')، days_to_deadline }.
- opportunity_digest_subscribe
- يُطلَق عند نجاح الاشتراك. خصائص إضافية: { country_preference، stage_preference، consent_partners (bool)، source: 'listing' }.
- opportunity_cross_module_click
- يُطلَق عند نقر كرت cross-module (قسم G). خصائص إضافية: { target_module، target_route }.
- opportunity_listing_load_more
- يُطلَق عند تَحميل دفعة infinite-scroll (بعد الأولى). خصائص إضافية: { batch_number، cumulative_card_count }.
أحداث صفحة التفاصيل
- opportunity_detail_view
- يُطلَق عند أول رسم لصفحة التفاصيل. خصائص إضافية: { has_cover_image، sponsor_relationship (bool)، verified_age_days، connected_signals_count، benefits_count، eligibility_count }.
- opportunity_share_click
- يُطلَق عند زر Share. خصائص إضافية: { channel ('native'|'copy_link'|'twitter'|'linkedin') }.
- opportunity_save_click
- يُطلَق عند زر Save (حين تسجيل الدخول مُفعَّل). خصائص إضافية: { action: 'save'|'unsave' }.
- opportunity_related_click
- يُطلَق عند نقر كرت Related Opportunities (قسم M). خصائص إضافية: { related_opportunity_id، position_in_rail، source_type ('manual'|'auto') }.
- opportunity_connected_signal_click
- يُطلَق عند نقر كرت Connected Signal (قسم N). خصائص إضافية: { source_entity_type، source_entity_id، relation_type، position_in_rail }.
- opportunity_subscription_submit
- يُطلَق عند submit اشتراك صفحة التفاصيل (قسم O). خصائص إضافية: { source: 'details'، opportunity_id_context، consent_partners (bool) }.
مؤشرات KPI المُشتقَّة من هذا التصنيف
- Apply CTR = opportunity_apply_click / (opportunity_card_view + opportunity_detail_view). الهدف ≥4% لـ non-sponsored، ≥6% لـ sponsored.
- تحويل Card-to-detail = opportunity_card_click / opportunity_card_view. الهدف ≥18%.
- كثافة العبور cross-module = opportunity_connected_signal_click / opportunity_detail_view. الهدف ≥0.5 (شريط Connected Signals هو السطح المُحَدِّد للمنصّة لعبور المنظومة).
- تحويل الاشتراك = opportunity_digest_subscribe / opportunity_listing_view + opportunity_subscription_submit / opportunity_detail_view. الهدف ≥2.5% مُجَمَّع.
