عیب یابی

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

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

  • Search Ads 360 Agency ID و Advertiser ID که می‌خواهید به آن دسترسی پیدا کنید

  • شماره پروژه از Google API Console

  • نام کاربری حساب 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. به کنسول API Google بروید.

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

  3. در نوار کناری سمت چپ، APIs & auth را گسترش دهید. در مرحله بعد، روی APIs کلیک کنید. در فهرست APIها، مطمئن شوید که وضعیت برای Search Ads 360 API روشن است.

Invalid grant

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

sa360Api.py --login

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

Invalid client
no application name

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

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

هنگام ورود به Google API Console برای بازیابی شناسه مشتری و راز سرویس گیرنده خود و هنگامی که یک نشانه رفرش دریافت می کنید، مطمئن شوید که از یک حساب Google استفاده کنید که به Search Ads 360 دسترسی داشته باشد .

خطاهای آپلود تبدیل

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

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

Click ID ' {ID} ' is not found

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

  • تأیید کرد که شناسه کلیک 4 ساعت قبل از آپلود تبدیل ایجاد شده است.

  • سرویس تبدیل API را فعال کرد .

  • اگر تبدیل‌ها را به بازدیدهای خاصی نسبت می‌دهید ، قبل از آپلود تبدیل، حداقل 30 دقیقه پس از بازدید منتظر بمانید. اگر زودتر از 30 دقیقه پس از بازدید آپلود کنید، Search Ads 360 ممکن است شناسه کلیک بازدید را تشخیص ندهد. در موارد نادر، ممکن است لازم باشد تا 4 ساعت صبر کنید تا Search Ads 360 بتواند شناسه کلیک را تشخیص دهد.

  • تأیید کرد که کلیک از منبع معتبری است که توسط پارامتر gclsrc نشان داده شده است .

  • تأیید شد که تبلیغ‌کننده صحیح را در ستون advertiserId مشخص کرده‌اید.

  • تأیید کرد که شناسه کلیک شما در 90 روز گذشته ایجاد شده است.

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

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

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

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

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

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

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 شما سعی کرد شناسه تبدیل تبلیغ‌کننده‌ای را به‌روزرسانی کند که وجود ندارد. مطمئن شوید که شناسه درست را مشخص کرده اید.

0x0000011D User does not have permission to view advertiser {advertiser ID}

حساب Google که مشتری شما از آن استفاده می‌کند، مجوز مشاهده تبلیغ‌کننده مشخص‌شده در درخواست را ندارد.

هنگامی که برای بازیابی شناسه مشتری و رمز سرویس گیرنده خود وارد Google API Console می‌شوید، و هنگامی که یک نشانه به‌روزرسانی دریافت می‌کنید، مطمئن شوید که از یک حساب 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 یا نامی که ارائه کرده‌اید با نوع تبدیلی که مشخص کرده‌اید مطابقت ندارد.

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

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

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

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