פתרון בעיות בהטמעת TCF בגרסה 2.2 של IAB EU

IAB הודיעה על גרסה 2.2 של TCF של IAB ב-16 במאי 2023. כספקית, Google תתחיל לקבל את נתוני השקיפות וההסכמה באמצעות TCF v2.2 החל מ-11 ביולי 2023. בקשות עם נתוני TCF v2.2 שיישלחו לפני התאריך הזה עלולות לגרום לשגיאות.

• TCF v2.1: נמשיך לקבל מחרוזות של TCF v2.1, אבל נעודד פלטפורמות CMP לפעול לפי ההנחיות של IAB להטמעת אבני דרך בזמן שהתחום עובר להשתמש ב-TCF v2.2.
• פתרונות לניהול הסכמה של Google: הפתרונות לניהול הסכמה של Google, שזמינים בכרטיסייה 'פרטיות והודעות' ב-Ad Manager, ב-AdSense וב-AdMob, יתחילו לתמוך ב-TCF v2.2 בעניין ההודעות בנושא הסכמה בהתאם ל-GDPR לא יאוחר מתחילת נובמבר, באופן שמתיישב עם המועד האחרון להטמעה בפלטפורמות CMP, ש-IAB עדכנה ל-20 בנובמבר 2023.

IAB Europe סיימה לפתח את גרסה 2.0 של Transparency and Consent Framework (‏TCF - מסגרת השקיפות וההסכמה). המסגרת פותחה בשיתוף עם IAB Tech Lab וארגונים שחברים בשני הגופים. Google תומכת כעת באופן מלא בגרסה 2.0 של TCF.

כדי לתת לבעלי תוכן דיגיטלי זמן לנהל שגיאות והגדרות שגויות הקשורות להשקה של גרסה 2.0 של Transparency & Consent Framework (מסגרת השקיפות וההסכמה – TCF) של IAB Europe,‏ Google תספק לבעלי תוכן דיגיטלי דיווח על שגיאות שזיהינו ותעניק להם תקופת חסד של 150 ימים כדי לפתור את השגיאות.

---

במאמר הזה תמצאו מידע נוסף על פתרון שגיאות הטמעה של TCF בגרסה 2.2, כולל:

• הנחיות מעודכנות
• מרכז המדיניות
• דוח שגיאות
• פתרון בעיות

 

---

הנחיות מעודכנות

עדכונים

• תזכורת לגבי הדרישה של TCF לקבלת הסכמה מחדש כל 13 חודשים: 

  You are required by IAB TCF policy to remind users about their consent choices at least once every 13 months. If the consent decision is more than 13 months old, the TC string will no longer be considered valid by Google and Google will not serve ads to that user. We suggest that you work with your CMP to remind users about their consent choices before the 13-month limit is reached.

• סוג השגיאה 3.2 בוטל. מחרוזות נתוני שקיפות והסכמה שעודכנו ב-13 החודשים האחרונים יישארו בתוקף.

תיקונים של שגיאות נפוצות

כדי לפתור כמה מהשגיאות הנפוצות ביותר ב-Ad Manager, ‏AdSense ו-AdMob, תוכלו להיעזר בפעולות הבאות:

מומלץ לבקש שוב הסכמה ממשתמשים עם מחרוזות נתוני שקיפות והסכמה (TC) שלא מייצרות הכנסות
^{(שגיאות 1.1, 3.1, 4.1, 5.1, 5.2 ו-6.1)}

שגיאות קשורות

שגיאה 1.1. את ההנחיות האלה אפשר ליישם גם לגבי השגיאות הבאות: 3.1, 4.1, 5.1, 5.2 ו-6.1.

הנחיה מעודכנת

מומלץ לבקש שוב הסכמה ממשתמשים.

הסבר לגבי ההנחיה

מומלץ לבעלי תוכן דיגיטלי לבקש שוב הסכמה אם בהטמעה שלהם חלו הבעיות הבאות: שימוש במחרוזות עם היקף מחוץ למסגרת והיקף גלובלי, שימוש במזהי CMP לא תקינים (שמקורם בבדיקות), שימוש במזהי GVL לא תקינים (שמקורם בבדיקות), או אם בשלב כלשהו בהטמעה הם לא ציינו את Google כספקית עם הסכמה מתאימה.

