تحلیل خودکار Google Analytics با هوش مصنوعی Gemini و اعلان‌ه…

اتوماسیون تحلیل Google Analytics با هوش مصنوعی Gemini و اعلان‌های هوشمند

این گردش کار، بازیابی هفتگی، تحلیل مبتنی بر هوش مصنوعی، طبقه‌بندی احساسات و اعلان هدفمند داده‌های Google Analytics را خودکار می‌کند. این گردش کار برای تیم‌هایی طراحی شده است که به گزارش‌های مختصر و روشنگر که از طریق Gmail و Telegram ارائه می‌شوند، نیاز دارند و با برجسته کردن خودکار روندهای مثبت و منفی، تصمیم‌گیری مبتنی بر داده را بهبود می‌بخشد.

مراحل گردش کار:

1. زمان‌بندی و بازیابی داده‌ها: گردش کار را به صورت هفتگی آغاز می‌کند تا معیارهای Google Analytics را دریافت کند.

2. تجمیع داده‌ها: داده‌های خام Google Analytics را به یک فرمت JSON یکپارچه نرمال می‌کند.

3. پردازش هوش مصنوعی و حافظه: از هوش مصنوعی Google Gemini و یک عامل هوش مصنوعی LangChain با حافظه برای تجزیه و تحلیل داده‌ها و تولید بینش‌های مختصر استفاده می‌کند.

4. تحلیل احساسات: بینش‌های تولید شده توسط هوش مصنوعی را به عنوان مثبت یا منفی طبقه‌بندی می‌کند.

5. اعلان‌های هوشمند: بینش‌ها را از طریق Gmail و Telegram با پیام‌های قالب‌بندی شده به ذینفعان ارسال می‌کند.

---

۱. زمان‌بندی و بازیابی داده‌ها

این مرحله گردش کار را به صورت هفتگی فعال می‌کند و داده‌های ضروری Google Analytics را از هفته گذشته بازیابی می‌کند.

گره‌ها (Nodes):

• Schedule Trigger

* نوع: Schedule Trigger

* نقش: هر ۷ روز گردش کار را آغاز می‌کند.

* پیکربندی: بازه زمانی روی ۷ روز تنظیم شده است.

* ورودی: ندارد (تریگر).

* خروجی: گره "Get a weekly report" را فعال می‌کند.

* موارد خاص (Edge Cases): پیکربندی نادرست ممکن است منجر به فعال‌سازی‌های از دست رفته یا اجرای همپوشان شود.

• Get a weekly report

* نوع: Google Analytics (GA4)

* نقش: معیارهای کلیدی Google Analytics را برای پراپرتی پیکربندی شده دریافت می‌کند.

* پیکربندی:

* Metrics: eventCount, userEngagementDuration, active7DayUsers, active28DayUsers, sessions.

* Dimensions: پیکربندی نشده است.

* Property ID: 483751327 (با شناسه پراپرتی GA4 خود جایگزین کنید).

* Authentication: اعتبارنامه‌های OAuth2 برای حساب Google Analytics شما.

* ورودی: فعال‌سازی از گره "Schedule Trigger".

* خروجی: داده‌های خام Google Analytics به گره "Aggregate" ارسال می‌شود.

* موارد خاص (Edge Cases): توکن‌های OAuth منقضی شده، محدودیت‌های سهمیه API، یا عدم وجود داده در صورت غیرفعال بودن وب‌سایت.

---

۲. تجمیع داده‌ها

این مرحله داده‌های خام Google Analytics را در یک فرمت JSON نرمال‌شده ادغام می‌کند و آن را برای تحلیل هوش مصنوعی آماده می‌سازد.

گره‌ها (Nodes):

• Aggregate

* نوع: Aggregate

* نقش: تمام آیتم‌های داده ورودی Google Analytics را در یک شیء JSON واحد (aggregateAllItemData) ادغام می‌کند.

* پیکربندی: گزینه‌های پیش‌فرض تجمیع؛ هیچ گروه‌بندی یا تبدیل خاصی فراتر از تجمیع وجود ندارد.

* ورودی: داده‌های خام Google Analytics از گره "Get a weekly report".

