برمجة حملات إعلانية ذكية: الدليل التقني الشامل لبناء نظام إعلانات آلي يزيد عائد استثمارك 400% في 2026

لماذا برمجة حملات إعلانية ذكية؟

الإعلانات الذكية المبرمجة تتفوق على الإدارة اليدوية بـ 400% في العائد على الاستثمار. النظام الذكي يعمل 24/7، يتخذ قرارات مبنية على البيانات، ويُحسّن الأداء لحظياً.

المرحلة 1: إعداد APIs المنصات الإعلانية

🔑 الحصول على مفاتيح API

💻 مثال كود: Meta Ads API Integration

// src/lib/meta-ads.ts

import axios from 'axios';

const META_API_VERSION = 'v18.0';
const BASE_URL = `https://graph.facebook.com/${META_API_VERSION}`;

interface MetaAdsConfig {
  accessToken: string;
  adAccountId: string;
}

class MetaAdsAPI {
  private config: MetaAdsConfig;

  constructor(config: MetaAdsConfig) {
    this.config = config;
  }

  // Create Campaign
  async createCampaign(data: {
    name: string;
    objective: string;
    status: string;
  }) {
    const response = await axios.post(
      `${BASE_URL}/act_${this.config.adAccountId}/campaigns`,
      {
        name: data.name,
        objective: data.objective,
        status: data.status
      },
      {
        params: {
          access_token: this.config.accessToken
        }
      }
    );
    return response.data;
  }

  // Create Ad Set
  async createAdSet(data: {
    campaignId: string;
    name: string;
    dailyBudget: number;
    targeting: any;
  }) {
    const response = await axios.post(
      `${BASE_URL}/act_${this.config.adAccountId}/adsets`,
      {
        name: data.name,
        campaign_id: data.campaignId,
        daily_budget: data.dailyBudget * 100, // Convert to cents
        billing_event: 'IMPRESSIONS',
        targeting: data.targeting,
        status: 'ACTIVE'
      },
      {
        params: {
          access_token: this.config.accessToken
        }
      }
    );
    return response.data;
  }

  // Create Ad Creative
  async createCreative(data: {
    name: string;
    imageUrl: string;
    message: string;
    headline: string;
    linkUrl: string;
  }) {
    const response = await axios.post(
      `${BASE_URL}/act_${this.config.adAccountId}/adcreatives`,
      {
        name: data.name,
        object_story_spec: {
          page_id: this.config.pageId,
          link_data: {
            image_url: data.imageUrl,
            message: data.message,
            link: data.linkUrl,
            name: data.headline,
            call_to_action: {
              type: 'LEARN_MORE'
            }
          }
        }
      },
      {
        params: {
          access_token: this.config.accessToken
        }
      }
    );
    return response.data;
  }

  // Get Campaign Insights
  async getInsights(campaignId: string, datePreset: string = 'last_7d') {
    const response = await axios.get(
      `${BASE_URL}/${campaignId}/insights`,
      {
        params: {
          access_token: this.config.accessToken,
          date_preset: datePreset,
          fields: 'impressions,clicks,spend,ctr,roas'
        }
      }
    );
    return response.data;
  }

  // Update Campaign Budget
  async updateBudget(adSetId: string, newBudget: number) {
    const response = await axios.post(
      `${BASE_URL}/${adSetId}`,
      {
        daily_budget: newBudget * 100
      },
      {
        params: {
          access_token: this.config.accessToken
        }
      }
    );
    return response.data;
  }
}

export default MetaAdsAPI;

💻 مثال كود: Google Ads API Integration

// src/lib/google-ads.ts

import { GoogleAdsApi, resources } from 'google-ads-api';

interface GoogleAdsConfig {
  developerToken: string;
  clientId: string;
  clientSecret: string;
  refreshToken: string;
  customerId: string;
}

class GoogleAdsAPI {
  private client: GoogleAdsApi;
  private customerId: string;

  constructor(config: GoogleAdsConfig) {
    this.client = new GoogleAdsApi({
      developer_token: config.developerToken,
      client_id: config.clientId,
      client_secret: config.clientSecret,
      refresh_token: config.refreshToken
    });
    this.customerId = config.customerId;
  }

