Ö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.
Kayıtlı Sütunlar
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Floodlight etkinlikleri, Google Analytics hedefleri veya özel durumlar hakkında rapor oluşturmak için
TPG'ler için Search Ads 360 kullanıcı arayüzünde oturum açıp bir veya
Floodlight etkinlik sütunları, Google Analytics etkinlik sütunları gibi diğer kaydedilen sütunlar veya
formül sütunları. Siz
Bir rapor isteğine, verilerini indirmek veya kaydedilen bir sütunu eklemek için
raporları filtreleme hakkında daha fazla bilgi edinin.
Kayıtlı sütunların listesini alma
Bir reklamverenin oluşturduğu kayıtlı tüm sütunları görmek için bir
SavedColumns.list()
.
isteğinde bulunabilirsiniz. Yanıtta
Reklamverenin her bir sütunu için
savedColumnName
.
Kayıtlı sütunlar için rapor isteme
Kayıtlı bir sütunu bir rapor isteğine dahil etmek için
savedColumnName özelliği, sütunun adına ayarlandı:
{
"reportType": "advertiser",
"columns": [
{
"savedColumnName": string,
"headerText": string,
}
],
"filters": [
{
"column": {
"savedColumnName": string,
},
...
},
...
],
...
}
Kayıtlı sütunları kullanırken aşağıdakileri göz önünde bulundurun:
Kaydedilen sütunlar reklamveren düzeyinde tanımlanır. Şu durumda:
isteğe bağlı olarak kaydedilmiş bir sütun dahil
request.reportScope, bir reklamveren veya daha düşük bir değer belirtmelidir
kapsam. Sonuç olarak her bir rapor, yalnızca
tek bir reklamveren olarak.
Kaydedilen sütun adları büyük/küçük harfe duyarlıdır, boşluklara duyarlıdır ve
noktalama işaretlerine duyarlıdır. İlgili içeriği oluşturmak için kullanılan
savedColumnName özelliğinin kaydedilen sütun adıyla eşleşmesi gerekiyor
tam olarak bunu sağlar. Kayıtlı bir sütunun adı
aynı istekte başka bir sütun görmek isterseniz Search Ads 360,
sütunlardan biri veya her ikisi için alternatif, benzersiz headerText.
Kayıtlı sütunlar, Search Ads 360 kampanya yönetiminde değiştirilebilir veya kaldırılabilir
her zaman kullanıcı arayüzünde gezinebilir, kayıtlı sütunları belirten bir istek başarısız olursa
kayıtlı sütunları istekten kaldırıp tekrar gönderebilirsiniz.
Artımlı raporlar, açıkça belirtilmeyen metrikleri içeremez
API tarafından desteklenen (örneğin, Google Analytics etkinlik sütunları). İçinde
ek olarak, Search Ads 360 kullanıcıları kaydedilen sütunları yeniden tanımlayabildiği için,
Kayıtlı sütunlar içeren raporlar doğru olmayabilir.
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 increased flexibility for creating custom reports and integrating data.\u003c/p\u003e\n"],["\u003cp\u003eLeverage saved columns in the API to report on Floodlight activities, Google Analytics goals, or custom KPIs.\u003c/p\u003e\n"],["\u003cp\u003eRetrieve a list of saved columns using the \u003ccode\u003eSavedColumns.list()\u003c/code\u003e request and include them in report requests by referencing their \u003ccode\u003esavedColumnName\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSaved columns are advertiser-specific and their names are case-sensitive, whitespace-sensitive, and punctuation-sensitive.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports have limitations with certain metrics and saved columns due to their dynamic nature.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows custom report building and data integration. Advertisers can create saved columns (Floodlight, Google Analytics, or formula) in the Search Ads 360 UI to report custom KPIs. To use these, send a `SavedColumns.list()` request to get a list of saved columns and their names. Include saved columns in report requests via the `savedColumnName` attribute. Saved columns are advertiser-specific, case-sensitive, and can be modified or removed. Incremental reports cannot contain unsupported metrics or saved columns.\n"],null,["# Saved Columns\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\nTo report on Floodlight activities, Google Analytics goals, or custom\nKPIs, an advertiser can sign into Search Ads 360 UI and create one or\nmore **saved columns** , such as [Floodlight activity columns](https://support.google.com/searchads/answer/6051170), [Google Analytics activity columns](https://support.google.com/searchads/answer/6073934), or\n[formula columns](https://support.google.com/searchads/answer/6008636). You\ncan include a saved column in a report request either to download its data or to\n[filter a report](/search-ads/v2/how-tos/reporting/filtered-reports).\n\n### Get a list of saved columns\n\n\nTo see all of the saved columns that an advertiser has created, send a\n`\n`[SavedColumns.list()](/search-ads/v2/reference/savedColumns/list)`\n`\nrequest. The response includes the\n`\n`[savedColumnName](/search-ads/v2/reference/reports#request.columns.savedColumnName)`\n` for each of the advertiser's columns.\n\n### Request reports for saved columns\n\n\nTo include a saved column in a report request, add a column with the\n`savedColumnName` attribute set to the name of the column: \n\n```\n{\n \"reportType\": \"advertiser\",\n \"columns\": [\n {\n \"savedColumnName\": string,\n \"headerText\": string,\n }\n ],\n \"filters\": [\n {\n \"column\": {\n \"savedColumnName\": string,\n },\n ...\n },\n ...\n ],\n ...\n}\n```\n\n\nWhen using saved columns, keep in mind that:\n\n-\n Saved columns are defined at the advertiser level. If you are\n including a saved column in a request,\n [request.reportScope](/search-ads/v2/reference/reports#request.reportScope) must specify an advertiser or lower\n scope. Consequently, each report can include saved columns only for a\n single advertiser.\n\n-\n Saved column names are case sensitive, whitespace sensitive and\n punctuation sensitive. The\n [savedColumnName](/search-ads/v2/reference/reports#request.columns.savedColumnName) attribute needs to match the saved column name\n exactly. If the name of a saved column is identical to the name of\n another column in the same request, Search Ads 360 requires you to specify an\n alternate, unique [headerText](/search-ads/v2/reference/reports#request.columns.headerText) for one or both of the columns.\n\n-\n Saved columns can be modified or removed in the Search Ads 360 campaign management\n UI at any time; if a request that specifies saved columns fails, try\n removing the saved columns from the request and sending it again.\n\n-\n [Incremental reports](/search-ads/v2/how-tos/reporting/incremental-reports) cannot contain metrics that are not explicitly\n supported by the API (for example, Google Analytics activity columns). In\n addition, because Search Ads 360 users can redefine saved columns, incremental\n reports containing saved columns might not be accurate.\n\n\u003cbr /\u003e"]]
