تقرير أداء أسبوعي يتبعت لعميلك تلقائيًا

عشان تعمل تقرير إعلانات تلقائي يتبعت لعميلك كل أسبوع، محتاج 4 حاجات: شيت فيه أرقام الإعلانات، وورقة ملخص بتحسب المؤشرات المهمة بس، وسكريبت Google Apps Script بيقرأ الملخص ويبني إيميل منسّق، ومشغّل (Trigger) أسبوعي يشغّل السكريبت لوحده. النتيجة: كل يوم أحد (أو أي ميعاد تحدده) عميلك بيلاقي إيميل فيه الإنفاق والنتايج وتكلفة النتيجة، من غير ما تفتح الجهاز. في المقال ده هاشرح الخطوات بالتفصيل مع كود جاهز تعدّل فيه، وإيه الأرقام اللي تستاهل تتبعت، وإزاي تتجنب الأخطاء اللي بتخلّي التقرير يبوّظ.

محتويات المقال

ليه تقرير أسبوعي تلقائي بيفيدك أنت والعميل

العميل بيحب يطمّن. ولو ما بعتّلوش تقرير بانتظام، هيسألك كل شوية أو يفترض إن مفيش شغل. التقرير المنتظم:

• بيبني ثقة: العميل يشوف إنك متابع.
• بيوفر وقتك: بدل ما تجمّع أرقام وتكتب إيميل كل أسبوع، ده بيحصل لوحده.
• بيخلّي الحوار على أرقام: مش على انطباعات.
• بيوثّق التاريخ: لما تحتاج ترجع لأسبوع قديم، التقارير محفوظة في بريدك.

وده جزء من إدارة العميل بشكل احترافي، وفصل تشخيص الأرقام في الكتاب بيساعدك تحدّد إيه اللي يستاهل يتحط في التقرير وإيه اللي يتفسّر.

قبل ما تبدأ: إيه اللي المفروض يتبعت

أشهر خطأ في التقارير إنها بتبقى مليانة أرقام مش مفهومة. العميل مش محتاج 40 عمود. محتاج يعرف: أنفقنا كام؟ جبنا إيه؟ بكام؟ وهل ده كويس؟

أرقام مقترحة (عدّل حسب نشاط العميل):

• الإنفاق في الأسبوع.
• النتيجة الأساسية: طلبات، أو عملاء محتملين، أو رسائل، حسب هدف الحملة.
• تكلفة النتيجة (الإنفاق ÷ عدد النتايج). لو بتبيع منتجات، ضيف ROAS (راجع حساب ROAS).
• مقارنة بالأسبوع السابق: زاد ولا نقص؟
• جملة تحليل قصيرة: إيه اللي حصل وإيه الخطوة الجاية (دي بتكتبها أنت أو بتعدّلها قبل الإرسال).

وعشان تفهم ازاي تقرا الأرقام صح وتختار اللي تذكره، شوف إزاي تقرا تقرير حملاتك.

خطوات عمل تقرير إعلانات تلقائي

الخطوة 1: جهّز الشيت

تحتاج ورقتين على الأقل:

ورقة «بيانات» (البيانات الخام)

كل صف يوم، والأعمدة: التاريخ، الإنفاق، النتايج، الإيراد (لو في مبيعات). البيانات دي بتجيلها من تصدير يدوي من Ads Manager، أو من سحب تلقائي كما في سحب بيانات إعلانات ميتا إلى Google Sheets.

ورقة «ملخص» (اللي هيتبعت)

فيها خلايا بمعادلات بتحسب الأسبوع الحالي والسابق. مثال على التخطيط (الخلايا اختيارية، عدّل المراجع حسب شيتك):

• B2: إنفاق الأسبوع الحالي.
• B3: نتايج الأسبوع الحالي.
• B4: تكلفة النتيجة (=B2/B3 مع حماية القسمة على صفر).
• C2 إلى C4: نفس الأرقام للأسبوع السابق.

ممكن تستخدم SUMIFS مع تواريخ بداية ونهاية الأسبوع عشان تجمع من ورقة «بيانات» تلقائيًا.

نصيحة: استخدم IFERROR أو شرط IF عشان لو النتايج صفر ما يطلعش خطأ قسمة على صفر في التقرير.

الخطوة 2: افتح Apps Script

من الشيت: الإضافات ← Apps Script. لو لسه مش فاهم المحرر، شوف Google Apps Script للمسوّقين الأول.

