שינויים בהמרות

אפשר להשתמש בשיטה IngestEvents כדי לבצע שינויים בהמרות שתיעדתם בעבר ב-Google Ads. ב-Data Manager API, שינוי יכול לשנות את ערך ההמרה או להוסיף נתונים למאגר נתוני המשתמשים.

אם אתם עוברים מ-Google Ads API, כדאי לעיין במאמר שדרוג מ-Google Ads API כדי להשוות בין אופן הטיפול בהתאמות בכל API.

סוגי ההמרות הנתמכים

אפשר לשנות את סוגי ההמרות הבאים ב-Google Ads:

איך מתבצעים שינויים

במסגרת אותה פעולת המרה, מערכת Google Ads מתאימה בין אירועים באמצעות transactionId:

  • אם הערך של transactionId תואם להמרה קיימת עבור אותה פעולת המרה, Data Manager API מתייחס לבקשה כהתאמה של המרה.
  • אם הערך של transactionId לא תואם להמרה קיימת, מערכת Google Ads יוצרת המרה חדשה. מידע נוסף מופיע במאמר בנושא אירועים שלא תואמים.

שליחת התאמה

כדי לשנות המרה קיימת, שולחים בקשת IngestEvents שכוללת את הפרטים הבאים:

  • אותו transactionId כמו באירוע המקורי.
  • אותו יעד ואותה פעולת המרה כמו באירוע המקורי.
  • הערכים המעודכנים של השדות שרוצים לשנות.
  • כל השדות שנדרשים לאירוע, כולל מזהה אחד לפחות, כמו adIdentifiers או userData. אפשר לעיין בדרישות לגבי אירועים ומזהים להמרות אופליין או להמרות ממקורות מרובים.

מומלץ לשלוח את אותם מזהים ששלחתם או שתעדתם עם האירוע המקורי. אם הערך של transactionId לא תואם להמרה קיימת, מערכת Google Ads משתמשת במזהים האלה כדי לשייך את ההמרה החדשה.

אין צורך לציין סוג התאמה. הממשק Data Manager API מסיק איך לעבד את הבקשה על סמך transactionId והשדות שאתם מספקים.

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

שדות נתמכים

בטבלה הבאה מפורט איך מערכת Google Ads מחילה כל שדה כשאירוע תואם להמרה קיימת:

שדה התנהגות
conversionValue, currency הוחלף. הערך החדש מחליף את הערך שתועד.
userData השלמה אם לא היו נתוני משתמש באירוע המקורי, אחרת התעלמות.
כל שאר השדות, כמו adIdentifiers.gclid לא עודכן. מערכת Google Ads שומרת את הערכים שתועדו עם האירוע המקורי. עדיין צריך להוסיף את שדות החובה.

ערכי המרות

שולחים conversionValue וcurrency חדשים כדי לשנות את הערך של המרה שתועדה. הערך החדש מבטל את הערך הקודם שתועד בדיווח ובבידינג, בלי להגדיל את מספר ההמרות.

נתוני משתמשים

כך Google Ads מטפל בuserData, כמו כתובת אימייל או מספר טלפון:

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

  • המערכת מתעלמת מהפרמטר אם הוא קיים: אם Google Tag או העלאה קודמת כבר תיעדו נתוני משתמשים, המערכת מתעלמת מנתוני המשתמשים החדשים. נתוני המשתמשים הקיימים לא יוחלפו ולא יצורפו.

שדות אחרים

אי אפשר לעדכן מזהים ומטא-נתונים אחרים מלבד ערך ההמרה, המטבע ונתוני המשתמש, כמו adIdentifiers.gclid, עבור אירועים תואמים. מערכת Google Ads שומרת את הערכים שתועדו עם האירוע המקורי.

עדיין צריך לכלול את כל השדות האלה שחובה למלא, כמו לפחות מזהה אחד. ה-Data Manager API מאמת אותם לכל אירוע.

אירועים לא תואמים

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

מערכת Google Ads תנסה לשייך את ההמרה החדשה לקליק על מודעה באמצעות המזהים שסיפקתם, כמו adIdentifiers.gclid או userData.