שגיאות 1.1, 1.2 ו-1.3: חשוב לבדוק אם השגיאות האלה מייצגות נפח משמעותי של תנועת גולשים. אם כן, יכול להיות שמדובר בבעיה בצד ה-CMP. צריך לוודא ש-Google קיבלה הסכמה למטרות הנדרשות, ושהיא גם הוגדרה כספקית לקבלת הסכמה ובעלת אינטרס לגיטימי (מזהה ספק 755).

מפרט IAB

לפי המפרט של IAB, אפשר לשמור מחרוזות הסכמה במטמון של פלטפורמות CMP למשך 13 חודשים.

חלק מפלטפורמות ה-CMP שמרו בעבר את תאריך ההסכמה הראשון והאריכו אותו. המצב הזה לא תקין. בכל פעם תאריך ההסכמה צריך להיות התאריך החדש של מחרוזת הסכמה ספציפית.

המלצה: כדאי לבקש מספק ה-CMP להחזיר קריאות מ-AddEventHandler תוך 500 אלפיות השנייה
^{(שגיאות 2.1a, ‏2.1b, ‏2.0a, ‏2.0b, ו-2.0c)}

שגיאות קשורות

שגיאה 2.1a. את ההנחיות האלה אפשר ליישם גם לגבי השגיאות הבאות: 2.1b,‏ 2.0a, ‏2.0b ו-2.0c.

הנחיה מעודכנת

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

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

הסבר לגבי ההנחיה

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

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

מפרט IAB

מפרט IAB רלוונטי: מפרט‏ AddEventListener של IAB (ב-GitHub)

יש להפעיל את הקריאה החוזרת (callback)‏ של AddEventListener מיד לאחר ההרשמה עם נתוני ה-TC הנוכחיים, גם אם הטעינה של סטטוס ה-CMP עדיין מתבצעת ונתוני ה-TC של ה-CMP לא מלאים. כך הסקריפט ששולח את הקריאה יכול לגשת אל ה-listenerId שרשום עבורו. בנוסף, צריך להפעיל את הקריאה החוזרת בכל שינוי של מחרוזת נתוני השקיפות וההסכמה, אלא אם היא הוסרה באמצעות RemoveEventListener.

מרכז המדיניות

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

דוח שגיאות

בעלי תוכן דיגיטלי יקבלו הודעה בממשק המשתמש של המוצר אם נזהה בעיה במחרוזת נתוני השקיפות וההסכמה שמשויכת לאחד או יותר מהאתרים או מהאפליקציות שלהם. בעלי תוכן דיגיטלי שירצו להוריד דוח מפורט של השגיאות שזוהו אצלם ב-7 הימים האחרונים, יוכלו להיכנס בחשבון שלהם לדף 'הסכמת משתמשים באיחוד האירופי' וללחוץ על הורדת דוח שגיאות של TCF.

הדוח הזה זמין רק אם זוהו שגיאות ב-7 הימים האחרונים.

כדי לגשת לדף 'הסכמת משתמשים באיחוד האירופי' ולדוח השגיאות של TCF: 

• Ad Manager: לוחצים על ניהול מערכת הסכמת משתמשים באיחוד האירופי.
• AdMob ו-AdSense: לוחצים על כלים לחסימת מודעות  הסכמת משתמשים באיחוד האירופי.

אפשר למצוא בדוח את הפרטים הבאים לגבי כל שגיאה שזוהתה: 

• הדומיין/MobileAppID: האתר או האפליקציה לנייד שהוגדרו באופן שגוי.
• נתיב יחידת המודעות: יחידת המודעות שמשויכת לשגיאה.
• קוד השגיאה: הקוד שהוקצה לשגיאה. 
• מספר השגיאות: מספר השאילתות שמכילות את השגיאה שזוהו במהלך השבוע הקודם.
• תאריך הזיהוי האחרון: התאריך האחרון שבו זוהתה השגיאה. 

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

פתרון בעיות

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

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

