Önceki Search Ads 360 Reporting API kullanımdan kaldırıldı. Artık yeni Search Ads 360 Reporting API'yi kullanarak raporlarınızı oluşturabilirsiniz.
Search Ads 360 Conversion API'deki get ve getByCustomerId yöntemlerinin desteğinin 2025'in 3. çeyreğinde sonlandırılacağını unutmayın. Dönüşüm verilerine erişmeye devam etmek için yeni Search Ads 360 Reporting API'yi kullanarak dönüşüm kaynağını kullanarak bir rapor oluşturmanız gerekir. Daha fazla ayrıntıyı burada bulabilirsiniz.
Diğer Search Ads 360 Conversion API işlevleri desteklenmeye devam edecektir.
Rapor İste
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Yeni Search Ads 360 Reporting API kullanıma sunuldu. Yeni API, özel raporlar oluşturmak ve raporlama uygulamalarınız ile süreçlerinize verileri entegre etmek için daha fazla esneklik sağlar.
Yeni Search Ads 360 Reporting API'ye geçme ve bu API'yi kullanma hakkında daha fazla bilgi edinin.
İstemci uygulamanızı İlk Uygulamam'da açıklandığı şekilde oluşturduktan sonra, rapor isteğinde bulunmak ve indirmek için Search Ads 360 API'yi kullanabilirsiniz. Aşağıdaki istek türlerinden birini gönderebilirsiniz:
- Eşzamanlı
Yalnızca tek bir istek gerektirir ve raporu JSON biçimli bir yanıtta döndürür. Eşzamanlı istekler:
Büyük reklamveren veya arama motoru hesabı raporları istiyorsanız eşzamansız yaklaşımı öneririz.
- Asenkron
Raporda bulunmasını istediğiniz verileri belirten bir ilk istek göndermenizi
gerektirir. Ardından, Search Ads 360'ta anket yapmak için ek istekler gönderirsiniz. Search Ads 360 raporu oluşturmayı bitirdiğinde, raporu bir veya daha fazla dosya olarak indirme istekleri gönderirsiniz. Eşzamansız istekler:
- Herhangi bir rapor türünü döndürebilir
- Çok büyük raporları birden çok dosyaya ayırır
- Raporları CSV veya TSV olarak biçimlendirir.
Veri modeli: satırlar ve sütunlar
Search Ads 360 bir rapordaki verileri satırlar ve sütunlar halinde düzenler.
İstediğiniz rapor türü, döndürülen satırları belirler.
Örneğin, bir anahtar kelime raporu isteğinde bulunuyorsanız her satırda tek bir anahtar kelimeyle ilgili veriler
yer alır. Tüm rapor türlerinin listesi için Rapor Türleri referansına bakın.
Raporda bulunmasını istediğiniz sütunları, rapor isteğinizdeki her bir sütunu adlandırarak belirtirsiniz. Her bir rapor türü için döndürülebilecek sütunların listesini Rapor Türleri referansına bakın.
Sütun davranışları
Bir sütunun davranışı, sütunun içerdiği veri türüne bağlıdır (Rapor Türleri referansı her sütunun davranışını görüntüler):
Özellik sütunları. Özellik sütunları, kampanya adı veya anahtar kelime teklifi gibi kampanyalardaki bir varlığı yapılandıran ya da tanımlayan verileri içerir. Search Ads 360 API, bir istekte belirtilen tarih veya tarih aralığından bağımsız olarak her zaman bir özellik sütununun geçerli değerini döndürür. Örneğin, bir anahtar kelimenin teklifini dün 2,00 değerinden 1,50 değerine değiştirdiyseniz ve ardından geçen ayın verileri için bir rapor isteğinde bulunursanız rapor, anahtar kelime teklifi için 1,50 değerini döndürür.
Metrik sütunları. Metrik sütunu, kampanyanızın performansıyla ilgili veriler (ör. bir reklamın aldığı tıklama sayısı, bir Floodlight etiketi tarafından kaydedildiği şekliyle ziyaret sayısı veya gelir) içerir. Tek bir güne ait bir zaman aralığı belirtmediğiniz sürece API, metrik sütunları için toplam değer döndürür. Örneğin, bir önceki ayın verileri için rapor isterseniz API, geçen ayın toplam tıklama sayısını döndürür.
Segment sütunları. Segment sütunu, verileri ayrı satırlara böler.
Örneğin date, birçok rapor türü için belirtebileceğiniz bir segment sütunudur. Bir anahtar kelime raporunda date sütununu 01.01.2013 ile 07.01.2013 arasında bir tarih aralığıyla belirtirseniz API, her anahtar kelime için her biri bir güne karşılık gelen ve o güne ait metrikleri gösteren yedi satır döndürür. Segmentlere Ayrılmış Raporlar
bölümünü inceleyin.
Para birimleri
Rapor isteğinizde parasal verilerin para birimini (dailyBudget gibi özellikler ve cost gibi metrikler) belirtmelisiniz. Aşağıdakilerden birini belirtebilirsiniz:
Para birimi belirtmek için Reports.request.statisticsCurrency istek özelliğini kullanın.
Para birimi, Reports.statisticsCurrencyCode özelliğinde gösterilir.
Saat dilimi
Search Ads 360 metrikleri, saat dilimi olmayan tarihlerde depolanır. Bu tarihler, motor metrikleri (tıklamalar, gösterimler ve ziyaretler gibi) için arama motoru hesabı saat dilimine ve dönüşüm metrikleri (eylemler, işlemler ve gelir gibi) için Campaign Manager ağı saat dilimine karşılık gelir. Bir rapordaki her metrik aynı saat diliminden geldiğinde, istekte söz konusu saat dilimi döndürülür. Aksi takdirde saat dilimi döndürülmez.
İstekleriniz, Reports.request.verifySingleTimeZone: true özelliğini birden fazla saat dilimine ait metrik sunan raporları başarısız olacak şekilde ayarlayabilir.
Bir raporda bulunan tüm metrikler tek bir saat dilimindeyse bu saat dilimi, Reports.statisticsTimeZoneReports politikasında döndürülür.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-29 UTC."],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers enhanced flexibility for building custom reports and integrating data into your workflows.\u003c/p\u003e\n"],["\u003cp\u003eYou can make synchronous requests for quick advertiser and engine account reports, or asynchronous requests for larger reports and various report types.\u003c/p\u003e\n"],["\u003cp\u003eReports are organized into rows based on the report type and columns that you specify in your request, with attribute, metric, and segment columns behaving differently.\u003c/p\u003e\n"],["\u003cp\u003eWhen requesting reports, you need to specify the currency for monetary data, and Search Ads 360 handles time zones based on engine and conversion metric sources.\u003c/p\u003e\n"]]],["The Search Ads 360 Reporting API allows custom report building and data integration. Reports can be requested synchronously (limited to advertiser/engine account reports, JSON format, blocking) or asynchronously (all report types, CSV/TSV format, multiple files). Data is organized in rows and columns; column behavior varies by type (attribute, metric, segment). Currency for monetary data must be specified and can be the agency's, advertiser's, or engine account's or USD. Time zones are relevant to metric dates.\n"],null,["# Request Reports\n\nThe new Search Ads 360 Reporting API is now available. The new API provides enhanced flexibility to build custom reports and integrate the data into your reporting applications and processes. Learn more about migrating to and using the [new Search Ads 360 Reporting\nAPI](https://developers.google.com/search-ads/reporting/overview).\n\n\nAfter you've set up your client app as described in [My First App](/search-ads/v2/first-app), you can use the Search Ads 360 API\nto request and download reports. You can make either of the following types of\nrequests:\n\n**[Synchronous](/search-ads/v2/how-tos/reporting/synchronous-requests)**\n\n: Requires just a single request and returns the report in a JSON-formatted response. Synchronous requests:\n\n - Can return only [advertiser](/search-ads/v2/report-types/advertiser) and [engine account](/search-ads/v2/report-types/account) reports\n - Block your client until Search Ads 360 generates the report\n\n\n If you're requesting large advertiser or engine-account reports, we recommend the\n asynchronous approach.\n\n**[Asynchronous](/search-ads/v2/how-tos/reporting/asynchronous-requests)**\n\n: Requires you to send an initial request that specifies the data you want in the\n report. Then you send additional requests to poll Search Ads 360. When Search Ads 360 finishes generating the report,\n you send requests to download the report as one or more files. Asynchronous requests:\n\n - Can return any [report type](/search-ads/v2/report-types)\n - Shards very large reports into multiple files\n - Formats reports as CSV or TSV\n\n### Data model: rows and columns\n\nSearch Ads 360 organizes data in a report into rows and columns.\nThe type of report you request determines the **rows** that are returned.\nFor example, if your request a keyword report, each row will contain data about a single\nkeyword. See the [Report Types](/search-ads/v2/report-types)\nreference for a list of all report types.\nYou specify which **columns** you want in the report by naming each column\nin your report request. See the [Report\nTypes](/search-ads/v2/report-types) reference for the list of columns that can be returned for each report type.\n\n### Column behaviors\n\n\nThe behavior of a column depends on the type of data that the column\ncontains (the [Report Types](/search-ads/v2/report-types) reference\ndisplays each column's behavior):\n\n-\n **Attribute columns**. An attribute column contains data that configures\n or identifies an entity in a campaign, such as the campaign name or a keyword bid. The Search Ads 360 API\n always returns the current value for an attribute column, regardless of any date or\n date range specified in a request. For example, if you changed a keyword's bid from\n 2.00 to 1.50 yesterday and then request a report for last month's data, the report\n will return a value of 1.50 for the keyword bid.\n\n-\n **Metric columns** . A metric column contains data about your campaign's\n performance, such as the number of clicks on an ad, the number of visits as recorded\n by a Floodlight tag, or revenue. Unless you [specify a\n time range](/search-ads/v2/reference/reports#request.timeRange) of a single day, the API returns an aggregate value for metric columns. For\n example, if you request a report for last month's data, the API will return the total\n number of clicks for last month.\n\n-\n **Segment columns** . A segment column splits data into separate rows.\n For example, `date` is a segment column that you can specify for many\n types of reports. If you specify the `date` column in a keyword report\n with a date range 2013-01-01 to 2013-01-07, the API would return seven rows for each\n keyword, each corresponding to one day and displaying metrics for that day. See [Segmented\n Reports](/search-ads/v2/how-tos/reporting/segmented-reports).\n\n### Currencies\n\n\nYour report request is required to specify the currency of monetary data (both attributes like `dailyBudget` and metrics like\n`cost`). You can specify one of the following:\n\n- The agency's currency, if the report is [scoped](/search-ads/v2/reference/reports#request.reportScope) to an agency, advertiser, or engine account.\n- The advertiser's currency, if the report is scoped to an advertiser or engine account.\n- The engine account's currency, if the report is scoped to an engine account.\n- USD\n\n\nUse the [Reports.request.statisticsCurrency](/search-ads/v2/reference/reports#request.statisticsCurrency)\nrequest property to specify a currency.\n\n\nThe report itself will indicate the currency in the ` `[Reports.statisticsCurrencyCode](/search-ads/v2/reference/reports#statisticsCurrencyCode) property.\n\n### Time zone\n\n\nSearch Ads 360 metrics are stored in dates without time zones. These dates correspond to the engine\naccount time zone for engine metrics (such as clicks, impressions, and visits), and\nCampaign Manager network time zone for conversion metrics (such as actions,\ntransactions and revenue). When every metric in a report comes from the same time zone,\nthat time zone will be returned in the request. Otherwise, no time zone will be returned.\nYour requests can set [Reports.request.verifySingleTimeZone](/search-ads/v2/reference/reports#request.verifySingleTimeZone)`: true`\nto fail reports that present metric from more than one time zone.\n\n\nIf all metrics present in a report are from one time zone, that time zone is\nreturned in [Reports.statisticsTimeZoneReports](/search-ads/v2/reference/reports#statisticsTimeZone)."]]
