تحلیل خودکار عملکرد تبلیغات با هوش مصنوعی و n8n

تحلیل عملکرد تبلیغات با بینش‌های مبتنی بر هوش مصنوعی

این گردش کار، تحلیل عملکرد تبلیغات شما را در Meta Ads، Google Ads و Microsoft Ads خودکار می‌کند. این گردش کار از مدل Llama 3.3 70B از Groq برای ارائه نظرات تخصصی استفاده می‌کند، داده‌ها را در یک ایمیل HTML استایل‌دهی شده جمع‌آوری می‌کند و گزارش را از طریق Gmail ارسال می‌کند.

این گردش کار برای موارد زیر ایده‌آل است:

• تولید گزارش‌های اجرایی ماهانه برای کمپین‌های رسانه‌های پولی.
• مقایسه عملکرد بین پلتفرم‌های مختلف تبلیغاتی.
• ارائه بینش‌های خودکار و مبتنی بر هوش مصنوعی به تیم‌های بازاریابی.
• به عنوان یک قالب گزارش‌دهی پایه برای آژانس‌ها یا تیم‌های رشد داخلی.

گردش کار به بخش‌های منطقی زیر ساختاربندی شده است:

۱. نمای کلی گردش کار

این گردش کار با یک تریگر زمان‌بندی شده آغاز می‌شود، داده‌ها را از Google Sheets استخراج می‌کند، شاخص‌های کلیدی عملکرد (KPI) را تجمیع و آماده می‌کند، بینش‌های مبتنی بر هوش مصنوعی را با استفاده از Groq تولید می‌کند، داده‌ها را ادغام می‌کند و در نهایت یک گزارش ایمیل HTML را ایجاد و ارسال می‌کند.

۱.۱. تریگر زمان‌بندی شده

• هدف: راه‌اندازی خودکار گردش کار به صورت ماهانه.
• Node: n8n-nodes-base.scheduleTrigger

۱.۲. استخراج داده از Google Sheets

• هدف: خواندن داده‌های عملکرد کمپین از سه تب مجزا در یک Google Sheet واحد: "Google"، "Meta" و "Microsoft".
• Nodes:

* n8n-nodes-base.googleSheets (برای داده‌های Google Ads)

* n8n-nodes-base.googleSheets (برای داده‌های Meta Ads)

* n8n-nodes-base.googleSheets (برای داده‌های Microsoft Ads)

۱.۳. تجمیع داده و آماده‌سازی KPI

• هدف: ادغام داده‌ها از هر سه پلتفرم، نرمال‌سازی آن‌ها به یک ساختار سازگار، تجمیع معیارهای کلیدی و آماده‌سازی یک پرامپت ساختاریافته برای مدل هوش مصنوعی.
• Node: n8n-nodes-base.code

۱.۴. تولید بینش هوش مصنوعی با Groq

• هدف: ارسال پرامپت آماده شده به API چت کامپلیشن Groq با استفاده از مدل llama-3.3-70b-versatile برای تولید نظرات تخصصی.
• Node: n8n-nodes-base.httpRequest

۱.۵. ادغام داده‌های KPI با خروجی هوش مصنوعی

• هدف: ترکیب KPIهای محاسبه شده با بینش‌های تولید شده توسط هوش مصنوعی در یک شیء داده واحد برای تولید گزارش.
• Node: n8n-nodes-base.merge

۱.۶. ترکیب گزارش HTML و تحویل ایمیل

• هدف: ایجاد یک گزارش HTML استایل‌دهی شده شامل نمودارها، جداول خلاصه، جزئیات کمپین و نظرات فرمت‌بندی شده هوش مصنوعی، سپس ارسال آن از طریق Gmail.
• Nodes:

* n8n-nodes-base.code (برای تولید HTML)

* n8n-nodes-base.gmail (برای ارسال ایمیل)

---

۲. تحلیل جزئی Node

۲.۱. تریگر زمان‌بندی شده

• نوع Node: n8n-nodes-base.scheduleTrigger
• نقش فنی: نقطه ورود گردش کار.
• پیکربندی: تنظیم شده برای اجرا به صورت ماهانه. روز و زمان دقیق باید در رابط کاربری n8n تأیید شود.
• اتصالات:

