تحلیل خلاقیت‌های تبلیغاتی متا با Google Vision API

تحلیل خلاقیت‌های تبلیغاتی متا با استفاده از APIهای Google Vision و Video Intelligence

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

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

1. تریگر زمان‌بندی شده و راه‌اندازی کمپین: گردش کار را روزانه آغاز کرده و شناسه کمپین متا تبلیغات را برای تحلیل تعریف می‌کند.

2. بازیابی آگهی و انشعاب نوع خلاقیت: آگهی‌های فعال را برای کمپین مشخص شده بازیابی کرده و پردازش را بر اساس اینکه خلاقیت ویدیو است یا تصویر، هدایت می‌کند.

3. تحلیل خلاقیت ویدیویی: برای آگهی‌های ویدیویی، این بلوک URL منبع ویدیو را بازیابی، ویدیو را دانلود و به Base64 تبدیل کرده، آن را به Google Video Intelligence API ارسال، تکمیل کار را بررسی (poll) می‌کند، نتایج را تجزیه کرده و بینش‌ها را ذخیره می‌کند.

4. تحلیل خلاقیت تصویری: برای آگهی‌های تصویری، این بلوک تصویر را دانلود، به Base64 تبدیل کرده، آن را به Google Vision API ارسال، نتایج را تجزیه کرده و بینش‌ها را ذخیره می‌کند.

5. مدیریت خطا: هرگونه خطا، مانند URLهای گمشده یا شکست API، را ثبت کرده و در یک تب اختصاصی Google Sheets ذخیره می‌کند.

6. تجمیع داده‌ها و خروجی: تمام داده‌های حاشیه‌نویسی تجزیه شده را از تحلیل‌های ویدیویی و تصویری تجمیع کرده و به Google Sheet اصلی اضافه می‌کند.

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

---

تشریح دقیق گردش کار

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

این بلوک اولیه، زمان‌بندی اجرای گردش کار را تنظیم کرده و کمپین مورد نظر در Meta Ads را مشخص می‌کند.

نودها:

• اجرا روزانه ساعت ۹ صبح (Schedule Trigger)

* هدف: گردش کار را هر روز ساعت ۹:۰۰ صبح به وقت محلی فعال می‌کند.

* پیکربندی: تنظیمات استاندارد تریگر زمان‌بندی.

* وابستگی‌ها: ندارد.

• تنظیم شناسه کمپین (Set)

* هدف: یک شناسه جایگزین برای شناسه کمپین Meta Ads تعیین می‌کند. کاربران باید "campaign_id" را با شناسه کمپین واقعی خود جایگزین کنند.

* پیکربندی: یک مقدار ثابت برای کلید campaign_id تنظیم می‌کند.

* وابستگی‌ها: اجرا روزانه ساعت ۹ صبح.

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

• یادداشت چسبان تنظیمات (Sticky Note)

* هدف: مستنداتی را برای کاربران در مورد نحوه یافتن شناسه کمپین خود در فیسبوک ادز منیجر ارائه می‌دهد.

* پیکربندی: فقط متن اطلاعاتی.

* وابستگی‌ها: ندارد.

---

۲. بازیابی آگهی و انشعاب نوع خلاقیت

این بخش، آگهی‌های فعال کمپین مشخص شده را بازیابی کرده و نوع خلاقیت (تصویر یا ویدیو) را برای پردازش بعدی تعیین می‌کند.

نودها:

• دریافت آگهی‌های فعال (Facebook Graph API)

* هدف: با استفاده از Facebook Graph API (نسخه ۲۲.۰)، آگهی‌های فعال مرتبط با شناسه کمپین ارائه شده را بازیابی می‌کند.

* پیکربندی: برای جزئیات id, name, و creative، از جمله video_data در صورت موجود بودن، کوئری می‌زند.

* وابستگی‌ها: تنظیم شناسه کمپین.

* مشکلات احتمالی: خطاهای احراز هویت (توکن فیسبوک منقضی شده)، محدودیت‌های نرخ API، یا شناسه کمپین نامعتبر.

• تقسیم کردن (Split Out)

* هدف: آرایه آگهی‌های دریافت شده از Facebook Graph API را به آیتم‌های آگهی مجزا برای پردازش موازی تجزیه می‌کند.

* وابستگی‌ها: دریافت آگهی‌های فعال.

* مشکلات احتمالی: اگر هیچ آگهی برگردانده نشود، پردازش‌های بعدی انجام نخواهد شد.

• آیا ویدیو است؟ (If)

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

