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

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

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

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

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

• הנתונים לא עברו גיבוב לפני שהם הועלו.

• הנתונים לא היו בפורמט הנכון לפני שהם גובבו.

• אתם משווים לשיעורי התאמה במערכת אחרת.

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

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

ההבדלים בין שיעור ההתאמה לבין גודל הרשימה

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

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

שגיאה
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	השגיאה הזו מתרחשת אם קוד המפתח שלכם לא שלח בעבר בקשות להתאמה ללקוחות לפני 1 באפריל 2026. במקום זאת, צריך להשתמש ב-Data Manager API כדי להשתמש בתהליכי עבודה של קהלים מסוג "התאמה ללקוחות".

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

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