  // Create Campaign
  async createCampaign(data: {
    name: string;
    status: string;
    advertisingChannelType: string;
  }) {
    const campaign = new resources.Campaign({
      name: data.name,
      status: data.status,
      advertising_channel_type: data.advertisingChannelType,
      campaign_budget: `customers/${this.customerId}/campaignBudgets/123456`
    });

    const result = await this.client.customers.createCampaign({
      customer_id: this.customerId,
      campaign
    });

    return result;
  }

  // Get Campaign Metrics
  async getCampaignMetrics(campaignId: string) {
    const report = await this.client.report({
      customer_id: this.customerId,
      entity: 'campaign',
      attributes: ['campaign.name', 'campaign.status'],
      metrics: [
        'metrics.impressions',
        'metrics.clicks',
        'metrics.cost_micros',
        'metrics.ctr',
        'metrics.cost_per_conversion'
      ],
      constraints: [
        {
          'campaign.id': campaignId
        }
      ],
      date_constants: 'LAST_7_DAYS'
    });

    return report;
  }

  // Update Campaign Budget
  async updateBudget(campaignId: string, newBudgetMicros: number) {
    const campaignBudget = new resources.CampaignBudget({
      resource_name: `customers/${this.customerId}/campaignBudgets/123456`,
      amount_micros: newBudgetMicros
    });

    const result = await this.client.campaignBudgets.update({
      customer_id: this.customerId,
      campaign_budget: campaignBudget
    });

    return result;
  }
}

export default GoogleAdsAPI;

المرحلة 2: نظام الأتمتة الذكي

🤖 محرك اتخاذ القرارات الذكي

// src/lib/smart-optimizer.ts

interface CampaignMetrics {
  campaignId: string;
  impressions: number;
  clicks: number;
  spend: number;
  conversions: number;
  ctr: number;
  roas: number;
  cpa: number;
}

class SmartOptimizer {
  private targetROAS = 4.0;
  private maxCPA = 50;
  private minCTR = 0.02;

  // Analyze campaign performance
  analyzePerformance(metrics: CampaignMetrics) {
    const analysis = {
      campaignId: metrics.campaignId,
      status: 'UNKNOWN',
      recommendations: [] as string[],
      budgetAdjustment: 0
    };

    // Check ROAS
    if (metrics.roas >= this.targetROAS) {
      analysis.status = 'EXCELLENT';
      analysis.recommendations.push('Increase budget by 20%');
      analysis.budgetAdjustment = 1.2;
    } else if (metrics.roas >= 3.0) {
      analysis.status = 'GOOD';
      analysis.recommendations.push('Maintain current budget');
      analysis.budgetAdjustment = 1.0;
    } else if (metrics.roas >= 2.0) {
      analysis.status = 'FAIR';
      analysis.recommendations.push('Optimize targeting and creatives');
      analysis.budgetAdjustment = 0.9;
    } else {
      analysis.status = 'POOR';
      analysis.recommendations.push('Pause campaign and review strategy');
      analysis.budgetAdjustment = 0.5;
    }

    // Check CTR
    if (metrics.ctr < this.minCTR) {
      analysis.recommendations.push('Improve ad creatives and copy');
    }

    // Check CPA
    if (metrics.cpa > this.maxCPA) {
      analysis.recommendations.push('Reduce budget or optimize targeting');
    }

    return analysis;
  }

  // Auto-optimize campaigns
  async optimizeCampaigns(
    campaigns: CampaignMetrics[],
    metaAPI: MetaAdsAPI,
    googleAPI: GoogleAdsAPI
  ) {
    const results = [];

    for (const campaign of campaigns) {
      const analysis = this.analyzePerformance(campaign);
      
      // Apply budget adjustments
      if (analysis.budgetAdjustment !== 1.0) {
        const currentBudget = await this.getCurrentBudget(campaign.campaignId);
        const newBudget = currentBudget * analysis.budgetAdjustment;
        
        if (campaign.campaignId.startsWith('meta_')) {
          await metaAPI.updateBudget(campaign.campaignId, newBudget);
        } else if (campaign.campaignId.startsWith('google_')) {
          await googleAPI.updateBudget(campaign.campaignId, newBudget * 100);
        }
      }

      results.push({
        campaignId: campaign.campaignId,
        status: analysis.status,
        recommendations: analysis.recommendations,
        budgetAdjusted: analysis.budgetAdjustment !== 1.0
      });
    }

    return results;
  }

