محمود عبدالنبي
شراء الوسائط · أداة سطر أوامر · 2

دليل المستودع: محلل عبارات البحث المتاحة لحملات Google Performance Max

صفحة تعريفية مستقلة بمستودع محلل عبارات البحث المتاحة لحملات Google Performance Max. توضّح ما الذي يحاول حله، ولمن يناسب، وما الملفات التي ستجدها قبل الانتقال إلى المصدر.

المشكلة التي يعالجها

يوضح التوثيق الأصلي نطاق المشكلة بهذا الوصف:

Build an open-source Google Ads PMax auditing toolkit: 1) Production-ready Google Ads JavaScript snippet (pmax_unmasker.js) that runs inside the Google Ads script editor and logs search category queries to a Google Sheet / CSV, 2) Python companion script (analyze_queries.py) that separates brand vs non-brand search terms and calculates incremental ROAS, 3) Automated negative keyword list generator.

لمن صُمم؟

الجمهور المحدد في README: PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

محتويات المستودع

الملفات الأساسية التي يسردها قسم بنية المستودع في README:

  • docs/setup-guide.md
  • examples/sample_pmax_export.csv
  • LICENSE
  • README.md
  • scripts/pmax_unmasker.js
  • src/analyze_queries.py
  • templates/negative-keyword-template.csv
  • tests/test_analyzer.py

طريقة مراجعته واستخدامه

  1. ابدأ بقراءة README وتأكد أن المشكلة المذكورة تطابق احتياجك الفعلي.
  2. افحص الملفات المذكورة أعلاه؛ أسماء الملفات توضح مكان البيانات والأدوات والقوالب والاختبارات.
  3. اتبع Quick Start الموجود في README، وتحقق من المتطلبات قبل تشغيل أي أمر.
  4. قارن المخرجات بعينة موثقة، وراجع القيود قبل استخدامها في قرار أو عمل عميل.

أمثلة أوامر البدء من README: python -m unittest discover -s tests · python src/analyze_queries.py --help

النطاق والقيود

  • Opaque Query Reporting: Google Ads Performance Max groups minor search terms into 'Other' categories; script parses available Search Term Insights.
  • Brand vs Non-Brand Isolation: Unmasker separates existing brand keywords from generic conquesting search terms to measure real incremental ROAS.
  • Script Runtime Limits: Google Ads Scripts execute within a 30-minute maximum timeout; large accounts require segmented date filtering.

هذه الصفحة تلخص التوثيق المتاح ولا تثبت أداءً أو نتيجة تجارية. تحقق من صلاحية البيانات والمتطلبات قبل الاستخدام.

مستودعات مرتبطة