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

‫Google כספקית מקבלת עכשיו את המחרוזות של נתוני השקיפות וההסכמה באמצעות TCF בגרסה 2.2 של IAB EU.

• ‫TCF בגרסה 2.1: נמשיך לקבל מחרוזות TCF בגרסה 2.1, אבל נעודד את הספקים של פלטפורמות ה-CMP לפעול לפי ההנחיות של IAB לגבי אבני הדרך להטמעה בזמן שהענף עובר להשתמש ב-TCF בגרסה 2.2.
• הפתרונות לניהול הסכמה של Google: הפתרונות לניהול הסכמה של Google, שזמינים בכרטיסייה 'פרטיות והודעות' ב-Ad Manager, ב-AdSense וב-AdMob, תומכים בגרסה 2.2 של TCF בכל הנוגע להודעות בנושא תקנות אירופאיות, בהתאם לדרישות המעודכנות של IAB לגבי פלטפורמות CMP.

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, אפשר לבצע את הפעולות הבאות:

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

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

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

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

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

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

מומלץ לבעלי תוכן דיגיטלי לבקש שוב הסכמה אם בהטמעה שלהם חלו הבעיות הבאות: שימוש במחרוזות עם היקף מחוץ למסגרת (Out-of-band) והיקף גלובלי (Global scope), שימוש במזהי 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 הוא loading (בטעינה) ונתוני ה-TC של ה-CMP לא מלאים. כך הסקריפט ששולח את הקריאה יכול לגשת אל ה-listenerId שרשום לו. בנוסף, צריך להפעיל את הקריאה החוזרת בכל שינוי של מחרוזת נתוני השקיפות וההסכמה, אלא אם היא הוסרה באמצעות RemoveEventListener.

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

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

דוח שגיאות

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

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

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

• ב-Ad Manager: לוחצים על Admin (ניהול) ואז על EU user consent (הסכמת משתמשים באיחוד האירופי).
• ב-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 או 'cmpuishown' + 'useractioncomplete'. התגובות האלה מציינות שפלטפורמת ה-CMP מוכנה לספק למשתמש אפשרויות בחירה לגבי הסכמה. אם אתם לא מפעילים ידנית את הפונקציה לבקשה להצגת מודעות, אתם צריכים לוודא שתוטמע בפלטפורמת ה-CMP תמיכה ב-getTCData ויוחזרו ממנה התגובות TCData.eventStatus = 'tcloaded'‎ או 'cmpuishown' + 'useractioncomplete'. התגובות האלה מציינות שהאפשרות לקבלת הסכמה מהמשתמש מוכנה לשימוש דרך ה-API.
2.1b	שני התנאים הבאים מתקיימים: ספקי פלטפורמת ה-CMP הגדירו ‎&gdpr=1 הבקשה כוללת ‎&gdpr_consent=‎, אבל מחרוזת נתוני השקיפות וההסכמה ריקה.	לבקש מספק ה-CMP שיבדוק שממשקי ה-API מוטמעים באופן תקין בהתאם למפרט הטכני של IAB TCF.
2.2a	לא ניתן לנתח את מחרוזת השקיפות וההסכמה כי היא לא בקידוד base64. דוגמה: "2"	בפרמטרים מסוג gdpr_consent=‎, הנתונים שנשלחים על ידי ספקי ה-CMP (או בעלי התוכן הדיגיטלי) צריכים להיות בקידוד base64 בלבד.
2.2b	לא ניתן לנתח את מחרוזת נתוני השקיפות וההסכמה בגלל שגיאה בפענוח הקוד. דוגמה: כוללת מספר שגוי של ביטים	ספק ה-CMP צריך לתקן את השגיאות בהטמעה של מחרוזת נתוני השקיפות וההסכמה.
2.2c	לא ניתן לנתח את מחרוזת נתוני השקיפות וההסכמה בגלל שגיאת נתונים. דוגמה: חותמת זמן שגויה, מזהה ספק ארוך מדי	ספק ה-CMP צריך לתקן את השגיאות בהטמעה של מחרוזת נתוני השקיפות וההסכמה.

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

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

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

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

יוצגו מודעות מוגבלות (LTD).

שגיאה	תיאור	הפעולה המומלצת
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 צריך להזין את '~' בתור התו השני במחרוזת נתוני ההסכמה הנוספים כדי להפריד בין מספר הגרסה לרשימת הספקים שקיבלו הסכמה.
8.2	הפורמט של רשימת הספקים שכלולה במחרוזת נתוני ההסכמה הנוספים לא תקין (הפורמט התקין הוא רשימה של פריטי int64 שמופרדים באמצעות '.').	ספק ה-CMP צריך לתקן את השגיאות בהטמעה של מחרוזת נתוני ההסכמה הנוספים.

אישור של פלטפורמת ה-CMP

אם יתרחשו בעיות כאלה, מערכת Google Ad Manager תנסה להציג מודעות ללא התאמה אישית.

שגיאה	תיאור	הפעולה המומלצת
9.1	פלטפורמת ה-CMP ששולבה עם TCF וצוינה בבקשה לא אושרה על ידי Google.	פלטפורמת ה-CMP צריכה לקבל אישור מ-Google.

אין אותות TCF בבקשות להצגת מודעות

אם יתרחשו בעיות כאלה, מערכת Google Ad Manager תנסה להציג מודעות מוגבלות.

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