مستندات توسعه‌دهندگان

یکپارچه‌سازی Google Ads API

مستندات فنی جامع برای یکپارچه‌سازی با Google Ads API، معماری سیستم و بهترین روش‌های امنیت

نمای کلی معماری

معماری سیستم

رابط کاربری

React/Next.js

API Gateway

Node.js/Express

منطق کسب‌وکار

TypeScript

Google Ads API

OAuth 2.0

پیاده‌سازی امنیت

OAuth 2.0
احراز هویت امن API
مدیریت Token
ذخیره رمزگذاری شده refresh token
محدودیت نرخ
انطباق با محدودیت‌های Google API
رمزگذاری داده
رمزگذاری AES-256 در حالت استراحت

پایپ‌لاین پردازش داده

Google Ads API
اعتبارسنجی داده
منطق کسب‌وکار
ذخیره پایگاه داده
رابط کاربری

جریان احراز هویت OAuth 2.0

مراحل احراز هویت:

  1. کاربر جریان رضایت OAuth را آغاز می‌کند
  2. تغییر مسیر به سرور مجوز Google
  3. کاربر مجوزها را به کمپ‌زن می‌دهد
  4. تبادل کد مجوز برای access token
  5. ذخیره امن refresh token
  6. تازه‌سازی خودکار token برای فراخوانی‌های API

نمونه کد احراز هویت

// OAuth 2.0 Authentication Flow
const initiateGoogleAdsAuth = async (userId: string) => {
  const oauth2Client = new google.auth.OAuth2(
    process.env.GOOGLE_CLIENT_ID,
    process.env.GOOGLE_CLIENT_SECRET,
    process.env.GOOGLE_REDIRECT_URI
  );
  
  const scopes = ['https://www.googleapis.com/auth/adwords'];
  
  const authUrl = oauth2Client.generateAuthUrl({
    access_type: 'offline',
    scope: scopes,
    state: userId,
    prompt: 'consent'
  });
  
  return authUrl;
};

// Token Exchange
const exchangeCodeForTokens = async (code: string) => {
  const { tokens } = await oauth2Client.getToken(code);
  
  // Securely store refresh token
  await encryptAndStoreToken(tokens.refresh_token, userId);
  
  return tokens;
};

توضیح Use Case - پلتفرم کمپ‌زن

مشکل کسب‌وکار

کسب‌وکارهای فارسی‌زبان با چالش‌های قابل توجهی در Google Ads مواجه هستند:

  • • موانع زبانی با ابزارهای فقط انگلیسی
  • • فقدان استراتژی‌های بهینه‌سازی محلی
  • • دسترسی محدود به ویژگی‌های درجه سازمانی
  • • پیچیدگی بالای مدیریت دستی کمپین
  • • کمبود بینش‌های بازار فارسی

راه‌حل نوآورانه

کمپ‌زن با بهره‌گیری از Google Ads API ارائه می‌دهد:

مدیریت خودکار
راه‌اندازی هوشمند کمپین با AI
بهینه‌سازی مناقصه
تنظیمات بلادرنگ مناقصه
تحلیل رقابتی
بینش‌های بازار فارسی
صرفه‌جویی زمان
80% کاهش کار دستی

تأثیر کسب‌وکار

1,000+
کاربر فعال
$2.5M+
بودجه ماهانه مدیریت شده
35%
بهبود متوسط ROI

توجیه Multiple Developer Token

Token اصلی (پلتفرم سازمانی)

هدف: عملکرد اصلی پلتفرم SaaS
استفاده: مدیریت کمپین برای 500+ مشتری سازمانی
فراخوانی‌های API: 15,000 روزانه

Token ثانویه (ابزارهای توسعه‌دهنده)

هدف: توسعه ابزارهای API و SDK
استفاده: یکپارچه‌سازی‌های توسعه‌دهنده و ابزارهای سفارشی
فراخوانی‌های API: 8,000 روزانه

این رویکرد چندtoken اطمینان قابلیت اطمینان خدمات، امکان ویژگی‌های تخصصی و پشتیبانی از پایگاه متنوع مشتریان ما را فراهم می‌کند و در عین حال انطباق با سیاست‌های API Google را حفظ می‌کند.

سوال فنی دارید؟

تیم فنی ما آماده پاسخگویی به سوالات توسعه‌دهندگان و یکپارچه‌سازی هستند