ابزار هوشمند جاسوسی تبلیغات فیسبوک با Apify و OpenAI

ابزار جاسوسی تبلیغات فیسبوک با هوش مصنوعی با استفاده از Apify، OpenAI، Gemini و Google Sheets

این گردش کار به عنوان یک ابزار جاسوسی تبلیغات فیسبوک با قدرت هوش مصنوعی عمل می‌کند که برای جمع‌آوری، تحلیل و خلاصه‌سازی تبلیغات رقبا از کتابخانه عمومی تبلیغات فیسبوک طراحی شده است. این ابزار برای آژانس‌های بازاریابی، مشتریان PPC و تبلیغ‌کنندگانی که به دنبال اطلاعات رقابتی در مورد استراتژی‌های تبلیغاتی در فرمت‌های ویدئویی، تصویری و متنی هستند، ایده‌آل است. این گردش کار، وب اسکرپینگ، پردازش هوش مصنوعی چندوجهی (OpenAI GPT-4، Gemini) و ذخیره‌سازی داده‌ها در Google Sheets را یکپارچه می‌کند.

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

ساختار گردش کار

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

1. جمع‌آوری داده از کتابخانه تبلیغات فیسبوک: جمع‌آوری تبلیغات با استفاده از Apify، فیلتر کردن تبلیغات بر اساس تعداد لایک صفحه و هدایت تبلیغات بر اساس نوع محتوای آن‌ها (ویدئو، تصویر، متن).

2. خط لوله پردازش تبلیغات ویدئویی: دانلود تبلیغات ویدئویی، آپلود آن‌ها در Google Drive و Gemini AI، انجام تحلیل محتوای ویدئو و تولید خلاصه‌ها به همراه کپی‌های بازنویسی شده تبلیغات.

3. پردازش تبلیغات تصویری و متنی: پردازش تبلیغات تصویری با GPT-4 Vision و تبلیغات متنی با GPT-4، خلاصه‌سازی و بازنویسی محتوا برای بینش‌های استراتژیک.

4. ذخیره‌سازی و خروجی داده‌ها: ذخیره تمام نتایج پردازش شده در یک Google Sheet، ایجاد یک پایگاه داده جامع برای هوش رقابتی.

5. کنترل و هماهنگ‌سازی: مدیریت منطق راه‌اندازی، دسته‌بندی، انتظار و انشعاب برای پردازش مقیاس‌پذیر تبلیغات.

---

تشریح گره‌ها (Nodes) به صورت جزئی

۱. استخراج داده از کتابخانه تبلیغات فیسبوک

این بخش گردش کار را آغاز می‌کند، تبلیغات فیسبوک را با استفاده از Apify استخراج می‌کند، آن‌ها را بر اساس تعامل تبلیغ‌کننده فیلتر می‌کند و سپس بر اساس نوع رسانه به خط لوله پردازش مناسب هدایت می‌کند.

• گره‌ها (Nodes):

* Manual Trigger (n8n-nodes-base.manualTrigger)

* Run Ad Library Scraper (n8n-nodes-base.httpRequest)

* Filter For Likes (n8n-nodes-base.filter)

* Switch (n8n-nodes-base.switch)

* Loop Over Video Ads (n8n-nodes-base.splitInBatches)

* Loop Over Image Ads (n8n-nodes-base.splitInBatches)

* Loop Over Text Ads (n8n-nodes-base.splitInBatches)

• جزئیات گره‌ها (Node Details):

* Manual Trigger: نقطه ورود برای اجرای گردش کار در صورت تقاضا.

* Run Ad Library Scraper: API Apify را برای استخراج تبلیغات فیسبوک فراخوانی می‌کند.

* پیکربندی (Configuration): از درخواست POST با بدنه JSON که پارامترهای جستجو را مشخص می‌کند (مانند کلیدواژه "ai automation"، کشور آمریکا، ۷ روز گذشته، ۲۰۰ تبلیغ) استفاده می‌کند. نیاز به کلید API Apify در هدر احراز هویت دارد.

* خروجی‌ها (Outputs): داده‌های خام تبلیغات.

