אפשר להשתמש ב-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.