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

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

אימות של אחוז הלקוחות לטירגוט

לפני שאתם מנסים לאמת את אחוז הלקוחות לטירגוט, ודאו שמשימת ההעלאה הושלמה.

יכולות להיות כמה סיבות לכך שאחוז הלקוחות לטירגוט נמוך מהצפוי, למשל:

• הנתונים לא עברו גיבוב לפני שהם הועלו.
• הפורמט של הנתונים לא היה תקין לפני הגיבוב.
• אתם משווים את אחוז הלקוחות לטירגוט לאחוז הלקוחות לטירגוט במערכת אחרת.
• אתם מנסים להוסיף כמה מזהי משתמשים לאובייקט 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 בתהליכי העבודה של ההתאמה ללקוחות.

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

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