بهترین شیوه ها

ویدیوی : صحبت‌های بهترین شیوه‌های کارگاه 2019 را بررسی کنید

این راهنما برخی از بهترین شیوه‌هایی را که می‌توانید برای بهینه‌سازی کارایی و عملکرد برنامه‌هایتان پیاده‌سازی کنید، پوشش می‌دهد.

تعمیر و نگهداری مداوم

برای اطمینان از اینکه برنامه شما بدون وقفه اجرا می شود:

  • ایمیل تماس برنامه‌نویس خود را در مرکز API به‌روز نگه دارید. این نام مستعار ما برای تماس با شما است. اگر نتوانیم در رابطه با رعایت شرایط و ضوابط API با شما تماس بگیریم، ممکن است دسترسی API شما بدون اطلاع قبلی شما لغو شود. از استفاده از آدرس ایمیل شخصی مرتبط با حساب شخصی یا بدون نظارت خودداری کنید. برای مشاهده مرکز API، باید به حساب مدیر خود وارد شوید.

  • برای اطلاع از مسائلی مانند تغییرات محصول، زمان از کار افتادن تعمیر و نگهداری، تاریخ های منسوخ شدن و غیره، مشترک ما شوید

انجمن به طور منظم توسط تیم Google Ads API نظارت می شود و آن را به مکانی ایده آل برای ارسال سوالات API تبدیل می کند.

  • برنامه خود را با شرایط و ضوابط (T&C) API Google Ads مطابقت دهید. در صورت لزوم، تیم بررسی و انطباق نشانه با استفاده از ایمیل تماس شما با شما تماس خواهند گرفت. اگر درباره T&C سؤال یا نگرانی دارید، می‌توانید با پاسخ دادن به ایمیلی که هنگام بررسی برنامه توکن توسعه‌دهنده‌تان برایتان ارسال کرده‌اند، با تیم بازبینی تماس بگیرید.

بهینه سازی

عملیات دسته ای

درخواست برای API مستلزم تعدادی هزینه ثابت است، مانند تأخیر شبکه رفت و برگشت، پردازش سریال‌سازی و سریال‌زدایی، و تماس‌ها با سیستم‌های پشتیبان. برای کاهش تأثیر این هزینه های ثابت و افزایش عملکرد کلی، اکثر روش های جهش یافته در API برای پذیرش مجموعه ای از عملیات طراحی شده اند. با دسته‌بندی چندین عملیات در هر درخواست، می‌توانید تعداد درخواست‌هایی را که می‌کنید و هزینه‌های ثابت مرتبط را کاهش دهید. اگر می توانید، از درخواست تنها با یک عملیات خودداری کنید.

برای مثال، فرض کنید در حال اضافه کردن 50000 کلمه کلیدی به یک کمپین در چندین گروه تبلیغاتی هستید. به جای 50000 درخواست با 1 کلمه کلیدی، 100 درخواست با 500 کلمه کلیدی یا حتی 10 درخواست با هر کلمه کلیدی 5000 ارسال کنید. محدودیت‌هایی در تعداد عملیات مجاز در یک درخواست وجود دارد، بنابراین ممکن است برای دستیابی به عملکرد بهینه نیاز به تنظیم اندازه دسته خود داشته باشید.

ارسال اشیاء پراکنده

هنگامی که اشیاء به API ارسال می شوند، فیلدها باید از فهرست، اعتبارسنجی و در پایگاه داده ذخیره شوند. ارسال کامل اشیاء زمانی که می‌خواهید فقط چند فیلد را به‌روزرسانی کنید می‌تواند منجر به زمان پردازش اضافی و کاهش عملکرد شود. برای کاهش این مشکل، Google Ads API از به‌روزرسانی‌های پراکنده پشتیبانی می‌کند و به شما امکان می‌دهد فقط فیلدهایی را در یک شی که باید تغییر دهید یا مورد نیاز است، پر کنید. به‌روزرسانی‌های پراکنده سریع‌تر پردازش می‌شوند و احتمال کمتری ایجاد خطا دارند. فیلدهایی که در update_mask (همچنین به عنوان FieldMask شناخته می شود) نیستند بدون تغییر باقی می مانند.

به عنوان مثال، برنامه‌ای که پیشنهادهای سطح کلمه کلیدی را به‌روزرسانی می‌کند، می‌تواند از استفاده از به‌روزرسانی‌های پراکنده بهره‌مند شود، زیرا فقط شناسه گروه آگهی، شناسه معیار و فیلدهای پیشنهادات باید پر شوند.