* شرط: بررسی می‌کند که آیا $json.data.creative.object_story_spec.video_data.video_id وجود دارد یا خیر.

* انشعاب‌ها:

* درست: به بلوک پردازش ویدیو می‌رود.

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

* وابستگی‌ها: تقسیم کردن.

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

• یادداشت چسبان تقسیم (Sticky Note)

* هدف: منطق انشعاب برای پردازش خلاقیت‌های ویدیو در مقابل تصویر را توضیح می‌دهد.

* پیکربندی: فقط متن اطلاعاتی.

* وابستگی‌ها: ندارد.

---

۳. تحلیل خلاقیت ویدیویی

این بلوک به تحلیل دقیق خلاقیت‌های ویدیویی می‌پردازد.

نودها:

• دریافت URL منبع ویدیو (Facebook Graph API)

* هدف: متادیتای خلاقیت‌های ویدیویی، به ویژه URL مستقیم منبع فایل ویدیو را بازیابی می‌کند.

* پیکربندی: از Facebook Graph API (نسخه ۲۳.۰) برای کوئری زدن permalink_url, created_time, id, و source استفاده می‌کند.

* وابستگی‌ها: آیا ویدیو است؟ (انشعاب درست).

* مشکلات احتمالی: ممکن است ویدیو حذف شده باشد، یا مجوزها مانع دسترسی به URL منبع شوند.

• دانلود فایل ویدیو (HTTP Request)

* هدف: محتوای باینری ویدیو را از URL منبع بازیابی شده دانلود می‌کند.

* وابستگی‌ها: دریافت URL منبع ویدیو.

* مشکلات احتمالی: خطاهای HTTP، مهلت زمانی شبکه، یا شکست به دلیل حجم فایل‌های بسیار بزرگ.

• تبدیل ویدیو به رشته Base64 (Extract From File)

* هدف: داده‌های باینری ویدیوی دانلود شده را به یک رشته کدگذاری شده Base64 تبدیل می‌کند که برای Google Video Intelligence API لازم است.

* وابستگی‌ها: دانلود فایل ویدیو.

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

• حلقه برای ویدیوها (Split in Batches)

* هدف: پردازش فایل‌های ویدیویی را در دسته‌هایی مدیریت می‌کند و نرخ درخواست‌های ارسال شده به Google Video Intelligence API را کنترل می‌کند.

* وابستگی‌ها: تبدیل ویدیو به رشته Base64.

* مشکلات احتمالی: اندازه دسته ممکن است خیلی بزرگ باشد، یا محدودیت‌های سهمیه API ممکن است فراتر رود.

• شروع حاشیه‌نویسی ویدیو (HTTP Request)

* هدف: با ارسال محتوای ویدیوی کدگذاری شده Base64 و ویژگی‌های مورد نظر (مانند تشخیص برچسب، رونویسی گفتار، تشخیص متن) به Google Video Intelligence API، یک کار تحلیل ویدیویی ناهمزمان را آغاز می‌کند.

* پیکربندی: نیاز به اعتبارنامه‌های Google API دارد.

* وابستگی‌ها: حلقه برای ویدیوها.

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

• انتظار ۳۰ ثانیه (Wait)

* هدف: گردش کار را به مدت ۳۰ ثانیه متوقف می‌کند تا به کار تحلیل ویدیویی ناهمزمان اجازه دهد قبل از بررسی وضعیت آن، پیشرفت کند.

* وابستگی‌ها: شروع حاشیه‌نویسی ویدیو.

• بررسی وضعیت عملیات (HTTP Request)

* هدف: با استفاده از نام عملیات بازگردانده شده توسط درخواست اولیه، Google Video Intelligence API را برای بررسی وضعیت تکمیل کار حاشیه‌نویسی، بررسی می‌کند (polling).

* وابستگی‌ها: انتظار ۳۰ ثانیه.

* مشکلات احتمالی: خطاهای شبکه یا شکست‌های کار گزارش شده توسط API.

• اگر آماده است (If)

* هدف: با بررسی فیلد done در پاسخ API، تعیین می‌کند که آیا کار حاشیه‌نویسی ویدیو تکمیل شده است یا خیر.

* انشعاب‌ها:

* درست: به تجزیه نتایج می‌رود.

* نادرست: کمی صبر کرده و دوباره بررسی می‌کند.

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

• انتظار ۳ ثانیه (Wait)

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

* وابستگی‌ها: اگر آماده است (انشعاب نادرست).

• تنظیم داده‌های شناسه برای ویدیو (Set)