  private async getCurrentBudget(campaignId: string): Promise<number> {
    // Fetch current budget from API
    return 100; // Placeholder
  }
}

export default SmartOptimizer;

⏰ نظام الجدولة التلقائية

// src/lib/scheduler.ts

import cron from 'node-cron';
import MetaAdsAPI from './meta-ads';
import GoogleAdsAPI from './google-ads';
import SmartOptimizer from './smart-optimizer';

class AdScheduler {
  private metaAPI: MetaAdsAPI;
  private googleAPI: GoogleAdsAPI;
  private optimizer: SmartOptimizer;

  constructor() {
    this.metaAPI = new MetaAdsAPI({
      accessToken: process.env.META_ACCESS_TOKEN!,
      adAccountId: process.env.META_AD_ACCOUNT_ID!
    });

    this.googleAPI = new GoogleAdsAPI({
      developerToken: process.env.GOOGLE_DEVELOPER_TOKEN!,
      clientId: process.env.GOOGLE_CLIENT_ID!,
      clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
      refreshToken: process.env.GOOGLE_REFRESH_TOKEN!,
      customerId: process.env.GOOGLE_CUSTOMER_ID!
    });

    this.optimizer = new SmartOptimizer();
  }

  // Run optimization every 6 hours
  startScheduler() {
    // Every 6 hours
    cron.schedule('0 */6 * * *', async () => {
      console.log('Running ad optimization...');
      await this.optimizeAllCampaigns();
    });

    // Daily report at 9 AM
    cron.schedule('0 9 * * *', async () => {
      console.log('Generating daily report...');
      await this.generateDailyReport();
    });

    console.log('Ad scheduler started successfully');
  }

  private async optimizeAllCampaigns() {
    try {
      // Get all active campaigns from Meta
      const metaCampaigns = await this.getMetaCampaigns();
      
      // Get all active campaigns from Google
      const googleCampaigns = await this.getGoogleCampaigns();

      // Combine all campaigns
      const allCampaigns = [...metaCampaigns, ...googleCampaigns];

      // Optimize campaigns
      const results = await this.optimizer.optimizeCampaigns(
        allCampaigns,
        this.metaAPI,
        this.googleAPI
      );

      console.log('Optimization completed:', results);
    } catch (error) {
      console.error('Optimization failed:', error);
    }
  }

  private async getMetaCampaigns() {
    // Fetch campaigns from Meta API
    return [];
  }

  private async getGoogleCampaigns() {
    // Fetch campaigns from Google API
    return [];
  }

  private async generateDailyReport() {
    // Generate and send daily report
    console.log('Daily report generated');
  }
}

export default AdScheduler;

المرحلة 3: لوحة التحكم التحليلية

📊 Dashboard شامل

// src/app/dashboard/page.tsx

'use client';

import { useState, useEffect } from 'react';
import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
import { LineChart, Line, BarChart, Bar, XAxis, YAxis, CartesianGrid, Tooltip, ResponsiveContainer } from 'recharts';

interface CampaignData {
  id: string;
  name: string;
  platform: string;
  impressions: number;
  clicks: number;
  spend: number;
  conversions: number;
  ctr: number;
  roas: number;
  cpa: number;
}

