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.
Lorsqu'un client effectue une action prédéfinie sur le site Web d'un annonceur (par exemple, acheter un article ou demander plus d'informations), Search Ads 360 enregistre une conversion.
Pour certains annonceurs, les conversions commencent en ligne et se terminent hors connexion. C'est, par exemple, le cas lorsqu'un internaute recherche en ligne un produit qu'il souhaite acquérir, clique sur une annonce, puis téléphone à un centre d'appel pour finaliser l'achat. Ou encore lorsqu'un internaute équipé d'un smartphone appuie sur le bouton "Appeler" d'une annonce et achète l'article qui l'intéresse par téléphone. Pour ce type de conversions, Search Ads 360 dispose automatiquement de données sur les actions réalisées en ligne. Si vous souhaitez fournir des données sur la partie hors connexion (pour améliorer les rapports, les utiliser dans des règles automatiques ou les optimiser dans une stratégie d'enchères), vous pouvez les importer dans Search Ads 360.
Dans certains cas, vous devrez peut-être modifier la valeur d'une conversion existante. Par exemple, vous pouvez modifier la valeur d'une conversion pour tenir compte des remises appliquées après un achat en ligne (comme une remise postale), des retours avec frais de remise en stock ou des avoirs appliqués après l'achat.
Toutes les demandes de conversion sont synchrones. Vous pouvez effectuer des requêtes synchrones parallèles (dans la limite de votre projet) dans un même client.
ID et conversions Search Ads 360
Étant donné que les conversions doivent être attribuées à une campagne, une annonce et un mot clé spécifiques, et éventuellement à une visite, chaque conversion spécifie l'ID Search Ads 360 d'une annonce, d'un mot clé et d'une campagne, ainsi que les ID des objets parents dans la hiérarchie Search Ads 360.
Lorsque vous obtenez, ajoutez ou mettez à jour une conversion, vous devez spécifier la plupart de ces ID dans la demande.
Obtenir des ID Search Ads 360
Pour trouver ces ID, procédez comme suit :
Utilisez l'UI Search Ads 360 pour télécharger un rapport contenant les ID de l'annonceur, des comptes de moteur, des campagnes, des groupes d'annonces, des mots clés et des annonces.
Ajoutez des macros Search Ads 360, comme CampaignID et TrackerID, à vos URL de page de destination. Lorsqu'un client clique sur une annonce, chaque macro indique à Search Ads 360 de transmettre son ID à la page de destination de l'annonceur en tant que paramètre d'URL.
Vous pouvez récupérer ces ID dans les journaux Web de l'annonceur et les utiliser dans vos requêtes Conversion.
Search Ads 360 propose plusieurs macros pour envoyer des ID de mots clés à une page de destination. Pour attribuer des conversions à un mot clé, vous devez ajouter la macro TrackerID aux URL des pages de destination.
ID de clic
Un ID de clic permet de suivre un clic sur une annonce. Vous pouvez l'utiliser pour attribuer une conversion à une visite spécifique au lieu de fournir toute la hiérarchie des ID pour les objets Search Ads 360. Search Ads 360 utilisera l'ID de clic pour trouver et attribuer le mot clé et l'annonce appropriés.
Les ID de clic sont sensibles à la casse. Assurez-vous donc que vos journaux Web et votre logiciel de suivi ne modifient pas la casse de l'ID de clic.
Générer un ID de clic
L'ID de clic est généré par Search Ads 360 ou Google Ads.
Si le taggage automatique est activé dans un compte Google Ads, Google Ads génère un ID de clic lorsqu'une annonce est diffusée. Par conséquent, si un utilisateur clique plusieurs fois sur une impression d'annonce particulière, ces clics seront associés à un seul ID de clic. Les visites de page de destination pour la même impression partagent le même ID de clic.
Search Ads 360 peut générer un ID de clic si vous
activez le service d'API de conversion. Si un clic est redirigé depuis Google Ads et que Google Ads a déjà généré un ID de clic, Search Ads 360 utilise l'ID Google Ads au lieu d'en générer un nouveau. Si un clic est redirigé depuis un autre type de moteur compatible, Search Ads 360 génère l'ID.
Paramètres d'ID de clic
Chaque ID de clic se compose de deux paramètres. Exemple :
gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds
Le paramètre gclid contient un ID de clic sensible à la casse. Search Ads 360
conserve les informations d'attribution (comme le mot clé, l'annonce, la campagne ou le groupe d'annonces) pour
chaque ID de clic généré.
Le paramètre gclsrc indique la source de l'ID de clic. Actuellement, il peut avoir l'une des valeurs suivantes :
gclsrc=ds : ID du clic généré par Search Ads 360. De plus, le clic a été effectué sur un moteur autre que Google ou sur Google, mais le compte Google Ads n'utilise pas le taggage automatique.
gclsrc=aw.ds : l'ID de clic a été généré par Google Ads, qui utilise le marquage automatique, et le clic a été redirigé vers le serveur de clics Search Ads 360.
gclsrc= : le paramètre est vide si l'ID de clic a été généré par Google Ads, mais que le service de l'API de conversion n'était pas activé dans Search Ads 360 au moment du clic.
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 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eSearch Ads 360 reports a conversion when a customer completes a pre-defined action on an advertiser's website, such as purchasing an item or requesting information.\u003c/p\u003e\n"],["\u003cp\u003eYou can upload offline conversion data to Search Ads 360 to enhance reports, use in automated rules, or for bid strategy optimization.\u003c/p\u003e\n"],["\u003cp\u003eConversion values can be modified to account for factors like discounts, returns, or credits applied after a purchase.\u003c/p\u003e\n"],["\u003cp\u003eThe Search Ads 360 API allows you to get, insert, and update conversions, but it cannot be used to send personally identifiable information or for advertising targeting.\u003c/p\u003e\n"],["\u003cp\u003eTo attribute conversions, each conversion needs to specify the Search Ads 360 ID of an ad, keyword, and campaign, or utilize a click ID to track the click and attribute accordingly.\u003c/p\u003e\n"]]],["Search Ads 360 reports a conversion when a customer completes a specified action. Advertisers can upload offline conversion data to enhance reports and optimize bid strategies. The Search Ads 360 API allows getting, adding, and updating conversions. Conversions require Search Ads 360 IDs of relevant entities or a click ID to attribute to specific ads. Click IDs, generated by either Search Ads 360 or Google Ads, track ad clicks. Advertisers should maintain the click ID case from the landing page.\n"],null,["# Upload Data About Conversions\n\nWhen a customer completes a pre-defined action on an advertiser's website, such as\npurchasing an item or requesting more information, Search Ads 360 reports a **conversion**.\n\nConversions for some advertisers start online and finish offline. For example, a\nconsumer initiates research online for a purchase, clicks on an ad, and then telephones a\ncall center to complete the purchase. Or a consumer with a smartphone taps a \"call now\"\nbutton in an ad and purchases an item over the telephone. For these conversions,\nSearch Ads 360 will automatically have data about the online portion. If you want to\nprovide data about the offline portion---to enhance reports, for use in automated\nrules, or for optimization in a bid strategy---you can upload it to Search Ads 360.\n\nIn some cases, you might need to modify the value of an existing conversion. For\nexample, you might edit a conversion value to account for discounts that were applied\nafter an online purchase was made (such as a mail-in-rebate), returns that occurred with\na restocking fee, or credits that were applied after the purchase.\n\n\nAfter you've set up your client app as described in [My First App](/search-ads/v2/first-app) (including [activating the\nconversion service](/search-ads/v2/prereqs#activate-conversion-service)), you can send the following conversion-related requests to the\nSearch Ads 360 API:\n\n\n[Insert](/search-ads/v2/how-tos/conversions/insert)\n\n:\n Adds new conversions.\n\n\n[Update](/search-ads/v2/how-tos/conversions/update)\n\n: Modifies existing conversions.\n\n| **Advertisers are prohibited** from using the Search Ads 360 API to send personally identifiable information, as outlined by the [Terms of Service](/search-ads/terms) for the API. Further, this API provides no ability to target advertising. The conversion data is used by advertisers to better manage and report on the amount they pay for advertising and the ROI they get from it.\n\n### Synchronous Requests\n\nAll conversion requests are synchronous. You can make parallel synchronous requests (up to your project's limit) in a single client.\n\nSearch Ads 360 IDs and Conversions\n----------------------------------\n\n\nBecause conversions need to be attributed to a specific campaign, ad, keyword, and\noptionally to a visit, each conversion specifies the Search Ads 360 ID of an ad,\nkeyword, and campaign, along with the IDs of the parent objects in the [Search Ads 360 hierarchy](https://support.google.com/searchads/answer/2491240).\nWhen you get, add, or update a conversion, you'll need to specify most of these IDs in\nthe request.\n\n### Obtaining Search Ads 360 IDs\n\nTo find these IDs, do any of the following:\n\n-\n Use the Search Ads 360 UI to [download\n a report](https://support.google.com/searchads/answer/1184146) that contains IDs for the advertiser, engine accounts, campaigns, ad\n groups, keywords, and ads.\n\n-\n [Add\n Search Ads 360 macros](https://support.google.com/searchads/answer/1649566#macros) such as `CampaignID` and `TrackerID`\n to your landing page URLs. When a customer clicks an ad, each macro will instruct\n Search Ads 360 to pass its ID to the advertiser's landing page as URL parameter.\n You can retrieve these IDs from the advertiser's web logs and use them in your `Conversion`\n requests.\n\n\n Search Ads 360 provides a few different macros for sending keyword IDs to a landing\n page. To attribute conversions to a keyword, you'll need to add the **TrackerID**\n macro to the landing page URLs.\n\n### Click IDs\n\nA **click ID** tracks a click on an ad, and you can use it to attribute a\nconversion to a specific visit instead of providing the entire hierarchy of IDs for\nSearch Ads 360 objects. Search Ads 360 will use the click ID to find and attribute the\nappropriate keyword and ad.\n\nClick IDs are case-sensitive, so **make sure your web logs and tracking software\ndo not change the case of the click ID**.\n\n#### Generating a Click ID\n\nEither Search Ads 360 or Google Ads generates the click ID.\n\nIf [auto-tagging](https://support.google.com/google-ads/answer/3095550) is enabled\nin an Google Ads account, Google Ads generates a click ID when an ad is shown. As a result, if a\nuser clicks on a particular ad impression multiple times, those clicks will be associated\nwith only one click ID. Landing page visits for the exact same impression will share the\nsame click ID.\n\nSearch Ads 360 can generate a click ID if you [activate the conversion API service](https://support.google.com/searchads/answer/2604604#activate). If a click is redirected from Google Ads and Google Ads has\nalready generated a click ID, Search Ads 360 uses the Google Ads ID instead of generating a new one. If a\nclick is redirected from another type of supported engine, Search Ads 360 generates the ID.\n\n#### Click ID Parameters\n\nEach click ID consists of two parameters. For example: \n\n```\ngclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds\n```\n\n\nThe `gclid` parameter contains a case-sensitive ID for the click. Search Ads 360\nmaintains the attribution information (such as keyword, ad, campaign, ad group) for\neach click ID generated.\n\n\nThe `gclsrc` parameter indicates the source of the click ID. Currently, it\ncan have one of the following values:\n\n-\n `gclsrc=ds`: the click ID was generated by Search Ads 360. In addition, the\n click was either on an engine other than Google, or the click was on Google but the\n Google Ads account is not using auto-tagging.\n\n-\n `gclsrc=aw.ds`: the click ID was generated by Google Ads that is using\n auto-tagging, and the click went through the Search Ads 360 clickserver.\n\n-\n `gclsrc=`: the parameter is empty if the click ID was generated by Google Ads,\n but the conversion API service was not enabled in Search Ads 360 when the click occurred.\n\n| **Tip**: We recommend you use the landing page of the website to keep track of the customer's offline contact information (such as phone number called) together with the click ID. When an offline conversion happens, the click ID can then be used to report the conversion back to Search Ads 360."]]