* موارد مرزی (Edge Cases): کلید API ناموجود/نامعتبر، خرابی درخواست، محدودیت‌های نرخ (rate limits)، پاسخ‌های JSON ناقص.

* Filter For Likes: تبلیغ‌کنندگانی را که کمتر از ۱۰۰۰ لایک صفحه دارند، فیلتر می‌کند.

* شرط (Condition): $json.advertiser.ad_library_page_info.page_info.likes > 1000

* خروجی‌ها (Outputs): تبلیغات فیلتر شده.

* موارد مرزی (Edge Cases): فیلد likes ناموجود، مقادیر صفر/null، ناسازگاری داده‌ها.

* Switch: تبلیغات را بر اساس محتوای رسانه‌ای آن‌ها مسیریابی می‌کند.

* شرایط (Conditions):

* Video: snapshot.videos[0].video_sd_url با "https://video-" شروع می‌شود.

* Image: snapshot.images[0].original_image_url با "https://scontent-ho" شروع می‌شود.

* Fallback: تبلیغات متنی.

* خروجی‌ها (Outputs): تبلیغات هدایت شده به حلقه‌های دسته‌ای مربوطه.

* موارد مرزی (Edge Cases): URLهای رسانه‌ای ناموجود/ناقص، تبلیغات با چندین نوع رسانه، انواع رسانه‌ای غیرمنتظره.

* Loop Over Video Ads / Image Ads / Text Ads: تبلیغات را در دسته‌های قابل مدیریت برای هر نوع رسانه پردازش می‌کند.

* نوع (Type): n8n-nodes-base.splitInBatches

* خروجی‌ها (Outputs): تبلیغات دسته‌بندی شده به خطوط لوله پردازش مربوطه.

* موارد مرزی (Edge Cases): دسته‌های خالی، مدیریت اندازه دسته، خرابی‌های جزئی.

---

۲. خط لوله پردازش تبلیغات ویدیویی

این خط لوله تبلیغات ویدیویی را پردازش می‌کند: دانلود آن‌ها، آپلود در Google Drive و Gemini برای تجزیه و تحلیل، و سپس استفاده از OpenAI برای خلاصه‌سازی و تولید متن تبلیغاتی.

• گره‌ها (Nodes):

* Download Video (n8n-nodes-base.httpRequest)

* Upload Video to Drive (n8n-nodes-base.googleDrive)

* Begin Gemini Upload Session (n8n-nodes-base.httpRequest)

* Redownload Video (n8n-nodes-base.googleDrive)

* Upload Video to Gemini (n8n-nodes-base.httpRequest)

* Wait 15s (n8n-nodes-base.wait)

* Analyze Video with Gemini (n8n-nodes-base.httpRequest)

* Output Video Summary (@n8n/n8n-nodes-langchain.openAi)

* Add as Type = Video (n8n-nodes-base.googleSheets)

• جزئیات گره‌ها (Node Details):

* Download Video: فایل ویدیو را از فیسبوک دانلود می‌کند.

* پیکربندی (Configuration): URL روی snapshot.videos[0].video_sd_url تنظیم شده است.

* خروجی‌ها (Outputs): داده‌های باینری ویدیو.

* موارد مرزی (Edge Cases): URL نامعتبر، خرابی دانلود، اندازه‌های بزرگ فایل، مهلت زمانی (timeouts).

* Upload Video to Drive: ویدیو را برای ذخیره‌سازی موقت در Google Drive آپلود می‌کند.

* اعتبارنامه (Credential): Google Drive OAuth2.

* خروجی‌ها (Outputs): فراداده فایل Google Drive.

* موارد مرزی (Edge Cases): خرابی آپلود، خطاهای مجوز، محدودیت‌های سهمیه (quota limits).

* Begin Gemini Upload Session: یک جلسه آپلود قابل از سرگیری (resumable upload) را به API Gemini آغاز می‌کند.

* پیکربندی (Configuration): درخواست POST به URL آپلود Gemini با هدرها و کلید API مناسب.

* خروجی‌ها (Outputs): URL جلسه آپلود.