* خروجی به: Read - Google Ads, Read - Meta Ads, Read - Microsoft Ads

• نسخه: typeVersion: 1.3
• مشکلات احتمالی: تنظیمات نادرست منطقه زمانی، غیرفعال بودن گردش کار، ابهام در تنظیم "اولین روز ماه" در صورت عدم پیکربندی صریح در رابط کاربری.

۲.۲. استخراج داده از Google Sheets

این بخش Nodeهای مسئول دریافت داده‌های خام کمپین از Google Sheet شما را شرح می‌دهد.

#### ۲.۲.۱. Read - Google Ads

• نوع Node: n8n-nodes-base.googleSheets
• نقش فنی: خواندن داده‌ها از تب "Google".
• پیکربندی: به یک سند Google Sheet خاص به نام "Campaign data" متصل می‌شود و از تب "Google" می‌خواند.
• اتصالات:

* ورودی از: Trigger - Monthly Schedule

* خروجی به: Merge all platform

• نسخه: typeVersion: 4.7
• مشکلات احتمالی: اعتبارنامه‌های OAuth گوگل مفقود یا منقضی شده، مجوزهای اشتراک‌گذاری نادرست sheet/tab، عدم تطابق ردیف هدر، تب خالی.

#### ۲.۲.۲. Read - Meta Ads

• نوع Node: n8n-nodes-base.googleSheets
• نقش فنی: خواندن داده‌ها از تب "Meta".
• پیکربندی: از همان سند Google Sheet استفاده می‌کند و از تب "Meta" می‌خواند.
• اتصالات:

* ورودی از: Trigger - Monthly Schedule

* خروجی به: Merge all platform

• نسخه: typeVersion: 4.7
• مشکلات احتمالی: مشکلات OAuth یا مجوز، ستون‌های خروجی مورد انتظار Meta مفقود (مانند Campaign name, Amount spent (USD), Results, Purchase ROAS (return on ad spend)), تب خالی.

#### ۲.۲.۳. Read - Microsoft Ads

• نوع Node: n8n-nodes-base.googleSheets
• نقش فنی: خواندن داده‌ها از تب "Microsoft".
• پیکربندی: از همان سند Google Sheet استفاده می‌کند و از تب "Microsoft" می‌خواند.
• اتصالات:

* ورودی از: Trigger - Monthly Schedule

* خروجی به: Merge all platform

• نسخه: typeVersion: 4.7
• مشکلات احتمالی: مشکلات OAuth یا اشتراک‌گذاری، فیلدهای مورد انتظار Microsoft مفقود (مانند Status, Impr., Spend, Conv.), تب خالی.

#### ۲.۲.۴. Merge all platform

• نوع Node: n8n-nodes-base.merge
• نقش فنی: ادغام جریان‌های داده از سه Node Google Sheets.
• پیکربندی: تنظیم شده برای پذیرش ۳ ورودی.
• اتصالات:

* ورودی از: Read - Google Ads, Read - Meta Ads, Read - Microsoft Ads

* خروجی به: Calculate - KPIs & Build Prompt

• نسخه: typeVersion: 3.2
• مشکلات احتمالی: اگر یک منبع داده‌ای برنگرداند، شکل خروجی پایین‌دستی ممکن است بسته به نسخه n8n و حالت ادغام تحت تأثیر قرار گیرد.

۲.۳. تجمیع داده و آماده‌سازی KPI

• نوع Node: n8n-nodes-base.code
• نقش فنی: این موتور تحلیلی اصلی است. شمای داده‌ها را استاندارد می‌کند، KPIها را محاسبه می‌کند، روندهای کلیدی کمپین را شناسایی می‌کند و یک پرامپت دقیق برای هوش مصنوعی می‌سازد.
• پیکربندی: کد جاوا اسکریپت جاسازی شده موارد زیر را انجام می‌دهد:

1. از یک تابع کمکی num() برای تجزیه عددی قوی استفاده می‌کند.

2. پلتفرم منبع را بر اساس هدرهای ستون تشخیص می‌دهد.

