שאלות נפוצות

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

• בקשות batchinsert ו-batchupdate בודדות מוגבלות ל-1,000 המרות.
• חותמת הזמן של המרה יכולה להיות עד 28 ימים ממועד השליחה.
• אתם יכולים לשלוח המרות רק להגדרות אישיות של Floodlight שיש לפרופיל המשתמש שלכם ב-Campaign Manager 360 גישה אליהן.

במרכז העזרה של Search Ads 360 אפשר למצוא השוואה מפורטת בין התכונות שמוצעות בשני המוצרים.

אם תוסיפו את אותה המרה גם ל-Campaign Manager 360 וגם ל-Search Ads 360, המערכת לא תבטל את הכפילויות ברשומות. במקרה כזה, צריך להשתמש בפעילויות נפרדות ב-Floodlight.

כדי ליהנות מחוויית פיתוח משופרת ומגישה לתכונות נוספות, מומלץ להשתמש ב-Data Manager API.

ערכים סידוריים קובעים איך המערכת תעבד המרות כפולות. אם מוסיפים כמה המרות עם אותה פעילות ב-Floodlight, אותו מזהה הגדרה של Floodlight, אותו מזהה משתמש ואותה חותמת זמן של המרה, המספר הסידורי משמש כדי לקבוע אם:

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

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

השיטות batchinsert ו-batchupdate מעבדות המרות על בסיס המאמץ המרבי: בקשת Batch יכולה להחזיר תגובת HTTP 200 OK, אבל המרות ספציפיות ב-Batch יכולות להיכשל. תמיד צריך לבדוק את hasFailures בתגובה ולבחון את הרשימה errors[] בכל אובייקט ConversionStatus:

• ‫INTERNAL (ניסיון חוזר): אירעה שגיאה זמנית במערכות של Google במהלך עיבוד ההמרה. ההמרה לא נוספה או עודכנה. נסו שוב לשלוח המרות שנכשלו באמצעות השהיה מעריכית לפני ניסיון חוזר (exponential backoff) (לדוגמה, התחילו אחרי כמה דקות ונסו שוב במשך כמה שעות), תוך שמירה על אותם ערכים בדיוק של ordinal, timestampMicros, floodlightActivityId ומזהה המשתמש או הקליק.
• NOT_FOUND (ניסיון חוזר עם השהיה): עדיין לא נמצא המזהה (gclid,‏ dclid,‏ matchId או mobileDeviceId) או ההמרה הקיימת שנערכת. יכול להיות שיעברו שעה עד שעתיים לפני שקליקים אונליין, תגי Floodlight והמרות יעובדו ויתווספו לאינדקס, לכן כדאי לנסות שוב להעלות המרות של NOT_FOUND מדי פעם (לדוגמה, כל שעה עד 3 שעות, למשך עד 6 שעות). אם השגיאה NOT_FOUND נמשכת אחרי 6 שעות, עיינו בקטעים הבאים כדי לראות סיבות נפוצות לפי סוג המזהה.
• ‫INVALID_ARGUMENT ו-PERMISSION_DENIED (אין לנסות שוב): נתוני ההמרות לא תקינים (לדוגמה, חותמת זמן של המרה מלפני יותר מ-28 ימים או שדה בפורמט שגוי) או שלפרופיל המשתמש שלכם אין הרשאה להגדרת היעד של Floodlight. אל תנסו להעלות שוב את ההמרות האלה בלי לתקן את הבעיה הבסיסית.

אם בקשת ה-HTTP כולה נכשלת עם שגיאה בחיבור לשרת 5xx או שגיאת מכסה/הגבלת קצב של יצירת בקשות 429, נסו שוב את הבקשה באמצעות השהיה מעריכית לפני ניסיון חוזר (exponential backoff).

ניסיונות חוזרים בטוחים וביטול כפילויות: כשמנסים שוב לשלוח המרה שנכשלה עם INTERNAL או NOT_FOUND (או אחרי זמן קצוב לתפוגה של HTTP 5xx כשהתוצאה לא ידועה), תמיד צריך לשלוח את אותם ordinal ו-timestampMicros בדיוק. אם המרה כבר תועדה, מערכת Campaign Manager 360 מבטלת את הכפילויות שלה באופן אוטומטי על סמך ordinal, מזהה המשתמש, הפעילות ב-Floodlight ותאריך ההמרה.

הסיבות הנפוצות ביותר לשגיאה הזו הן:

• הערך של mobileDeviceId לא תקין.
• הערך mobileDeviceId לא מוכר ב-Search Ads 360. כלומר, עדיין לא הוצגה מודעה במכשיר על ידי Campaign Manager 360.

הסיבות הנפוצות ביותר לשגיאה הזו הן:

• הערך של gclid לא תקין.
• הערך gclid לא משויך לקמפיין ב-Search Ads 360 או לפריט ב-Display & Video 360 ב-YouTube. זה יכול לקרות אם ה-gclid נאסף מהפניה אוטומטית של קליק ב-Google Ads שלא עברה דרך Search Ads 360 (למשל, קליקים על תוספי מיקום) או נאסף מהפניה אוטומטית של קליק על מודעת YouTube שלא משויכת לפריט YouTube ב-Display & Video 360.
• הקליק שמשויך ל-gclid התרחש לפני יותר מדי זמן. אפשר להוסיף המרות רק לקליקים שנוצרו לפני פחות מ-60 ימים.
• הקליק שמשויך ל-gclid התרחש לפני זמן קצר מדי. מומלץ להמתין שעה לפני שמעלים המרות שמבוססות על gclid, כדי לוודא שהמערכת עיבדה את ה-gclid והוא זמין להתאמה.

הסיבות הנפוצות ביותר לשגיאה הזו הן:

• הערך של dclid לא תקין.
• הקליק שמשויך ל-dclid התרחש לפני יותר מדי זמן. אפשר להוסיף המרות רק לקליקים שנוצרו לפני פחות מ-60 ימים.
• הקליק שמשויך אל dclid התרחש לפני זמן קצר מדי. מומלץ להמתין שעה לפני שמעלים המרות שמבוססות על dclid, כדי לוודא שהמערכת עיבדה את ה-dclid והוא זמין להתאמה.

הסיבות הנפוצות ביותר לשגיאה הזו הן:

• הערך matchId לא מוכר ב-Campaign Manager 360. יכול להיות שהסיבה לכך היא שהערך של matchId נאסף מקריאה ל-Floodlight שלא עברה כמו שצריך דרך Campaign Manager 360 (צריך לוודא שהקריאות ל-Floodlight פועלות בצורה תקינה, כולל הפרמטר של התג matchId).
• הקריאה לתג Floodlight שמשויכת ל-matchId לא הכילה קובץ Cookie. הקריאה ל-Floodlight חייבת להכיל קובץ Cookie או מזהה כדי שמערכת Campaign Manager 360 תוכל לאחסן את matchId בצורה נכונה (למשל, יכול להיות שהמשתמש חסם קובצי Cookie או ביטל את ההסכמה לשימוש בהם).
• הקריאה ל-Floodlight שמשויכת ל-matchId התרחשה לפני יותר מדי זמן. צריך להעלות המרות אופליין תוך 60 יום מהקריאה ל-Floodlight שמכילה את ה-matchId.
• הקריאה ל-Floodlight שמשויכת ל-matchId התרחשה לפני זמן קצר מדי. מומלץ להמתין שעתיים לפני שמעלים המרות שמבוססות על matchId, כדי לוודא שה-matchId עבר עיבוד וזמין להתאמה.

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

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