תרחישים של הסכמה מוגבלת

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

תרחיש	תיאור	פעולה מומלצת לביצוע
1.1	Google, כספקית, לא אושרה על בסיס הסכמה או אינטרס לגיטימי.	צריך לבדוק אם המשתמש דחה את Google כספקית באופן מכוון, אם התרחשו שגיאות בהטמעת ה-CMP או אם יש הגבלות על בעלי תוכן דיגיטלי.
1.2	אין הסכמה למטרה 1 עבור מדינות באזור הכלכלי האירופי (EEA) ובריטניה.	צריך לבדוק אם המשתמש לא הביע הסכמה למטרה 1 באופן מכוון או שהבעיה נובעת משגיאות בהטמעת ה-CMP. בעלי תוכן דיגיטלי בשווייץ צריכים לוודא שהם מגדירים את השדות PublisherCC ו-PurposeOneTreatment בצורה נכונה, אם הם לא מבקשים מהמשתמשים להביע הסכמה.    החל מדצמבר 2021, לא נבדוק יותר את האופן שבו מתבצע הטיפול ב-DestinationOneTreatment בבקשות להצגת מודעות שמקורן בגרמניה, בהתאם לחוקי התקשורת והטלמדיה להגנת נתונים בגרמניה.
1.3	יש הסכמה למטרה 1, אבל אין בסיס משפטי למודעות בסיסיות.	צריך לבדוק אם המשתמש דחה אינטרסים לגיטימיים בשאר המטרות באופן מכוון או אם הבעיה נובעת משגיאות בהטמעה של ה-CMP.

הגדרה שגויה

בקשות להצגת מודעות לא ימולאו אם קיימות שגיאות בהגדרה.

שגיאה	תיאור	פעולה מומלצת לביצוע
2.1a	התג או ה-SDK לא מקבלים מחרוזת של נתוני שקיפות והסכמה כי הסטטוס של ה-CMP הוא stub‏, loading או error.	אם אתם מפעילים ידנית את הפונקציה לבקשה להצגת מודעות, עליכם להקפיד שהתגובה ל-getTCData TCData.eventStatus תהיה 'tcloaded' או 'cmpuishowed' + 'useractioncomplete'. התגובות האלה מציינות שפלטפורמת ה-CMP מוכנה לספק למשתמש אפשרויות בחירה לגבי הסכמה. אם אתם לא מפעילים ידנית את הפונקציה לבקשה להצגת מודעות, עליכם לוודא שתוטמע בפלטפורמת ה-CMP תמיכה ב-getTCData ויוחזרו ממנה התגובות TCData.eventStatus = 'tcloaded'‎ או 'cmpuishown' + 'useractioncomplete'. התגובות האלה מציינות שהאפשרות לקבלת הסכמה מהמשתמש מוכנה לשימוש דרך ה-API.
2.1b	שני התנאים הבאים מתקיימים: ספקי פלטפורמת ה-CMP הגדירו ‎&gdpr=1 הבקשה כוללת ‎&gdpr_consent=‎, אבל מחרוזת נתוני השקיפות וההסכמה (TC) ריקה.	כדאי לבקש מספק ה-CMP לוודא שממשקי ה-API מוטמעים באופן תקין בהתאם למפרט הטכני של IAB TCF.
2.0a	לא ניתן לנתח את מחרוזת השקיפות וההסכמה כי היא לא בקידוד base64. דוגמה: "2"	בפרמטרים מסוג gdpr_consent=‎, הנתונים שנשלחים על ידי ספקי ה-CMP (או בעלי התוכן הדיגיטלי) צריכים להיות בקידוד bases64 בלבד.
2.0b	לא ניתן לנתח את מחרוזת נתוני השקיפות וההסכמה עקב שגיאה בפענוח הקידוד. דוגמה: כוללת מספר שגוי של ביטים	פלטפורמת ה-CMP צריכה לתקן את השגיאות בהטמעה של מחרוזת נתוני השקיפות וההסכמה.
2.0c	לא ניתן לנתח את מחרוזת נתוני השקיפות וההסכמה עקב שגיאת נתונים. דוגמה: חותמת זמן שגויה, מזהה ספק ארוך מדי	פלטפורמת ה-CMP צריכה לתקן את השגיאות בהטמעה של מחרוזת נתוני השקיפות וההסכמה.