3. هر ردیف را به یک مدل شیء سازگار نرمال‌سازی می‌کند (platform, campaign, status, type, impressions, clicks, spend, conversions, roas, cpm, purchases, budget).

4. معیارها را بر اساس پلتفرم و به صورت سراسری تجمیع می‌کند.

5. کمپین‌های با بهترین/بدترین عملکرد و پرچم‌های مرتبط با بودجه را شناسایی می‌کند.

6. یک پرامپت زبان طبیعی برای مدل Groq می‌سازد.

• عبارات/متغیرهای کلیدی: متغیرهای داخلی شامل items.map(i => i.json), detectPlatform(r), normalise(r), اشیاء KPI تجمیع شده (tG, tM, tMeta, tAll), توابع کمکی بینش (bestMS, worstMeta, bestMeta, budgetPaused) و پرامپت نهایی groqPrompt هستند.
• اتصالات:

* ورودی از: Merge all platform

* خروجی به: Groq - Generate Insights, Merge - KPI + AI

• نسخه: typeVersion: 2
• مشکلات احتمالی:

* تطابق دقیق نام ستون برای تشخیص پلتفرم حیاتی است.

* داده‌های عددی ناقص ممکن است به صورت خاموش به 0 تبدیل شوند.

* کمپین‌های گوگل به صورت ثابت برای نمایش "0 تبدیل در تمام کمپین‌ها" در پرامپت کدگذاری شده‌اند که ممکن است برای داده‌های آینده نیاز به تنظیم داشته باشد.

* کلیک‌های Meta استخراج نمی‌شوند و روی 0 تنظیم می‌شوند.

* roas و cpm مایکروسافت روی 0 تنظیم شده‌اند.

* شمای ردیف‌های ناشناخته دور ریخته می‌شوند.

* پردازش داده‌های Meta برای spend > 0 فیلتر می‌شود.

* ماه پرامپت ("February 2026") و نام تجاری ("Biogetica") به صورت ثابت کدگذاری شده‌اند و در صورت استفاده مجدد باید پویا باشند.

• خروجی:

* json.kpi: شامل معیارهای تجمیع شده و لیست کمپین‌ها.

* json.groqPrompt: متن پرامپت آماده برای هوش مصنوعی.

۲.۴. تولید بینش هوش مصنوعی با Groq

• نوع Node: n8n-nodes-base.httpRequest
• نقش فنی: ارسال پرامپت به API Groq و دریافت تحلیل هوش مصنوعی.
• پیکربندی:

* متد: POST

* URL: https://api.groq.com/openai/v1/chat/completions

* احراز هویت: احراز هویت هدر HTTP با استفاده از کلید API Groq.

* هدرها: Content-Type: application/json

* بدنه: JSON ساخته شده به صورت پویا شامل model: "llama-3.3-70b-versatile" و messages: [{ role: "user", content: $json.groqPrompt }].

• عبارات/متغیرهای کلیدی: {{$json.groqPrompt}} در بدنه درخواست استفاده می‌شود.
• اتصالات:

* ورودی از: Calculate - KPIs & Build Prompt

* خروجی به: Merge - KPI + AI

• نسخه: typeVersion: 4.4
• مشکلات احتمالی: کلید API نامعتبر/مفقود، خطاهای احراز هویت (401/403)، محدودیت نرخ، مهلت زمانی API، ساختار پاسخ API غیرمنتظره، طول پرامپت فراتر از محدودیت‌ها.

۲.۵. ادغام داده‌های KPI با خروجی هوش مصنوعی

• نوع Node: n8n-nodes-base.merge
• نقش فنی: ترکیب داده‌های KPI و پاسخ هوش مصنوعی در یک آیتم واحد.
• پیکربندی:

* حالت: combine

* ترکیب بر اساس: combineByPosition (فرض می‌کند یک آیتم از هر شاخه ورودی).

• اتصالات:

* ورودی از: Groq - Generate Insights, Calculate - KPIs & Build Prompt

* خروجی به: Build - HTML Report

