Conversion: get
Stay organized with collections
Save and categorize content based on your preferences.
Retrieves a list of conversions from a DoubleClick Search engine account.
Try it now.
Request
HTTP request
GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion
Parameters
| Parameter name |
Value |
Description |
| Path parameters |
advertiserId |
long |
Numeric ID of the advertiser.
|
agencyId |
long |
Numeric ID of the agency.
|
engineAccountId |
long |
Numeric ID of the engine account.
|
| Required query parameters |
endDate |
integer |
Last date (inclusive) on which to retrieve conversions. Format is yyyymmdd.
Acceptable values are 20091101 to 99991231, inclusive.
|
rowCount |
integer |
The number of conversions to return per call.
Acceptable values are 1 to 1000, inclusive.
|
startDate |
integer |
First date (inclusive) on which to retrieve conversions. Format is yyyymmdd.
Acceptable values are 20091101 to 99991231, inclusive.
|
startRow |
unsigned integer |
The 0-based starting index for retrieving conversions results.
|
| Optional query parameters |
adGroupId |
long |
Numeric ID of the ad group.
|
adId |
long |
Numeric ID of the ad.
|
campaignId |
long |
Numeric ID of the campaign.
|
criterionId |
long |
Numeric ID of the criterion.
|
Authorization
This request requires authorization with the following scope:
| Scope |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
For more information, see the authentication and authorization page.
Request body
Do not supply a request body with this method.
Try it!
Use the APIs Explorer below to call this method on live data and see the response.
Alternatively, try the
standalone
Explorer.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-09 UTC.
[null,null,["Last updated 2024-10-09 UTC."],[[["\u003cp\u003eRetrieves a list of conversions from a specified DoubleClick Search engine account within a given date range.\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 the agency, advertiser, engine account, date range, and result pagination.\u003c/p\u003e\n"],["\u003cp\u003eOptionally filter conversions by ad group, ad, campaign, or criterion IDs.\u003c/p\u003e\n"],["\u003cp\u003eResponse provides a Conversion resource containing details about the retrieved conversions.\u003c/p\u003e\n"]]],["This method retrieves conversions from a DoubleClick Search engine account. It requires authorization and uses a GET request with specific path and query parameters. Mandatory parameters include `agencyId`, `advertiserId`, `engineAccountId`, `endDate`, `rowCount`, `startDate`, and `startRow`. Optional parameters include `adGroupId`, `adId`, `campaignId`, and `criterionId`. The successful response contains a list of conversion resources. No request body is needed.\n"],null,["# Conversion: get\n\n| **Note:** Requires [authorization](#auth).\n\nRetrieves a list of conversions from a DoubleClick Search engine account.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|-------------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `advertiserId` | `long` | Numeric ID of the advertiser. |\n| `agencyId` | `long` | Numeric ID of the agency. |\n| `engineAccountId` | `long` | Numeric ID of the engine 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.get)."]]