الخطوة 3: اكتب سكريبت التقرير

الكود ده بيقرأ الأرقام من ورقة «ملخص» ويبعت إيميل HTML بسيط. عدّل الإيميل والأسماء والخلايا حسب شيتك:

function sendWeeklyReport() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName('ملخص');

  var spend = sheet.getRange('B2').getValue();
  var results = sheet.getRange('B3').getValue();
  var cpr = sheet.getRange('B4').getValue();
  var prevSpend = sheet.getRange('C2').getValue();
  var prevResults = sheet.getRange('C3').getValue();
  var prevCpr = sheet.getRange('C4').getValue();
  var note = sheet.getRange('B6').getValue(); // جملة التحليل

  var clientEmail = 'client@example.com'; // عدّلها
  var clientName = 'اسم العميل';          // عدّلها

  var subject = 'تقرير أداء الإعلانات الأسبوعي — ' + clientName;

  var html =
    '<div dir="rtl" style="font-family:Tahoma,Arial,sans-serif;line-height:1.8">' +
    '<h2>تقرير الأسبوع</h2>' +
    '<table border="1" cellpadding="8" cellspacing="0" style="border-collapse:collapse">' +
    '<tr><th>المؤشر</th><th>هذا الأسبوع</th><th>الأسبوع السابق</th></tr>' +
    '<tr><td>الإنفاق</td><td>' + spend + '</td><td>' + prevSpend + '</td></tr>' +
    '<tr><td>النتايج</td><td>' + results + '</td><td>' + prevResults + '</td></tr>' +
    '<tr><td>تكلفة النتيجة</td><td>' + Number(cpr).toFixed(2) + '</td><td>' + Number(prevCpr).toFixed(2) + '</td></tr>' +
    '</table>' +
    '<p><strong>ملاحظات:</strong> ' + note + '</p>' +
    '<p>أي استفسار رد على الإيميل ده.</p>' +
    '</div>';

  MailApp.sendEmail({
    to: clientEmail,
    subject: subject,
    htmlBody: html
  });
}

شرح الكود ببساطة

• نقرأ الأرقام من خلايا ورقة «ملخص» بـ getRange(...).getValue().
• نبني نص الإيميل كـ HTML بسيط مع dir="rtl" عشان العربي يظهر صح من اليمين.
• نبعت الإيميل بـ MailApp.sendEmail.
• toFixed(2) بيقرّب الرقم لخانتين عشريتين. كل الأرقام في الإيميل هي اللي في الشيت بالظبط، ما فيش حاجة بتتألف.

الخطوة 4: اختبر على نفسك الأول

1. غيّر clientEmail لبريدك أنت.
2. شغّل الدالة sendWeeklyReport بزر Run.
3. أول مرة هتطلب صلاحية إرسال الإيميل والوصول للشيت. راجعها وسمح.
4. افتح الإيميل على الموبايل وعلى الكمبيوتر وتأكد إن العربي والأرقام ظاهرين صح.
5. قارن أرقام الإيميل بالشيت لتتأكد إنها مطابقة.
6. بعد ما تتأكد، حط إيميل العميل.

الخطوة 5: اضبط المشغّل الأسبوعي

1. من محرر Apps Script اضغط على المشغّلات (Triggers) (أيقونة الساعة).
2. اضغط إضافة مشغّل واختار sendWeeklyReport.
3. نوع الحدث: مشغّل مرتبط بالوقت ← مؤقّت أسبوعي.
4. اختار اليوم والساعة (مثلًا الأحد الصبح). ملحوظة: المشغّل ممكن يشتغل في نافذة زمنية حوالين الساعة اللي حددتها مش بالثانية بالظبط.
5. احفظ.

وتأكد إن بيانات الأسبوع بتتحدّث قبل موعد الإرسال. لو سحبك للبيانات بيشتغل بمشغّل تاني، خلّيه يسبق التقرير بساعات.

تطويرات مفيدة بعد النسخة الأولى