• نسخه: typeVersion: 3.2
• مشکلات احتمالی: اگر هر یک از شاخه‌های ورودی صفر آیتم تولید کند، ادغام ممکن است شکست بخورد یا نتایج غیرمنتظره‌ای تولید کند.

۲.۶. ترکیب گزارش HTML و تحویل ایمیل

این بخش مراحل نهایی ایجاد و ارسال گزارش را پوشش می‌دهد.

#### ۲.۶.۱. Build - HTML Report

• نوع Node: n8n-nodes-base.code
• نقش فنی: تولید محتوای نهایی HTML برای گزارش ایمیل.
• پیکربندی: کد جاوا اسکریپت در این Node داده‌های ادغام شده KPI و هوش مصنوعی را دریافت کرده و آن را به یک ساختار HTML جامع، شامل جداول، نمودارها (در صورت پیاده‌سازی از طریق کتابخانه‌ها یا SVGهای جاسازی شده) و متن استایل‌دهی شده برای نظرات هوش مصنوعی، فرمت می‌کند.
• اتصالات:

* ورودی از: Merge - KPI + AI

* خروجی به: Send - Email Report

• نسخه: typeVersion: 2
• مشکلات احتمالی: خطاهای منطق تولید HTML، مشکلات در فرمت‌بندی داده‌ها برای نمودارها یا جداول، مشکلات سازگاری با کلاینت‌های مختلف ایمیل.

#### ۲.۶.۲. Send - Email Report

• نوع Node: n8n-nodes-base.gmail
• نقش فنی: ارسال گزارش HTML تولید شده از طریق ایمیل با استفاده از یک حساب Gmail.
• پیکربندی: نیاز به اعتبارنامه‌های OAuth Gmail دارد. موضوع ایمیل، گیرنده(ها) و بدنه (حاوی HTML) در اینجا پیکربندی می‌شوند.
• اتصالات:

* ورودی از: Build - HTML Report

• نسخه: typeVersion: 3.1
• مشکلات احتمالی: اعتبارنامه‌های OAuth Gmail نامعتبر، آدرس‌های گیرنده نادرست، محدودیت‌های ارسال Gmail، مشکلات در رندر HTML در کلاینت‌های ایمیل.

---

۳. راه‌اندازی و سفارشی‌سازی گردش کار

1. Google Sheets: اطمینان حاصل کنید که Google Sheet شما به نام "Campaign data" وجود دارد و شامل سه تب است: "Google"، "Meta" و "Microsoft". این تب‌ها را با داده‌های عملکرد تبلیغات خود پر کنید و اطمینان حاصل کنید که هدرهای ستون با مواردی که توسط Node Calculate - KPIs & Build Prompt انتظار می‌رود مطابقت دارند.

2. کلید API Groq: یک کلید API از Groq دریافت کرده و آن را در Node Groq - Generate Insights با استفاده از احراز هویت هدر HTTP پیکربندی کنید.

3. اعتبارنامه‌های Gmail: اعتبارنامه‌های OAuth Gmail را در n8n راه‌اندازی کنید تا به گردش کار اجازه ارسال ایمیل را بدهد.

4. مقادیر پویا: برای قابلیت استفاده مجدد، در نظر بگیرید که ماه، سال و نام تجاری کدگذاری شده در Node Calculate - KPIs & Build Prompt را با استفاده از پارامترهای گردش کار یا متغیرهای محیطی پویا کنید.

5. مدیریت خطا: Nodeهای اضافی مدیریت خطا (مانند n8n-nodes-base.stickyNote با تریگرهای خطا) را برای نظارت بر شکست‌ها در مراحل حیاتی مانند فراخوانی API یا پردازش داده پیاده‌سازی کنید.

6. پیاده‌سازی نمودار: اگر می‌خواهید نمودارهای بصری را شامل کنید، ممکن است لازم باشد یک کتابخانه نمودار را در Node کد Build - HTML Report ادغام کنید یا از سرویسی استفاده کنید که تصاویر نمودار را تولید می‌کند.

---

۴. لینک کاتالوگ Axeto.ai

این گردش کار را مستقیماً از کاتالوگ n8n در Axeto.ai کاوش و وارد کنید: https://axeto.ai/n8n