* هدف: متادیتای ضروری (مانند campaign_id, ad_id, creative_id, video_id, file_name, image_url, source) را به داده‌ها برای زمینه در نتایج تجزیه شده اختصاص می‌دهد.

* وابستگی‌ها: اگر آماده است (انشعاب درست).

• تجزیه داده‌ها (Code)

* هدف: پاسخ JSON را از Google Video Intelligence API تجزیه کرده و داده‌های ساختاریافته مانند برچسب‌های بخش، برچسب‌های شات، تشخیص متن و رونویسی گفتار را استخراج می‌کند.

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

* مدیریت خطا: برای مدیریت صحیح فیلدهای گمشده طراحی شده است.

• افزودن داده‌های بخش‌ها (Google Sheets)

* هدف: ردیف‌های داده تحلیل ویدیویی تجزیه شده را به تب اصلی Google Sheet اضافه می‌کند.

* پیکربندی: نیاز به اعتبارنامه‌های OAuth Google Sheets با مجوز نوشتن دارد.

* وابستگی‌ها: تجزیه داده‌ها.

* مشکلات احتمالی: محدودیت‌های نرخ API Google Sheets یا خطاهای مجوز.

• تنظیم (ردیف خطای ویدیو) (Set)

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

* وابستگی‌ها: شروع حاشیه‌نویسی ویدیو (در صورت خطا).

• افزودن خطاها (Google Sheets)

* هدف: هرگونه خطای مشاهده شده در طول پردازش ویدیو را در یک تب اختصاصی "errors" در Google Sheets ثبت می‌کند.

* وابستگی‌ها: تنظیم (ردیف خطای ویدیو).

* پیکربندی: نیاز به اعتبارنامه‌های OAuth Google Sheets دارد.

• یادداشت چسبان ویدیو (Sticky Note)

* هدف: مستندات و توضیحات مربوط به منطق پردازش ویدیو را ارائه می‌دهد.

* پیکربندی: فقط متن اطلاعاتی.

* وابستگی‌ها: ندارد.

---

۴. تحلیل خلاقیت تصویری

این بلوک به تحلیل خلاقیت‌های تصویری ثابت می‌پردازد.

نودها:

• آیا image_url وجود دارد؟ (If)

* هدف: بررسی می‌کند که آیا شیء خلاقیت حاوی فیلد image_url است یا خیر.

* انشعاب‌ها:

* درست: به دانلود تصویر می‌رود.

* نادرست: به مدیریت خطا برای URLهای تصویر گمشده هدایت می‌شود.

* وابستگی‌ها: آیا ویدیو است؟ (انشعاب نادرست).

• دانلود فایل تصویر (HTTP Request)

* هدف: محتوای باینری تصویر را از image_url دانلود می‌کند.

* وابستگی‌ها: آیا image_url وجود دارد؟ (انشعاب درست).

* مشکلات احتمالی: خطاهای HTTP، یا URL تصویر غیرقابل دسترس یا نامعتبر باشد.

• تبدیل تصویر به رشته Base64 (Extract From File)

* هدف: داده‌های باینری تصویر دانلود شده را به یک رشته کدگذاری شده Base64 برای Google Vision API تبدیل می‌کند.

* وابستگی‌ها: دانلود فایل تصویر.

• شروع حاشیه‌نویسی تصویر (HTTP Request)

* هدف: تصویر کدگذاری شده Base64 را به Google Vision API ارسال کرده و چندین ویژگی تحلیل (تشخیص برچسب، تشخیص متن، تشخیص لوگو، تشخیص نشانه‌گذاری، مکان‌یابی اشیاء، تشخیص وب، جستجوی ایمن) را درخواست می‌کند.

* پیکربندی: نیاز به اعتبارنامه‌های Google API دارد.

* وابستگی‌ها: تبدیل تصویر به رشته Base64.

* مشکلات احتمالی: خطاهای احراز هویت API یا محدودیت‌های سهمیه.

• تنظیم داده‌های شناسه برای استاتیک (Set)

* هدف: فیلدهای متادیتا (مانند campaign_id, ad_id, creative_id, file_name, image_url, source) را به داده‌های تصویر برای غنی‌سازی اختصاص می‌دهد.

* وابستگی‌ها: شروع حاشیه‌نویسی تصویر.

• تجزیه داده‌ها از تصاویر (Code)

* هدف: پاسخ JSON را از Google Vision API تجزیه کرده و داده‌های ساختاریافته مانند برچسب‌ها، لوگوها، نشانه‌گذاری‌ها، اشیاء (با جعبه‌های مرزی)، موجودیت‌های وب، حاشیه‌نویسی‌های جستجوی ایمن و حاشیه‌نویسی‌های متن را استخراج می‌کند.

