مستندات توسعهدهندگان
یکپارچهسازی 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
مراحل احراز هویت:
- کاربر جریان رضایت OAuth را آغاز میکند
- تغییر مسیر به سرور مجوز Google
- کاربر مجوزها را به کمپزن میدهد
- تبادل کد مجوز برای access token
- ذخیره امن refresh token
- تازهسازی خودکار 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 را حفظ میکند.
سوال فنی دارید؟
تیم فنی ما آماده پاسخگویی به سوالات توسعهدهندگان و یکپارچهسازی هستند