* خروجی: داده‌های JSON تجمیع‌شده به گره "AI Agent" ارسال می‌شوند.

* موارد خاص (Edge Cases): داده‌های ورودی خالی ممکن است منجر به خروجی JSON خالی شود.

* یادداشت چسبان (Sticky Note):

```markdown

## Aggregate

نرمال‌سازی ردیف‌های GA به یک JSON واحد

```

---

۳. پردازش هوش مصنوعی و حافظه

این مرحله از هوش مصنوعی Google Gemini و یک عامل هوش مصنوعی LangChain با حافظه برای تجزیه و تحلیل داده‌های تجمیع شده و تولید خلاصه‌های تحلیلی هفتگی مختصر استفاده می‌کند.

گره‌ها (Nodes):

• AI Agent

* نوع: LangChain Agent

* نقش: داده‌های JSON تجمیع شده را دریافت کرده و خلاصه‌ای تحلیلی مختصر را که برای پیام تلگرام قالب‌بندی شده است، تولید می‌کند.

* پیکربندی:

* عبارت ورودی متن (Input Text Expression): ={{ $json.data }} (JSON تجمیع شده).

* پیام سیستمی (System Message): به هوش مصنوعی دستور می‌دهد تا به عنوان یک تحلیلگر داده با تجربه عمل کند، با حافظه مقایسه کند و خلاصه‌ای حداکثر ۱۰۰۰ کاراکتری تولید کند و اطلاعات کلیدی را با بک‌تیک برجسته کند.

* نوع اعلان (Prompt Type): "define" (اعلان سفارشی).

* ورودی: JSON تجمیع شده از نود "Aggregate".

* مدل زبان هوش مصنوعی (AI Language Model): روی "Google Gemini Chat Model" تنظیم شده است.

* حافظه هوش مصنوعی (AI Memory): روی "Simple Memory" تنظیم شده است.

* خروجی: JSON حاوی متن خلاصه‌شده، که به نود "Insight Sentiment Analysis" ارسال می‌شود.

* موارد خاص (Edge Cases): خرابی سرویس هوش مصنوعی، ورودی JSON نامعتبر، یا تجاوز از محدودیت‌های توکن.

* یادداشت چسبان (Sticky Note):

```markdown

## AI Agent

مصرف JSON تجمیع شده. پردازش JSON با اعلان سفارشی برای بینش

```

• Simple Memory

* نوع: LangChain Memory Buffer Window

* نقش: گزارش‌های هفتگی را که بر اساس داده‌های JSON تجمیع شده کلیدگذاری شده‌اند، ذخیره می‌کند تا مقایسه روند را تسهیل کند.

* پیکربندی:

* کلید جلسه (Session Key): روی داده‌های JSON تجمیع شده تنظیم شده است.

* شناسه جلسه (Session ID): از یک کلید سفارشی استفاده می‌کند.

* ورودی: برای زمینه حافظه به نود "AI Agent" متصل است.

* خروجی: زمینه حافظه را به نود "AI Agent" ارائه می‌دهد.

* موارد خاص (Edge Cases): سرریز احتمالی حافظه در صورت عدم مدیریت صحیح؛ عدم تطابق در کلیدهای جلسه.

* یادداشت چسبان (Sticky Note):

```markdown

## Simple Memory

گزارش هر هفته و معیارهای کلیدی را ذخیره کنید. برای تشخیص روند استفاده کنید.

```

• Google Gemini Chat Model

* نوع: Google Gemini (PaLM) Language Model

* نقش: بک‌اند مدل زبان هوش مصنوعی را برای نودهای "AI Agent" و "Insight Sentiment Analysis" فراهم می‌کند.

* پیکربندی: از اعتبارنامه‌های حساب Google PaLM API شما استفاده می‌کند.

* ورودی: به عنوان مدل زبان برای نودهای "AI Agent" و "Insight Sentiment Analysis" متصل است.

* خروجی: اعلان‌ها را برای هر دو نود متصل پردازش می‌کند.

* موارد خاص (Edge Cases): محدودیت‌های سهمیه API، خرابی احراز هویت.

---

۴. تحلیل احساسات