* وابستگی‌ها: تنظیم داده‌های شناسه برای استاتیک.

• افزودن داده‌های بخش‌ها (Google Sheets)

* هدف: داده‌های تحلیل تصویر تجزیه شده را به تب اصلی Google Sheet اضافه می‌کند.

* پیکربندی: نیاز به اعتبارنامه‌های OAuth Google Sheets با مجوز نوشتن دارد.

* وابستگی‌ها: تجزیه داده‌ها از تصاویر.

* مشکلات احتمالی: محدودیت‌های نرخ API Google Sheets یا خطاهای مجوز.

• تنظیم (ردیف خطا) (Set)

* هدف: یک ردیف داده خطای استاندارد برای URLهای تصویر گمشده یا نامعتبر ایجاد می‌کند.

* وابستگی‌ها: آیا image_url وجود دارد؟ (انشعاب نادرست).

• افزودن خطاها (Google Sheets)

* هدف: خطاهای مربوط به پردازش تصویر را در تب اختصاصی "errors" در Google Sheets ثبت می‌کند.

* وابستگی‌ها: تنظیم (ردیف خطا).

* پیکربندی: نیاز به اعتبارنامه‌های OAuth Google Sheets دارد.

• یادداشت چسبان تصویر (Sticky Note)

* هدف: مستندات و توضیحات مربوط به منطق پردازش تصویر را ارائه می‌دهد.

* پیکربندی: فقط متن اطلاعاتی.

* وابستگی‌ها: ندارد.

---

۵. مدیریت خطا

این بلوک، ثبت خطاهای مشاهده شده در طول گردش کار را متمرکز می‌کند.

نودها:

• تنظیم (ردیف خطا) (Set)

* هدف: خطاها مربوط به URLهای تصویر گمشده یا سایر مسائل پردازش عمومی را به همراه متادیتای مربوطه ثبت می‌کند.

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

• تنظیم (ردیف خطای ویدیو) (Set)

* هدف: پیام‌های خطای دقیق را از فراخوانی‌های ناموفق Google Video Intelligence API، از جمله متادیتا، ثبت می‌کند.

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

• افزودن خطاها (Google Sheets)

* هدف: ردیف‌های داده خطا تولید شده توسط تنظیم (ردیف خطا) یا تنظیم (ردیف خطای ویدیو) را به تب اختصاصی "errors" در Google Sheets اضافه می‌کند.

* پیکربندی: نیاز به اعتبارنامه‌های OAuth Google Sheets دارد.

* وابستگی‌ها: تنظیم (ردیف خطا) یا تنظیم (ردیف خطای ویدیو).

• یادداشت چسبان خطاها (Sticky Note)

* هدف: استراتژی مدیریت خطا و محل ذخیره گزارش‌های خطا را توضیح می‌دهد.

* پیکربندی: فقط متن اطلاعاتی.

* وابستگی‌ها: ندارد.

---

۶. تجمیع داده‌ها و خروجی

این بلوک نهایی تضمین می‌کند که تمام بینش‌های پردازش شده با موفقیت در Google Sheet اصلی نوشته شوند.

نودها:

• افزودن داده‌های بخش‌ها (Google Sheets)

* هدف: ردیف‌های بینش ساختاریافته تولید شده از تحلیل‌های ویدیویی و تصویری را به تب اصلی Google Sheet اضافه می‌کند. این نود در هر دو شاخه پردازش ویدیو و تصویر استفاده می‌شود.

* پیکربندی: نیاز به اعتبارنامه‌های OAuth2 Google Sheets با دسترسی نوشتن به صفحه گسترده هدف دارد.

* فیلدهای خروجی: شامل campaign_id, ad_id, creative_id, video_id, annotation_type, label/text, confidence, مُهر زمانی و زمان پردازش است.

* وابستگی‌ها: تجزیه داده‌ها (از شاخه ویدیو) و تجزیه داده‌ها از تصاویر (از شاخه تصویر).

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

• یادداشت چسبان Google Sheets (Sticky Note)

* هدف: دستورالعمل‌ها و یادآوری‌هایی را برای کاربران در مورد ادغام Google Sheets، مانند مجوزهای لازم و راه‌اندازی صفحه گسترده، ارائه می‌دهد.

* پیکربندی: فقط متن اطلاعاتی.

* وابستگی‌ها: ندارد.