export default function DashboardPage() {
  const [campaigns, setCampaigns] = useState<CampaignData[]>([]);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    fetchCampaignData();
  }, []);

  const fetchCampaignData = async () => {
    const response = await fetch('/api/campaigns');
    const data = await response.json();
    setCampaigns(data);
    setLoading(false);
  };

  const totalSpend = campaigns.reduce((sum, c) => sum + c.spend, 0);
  const totalConversions = campaigns.reduce((sum, c) => sum + c.conversions, 0);
  const avgROAS = campaigns.reduce((sum, c) => sum + c.roas, 0) / campaigns.length;
  const avgCPA = totalSpend / totalConversions;

  return (
    <div className="p-8 space-y-6">
      <h1 className="text-3xl font-bold">لوحة تحكم الحملات الإعلانية</h1>

      {/* KPI Cards */}
      <div className="grid grid-cols-1 md:grid-cols-4 gap-4">
        <Card>
          <CardHeader>
            <CardTitle>إجمالي الإنفاق</CardTitle>
          </CardHeader>
          <CardContent>
            <div className="text-3xl font-bold">
              {totalSpend.toLocaleString()} ريال
            </div>
          </CardContent>
        </Card>

        <Card>
          <CardHeader>
            <CardTitle>التحويلات</CardTitle>
          </CardHeader>
          <CardContent>
            <div className="text-3xl font-bold text-green-600">
              {totalConversions}
            </div>
          </CardContent>
        </Card>

        <Card>
          <CardHeader>
            <CardTitle>متوسط ROAS</CardTitle>
          </CardHeader>
          <CardContent>
            <div className="text-3xl font-bold text-blue-600">
              {avgROAS.toFixed(2)}x
            </div>
          </CardContent>
        </Card>

        <Card>
          <CardHeader>
            <CardTitle>متوسط CPA</CardTitle>
          </CardHeader>
          <CardContent>
            <div className="text-3xl font-bold">
              {avgCPA.toFixed(2)} ريال
            </div>
          </CardContent>
        </Card>
      </div>

      {/* Performance Chart */}
      <Card>
        <CardHeader>
          <CardTitle>أداء الحملات</CardTitle>
        </CardHeader>
        <CardContent>
          <ResponsiveContainer width="100%" height={400}>
            <BarChart data={campaigns}>
              <CartesianGrid strokeDasharray="3 3" />
              <XAxis dataKey="name" />
              <YAxis />
              <Tooltip />
              <Bar dataKey="spend" fill="#f59e0b" name="الإنفاق" />
              <Bar dataKey="conversions" fill="#10b981" name="التحويلات" />
            </BarChart>
          </ResponsiveContainer>
        </CardContent>
      </Card>

      {/* Campaigns Table */}
      <Card>
        <CardHeader>
          <CardTitle>تفاصيل الحملات</CardTitle>
        </CardHeader>
        <CardContent>
          <table className="w-full">
            <thead>
              <tr>
                <th>الحملة</th>
                <th>المنصة</th>
                <th>الإنفاق</th>
                <th>التحويلات</th>
                <th>ROAS</th>
                <th>CPA</th>
              </tr>
            </thead>
            <tbody>
              {campaigns.map((campaign) => (
                <tr key={campaign.id}>
                  <td>{campaign.name}</td>
                  <td>{campaign.platform}</td>
                  <td>{campaign.spend.toLocaleString()} ريال</td>
                  <td>{campaign.conversions}</td>
                  <td>{campaign.roas.toFixed(2)}x</td>
                  <td>{campaign.cpa.toFixed(2)} ريال</td>
                </tr>
              ))}
            </tbody>
          </table>
        </CardContent>
      </Card>
    </div>
  );
}

دراسة حالة: شركة سعودية تزيد ROAS 400%

أخطاء شائعة يجب تجنبها

• ❌ عدم اختبار النظام: إطلاق بدون اختبار كافٍ
• ❌ قواعد صارمة جداً: قد توقف حملات جيدة
• ❌ تجاهل المراقبة: النظام يحتاج مراقبة بشرية
• ❌ عدم وجود حدود: تحديد حدود للإنفاق اليومي
• ❌ تجاهل الأمان: حماية مفاتيح API
• ❌ عدم التوثيق: توثيق جميع القرارات
• ❌ تغييرات مفاجئة: تغييرات تدريجية ومدروسة
• ❌ تجاهل التقارير: مراجعة التقارير يومياً

قائمة التحقق (Checklist)

الخلاصة

برمجة حملات إعلانية ذكية هي مستقبل الإعلان الرقمي. النظام الذكي يعمل 24/7، يتخذ قرارات مبنية على البيانات، ويُحسّن الأداء لحظياً. هذا ليس رفاهية، بل ضرورة تنافسية.

القاعدة الذهبية: تكامل APIs + قرارات مبنية على البيانات + أتمتة كاملة + مراقبة مستمرة = نظام إعلانات ذكي ناجح. لا تعتمد على الإدارة اليدوية، برمج نظاماً ذكياً.

تذكر: الأتمتة الذكية توفر 94% من الوقت وتزيد العائد 125%. الاستثمار في برمجة نظام ذكي هو أفضل استثمار يمكنك القيام به. ابدأ اليوم، وستحصد ثماراً استثنائية غداً.

الأسئلة الشائعة (FAQ)