عیب‌یابی

اگر هنگام استفاده از Search Ads 360 API با مشکلی مواجه شدید، به این بخش عیب‌یابی نگاهی بیندازید.

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

  • «شناسه آژانس» و «شناسه آگهی‌دهنده» Search Ads 360 که می‌خواهید به آن دسترسی پیدا کنید

  • شماره پروژه از کنسول Google API

  • نام کاربری «حساب Google» که از آن برای دسترسی به API استفاده می‌کنید.
    این حسابی است که اجازه دسترسی به Search Ads 360 به آن داده شده است، که همان حسابی است که برای راه‌اندازی مجوز استفاده می‌کنید.

  • تکه‌کد درخواست شما

  • پاسخ JSON
    اگر پاسخ خطا است، حتماً پیام خطا را اضافه کنید، نه فقط کد خطای عددی را.

خطاهای صدور مجوز

در اینجا برخی‌از خطاهای رایج در صدور مجوز آورده شده است:

پیام شرح

Access Not Configured. Please use Google API Console to activate the API for your project.

این خطا زمانی رخ می‌دهد که Search Ads 360 API را برای حسابتان فعال نکرده باشید. مطمئن شوید موارد زیر را انجام داده‌اید:

  1. به کنسول Google API بروید.

  2. پروژه‌تان را انتخاب کنید. اگر هنوز پروژه‌ای ایجاد نکرده‌اید، ایجاد پروژه برای مشتری را ببینید.

  3. در نوار کناری سمت راست، APIs & auth (میاناهای برنامه‌سازی کاربردی و اصالت‌سنجی) را ازهم باز کنید. سپس، روی میاناهای برنامه‌سازی کاربردی کلیک کنید. در فهرست میاناهای برنامه‌سازی کاربردی، مطمئن شوید که وضعیت Search Ads 360 API روی روشن باشد.

Invalid grant

این خطا زمانی رخ می‌دهد که ژتون بازآوری شما معتبر نباشد. می‌توانید با فراخوانی اسکریپت ابزار Search Ads 360 به‌صورت زیر، ژتون بازآوری دریافت کنید:

sa360Api.py --login

درباره گردش کار توصیه‌شده برای صدور مجوز بیشتر بدانید.

Invalid client
no application name

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

انواع دیگر خطاهای صدور مجوز

هنگام ورود به سیستم Google API Console برای بازیابی شناسه کارخواه و رمز کارخواه، و هنگام دریافت ژتون بازآوری، حتماً از «حساب Google» استفاده کنید که دسترسی به Search Ads 360 به آن اعطا شده است.

خطاهای بارگذاری تبدیل‌به‌مشتری

جدول زیر خطاهایی را که ممکن است هنگام بارگذاری تبدیل‌ها با آن‌ها مواجه شوید فهرست می‌کند. توجه داشته باشید که کدهای خطای دستگاه شانزده‌شانزدهی تغییرناپذیر هستند، بنابراین می‌توانید از آن‌ها در اسکریپت‌های خود برای شناسایی خطاها استفاده کنید.

کد خطا پیام شرح
0x00000101

Click ID '{ID}' is not found

شناسه کلیک که در درخواست insert یا update مشخص کرده‌اید معتبر نیست. تبدیل‌ها را پس‌از انجام کارهای زیر دوباره بارگذاری کنید:

0x00000106 Either a click ID or keyword ID is required

تبدیل مشخص نمی‌کند که به چه چیزی نسبت داده شده است. یا ستون clickId یا ستون‌های customerId، campaignId، adGroupId، و criterionId را که کلیدواژه را شناسایی می‌کنند مشخص کنید.

0x0000010C Either of Floodlight activity ID or Floodlight activity name is required

segmentationType: "FLOODLIGHT" و فعالیت Floodlight را در ستون segmentationName یا segmentationId مشخص کنید.

وقتی تبدیلی را که Search Ads 360 ازطریق برچسب Floodlight ثبت کرده است ویرایش می‌کنید، فعالیت Floodlight برای شناسایی تبدیل لازم است.

0x0000010E Floodlight activity name '{name}' is not found

