אפשר להשתמש בשיטה IngestEvents כדי לבצע התאמות להמרות ממודעות ב-Google Ads שתועדו בעבר.
ב-Data Manager API, שינוי יכול לעדכן ערך המרה או להוסיף נתוני משתמשים.
אם אתם עוברים מ-Google Ads API, כדאי לעיין במאמר שדרוג מ-Google Ads API כדי להשוות בין הטיפול בהתאמות בכל אחד מממשקי ה-API.
סוגי ההמרות הנתמכים
אפשר לשנות את סוגי ההמרות הבאים ב-Google Ads:
- המרות שמבוססות על מספר מקורות נתונים: המרות שתועדו על ידי Google Tag באתר לפעולת המרה מסוג
WEBSITE. - המרות אופליין והמרות משופרות לצורך שיוך ללידים:
אירועי אופליין שהועלו בעבר לפעולת המרה מסוג
UPLOAD_CLICKS.
איך פועלות ההתאמות
במסגרת אותה פעולת המרה, מערכת 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.