Search Ads 360 Reporting API versi sebelumnya tidak digunakan lagi. Sekarang Anda dapat membuat laporan menggunakan Search Ads 360 Reporting API baru.
Perhatikan bahwa metode get dan getByCustomerId di Search Ads 360 Conversion API tidak digunakan lagi pada Kuartal 3 2025. Untuk terus mengakses data konversi, Anda harus membuat laporan menggunakan resource konversi menggunakan Search Ads 360 Reporting API versi baru. Lihat detail selengkapnya di sini.
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Saat pelanggan menyelesaikan tindakan yang telah ditentukan sebelumnya di situs pengiklan, seperti
membeli item atau meminta informasi lebih lanjut, Search Ads 360 akan melaporkan konversi.
Konversi untuk sebagian pengiklan dimulai secara online dan diselesaikan secara offline. Misalnya, konsumen memulai riset online untuk melakukan pembelian, mengklik iklan, lalu menelepon pusat panggilan untuk menyelesaikan pembelian tersebut. Atau konsumen dengan smartphone yang mengetuk tombol “hubungi sekarang”
dalam iklan dan membeli item melalui telepon. Untuk konversi ini,
Search Ads 360 akan otomatis memiliki data tentang bagian online. Jika Anda ingin
memberikan data tentang bagian offline—untuk meningkatkan kualitas laporan, untuk digunakan dalam aturan otomatis, atau untuk pengoptimalan dalam strategi bidding—Anda dapat menguploadnya ke Search Ads 360.
Dalam beberapa kasus, Anda mungkin perlu mengubah nilai konversi yang ada. Misalnya, Anda dapat mengedit nilai konversi untuk memperhitungkan diskon yang diterapkan setelah pembelian online dilakukan (seperti rabat melalui surat), pengembalian yang terjadi dengan biaya penyetokan ulang, atau kredit yang diterapkan setelah pembelian.
Setelah menyiapkan aplikasi klien seperti yang dijelaskan dalam Aplikasi Pertama Saya (termasuk mengaktifkan
layanan konversi), Anda dapat mengirim permintaan terkait konversi berikut ke
Search Ads 360 API:
Semua permintaan konversi bersifat sinkron. Anda dapat membuat permintaan sinkron paralel (hingga batas project Anda) dalam satu klien.
ID dan Konversi Search Ads 360
Karena konversi harus diatribusikan ke kampanye, iklan, kata kunci tertentu, dan secara opsional ke kunjungan, setiap konversi menentukan ID Search Ads 360 dari iklan, kata kunci, dan kampanye, beserta ID objek induk dalam hierarki Search Ads 360.
Saat mendapatkan, menambahkan, atau memperbarui konversi, Anda harus menentukan sebagian besar ID ini dalam
permintaan.
Mendapatkan ID Search Ads 360
Untuk menemukan ID ini, lakukan salah satu hal berikut:
Gunakan UI Search Ads 360 untuk mendownload
laporan yang berisi ID untuk pengiklan, akun mesin telusur, kampanye, grup
iklan, kata kunci, dan iklan.
Tambahkan
makro Search Ads 360 seperti CampaignID dan TrackerID
ke URL halaman landing Anda. Saat pelanggan mengklik iklan, setiap makro akan menginstruksikan
Search Ads 360 untuk meneruskan ID-nya ke halaman landing pengiklan sebagai parameter URL.
Anda dapat mengambil ID ini dari log web pengiklan dan menggunakannya dalam permintaan Conversion
Anda.
Search Ads 360 menyediakan beberapa makro berbeda untuk mengirimkan ID kata kunci ke halaman
landing. Untuk mengatribusikan konversi ke kata kunci, Anda harus menambahkan makro TrackerID
ke URL halaman landing.
ID klik
ID klik melacak klik pada iklan, dan Anda dapat menggunakannya untuk mengatribusikan konversi ke kunjungan tertentu, bukan memberikan seluruh hierarki ID untuk objek Search Ads 360. Search Ads 360 akan menggunakan ID klik untuk menemukan dan mengatribusikan kata kunci dan iklan yang sesuai.
ID klik peka huruf besar/kecil, jadi pastikan log web dan software pelacakan Anda
tidak mengubah huruf besar/kecil ID klik.
Membuat ID Klik
Search Ads 360 atau Google Ads akan membuat ID klik.
Jika pemberian tag otomatis diaktifkan
di akun Google Ads, Google Ads akan membuat ID klik saat iklan ditampilkan. Akibatnya, jika pengguna mengklik tayangan iklan tertentu beberapa kali, klik tersebut akan dikaitkan dengan hanya satu ID klik. Kunjungan halaman landing untuk tayangan iklan yang sama persis akan memiliki
ID klik yang sama.
Search Ads 360 dapat membuat ID klik jika Anda
mengaktifkan layanan API konversi. Jika klik dialihkan dari Google Ads dan Google Ads telah membuat ID klik, Search Ads 360 akan menggunakan ID Google Ads, bukan membuat ID baru. Jika
klik dialihkan dari jenis mesin telusur lain yang didukung, Search Ads 360 akan membuat ID.
Parameter ID Klik
Setiap ID klik terdiri dari dua parameter. Contoh:
gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds
Parameter gclid berisi ID yang peka huruf besar/kecil untuk klik. Search Ads 360
mempertahankan informasi atribusi (seperti kata kunci, iklan, kampanye, grup iklan) untuk
setiap ID klik yang dihasilkan.
Parameter gclsrc menunjukkan sumber ID klik. Saat ini, kolom ini dapat memiliki salah satu nilai berikut:
gclsrc=ds: ID klik dibuat oleh Search Ads 360. Selain itu, klik tersebut dilakukan di mesin telusur selain Google, atau klik tersebut dilakukan di Google, tetapi akun Google Ads tidak menggunakan pemberian tag otomatis.
gclsrc=aw.ds: ID klik dibuat oleh Google Ads yang menggunakan
pemberian tag otomatis, dan klik melewati server klik Search Ads 360.
gclsrc=: parameter kosong jika ID klik dibuat oleh Google Ads,
tetapi layanan API konversi tidak diaktifkan di Search Ads 360 saat klik terjadi.
[null,null,["Terakhir diperbarui pada 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."]]