نام فعالیت Floodlight مشخص‌شده در ستون segmentationName نادرست است یا هنوز دردسترس نیست. اگر این خطا را می‌بینید، مشکلات رایج زیر را بررسی کنید:

  • نام‌ها به حروف بزرگ و کوچک حساس هستند، بنابراین مطمئن شوید که درخواست شما دقیقاً با حروف بزرگ و کوچک مطابقت داشته باشد.
  • مطمئن شوید که هیچ نویسه Unicode غیرقابل‌چاپی یا فاصله دوگانه در نام فعالیت Floodlight وجود نداشته باشد.
  • مطمئن شوید نام فعالیت Floodlight را مشخص کرده‌اید، نه ستون Floodlight.
  • بررسی کنید که فعالیت Floodlight برای تبلیغ‌کننده‌ای که شناسه کلیک یا کلیدواژه در درخواست شما به آن تعلق دارد وجود داشته باشد.
  • پس‌از ایجاد یا ویرایش فعالیت Floodlight، چند ساعت صبر کنید و سپس تبدیل‌های مربوط به آن فعالیت را بارگذاری کنید.
0x00000115 Custom dimension '{name}' is not found

مطمئن شوید متغیر Floodlight سفارشی که مشخص کرده‌اید به‌عنوان بُعد (نه سنجه) برای تبلیغ‌کننده مرتبط با clickId، criterionId، یا productGroupId که برای تبدیل نسبت می‌دهید راه‌اندازی شده باشد.

0x00000116 Custom metric '{name}' is not found

مطمئن شوید متغیر Floodlight سفارشی که مشخص کرده‌اید به‌عنوان سنجه (نه بُعد) برای آگهی‌دهنده مرتبط با clickId، criterionId، یا productGroupId که برای تبدیل نسبت می‌دهید راه‌اندازی شده باشد.

0x00000119 A conversion ID or advertiser conversion ID is required to modify an existing conversion

درخواست update شما ستون conversionId را مشخص نکرده است. conversionId برای شناسایی تبدیلی که می‌خواهید ویرایش کنید لازم است. منسوخ شدن dsConversionId را ببینید.

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

شخصی قبلاً تبدیلی را برای همان دامنه و شناسه تبدیل آگهی‌دهنده که در ستون conversionId مشخص شده است بارگذاری کرده است.

«شناسه تبدیل آگهی‌دهنده» شناسه‌ای است که شما تولید می‌کنید. ‫Search Ads 360 لازم می‌داند که این شناسه برای یک دامنه مشخص منحصربه‌فرد باشد. شناسه تبدیل Search Ads 360 توسط Search Ads 360 تولید می‌شود و تضمین می‌شود که منحصربه‌فرد باشد.

0x0000011B Advertiser conversion ID '{ID}' is not found

درخواست update شما سعی کرد شناسه تبدیل آگهی‌دهنده‌ای را به‌روز کند که وجود ندارد. مشکلات رایج زیر را بررسی کنید:

  • مطمئن شوید شناسه درست را در ستون conversionId مشخص کرده‌اید. برای تبدیل‌های بارگذاری‌شده ازطریق میانای برنامه‌سازی کاربردی، این conversionId است که هنگام درج تبدیل مشخص کرده‌اید. برای تبدیل‌های ثبت‌شده ازطریق برچسب‌های Floodlight، این شناسه سفارش Floodlight است.
  • مطمئن شوید conversionTimestamp مُهر زمان تبدیل موجود، در میلی‌ثانیه Epoch ساعت هماهنگ جهانی باشد. مُهر زمانی‌ای که از منطقه زمانی محلی تبدیل شده است یا به‌جای میلی‌ثانیه برحسب ثانیه مشخص شده است با تبدیل موجود مطابقت ندارد.
  • برای تبدیل‌های ثبت‌شده ازطریق برچسب‌های Floodlight، مطمئن شوید که فعالیت Floodlight تبدیل را در ستون segmentationName یا segmentationId مشخص کرده‌اید و تبدیل در ۲۸ روز گذشته رخ داده است.
0x0000011D User does not have permission to view advertiser {advertiser ID}

«حساب Google» مورداستفاده مشتری شما اجازه مشاهده آگهی‌دهنده‌ای را که شناسه کلیک یا کلیدواژه موجود در درخواست به آن تعلق دارد ندارد.

وقتی برای بازیابی شناسه کارخواه و رمز کارخواه به سیستم «کنسول Google API» وارد می‌شوید و وقتی ژتون بازآوری دریافت می‌کنید، حتماً از «حساب Google» استفاده کنید که دسترسی به آن آگهی‌دهنده به آن اعطا شده باشد.

