אתם יכולים להשתמש ב-Data Manager API כדי לשלוח נתוני אירועים בשביל המרות אופליין או המרות משופרות לצורך שיוך ללידים ב-Google Ads.
אם אתם משדרגים מ-Google Ads API, קראו את המאמר שדרוג מ-Google Ads API.
סקירה כללית של תהליך העבודה
כדי לשלוח נתוני אירועים באמצעות Data Manager API:
הכנת היעדים: מגדירים את האובייקטים של
Destinationבשדהdestinationsשל בקשת ההטמעה כדי לציין את חשבון היעד ואת יעד ההמרה או האירוע. פרטים נוספים זמינים במאמר הכנת יעדים.הכנת נתוני אירועים ומזהים: מאכלסים את השדות של
Eventבפרטי אירועים ובמזהים הנדרשים (כמו מזהים של קליקים על מודעות, לקוחות או מופעי אפליקציות). אם אתם כוללים פרטים ליצירת קשר עם המשתמשים ב-userData, אתם צריכים לנרמל את המזהים ולגבב אותם באמצעות SHA-256 בהתאם להנחיות הפורמט, ואתם יכולים גם להצפין אותם. פרטים נוספים זמינים במאמר הכנת נתוני אירועים.יוצרים ושולחים את בקשת ההטמעה: שולחים בקשת
events.ingestשמכילה את ה-destinations, רשומותEventו-encryptionInfoאם הצפנתם אתuserData. כדאי להשתמש ב-validateOnly: trueכדי לבדוק את המטען הייעודי (payload) שלכם לאיתור שגיאות מסוג fast-fail לפני שאתם שולחים נתוני ייצור. בקטע שליחת אירועים מפורטות דרישות השדות ודוגמאות קוד.בדיקת סטטוס הבקשה והאבחון, ושינוי ההמרות: בודקים את סטטוס העיבוד האסינכרוני ומעיינים באבחון באמצעות
requestStatus.retrieve, ומשנים או מבטלים המרות שתועדו בעבר לפי הצורך.