אתם יכולים להשתמש ב-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, ולשנות או לבטל המרות שתועדו בעבר לפי הצורך.