* موارد مرزی (Edge Cases): کلید API نامعتبر، خطاهای شبکه، پیکربندی نادرست هدر.

* Redownload Video: ویدیو را از Google Drive دانلود می‌کند تا برای آپلود در Gemini آماده شود.

* اعتبارنامه (Credential): Google Drive OAuth2.

* خروجی‌ها (Outputs): داده‌های باینری ویدیو.

* موارد مرزی (Edge Cases): فایل یافت نشد، مشکلات مجوز.

* Upload Video to Gemini: داده‌های ویدیو را با استفاده از جلسه قابل از سرگیری به Gemini آپلود می‌کند.

* پیکربندی (Configuration): درخواست POST با داده‌های باینری، هدرهایی برای طول محتوا، افست (offset) و دستورات آپلود. از کلید API استفاده می‌کند.

* خروجی‌ها (Outputs): تأیید تکمیل آپلود.

* موارد مرزی (Edge Cases): وقفه در آپلود، افست‌های نادرست، خطاهای API.

* Wait 15s: اجرای برنامه را به مدت ۱۵ ثانیه متوقف می‌کند تا Gemini بتواند ویدیوی آپلود شده را پردازش کند.

* نوع (Type): n8n-nodes-base.wait

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

* Analyze Video with Gemini: درخواستی را به Gemini AI برای توصیف دقیق محتوای ویدیو ارسال می‌کند.

* پیکربندی (Configuration): POST به نقطه پایانی مدل Gemini با بدنه JSON که درخواست توصیف ویدیو را دارد. از کلید API استفاده می‌کند. برای تلاش‌های مجدد پیکربندی شده است.

* خروجی‌ها (Outputs): توضیحات محتوای ویدیوی Gemini.

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

* Output Video Summary: از OpenAI GPT-4.1 برای تولید خلاصه‌ای استراتژیک و متن تبلیغاتی بازنویسی شده استفاده می‌کند.

* نوع (Type): @n8n/n8n-nodes-langchain.openAi

* پیکربندی (Configuration): دما 0.7، اعلان‌های سیستمی و کاربر که برای تجزیه و تحلیل تبلیغات سفارشی شده‌اند. خروجی JSON.

* اعتبارنامه (Credential): کلید API OpenAI.

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

* Add as Type = Video: داده‌های تبلیغات ویدیویی تجزیه و تحلیل شده را به یک صفحه گسترده Google Sheets اضافه می‌کند.

* نوع (Type): n8n-nodes-base.googleSheets

* پیکربندی (Configuration): فیلدهایی مانند page_id، summary، rewritten_ad_copy، video_prompt، تاریخ و غیره را نگاشت می‌کند.

* اعتبارنامه (Credential): Google Sheets OAuth2.

* موارد مرزی (Edge Cases): دسترسی به صفحه رد شد، سهمیه فراتر رفت، عدم تطابق طرح (schema mismatches).

---

۳. پردازش تبلیغات تصویری و متنی

این بخش تبلیغات تصویری و متنی را به طور جداگانه پردازش می‌کند، از GPT-4 Vision برای تصاویر و GPT-4 برای متن استفاده می‌کند و سپس بینش‌ها را در Google Sheets ذخیره می‌کند.

• گره‌ها (Nodes):

* مسیر تصویر (Image Route):

* Analyze Image (OpenAI Vision - بخشی از @n8n/n8n-nodes-langchain.openAi)

* Output Image Summary (OpenAI - بخشی از @n8n/n8n-nodes-langchain.openAi)

* Add as Type = Image (n8n-nodes-base.googleSheets)

* Wait 1s (n8n-nodes-base.wait)

* مسیر متن (Text Route):

* Output Text Summary (OpenAI - بخشی از @n8n/n8n-nodes-langchain.openAi)

* Add as Type = Text (n8n-nodes-base.googleSheets)

* Wait 1s (n8n-nodes-base.wait)

• جزئیات گره‌ها (Node Details):

* Analyze Image: محتوای تصویر را با استفاده از GPT-4 Vision توصیف می‌کند.

* پیکربندی (Configuration): ورودی URL تصویر از snapshot.images[0].original_image_url است.

