L'ancienne API Search Ads 360 Reporting est mise hors service. Vous pouvez désormais créer vos rapports à l'aide de la nouvelle API Search Ads 360 Reporting.
Notez que les méthodes get et getByCustomerId de l'API Search Ads 360 Conversion seront abandonnées au 3e trimestre 2025. Pour continuer à accéder aux données de conversion, vous devez créer un rapport à l'aide de la ressource de conversion à l'aide de la nouvelle API Search Ads 360 Reporting. Pour en savoir plus, cliquez ici.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Récupère une liste de conversions à partir d'un compte associé à un moteur DoubleClick Search à l'aide d'un nouveau numéro client Search Ads 360.
Essayer maintenant
Requête
Requête HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion
Paramètres
Nom du paramètre
Valeur
Description
Paramètres de chemin d'accès
customerId
string
Nouvelle chaîne de numéro client Search Ads 360. Il doit s'agir d'un compte client.
Paramètres de requête requis
endDate
integer
Date (incluse) de la période de récupération des conversions. au format aaaammjj.
Les valeurs autorisées vont de 20091101 à 99991231, inclus.
rowCount
integer
Nombre de conversions à renvoyer par appel.
Les valeurs autorisées vont de 1 à 1000, inclus.
startDate
integer
Date de début (incluse) de la récupération des conversions. au format aaaammjj.
Les valeurs autorisées vont de 20091101 à 99991231, inclus.
startRow
unsigned integer
Indice de départ basé sur 0 pour la récupération des résultats de conversion.
Paramètres de requête facultatifs
adGroupId
long
ID numérique du groupe d'annonces.
adId
long
ID numérique de l'annonce.
campaignId
long
ID numérique de la campagne.
criterionId
long
ID numérique du critère.
Autorisation
Cette requête nécessite une autorisation ayant le champ d'application suivant:
Ne spécifiez pas de corps de requête pour cette méthode.
Réponse
Lorsque cette méthode fonctionne, elle renvoie une ressource de conversion dans le corps de réponse.
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.
Vous pouvez également essayer la
autonome
l'explorateur de données.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/08/20 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)."]]