פתרון בעיות הקשורות לרשימות של לקוחות

המדריך הזה יעזור לכם לפתור בעיות שקשורות לשיעורי התאמה נמוכים ולשגיאות נפוצות שעלולות להופיע בשילוב של התכונה 'התאמה ללקוחות'.

אימות שיעור ההתאמה

לפני שמנסים לאמת את שיעור ההתאמה, צריך לוודא שעבודת ההעלאה הסתיימה.

יכולות להיות כמה סיבות לכך ששיעור הבקשות שמולאו נמוך מהצפוי, כולל:

  • הנתונים לא עברו גיבוב לפני שהועלו.
  • הפורמט של הנתונים לא היה תקין לפני שהם עברו גיבוב.
  • אתם משווים לשיעורי התאמה במערכת אחרת.
  • אתם מנסים להוסיף כמה מזהי משתמש לאותו אובייקט UserIdentifier. במקום זאת, מוסיפים כמה אובייקטים מסוג UserIdentifier לאובייקט אחד מסוג UserData, כמו שמוצג בדוגמת הקוד הזו.

יכול להיות שמפרסם יצליח להגיע ל-1% עד 99% מהמשתמשים ברשימה שלו, בהתאם לרמת הפעילות של המשתמשים בחיפוש Google, ב-Gmail או ב-YouTube. מדריך מפורט יותר לפתרון בעיות שקשורות לשיעורי התאמה נמוכים זמין במרכז העזרה.

ההבדלים בין אחוז הלקוחות לטירגוט לבין גודל הרשימה

גודל הרשימה ואחוז הלקוחות לטירגוט הם ערכים שונים. שיעור ההתאמה כולל את כל המשתמשים עם חשבון Google, גם אם אי אפשר להגיע אליהם בפועל באמצעות קהל מסוג "התאמה ללקוחות". בגודל הרשימה נספרים משתמשים פעילים שתואמים לחשבון Google ושאפשר להגיע אליהם באמצעות התאמה אישית של מודעות.

ניפוי באגים בשגיאות נפוצות

שגיאה
USER_PERMISSION_DENIED יכול להיות שתיתקלו בשגיאות הרשאות אם תנסו לשנות רשימה שנוצרה על ידי חשבון אחר. אפשר לערוך רק רשימה שנוצרה על ידי החשבון שלכם.
EXTERNAL_UPDATE_ID_ALREADY_EXISTS השגיאה הזו יכולה להתרחש אם מנסים ליצור כמה משימות עם אותו external_id.
CONFLICTING_OPERATION השגיאה הזו יכולה להתרחש אם פעולות של remove משולבות עם פעולות של create במשימה אחת.
TOO_MANY_USER_IDENTIFIERS מספר הפעולות create בעבודה אחת גדול מ-100,000 user_identifiers בסך הכול. צריך לפצל את הבקשה לכמה בקשות שלא חורגות מהמגבלה.
CONCURRENT_MODIFICATION השגיאה הזו יכולה להתרחש אם מנסים לבצע פעולה באותה רשימה באותו הזמן.
RESOURCE_EXHAUSTED השגיאה הזו יכולה להופיע אם מנסים לשלוח יותר מדי בקשות. כדי לצמצם את הסיכון הזה, אפשר לבצע את הפעולות בקבוצות, בהתאם ל תהליך השימוש המומלץ. אפשר גם לעיין במדריך לשיטות מומלצות בנושא מגבלות ומכסות של API.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE השגיאה הזו מתרחשת אם בפרויקט Google Cloud שלכם (או באסימון מפתח ישן, שיצא משימוש ב-9 בספטמבר 2026) לא היו בקשות להתאמה ללקוחות בין 1 באוקטובר 2025 ל-31 במרץ 2026. במקום זאת, צריך להשתמש ב- Data Manager API בתהליכי ההתאמה ללקוחות.

תמיכה נוספת לפתרון בעיות

אם הבעיות לא נפתרות, אפשר לפנות אלינו באמצעות כלי לפתרון בעיות שקשורות לקהלים מסוג "התאמה ללקוחות".