• مرفق PDF: ممكن تحوّل ورقة الملخص أو مستند إلى PDF وترفقه بالإيميل. بتحتاج شوية كود زيادة، فجرّبها بعد ما النسخة الأولى تستقر.
• تقرير لكل عميل: لو عندك عملاء كتير، اعمل ورقة عملاء فيها الإيميل واسم الشيت، والسكريبت يلف عليهم. لكن راعي حدود الإيميلات اليومية وخصوصية بيانات كل عميل (ما تخلّيش عميل يشوف بيانات عميل تاني).
• تلوين التغيّر: لو تكلفة النتيجة زادت، اكتب «زيادة» بلون مختلف. لكن حافظ على بساطة التقرير.
• تنبيه فوري: بالإضافة للأسبوعي، سكريبت بيبعتلك أنت (مش للعميل) إيميل لو التكلفة عدّت حد معين.
• سجل الإرسال: سطر في ورقة «سجل» بكل مرة اتبعت فيها تقرير، وتاريخها.

نقاط مهمة في الاحترافية والخصوصية

• خد موافقة العميل على استقبال التقرير على الإيميل المحدد.
• ما تبعتش بيانات حساسة (بيانات عملاء العميل أو أرقام الاتصال) في الإيميل التلقائي.
• راجع الأرقام يدويًا في الأسابيع الأولى. الأتمتة بتنقل الغلط زي ما بتنقل الصح.
• خلّي الجملة التحليلية بشرية. الأرقام تقدر تتأتمت، لكن تفسيرها (ليه التكلفة زادت؟ وإيه الخطوة الجاية؟) هو قيمتك.
• وضّح مصدر البيانات وفرق التتبع: أرقام ميتا وأرقام الموقع ممكن تختلف، وده تفصيل شرحته في فرق أرقام ميتا وGA4.
• حدّد مسؤول عن السكريبت: لو الحساب اللي مربوط بيه السكريبت اتقفل، التقرير هيقف.

أخطاء شائعة

• تقرير مليان أرقام: العميل ما بيقراش 30 مؤشر.
• قسمة على صفر: لما النتايج صفر، التقرير بيطلع خطأ أو Infinity.
• اسم ورقة أو خلية غلط: بيوقف السكريبت. اقرأ رسالة الخطأ في سجل التنفيذ.
• تواريخ بتتحسب غلط: تأكد من تنسيق التاريخ في الشيت ومن بداية الأسبوع عندك.
• نسيان اختبار الإيميل على الموبايل.
• الاعتماد على المشغّل من غير مراقبة: شوف سجل التنفيذات من وقت لوقت.
• إرسال تقرير بيانات ناقصة لأن السحب فشل. أضف شرط يتأكد إن فيه بيانات لليوم قبل الإرسال.

للتأكد من أحدث التفاصيل، راجع حدود استخدام Apps Script الرسمية (Quotas)، لأن الواجهات والسياسات بتتغيّر باستمرار.

مقالات ذات صلة بتفيدك:

• تقرير شهري للعميل: إيه اللي يتحط فيه وإيه اللي يتشال
• Looker Studio: بناء تقرير عميل من الصفر
• إدارة حسابات إعلانية لعملاء في أكتر من دولة: التنظيم الصحيح
• إزاي تبقى ميديا باير: خطة تعلّم من 6 شهور من غير كورسات غالية

اقرا كمان: أنواع المشغلات Triggers في Apps Script.

أسئلة شائعة

هل لازم أستخدم Looker Studio بدل الإيميل؟

لا، دي طرق مختلفة. Looker Studio بيعمل لوحة بيانات تفاعلية بيدخلها العميل، والإيميل بيوصل للعميل من غير ما يفتح حاجة. بعض العملاء بيفضّلوا الإيميل المختصر، وبعضهم يحبوا لوحة بيانات. اسألهم.

هل ينفع التقرير يتبعت بصيغة PDF؟

ينفع، لكن بتحتاج كود إضافي لتحويل المستند. ابدأ بإيميل HTML بسيط وبعدين طوّر.

كام عميل أقدر أبعتلهم من نفس السكريبت؟

فيه حد يومي للإيميلات المرسلة بيختلف حسب نوع حسابك، وبيتغيّر. راجع صفحة Quotas في وثائق Apps Script.

هل ينفع أعدّل الجملة التحليلية قبل الإرسال؟

آه، ودي أفضل ممارسة: اكتب الملاحظة في الخلية قبل موعد الإرسال، والسكريبت يقرأها. ولو ما كتبتش، ممكن تخلّي السكريبت يرسل التقرير بجملة افتراضية أو يتوقف.

لو عايز أبني لك نموذج تقرير تلقائي لحساباتك وعملائك أو أراجع تقريرك الحالي، تقدر تحجز استشارة معايا.