אפשר להתקשר אל Conversion.get()
כדי להחזיר רשימה של אובייקטי המרה שעובדו ב-Search Ads 360. ניתן
לבקש את כל ההמרות בחשבון מנוע החיפוש של המפרסם, או לצמצם את היקף
הקמפיין, קבוצת המודעות, המודעה או מילת המפתח הספציפיים.
המזהים של Search Ads 360 שציינת בבקשה קובעים את היקף התגובה. למשל:
- כדי להציג את כל ההמרות בחשבון מנוע חיפוש, מציינים מזהים אלה:
agencyId
advertiserId
engineAccountId
- כדי לראות את ההמרות בקמפיין ספציפי, מציינים את המזהים הבאים:
agencyId
advertiserId
engineAccountId
campaignId
- כדי להציג את ההמרות המשויכות למודעה ומילת מפתח ספציפיות, מציינים את המזהים הבאים:
agencyId
advertiserId
engineAccountId
campaignId
adGroupId
(אם מילת המפתח קיימת ברמת קבוצת המודעות)adId
criterionId
מידע על קבלת מזהי Search Ads 360 עבור המפרסם זמין במאמר מזהים והמרות ב-Search Ads 360.
אחרי שליחת הבקשה, מערכת Search Ads 360 מאמתת את הבקשה, יוצרת את רשימת האובייקטים ומחזירה את הרשימה כמשאב ConversionList
בגוף התגובה.
דוגמה לבקשת בקשה
הדוגמה הבאה מבקשת רשימת המרות שהתרחשו בין 15 בנובמבר ל-31 בדצמבר 2012 בקמפיין ספציפי.
JSON
כשיוצרים כתובת URL כדי לאחזר רשימה של המרות, צריך להזין את שלושת הפרמטרים הראשונים – AgencyId, advertiserId ו-engineId, כחלק מהנתיב למשאב ההמרות. הגדרת הפרמטרים הנותרים כפרמטרים של שאילתה של כתובת אתר.
GET https://www.googleapis.com/doubleclicksearch/v2/agency/12300000000000456/advertiser/45600000000010291/engine/700000000042441/conversion?campaign=71700000001899732&startDate=20121115&endDate=20121231&startRow=0&rowCount=10
Java
/** * Instantiate the Doubleclicksearch service, request a list of conversions in a specific campaign, * and print the list to standard out. */ public static void main(String[] args) throws Exception { Doubleclicksearch service = getService(); // See Set Up Your Application. ConversionList conversionList = listConversions(service); outputList(conversionList); } /** * Request a list of the first 10 conversions in a specific campaign. */ private static ConversionList listConversions(Doubleclicksearch service) throws IOException { try { Get getRequest = service.conversion().get( new Long(12300000000000456L), // Replace with your agency ID new Long(45600000000010291L), // Replace with your advertiser ID new Long(700000000042441L), // Replace with your engine account ID new Integer(20121231), // End date new Integer(10), // Number of rows new Integer(20121115), // Start date new Long(0L)); // Starting row getRequest.setCampaignId(71700000002044839L); // Optional parameter return getRequest.execute(); } catch (GoogleJsonResponseException e) { System.err.println("Get request was rejected."); for (ErrorInfo error : e.getDetails().getErrors()) { System.err.println(error.getMessage()); } System.exit(e.getStatusCode()); return null; // Unreachable code. } } /** * Print to standard out. */ privte static void outputList(ConversionList conversionList) { for (Conversion conversion : conversionList.getConversion()) { if (null != conversion) { System.out.println(conversion.toString()); } } }
Python
def get_conversion(service): """Request the first 10 conversions in a specific campaign and print the list. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().get( agencyId='12300000000000456', // Replace with your ID advertiserId='45600000000010291', // Replace with your ID engineAccountId='700000000042441', // Replace with your ID campaignId='71700000002044839', // Replace with your ID startDate=20131115, endDate=20131231, startRow=0, rowCount=10 ) pprint.pprint(request.execute())
דוגמה לקבלת תגובה
אם אימות הבקשה יצליח, מערכת Search Ads 360 תחזיר משאב ConversionList
בגוף התגובה.
{ "kind": "doubleclicksearch#conversionList", "conversion": [ { "agencyId": "12300000000000456", "advertiserId": "45600000000010291", "engineAccountId": "700000000042441", "campaignId": "71700000002044839", "adGroupId": "58700000032026064", "criterionId": "43700003491981017", "adId": "0", "dsConversionId": "48752623802180029", "conversionId": "ag5zfmV2ZW50YXBpZGVtb3ITCxILVHJhbnNhY3Rpb24YgfQDDA", "state": "ACTIVE", "type": "TRANSACTION", "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue "currencyCode": "USD", "quantityMillis": "0", "segmentationType": "FLOODLIGHT", "segmentationId": "25700000001081555", "segmentationName": "Customer Call", "conversionTimestamp": "1355776573000", "conversionModifiedTimestamp": "1355776580813" }, { "agencyId": "12300000000000456", "advertiserId": "45600000000010291", "engineAccountId": "700000000042441", "campaignId": "71700000002044839", "adGroupId": "58700000032026064", "criterionId": "43700003491981017", "adId": "44700000155906860", "dsConversionId": "48752623802180029", "conversionId": "ag5zfmV2ZW50YXBpZGVtb3ITCxILVHJhbnNhY3Rpb24YgfQDDA", "state": "ACTIVE", "type": "TRANSACTION", "revenueMicros": "20000000", "currencyCode": "USD", "quantityMillis": "0", "segmentationType": "FLOODLIGHT", "segmentationId": "25700000001081555", "segmentationName": "Customer Call", "conversionTimestamp": "1355776573000", "conversionModifiedTimestamp": "1355776580813" }, ... ] }
אם האימות נכשל
אם הדוח לא עובר את האימות, מערכת Search Ads 360 תחזיר את השגיאה "לא נמצא". לדוגמה, אם בבקשת הדוגמה שלמעלה לא צוינה סוכנות אמיתית:
Not Found