Die vorherige Search Ads 360 Reporting API wird eingestellt. Sie können Ihre Berichte jetzt mit der neuen Search Ads 360 Reporting API erstellen.
Die Methoden get und getByCustomerId in der Search Ads 360 Conversion API werden im 3. Quartal 2025 eingestellt. Wenn Sie weiterhin auf Conversion-Daten zugreifen möchten, müssen Sie mit der neuen Search Ads 360 Reporting API einen Bericht mit der Conversion-Ressource erstellen. Weitere Informationen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Wenn ein Kunde eine vordefinierte Aktion auf der Website eines Werbetreibenden ausführt, z. B. einen Artikel kauft oder weitere Informationen anfordert, wird in Search Ads 360 eine Conversion erfasst.
Manche Conversions beginnen online und werden offline abgeschlossen. Beispiel: Ein Nutzer startet eine Suche nach einem Produkt online, klickt auf eine Anzeige und telefoniert dann mit einem Callcenter, um den Kauf abzuschließen. Oder ein Nutzer mit einem Smartphone tippt in einer Anzeige auf die Schaltfläche „Jetzt anrufen“ und kauft einen Artikel über das Telefon. Für diese Conversions werden in Search Ads 360 automatisch Daten zum Onlineteil erfasst. Wenn Sie Daten zum Offlineteil bereitstellen möchten, um Berichte zu verbessern, für automatisierte Regeln zu verwenden oder eine Gebotsstrategie zu optimieren, können Sie sie in Search Ads 360 hochladen.
In einigen Fällen müssen Sie möglicherweise den Wert einer vorhandenen Conversion ändern. Sie können beispielsweise einen Conversion-Wert bearbeiten, um Rabatte zu berücksichtigen, die nach einem Onlinekauf angewendet wurden (z. B. ein Rabatt per Post), Rückgaben mit einer Rücknahmegebühr oder Gutschriften, die nach dem Kauf angewendet wurden.
Nachdem Sie Ihre Client-App wie in My First App beschrieben eingerichtet haben (einschließlich der Aktivierung des Conversion-Dienstes), können Sie die folgenden Conversion-bezogenen Anfragen an die Search Ads 360 API senden:
Alle Konvertierungsanfragen sind synchron. Sie können in einem einzelnen Client parallele synchrone Anfragen (bis zum Limit Ihres Projekts) stellen.
Search Ads 360-IDs und ‑Conversions
Da Conversions einer bestimmten Kampagne, Anzeige, einem bestimmten Keyword und optional einem Besuch zugeordnet werden müssen, wird für jede Conversion die Search Ads 360-ID einer Anzeige, eines Keywords und einer Kampagne sowie die IDs der übergeordneten Objekte in der Search Ads 360-Hierarchie angegeben.
Wenn Sie eine Conversion abrufen, hinzufügen oder aktualisieren, müssen Sie die meisten dieser IDs in der Anfrage angeben.
Search Ads 360-IDs abrufen
So finden Sie diese IDs:
Laden Sie über die Search Ads 360-Benutzeroberfläche einen Bericht herunter, der IDs für den Werbetreibenden, Engine-Konten, Kampagnen, Anzeigengruppen, Keywords und Anzeigen enthält.
Fügen Sie Search Ads 360-Makros wie CampaignID und TrackerID
zu Ihren Landingpage-URLs hinzu. Wenn ein Kunde auf eine Anzeige klickt, wird durch jedes Makro
die ID an die Landingpage des Werbetreibenden als URL-Parameter übergeben.
Sie können diese IDs aus den Webprotokollen des Werbetreibenden abrufen und in Ihren Conversion-Anfragen verwenden.
Search Ads 360 bietet verschiedene Makros zum Senden von Keyword-IDs an eine Landingpage. Wenn Sie Conversions einem Keyword zuordnen möchten, müssen Sie das Makro TrackerID in die Landingpage-URLs einfügen.
Klick-IDs
Mit einer Klick-ID wird ein Klick auf eine Anzeige erfasst. Sie können damit eine Conversion einem bestimmten Besuch zuordnen, anstatt die gesamte Hierarchie der IDs für Search Ads 360-Objekte anzugeben. Anhand der Klick-ID werden in Search Ads 360 das entsprechende Keyword und die entsprechende Anzeige ermittelt und zugeordnet.
Bei Klick-IDs wird zwischen Groß- und Kleinschreibung unterschieden. Achten Sie daher darauf, dass Ihre Webprotokolle und Ihre Tracking-Software keine Änderungen an der Groß- und Kleinschreibung der Klick-ID vornehmen.
Klick-ID generieren
Die Klick-ID wird entweder von Search Ads 360 oder von Google Ads generiert.
Wenn automatisches Tagging in einem Google Ads-Konto aktiviert ist, wird in Google Ads eine Klick-ID generiert, wenn eine Anzeige ausgeliefert wird. Wenn ein Nutzer mehrmals auf eine bestimmte Anzeigenimpression klickt, werden diese Klicks deshalb nur einer Klick-ID zugeordnet. Landingpage-Besuche für dieselbe Impression haben dieselbe Klick-ID.
In Search Ads 360 kann eine Klick-ID generiert werden, wenn Sie
den Conversion-API-Dienst aktivieren. Wenn ein Klick von Google Ads weitergeleitet wird und in Google Ads bereits eine Klick-ID generiert wurde, verwendet Search Ads 360 die Google Ads-ID, anstatt eine neue zu generieren. Wenn ein Klick von einer anderen unterstützten Engine weitergeleitet wird, generiert Search Ads 360 die ID.
Parameter für Klick-IDs
Jede Klick-ID besteht aus zwei Parametern. Beispiel:
gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds
Der Parameter gclid enthält eine ID für den Klick, bei der die Groß-/Kleinschreibung beachtet wird. In Search Ads 360 werden die Attributionsinformationen (z. B. Keyword, Anzeige, Kampagne, Anzeigengruppe) für jede generierte Klick-ID gespeichert.
Der Parameter gclsrc gibt die Quelle der Klick-ID an. Derzeit kann er einen der folgenden Werte haben:
gclsrc=ds: Die Klick-ID wurde von Search Ads 360 generiert. Außerdem erfolgte der Klick entweder auf einer anderen Suchmaschine als Google oder auf Google, aber im Google Ads-Konto wird kein automatisches Tagging verwendet.
gclsrc=aw.ds: Die Klick-ID wurde von Google Ads generiert, wo die automatische Tag-Kennzeichnung verwendet wird, und der Klick wurde über den Search Ads 360-Klickserver weitergeleitet.
gclsrc=: Der Parameter ist leer, wenn die Klick-ID von Google Ads generiert wurde, der Conversion API-Dienst in Search Ads 360 jedoch nicht aktiviert war, als der Klick erfolgte.
[null,null,["Zuletzt aktualisiert: 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."]]
