Propaganda Ads Connector • API Automation

إعداد ربط الإعلانات بالداشبورد

صفحة عملية لتجهيز ربط حسابات الإعلانات مع n8n و Propaganda Mission Control، بحيث نقدر نتابع الحملات، المصروف، النتائج، والتحسينات من مكان واحد بدون إدخال يدوي كل مرة.

مهم: اسم التطبيق في OAuth / Google Cloud لا يكون فيه كلمة Google. الاسم المعتمد: Propaganda Ads Connector. استخدام Google يكون فقط عند ذكر اسم الخدمة أو الـ API، وليس كاسم للتطبيق.
5مفاتيح وبيانات أساسية مطلوبة
n8nتشغيل تلقائي وسحب بيانات الحملات
Dashboardمتابعة الأداء والقرارات بوضوح

ليه نربط بيانات الإعلانات بالداشبورد؟

بدل ما نراجع الحملات يدويًا كل مرة، الربط يخلي بيانات الإعلانات تتحول لتقارير قابلة للمتابعة داخل لوحة Propaganda.

📊

رؤية أوضح للأداء

متابعة المصروف، النقرات، التحويلات، الكلمات، والحملات من مصدر واحد.

⚙️

أتمتة التقارير

n8n يسحب البيانات دوريًا ويرسلها للوحة بدون نسخ ولصق أو متابعة مشتتة.

🚀

تحسين أسرع

لما البيانات تظهر بسرعة، قرارات الإيقاف أو التعديل أو زيادة الميزانية تبقى أسرع.

المطلوب قبل التفعيل

عشان الربط يشتغل بشكل صحيح، لازم تكون بيانات حساب الإعلانات و Google Cloud جاهزة. اسم التطبيق نفسه يكون Propaganda Ads Connector بدون استخدام اسم Google في اسم التطبيق.

Ads Manager Account

حساب مدير مرتبط بالحساب الإعلاني الفعلي. رقم المدير يستخدم في login-customer-id.

Ads Account Customer ID

رقم الحساب الذي عليه الحملات الفعلية. هذا الرقم يدخل في رابط Google Ads API نفسه.

Developer Token

من API Center الخاص بحساب الإعلانات. ممكن يبدأ Test/Explorer ثم نطلب Basic Access لو التشغيل الحقيقي يحتاج ذلك.

OAuth Client ID و Client Secret

من Google Cloud Project بعد تفعيل الـ API وتجهيز OAuth Consent Screen. اسم التطبيق المقترح: Propaganda Ads Connector.

Refresh Token

التوكن الذي يسمح للنظام بتحديث الوصول وسحب البيانات تلقائيًا بدون تسجيل دخول كل مرة.

متغيرات البيئة المطلوبة في n8n / Coolify

لا يتم نشر القيم السرية هنا. هذه أسماء المتغيرات فقط حتى يتم حفظها بأمان داخل بيئة التشغيل.

GOOGLE_ADS_DEVELOPER_TOKEN=ضع_الرمز_هنا
GOOGLE_ADS_CLIENT_ID=ضع_client_id_هنا
GOOGLE_ADS_CLIENT_SECRET=ضع_client_secret_هنا
GOOGLE_ADS_REFRESH_TOKEN=ضع_refresh_token_هنا
GOOGLE_ADS_LOGIN_CUSTOMER_ID=رقم_المانجر_بدون_شرطات
GOOGLE_ADS_CUSTOMER_ID=رقم_حساب_الإعلانات_بدون_شرطات
N8N_ADS_API_SECRET=سر_داخلي_بين_n8n_والداشبورد

خطة التنفيذ

تجهيز الحسابات: ربط حساب المدير بحساب الإعلانات الفعلي.
تجهيز Google Cloud: تفعيل Google Ads API وإنشاء OAuth Credentials.
إدخال المفاتيح بأمان: حفظ القيم داخل n8n/Coolify وليس داخل صفحات عامة.
اختبار القراءة: سحب أول تقرير للحملات بدون تعديل أي حملة.
ربط Mission Control: إرسال ملخص الأداء إلى لوحة Propaganda.
متابعة وتحسين: تحويل الأرقام إلى قرارات واضحة للحملة.
تنبيه أمان: لا ترسل Client Secret أو Refresh Token أو Developer Token في مكان عام. يتم حفظ الأسرار داخل بيئة التشغيل فقط، ويمكن تغييرها أو إلغاؤها في أي وقت من حساب Google.