בעיות שקשורות למחרוזת נתוני השקיפות וההסכמה

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

שגיאה	תיאור	פעולה מומלצת לביצוע
3.1	מזהה CMP לא חוקי.	צריך לוודא שנעשה שימוש בפלטפורמת CMP שאומתה על ידי IAB ושהמזהה של ה-CMP מוגדר נכון במחרוזות נתוני השקיפות וההסכמה. אם ה-CMP אומתה בזמן יצירת מחרוזת נתוני השקיפות וההסכמה, אבל נמחקה בהמשך על ידי IAB, יש לקבל שוב הסכמה באמצעות CMP שעברה אימות.
3.2	כבר לא בשימוש.	אין. המשמעות הקודמת: תאריך היצירה של מחרוזת נתוני השקיפות וההסכמה היה לפני יותר מ-13 חודשים.

צריך לקבל הסכמה מחדש

צריך לקבל הסכמה מהמשתמש. אם קיבלתם הסכמה מהמשתמש לפני יותר מ-13 חודשים או שאתם משתמשים בגרסה של רשימת הספקים הגלובלית (GVL) שבה Google עוד לא הייתה רשומה, עליכם לקבל מחדש הסכמה מהמשתמש. אחרת, המערכת תתעלם מבקשות להצגת מודעות ולא תמלא אותן.

שגיאה	תיאור	פעולה מומלצת
3.3	תאריך העדכון האחרון של מחרוזת נתוני השקיפות וההסכמה היה לפני יותר מ-13 חודשים.	צריך למחוק ב-CMP את הגרסה הישנה של מחרוזת נתוני השקיפות וההסכמה ולקבל הסכמה מחדש. סביר להניח שחלק קטן מהשגיאות האלה יתרחשו אם הבקשות להצגת מודעות נשלחות במצב שבו פג התוקף של מחרוזת נתוני השקיפות וההסכמה, ולפני שההסכמה מהמשתמש בוטלה והתקבלה מחדש על ידי ה-CMP. אם אתם משתמשים בפתרונות של Google לניהול הסכמה וב-UMP SDK באפליקציה, עליכם לוודא שה-UMP SDK הוטמע כראוי ושנשלחת קריאה אל requestConsentInfoUpdate בכל הפעלה של האפליקציה.
4.1	מחרוזת נתוני השקיפות וההסכמה נוצרה באמצעות גרסה של רשימת הספקים הגלובלית (GVL) שבה Google עוד לא הייתה רשומה.	צריך לקבל הסכמה מחדש באמצעות גרסה עדכנית של ה-GVL.

היקף גלובלי והיקף מחוץ למסגרת

בעיות שקשורות להיקף גלובלי ולהיקף מחוץ למסגרת (Ad Manager,‏ AdMob,‏ AdSense). מודעות לא יוצגו אם מחרוזת נתוני השקיפות וההסכמה מציינת 'היקף גלובלי' (Global scope) או 'מחוץ למסגרת' (Out-of-band).

שגיאה	תיאור	פעולה מומלצת
5.1	מחרוזת נתוני השקיפות וההסכמה מאפשרת הסכמה 'מחוץ למסגרת'.	צריך להנחות את ה-CMP להסיר אותות 'מחוץ למסגרת' ממחרוזות נתוני השקיפות וההסכמה.
5.2	מחרוזת נתוני שקיפות והסכמה עם היקף גלובלי.	צריך להנחות את ה-CMP לעדכן את מחרוזות נתוני השקיפות וההסכמה כך שיהיו מותאמות ספציפית לשירות.

הצגת מודעות מוגבלות

יוצגו מודעות מוגבלות.

שגיאה	תיאור	פעולה מומלצת
6.1	הגרסה של מחרוזת נתוני השקיפות וההסכמה היא 1 או 1.1 (מחרוזת מגרסה 1.0).	פלטפורמת ה-CMP צריכה לשלוח מחרוזות של TCF בגרסה 2.2.