* اعتبارنامه (Credential): OpenAI API.

* موارد مرزی (Edge Cases): URL تصویر نامعتبر، خرابی API.

* Output Image Summary: JSON تبلیغات و توضیحات تصویر را برای بینش خلاصه می‌کند.

* پیکربندی (Configuration): GPT-4.1، دما 0.7، اعلان‌های سفارشی شده، خروجی JSON.

* اعتبارنامه (Credential): OpenAI API.

* موارد مرزی (Edge Cases): خطاهای API، خرابی اعلان‌ها.

* Add as Type = Image: خلاصه‌ها و متن تبلیغاتی بازنویسی شده تبلیغات تصویری را در Google Sheets ذخیره می‌کند.

* پیکربندی (Configuration): فیلدهایی مانند page_id، summary، image_prompt و غیره را نگاشت می‌کند.

* اعتبارنامه (Credential): Google Sheets OAuth2.

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

* Wait 1s: پس از پردازش تصویر، یک تأخیر ۱ ثانیه‌ای اضافه می‌کند.

* نوع (Type): n8n-nodes-base.wait

* Output Text Summary: تبلیغات فقط متنی را با استفاده از GPT-4.1 خلاصه و بازنویسی می‌کند.

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

* اعتبارنامه (Credential): OpenAI API.

* موارد مرزی (Edge Cases): خرابی اعلان یا API.

* Add as Type = Text: نتایج تجزیه و تحلیل تبلیغات متنی را در Google Sheets ذخیره می‌کند.

* اعتبارنامه (Credential): Google Sheets OAuth2.

* موارد مرزی (Edge Cases): مشکلات دسترسی به صفحه.

* Wait 1s: پس از دسته‌های پردازش متن، یک تأخیر ۱ ثانیه‌ای اضافه می‌کند.

* نوع (Type): n8n-nodes-base.wait

---

۴. ذخیره‌سازی و خروجی داده‌ها

تمام داده‌های تبلیغاتی پردازش شده (ویدیویی، تصویری، متنی) در یک صفحه گسترده Google Sheets واحد ادغام می‌شوند و یک پایگاه داده اطلاعات رقابتی قابل جستجو ایجاد می‌کنند.

• گره‌ها (Nodes):

* Add as Type = Video (n8n-nodes-base.googleSheets)

* Add as Type = Image (n8n-nodes-base.googleSheets)

* Add as Type = Text (n8n-nodes-base.googleSheets)

• جزئیات (Details): هر گره Google Sheets داده‌ها را به همان سند صفحه گسترده و صفحه اضافه می‌کند. فیلدها شامل نوع تبلیغات، اطلاعات صفحه، خلاصه، متن تبلیغاتی بازنویسی شده، اعلان‌ها و مُهر زمانی هستند.

* اعتبارنامه (Credential): Google Sheets OAuth2 مورد نیاز است.

* موارد مرزی (Edge Cases): محدودیت‌های سهمیه API، عدم تطابق طرح، مجوزهای دسترسی.

---

۵. کنترل و هماهنگ‌سازی

این بخش جریان اجرا، دسته‌بندی و زمان‌بندی را مدیریت می‌کند تا از پردازش روان اطمینان حاصل شود و از مشکلات محدودیت نرخ API جلوگیری کند.

• گره‌ها (Nodes):

* گره‌های مختلف Wait (مانند Wait 1s، Wait 15s) (n8n-nodes-base.wait)

* Sticky Note (n8n-nodes-base.stickyNote) برای حاشیه‌نویسی‌ها و توضیحات.

• جزئیات (Details): گره‌های Wait تأخیرهای کنترل شده‌ای را برای تنظیم سرعت درخواست‌های API و مدیریت پردازش دسته‌ای معرفی می‌کنند.

* موارد مرزی (Edge Cases): تأخیرهای خیلی کوتاه می‌توانند باعث خطاهای محدودیت نرخ API شوند؛ تأخیرهای خیلی طولانی می‌توانند تأخیر کلی گردش کار را افزایش دهند.

جدول خلاصه