Conversion: getByCustomerId
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אחזור רשימה של המרות מחשבון מנוע חיפוש של DoubleClick באמצעות מספר לקוח של הממשק החדש של Search Ads 360.
רוצים לנסות עכשיו?
בקשה
בקשת HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion
פרמטרים
שם הפרמטר |
ערך |
תיאור |
פרמטרים של נתיב |
customerId |
string |
מחרוזת מזהה הלקוח של הממשק החדש של Search Ads 360. צריך להיות חשבון לקוח.
|
פרמטרים נדרשים של שאילתה |
endDate |
integer |
התאריך האחרון (כולל) שבו מאחזרים המרות. הפורמט הוא yyyymmdd.
הערכים הקבילים הם 20091101 עד 99991231 , כולל.
|
rowCount |
integer |
מספר ההמרות שיש להחזיר לכל שיחה.
הערכים הקבילים הם 1 עד 1000 , כולל.
|
startDate |
integer |
התאריך הראשון (כולל) שבו תאחזר המרות. הפורמט הוא yyyymmdd.
הערכים הקבילים הם 20091101 עד 99991231 , כולל.
|
startRow |
unsigned integer |
אינדקס התחלה מבוסס 0 לאחזור תוצאות של המרות.
|
פרמטרים אופציונליים של שאילתה |
adGroupId |
long |
המזהה המספרי של קבוצת המודעות.
|
adId |
long |
המזהה המספרי של המודעה.
|
campaignId |
long |
המזהה המספרי של הקמפיין.
|
criterionId |
long |
המזהה המספרי של הקריטריון.
|
אישור
הבקשה הזו מחייבת הרשאה עם ההיקף הבא:
היקף |
https://www.googleapis.com/auth/doubleclicksearch |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
אל תספקו גוף בקשה בשיטה הזו.
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו תחזיר משאב המרה בגוף התגובה.
נסה בעצמך!
אפשר להשתמש ב-APIs Explorer שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.
לחלופין, אפשר לנסות את
עצמאי
חוקר.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-08-20 (שעון UTC).
[null,null,["עדכון אחרון: 2024-08-20 (שעון UTC)."],[[["\u003cp\u003eRetrieves a list of conversions from a DoubleClick Search engine account using a new Search Ads 360 customer ID.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eRequest parameters include specifying date ranges, result limits, and filtering by ad group, ad, campaign, or criterion IDs.\u003c/p\u003e\n"],["\u003cp\u003eThe response, if successful, returns a Conversion resource.\u003c/p\u003e\n"],["\u003cp\u003eYou can try this method using the provided APIs Explorer or standalone Explorer.\u003c/p\u003e\n"]]],["This outlines how to retrieve conversion data from a Search Ads 360 account. A `GET` request to a specific URL is required, using the customer ID, start and end dates, number of rows, and a start row. Optional parameters allow filtering by ad group, ad, campaign, or criterion IDs. The request needs authorization using a specified scope. A successful request returns a conversion resource, with the response having no request body.\n"],null,["# Conversion: getByCustomerId\n\n| **Note:** Requires [authorization](#auth).\n\nRetrieves a list of conversions from a DoubleClick Search engine account using a new Search Ads 360 customer ID.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `customerId` | `string` | New search Ads 360 Customer ID String. Must be a client account. |\n| **Required query parameters** |||\n| `endDate` | `integer` | Last date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive. |\n| `rowCount` | `integer` | The number of conversions to return per call. Acceptable values are `1` to `1000`, inclusive. |\n| `startDate` | `integer` | First date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive. |\n| `startRow` | `unsigned integer` | The 0-based starting index for retrieving conversions results. |\n| **Optional query parameters** |||\n| `adGroupId` | `long` | Numeric ID of the ad group. |\n| `adId` | `long` | Numeric ID of the ad. |\n| `campaignId` | `long` | Numeric ID of the campaign. |\n| `criterionId` | `long` | Numeric ID of the criterion. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclicksearch` |\n\nFor more information, see the [authentication and authorization](/search-ads/v2/authorizing) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a [Conversion resource](/search-ads/v2/reference/conversion#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/doubleclicksearch.conversion.getByCustomerId)."]]