مدیریت و مدیریت خطا

در طول توسعه، احتمالاً با خطاهایی روبرو خواهید شد. این بخش ملاحظات و استراتژی هایی را برای ایجاد مدیریت خطا در برنامه شما شرح می دهد. علاوه بر این بخش، برای اطلاعات بیشتر در مورد مدیریت خطاها، به راهنمای عیب یابی مراجعه کنید.

منابع درخواست را متمایز کنید

برخی از برنامه‌ها عمدتاً تعاملی هستند و تماس‌های API را مستقیماً در پاسخ به اقدامات آغاز شده توسط کاربر در یک UI صادر می‌کنند. برخی دیگر عمدتاً به صورت آفلاین کار می کنند و فراخوانی های API را به عنوان بخشی از یک فرآیند دوره ای back-end صادر می کنند. بسیاری از اپلیکیشن ها این دو را با هم ترکیب می کنند. هنگامی که به مدیریت خطا فکر می کنید، تشخیص انواع مختلف درخواست ها می تواند مفید باشد.

برای درخواست‌های آغاز شده توسط کاربر، نگرانی اصلی شما باید ارائه یک تجربه خوب برای کاربران باشد. از خطای خاصی که رخ داده است استفاده کنید تا هرچه بیشتر زمینه را در UI به کاربر ارائه دهید. گام‌های آسانی را که می‌توانند برای رفع خطا بردارند، ارائه دهید (پیشنهادات زیر را بررسی کنید).

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

تشخیص انواع خطا

دانستن تفاوت‌های بین انواع خطا در Google Ads API هنگام ایجاد مدیریت قوی خطا بسیار مهم است. برخی از رایج ترین انواع خطا عبارتند از:

  1. خطاهای احراز هویت
  2. خطاهای قابل امتحان مجدد
  3. خطاهای اعتبارسنجی
  4. خطاهای مرتبط با همگام سازی

برای جزئیات بیشتر به انواع خطا و خطاهای رایج مراجعه کنید.

همگام سازی پایان های پشتی

اگر کاربران برنامه شما به حساب‌های Google Ads دسترسی دستی داشته باشند، ممکن است تغییراتی را ایجاد کنند که برنامه شما از آن بی‌اطلاع باشد و باعث شود پایگاه داده محلی برنامه‌تان از همگام‌سازی خارج شود. همانطور که در راهنمای انواع خطا ذکر شده است، می‌توانید خطاهای مرتبط با همگام‌سازی را به‌صورت واکنشی در صورت وقوع آنها برطرف کنید، اما همچنین می‌توانید سعی کنید به طور فعال از آنها جلوگیری کنید. یک استراتژی فعال این است که یک کار همگام سازی شبانه را در تمام حساب های خود اجرا کنید، اشیاء Google Ads را در حساب های خود بازیابی کنید و با پایگاه داده محلی خود مقایسه کنید.

خطاهای ثبت نام

تمام خطاها باید برای تسهیل اشکال زدایی و نظارت ثبت شوند. حداقل شناسه درخواست، عملیاتی که باعث ایجاد خطا شده است و خود خطا را ثبت کنید. اطلاعات دیگر برای ثبت نام شامل شناسه مشتری، سرویس API، تاخیر درخواست رفت و برگشت، تعداد دفعات مجدد، و درخواست و پاسخ خام است.

مطمئن شوید که روند خطاهای API را زیر نظر داشته باشید تا بتوانید مشکلات برنامه خود را شناسایی و برطرف کنید. راه حل خود را بسازید یا یکی از بسیاری از ابزارهای تجاری موجود را به کار بگیرید که می تواند از گزارش های شما برای تولید داشبوردهای تعاملی و ارسال هشدارهای خودکار استفاده کند.

توسعه

از حساب های آزمایشی استفاده کنید

حساب‌های آزمایشی ، حساب‌های Google Ads هستند که در واقع تبلیغات را ارائه نمی‌کنند. می‌توانید از یک حساب آزمایشی برای آزمایش با Google Ads API استفاده کنید و آزمایش کنید که اتصال برنامه‌تان، منطق مدیریت کمپین یا سایر پردازش‌ها مطابق انتظار کار می‌کنند. توکن برنامه‌نویس شما برای استفاده در حساب آزمایشی نیازی به تأیید ندارد، بنابراین می‌توانید بلافاصله پس از درخواست توکن توسعه‌دهنده، حتی قبل از بازبینی برنامه‌تان، توسعه را با Google Ads API شروع کنید.