این مرحله بینش‌های تولید شده توسط هوش مصنوعی را به احساسات "مثبت" یا "منفی" طبقه‌بندی می‌کند و امکان ارسال اعلان‌های هدفمند را فراهم می‌آورد.

گره‌ها (Nodes):

• Insight Sentiment Analysis

* نوع: LangChain Sentiment Analysis

* نقش: خلاصه خروجی هوش مصنوعی را به "مثبت" یا "منفی" دسته‌بندی می‌کند.

* پیکربندی:

* دسته‌ها: به صراحت روی "Positive, Negative" تنظیم شده است.

* متن ورودی: خروجی خلاصه‌شده از نود "AI Agent".

* ورودی: خروجی از نود "AI Agent".

* خروجی: به نودهای "Notify Stakeholders" و "Send a message to group" هدایت می‌شود.

* موارد خاص (Edge Cases): احساسات مبهم، طبقه‌بندی اشتباه توسط هوش مصنوعی، یا متن ورودی ناموجود/خالی.

---

۵. اعلان‌های هوشمند

این مرحله نهایی، یافته‌های طبقه‌بندی‌شده احساسات را از طریق ایمیل Gmail و پیام‌های گروهی تلگرام به ذینفعان ارسال می‌کند.

گره‌ها (Nodes):

• Notify Stakeholders

* نوع: Gmail

* نقش: خلاصه گزارش هفتگی Google Analytics را به گیرندگان پیکربندی‌شده ایمیل می‌کند.

* پیکربندی:

* ایمیل(های) گیرنده: به‌صورت دستی تنظیم می‌شود.

* موضوع: شامل بازه زمانی گزارش است.

* متن پیام: از خروجی خلاصه‌شده عامل هوش مصنوعی استفاده می‌کند.

* احراز هویت: اعتبارنامه‌های OAuth2 برای حساب Gmail شما.

* ورودی: خروجی احساسات مثبت یا منفی از نود "Insight Sentiment Analysis".

* خروجی: ندارد (نود پایانی).

* موارد خاص (Edge Cases): توکن‌های منقضی‌شده Gmail OAuth، ایمیل‌های گیرنده نامعتبر، یا محدودیت‌های ارسال.

* یادداشت چسبان (Sticky Note):

```markdown

## Notify Stakeholders

ارسال پیام با بازه زمانی گزارش هفتگی زیر

```

• Send a message to group

* نوع: Telegram

* نقش: پیامی قالب‌بندی‌شده را به یک گروه چت تلگرام تعیین‌شده ارسال می‌کند تا در مورد یافته‌های تحلیلی هفتگی هشدار دهد.

* پیکربندی:

* متن پیام: شامل بازه زمانی و خروجی خلاصه هوش مصنوعی، قالب‌بندی‌شده برای تلگرام.

* شناسه چت: روی شناسه گروه یا کانال تلگرام هدف شما تنظیم شده است.

* احراز هویت: اعتبارنامه‌های API تلگرام شما.

* ورودی: مشابه نود "Notify Stakeholders".

* خروجی: ندارد (نود پایانی).

* موارد خاص (Edge Cases): شناسه چت نامعتبر، محدودیت‌های API تلگرام، یا خطاهای قالب‌بندی پیام.

* یادداشت چسبان (Sticky Note):

```markdown

## Send a message

ایجاد پیام هشدار مختصر برای کانال عملیات/بازاریابی

```

---

خلاصه گردش کار (Workflow Summary)

یادداشت کلی (Overall Sticky Note):

## بینش‌های هوش مصنوعی گوگل آنالیتیکس + مسیریابی احساسات

این اتوماسیون n8n به صورت هفتگی اجرا می‌شود تا آخرین داده‌های گوگل آنالیتیکس را دریافت کند، بینش‌های مبتنی بر هوش مصنوعی تولید کند و احساسات گزارش را طبقه‌بندی کند.

💡 **هدف:** ارائه خودکار به‌روزرسانی‌های تحلیلی قابل اجرا، اطمینان از اینکه روند‌های مثبت جشن گرفته می‌شوند و روند‌های منفی به سرعت مورد رسیدگی قرار می‌گیرند.

---

بازسازی گردش کار

