عیب یابی مشکلات لیست مشتریان

از این راهنما برای عیب‌یابی نرخ تطابق پایین و خطاهای رایجی که ممکن است در ادغام تطابق مشتری شما رخ دهد، استفاده کنید.

اعتبارسنجی نرخ تطابق

قبل از تلاش برای اعتبارسنجی نرخ تطابق، مطمئن شوید که کار آپلود شما تکمیل شده است.

نرخ تطابق شما ممکن است به دلایل مختلفی کمتر از حد انتظار باشد، از جمله:

  • داده‌ها قبل از آپلود شدن هش نشده بودند.

  • داده‌ها قبل از هش شدن به درستی قالب‌بندی نشده‌اند.

  • شما در حال مقایسه با نرخ‌های تطبیق در یک سیستم متفاوت هستید.

  • شما در حال تلاش برای اضافه کردن چندین شناسه کاربر به یک شیء UserIdentifier هستید. در عوض، همانطور که در این مثال کد نشان داده شده است، چندین UserIdentifier را به یک شیء UserData اضافه کنید.

بسته به میزان فعالیت کاربران در جستجوی گوگل، جیمیل یا یوتیوب، یک تبلیغ‌کننده می‌تواند از ۱٪ تا ۹۹٪ از فهرست خود را پوشش دهد. برای راهنمای دقیق‌تر در مورد عیب‌یابی نرخ تطابق پایین، به مرکز راهنمایی مراجعه کنید.

تفاوت بین نرخ تطابق و اندازه لیست

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

اشکال‌زدایی خطاهای رایج

خطا
USER_PERMISSION_DENIED اگر سعی کنید فهرستی را که توسط حساب دیگری ایجاد شده است تغییر دهید، ممکن است با خطاهای مجوز مواجه شوید. شما فقط می‌توانید فهرستی را که حساب خودتان ایجاد کرده است ویرایش کنید.
EXTERNAL_UPDATE_ID_ALREADY_EXISTS این خطا می‌تواند در صورتی رخ دهد که سعی کنید چندین job با external_id یکسان ایجاد کنید.
CONFLICTING_OPERATION این خطا می‌تواند در صورتی رخ دهد که عملیات remove با عملیات create در یک کار واحد ترکیب شوند.
TOO_MANY_USER_IDENTIFIERS عملیات create در یک کار واحد در مجموع شامل بیش از ۱۰۰۰۰۰ user_identifiers است. درخواست را به چندین درخواست تقسیم کنید که از این حد تجاوز نکنند.
CONCURRENT_MODIFICATION این خطا ممکن است در صورتی رخ دهد که سعی کنید همزمان روی یک لیست کار کنید.
RESOURCE_EXHAUSTED این خطا می‌تواند در صورت ارسال درخواست‌های زیاد رخ دهد. می‌توانید با دسته‌بندی عملیات خود طبق جریان استفاده توصیه‌شده، این مشکل را کاهش دهید. همچنین می‌توانید برای محدودیت‌ها و سهمیه‌های API به راهنمای بهترین شیوه‌ها مراجعه کنید.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE این خطا زمانی رخ می‌دهد که توکن توسعه‌دهنده شما قبل از ۱ آوریل ۲۰۲۶ درخواست‌های تطابق مشتری ارسال نکرده باشد. در عوض، باید از رابط برنامه‌نویسی کاربردی (API) مدیریت داده برای گردش‌های کاری تطابق مشتری استفاده کنید.

پشتیبانی عیب‌یابی اضافی

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