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

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

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

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

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

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

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

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

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

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

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