برای ساخت این گردش کار از ابتدا، مراحل زیر را دنبال کنید:

1. افزودن گره "Schedule Trigger":

* نوع: Schedule Trigger

* بازه زمانی را برای اجرای هر 7 روز تنظیم کنید.

2. افزودن گره "Get a weekly report":

* نوع: Google Analytics (GA4)

* شناسه Property را به شناسه Property GA4 خود تنظیم کنید (مثال: 483751327).

* Metrics را پیکربندی کنید: eventCount, userEngagementDuration, active7DayUsers, active28DayUsers, sessions.

* (اختیاری) Dimensions را پیکربندی کنید.

* اعتبارنامه‌های OAuth2 Google Analytics خود را متصل کنید.

* خروجی گره "Schedule Trigger" را به ورودی این گره متصل کنید.

3. افزودن گره "Aggregate":

* نوع: Aggregate

* روش تجمیع را روی "Aggregate all items into one JSON" تنظیم کنید.

* ورودی را از گره "Get a weekly report" متصل کنید.

4. افزودن گره "Google Gemini Chat Model":

* نوع: Google Gemini (PaLM) AI Model

* اعتبارنامه‌های API Google PaLM خود را اضافه کنید.

* در این مرحله پارامترهای ویژه دیگری برای این گره لازم نیست. این گره به عنوان مدل زبان هوش مصنوعی برای گره‌های بعدی عمل خواهد کرد.

5. افزودن گره "Simple Memory":

* نوع: LangChain Memory Buffer Window

* Session Key را برای استفاده از ورودی JSON تجمیع شده پیکربندی کنید: ={{ $json.data }}.

* Session ID Type را روی "Custom Key" تنظیم کنید.

6. افزودن گره "AI Agent":

* نوع: LangChain Agent

* Input Text را به صورت ={{ $json.data }} تنظیم کنید (با ارجاع به JSON تجمیع شده از گره "Aggregate").

* گره "Google Gemini Chat Model" را به عنوان AI Language Model انتخاب کنید.

* گره "Simple Memory" را به عنوان AI Memory انتخاب کنید.

* System Message را پیکربندی کنید:

```

Acting as a experienced data analyst who mainly working with the analytics data. Please analyze the those google analytics report with the past history. Give the insightful and important summary. Make it concise maximum 1000 chars. The important information must give `` so user can notice easily. The result must follow the telegram messenger format. Compare with your memory as well.

Think step by step.

```

7. افزودن گره "Insight Sentiment Analysis":

* نوع: LangChain Sentiment Analysis

* Categories را روی Positive, Negative تنظیم کنید.

* Input Text را برای استفاده از خروجی گره "AI Agent" پیکربندی کنید.

* خروجی گره "AI Agent" را به ورودی این گره متصل کنید.

8. افزودن گره "Notify Stakeholders":

* نوع: Gmail

* آدرس(های) ایمیل گیرنده را پیکربندی کنید.

* Subject را برای شامل کردن محدوده تاریخ گزارش تنظیم کنید.

* Message Body را با استفاده از خروجی گره "AI Agent" بنویسید.

* اعتبارنامه‌های OAuth2 Gmail خود را متصل کنید.

* خروجی گره "Insight Sentiment Analysis" را به ورودی این گره متصل کنید.

9. افزودن گره "Send a message to group":

* نوع: Telegram

* Chat ID را برای گروه یا کانال تلگرام مورد نظر خود پیکربندی کنید.

* Message Text را با فرمت‌بندی برای تلگرام و شامل خلاصه هوش مصنوعی بنویسید.

* اعتبارنامه‌های API تلگرام خود را متصل کنید.

* خروجی گره "Insight Sentiment Analysis" را به ورودی این گره متصل کنید.

10. افزودن گره‌های "Sticky Note" (اختیاری اما توصیه می‌شود):

* از گره‌های "Sticky Note" برای اضافه کردن مستندات و توضیحات مستقیماً در بوم گردش کار خود استفاده کنید، همانطور که در "Workflow Summary Table" و توضیحات گره‌های فردی در بالا نشان داده شده است.

شما می‌توانید این قالب گردش کار را در Axeto.ai پیدا کرده و وارد کنید.