0x0000011F Advertiser conversion ID is already specified in this request

دو یا چند تبدیل در درخواست، دامنه و شناسه تبدیل آگهی‌دهنده یکسانی را مشخص می‌کنند.

شناسه تبدیل آگهی‌دهنده شناسه‌ای است که شما تولید می‌کنید و در ستون conversionId مشخص می‌کنید. ‫Search Ads 360 نیاز دارد که این شناسه برای یک دامنه مشخص منحصربه‌فرد باشد.

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

شناسه یا نام فعالیت Floodlight که ارائه کرده‌اید با نوع تبدیلی که مشخص کرده‌اید مطابقت ندارد.

0x00000124 Conversion timestamp is before click timestamp

conversionTimestamp قبل‌از زمان کلیکی است که در ستون clickId مشخص کرده‌اید. مطمئن شوید مُهر زمان در Epoch میلی‌ثانیه UTC مشخص شده باشد، نه در ثانیه یا در منطقه زمانی محلی.

0x00000125 Conversion age is older than the max supported age

درخواست update شما سعی کرد تبدیلی را ویرایش کند که برای ویرایش شدن خیلی قدیمی است. تبدیل‌هایی که Search Ads 360 ازطریق برچسب‌های Floodlight ثبت کرده است فقط ظرف ۲۸ روز از conversionTimestamp قابل‌ویرایش هستند.

0x00000126 Service internal error

کمی بعد درخواستتان را دوباره امتحان کنید. این احتمالاً خطایی گذرا است. اگر این خطا برطرف نشد، لطفاً با پشتیبانی SA360 تماس بگیرید.

0x00000129 Invalid customer ID: {ID}

Search Ads 360 نمی‌تواند شناسه مشتری‌ای را که در ستون customerId مشخص کرده‌اید پیدا کند. شناسه مشتری Search Ads 360 جدید حساب مشتری را که حاوی کلیدواژه است مشخص کنید، برای مثال 123-456-7890.

0x0000012C Cannot find this keyword ID in Search Ads 360.

‫Search Ads 360 نمی‌تواند کلیدواژه‌ای را که با ستون‌های customerId، campaignId، adGroupId، و criterionId شناسایی شده است پیدا کند. مطمئن شوید که هر چهار شناسه شناسه‌های Search Ads 360 جدید باشند و کلیدواژه به گروه آگهی، پویش، و حساب مشتری‌ای که مشخص کرده‌اید تعلق داشته باشد.

0x0000012E Please provide the full set of new Search Ads 360 IDs: {missing ID}

تبدیلی که به کلیدواژه‌ای نسبت داده می‌شود باید customerId، campaignId، adGroupId، و criterionId را مشخص کند. پیام نام شناسه‌ای را که وجود ندارد نشان می‌دهد. نسبت دادن تبدیل فقط به کلیدواژه را ببینید.

0x0000012F Editing a click ID older than 60 days is not supported.

درخواست update شما clickId را مشخص کرده است که بیش‌از ۶۰ روز پیش تولید شده است. تبدیل‌ها فقط ظرف ۶۰ روز پس‌از کلیک قابل ویرایش هستند.

0x0000013C Conversion editing using integer DS conversion ID is deprecated. Please use conversion ID instead.

درخواست update شما ستون منسوخ‌شده dsConversionId را مشخص کرده است، یا شناسه تبدیل Search Ads 360 را در ستون conversionId ارسال کرده است. درعوض، تبدیل را با شناسه تبدیل آگهی‌دهنده آن شناسایی کنید. منسوخ شدن dsConversionId را ببینید.

کدهای پاسخ گزارش و پیام‌های خطا

اگر گزارشی درخواست کنید و پاسخ پیام خطا باشد، برای اطلاعات بیشتر درباره خطا به کدهای پاسخ در Search Ads 360 API و پاسخ‌های خطای استاندارد مراجعه کنید.

داده‌های موجود در میانای کاربر Search Ads 360 با گزارش برگردانده‌شده توسط API مطابقت ندارد

داده‌های موجود در میانای کاربر Search Ads 360 باید به‌طور پیش‌فرض با داده‌های برگردانده‌شده توسط API مطابقت داشته باشد. اگر includeRemovedEntities را در درخواست گزارش روی true تنظیم کنید، مطمئن شوید که چارگوش انتخاب نمایش موارد برداشته‌شده نیز در میانای کاربر انتخاب شده باشد.