Conversion: insert
הוספת כמות גדולה של המרות חדשות ל-DoubleClick Search.
רוצים לנסות עכשיו?
בקשה
בקשת HTTP
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
אישור
הבקשה הזו מחייבת הרשאה עם ההיקף הבא:
| היקף |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, מציינים משאב המרות עם המאפיינים הבאים:
| שם הנכס |
ערך |
תיאור |
הערות |
| המאפיינים הנדרשים |
conversion[].conversionId |
string |
כשמדובר בהמרות אופליין, המפרסמים מספקים את המזהה הזה. המפרסמים יכולים לציין כל מזהה שיש לו משמעות עבורו. לכל המרה בבקשה צריך לציין מזהה ייחודי, והשילוב של המזהה וחותמת הזמן חייב להיות ייחודי בין כל ההמרות אצל המפרסם.
כשמדובר בהמרות אונליין, מערכת DS מעתיקה את dsConversionId או את floodlightOrderId לנכס הזה, בהתאם להוראות לדיווח על פעילות מ-Floodlight של המפרסם. |
|
conversion[].conversionTimestamp |
unsigned long |
השעה שבה התרחשה ההמרה, בתקופת זמן של אלפיות השנייה לפי שעון UTC. |
|
conversion[].segmentationType |
string |
סוג הפילוח של ההמרה הזו (לדוגמה, FLOODLIGHT).
הערכים הקבילים הם:
|
|
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו תחזיר משאב המרה בגוף התגובה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-08-20 (שעון UTC).
[null,null,["עדכון אחרון: 2024-08-20 (שעון UTC)."],[[["Inserts a batch of new conversions into DoubleClick Search using the provided Conversion resource and requires authorization with the `doubleclicksearch` scope."],["Each conversion requires a unique ID, timestamp, and segmentation type (e.g., FLOODLIGHT)."],["Successful requests return a Conversion resource in the response body."],["The API allows insertion of both offline and online conversions, with specific ID handling for each."],["Developers can test the method using the provided APIs Explorer or the standalone Explorer."]]],["This outlines how to insert new conversions into DoubleClick Search using a POST request to the specified endpoint. Authorization with the `https://www.googleapis.com/auth/doubleclicksearch` scope is required. The request body should include a Conversion resource containing properties like `conversionId` (unique identifier), `conversionTimestamp` (time of conversion in UTC), and `segmentationType` (e.g., `FLOODLIGHT`). Successful requests return a Conversion resource in the response body.\n"]]