Google תטפל בבעיות

אם תתרחש בעיה מהסוג הזה, Google תתייחס לבעיה בעצמה, במידת הצורך, ותמשיך בטיפול הרגיל במסגרת ה-TCF.

שגיאה	תיאור	פעולה מומלצת
7.1	gdprApplies לא מוגדר, או מוגדר כערך לא חוקי או בלתי ניתן לפענוח, אבל קיימת מחרוזת נתוני שקיפות והסכמה חוקית.	לא רלוונטי
7.2	מחרוזת השקיפות וההסכמה נוצרה באמצעות גרסה חדשה יותר של רשימת הספקים הגלובלית (GVL) מהגרסה הנוכחית שמוכרת לטכנולוגיית פרסום המודעות של Google.	לא רלוונטי
7.3	מטרות, תכונות ו/או ספקים מסוימים לא נמצאים בטווח (לא ידועים).	לא רלוונטי
7.4	מחרוזת נתוני השקיפות וההסכמה מכילה גרסה ישנה יותר של tcf_policy_version מזו שמופיעה בגרסה החדשה ביותר של רשימת הספקים הגלובלית (GVL).	ספק ה-CMP צריך למחוק את הגרסה הישנה של מחרוזת נתוני השקיפות וההסכמה ולקבל שוב הסכמה באמצעות הגרסה החדשה ביותר של רשימת הספקים הגלובלית.
7.5	הבקשה מכילה ‎&gdpr=1, אבל כתובת ה-URL של הבקשה לא מכילה את הפרמטר ‎&gdpr_consent.	לא רלוונטי
7.6	קוד מדינה לא חוקי של בעל תוכן דיגיטלי, אבל קיימת הסכמה למטרה 1.	פלטפורמת ה-CMP צריכה לתקן את השגיאות בהטמעה של מחרוזת נתוני השקיפות וההסכמה.
7.7	קוד שפה לא חוקי.	פלטפורמת ה-CMP צריכה לתקן את השגיאות בהטמעה של מחרוזת נתוני השקיפות וההסכמה.
7.8	הערך של שדה הגרסה של מחרוזת נתוני השקיפות וההסכמה הוא לא 1 וגם לא 2.	אם היא מזהה מחרוזת לא תקינה של נתוני השקיפות וההסכמה, פלטפורמת ה-CMP צריכה לבקש הסכמה מחדש כדי לתקן את השגיאות בהטמעה של המחרוזת. אם אתם משתמשים בפתרונות של Google לניהול הסכמה וב-UMP SDK באפליקציה, עליכם לוודא שה-UMP SDK הוטמע כראוי ושנשלחת קריאה אל requestConsentInfoUpdate בכל הפעלה של האפליקציה.
7.9	הגרסה של מחרוזת נתוני ההסכמה הנוספים היא לא 1 וגם לא 2.	פלטפורמת ה-CMP צריכה להגדיר את הגרסה של מחרוזת נתוני ההסכמה הנוספים ל-1 או 2.

בעיות במחרוזת נתוני ההסכמה הנוספים

כשהמערכת תזהה בעיות מהסוג הזה, Google תתייחס למחרוזת נתוני ההסכמה הנוספים (AC) כלא תקינה, ולא יתקבלו ספקים נוספים מעבר לאלו שמצוינים במחרוזת נתוני השקיפות וההסכמה (TC).

שגיאה	תיאור	פעולה מומלצת
8.1	אין מפריד גרסה (~) במחרוזת נתוני ההסכמה הנוספים.	פלטפורמת ה-CMP צריכה להזין את '~' בתור התו השני במחרוזת ה-AC כדי להפריד בין מספר הגרסה לרשימת הספקים שקיבלו הסכמה.
8.2	הפורמט של רשימת הספקים שכלולה במחרוזת נתוני ההסכמה הנוספים לא תקין (הפורמט התקין הוא רשימה של פריטי int64 שמופרדים בתו ' . ')	פלטפורמת ה-CMP צריכה לתקן את השגיאות בהטמעה של מחרוזת ה-AC.