Ö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.
Artımlı Raporlar
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.
Her rapor isteğinde bulunduğunuzda tüm verilerin dökümünü almak yerine düzenli aralıklarla yalnızca son raporunuzdan bu yana değişen verileri isteyebilirsiniz. Bu artımlı raporlar, muhtemelen tam bir rapordan önemli ölçüde daha küçük olacaktır.
Ek raporlar isteğinde bulunursanız aşağıdakileri göz önünde bulundurmanız gerekir:
- Yine de bazı ek değişikliklerin kaybolma olasılığına karşı, arada sırada eksiksiz bir rapor istemek iyi bir fikirdir. Örneğin, Ocak ayı boyunca haftalık ek raporlar isterseniz Şubat ayının sonunda, Ocak ayının tüm verilerini aldığınızdan emin olmak için Ocak ayına ait tam bir rapor talep etmeniz gerekir.
- Bazı varlıkların değişip değişmediğini belirlemek her zaman mümkün olmadığından, Search Ads 360 varlığın değişeceğinden şüphelendiği bile olsa artımlı bir rapor bir varlık içerir. Diğer bir deyişle, artımlı raporlar değişmemiş veriler içerebilir.
Artımlı rapor istemek için aşağıdaki Reports.request.timeRange
özelliklerinden birini belirtin:
changedMetricsSinceTimestamp=timestampBelirtilen zaman damgasından sonra değişen istek metrikleri. Metrikler günlük ayrıntı düzeyinde depolandığı ve bir gün değişebileceği için bir gün değişebileceği için bu tür istekler güne göre segmentlere ayrılmalıdır (date sütunu mevcut olmalıdır). Örneğin, clicks, actions ve date sütunlarını içeren bir keyword raporu, belirtilen zaman damgasından bu yana kaydedilen tıklama veya işlem sayısının değiştiği her bir anahtar kelime ve tarih için bir satır döndürür.
Zaman damgası, isteğin zamanından en fazla 8 gün önce olmalıdır. Değişen tüm metrikleri yakalamak için 7 günde bir en az bir kez changedMetricsSinceTimestamp isteğinde bulunduğunuzdan ve metrikler çözüldükten sonra her tarih için tam bir rapor oluşturduğunuzdan emin olun (en az 7 gün beklemek daha güvenlidir). Her gün iki rapor oluşturmak buna örnek olarak verilebilir: son 36 saat içinde değişen metrikler için artımlı bir rapor ve 8 gün önce gerçekleşmiş metrikler için tam bir rapor.
changedAttributesSinceTimestamp=timestampBelirtilen zaman damgasından sonra değişen istek özellikleri. changedAttributesSinceTimestamp isteği yalnızca özellik sütunlarını içerebilir (metrik veya segment sütunu içermez) ve conversion raporları gibi ham etkinlik raporları için çalışmaz. Örneğin, dailyBudget ve campaignStartDate sütunlarını içeren bir campaign raporu, belirtilen zaman damgasından sonra günlük bütçesi veya başlangıç tarihi değişen her kampanya için bir satır döndürür.
Üst özelliklerde yapılan değişikliklerin changedAttributesSinceTimestamp raporlarında yansıtılmadığını unutmayın. Örneğin, bir anahtar kelime, teklif stratejisini üst reklam grubundan devralabilir.
Reklam grubuna yeni bir teklif stratejisi atansa bile bu anahtar kelime
raporda görünmeyebilir. Değeri üst varlıklara bağlı olan (ve bu nedenle changedAttributesSinceTimestamp raporları tarafından alınmadan değişebilen) özellik sütunları genellikle effectiveLabelIds veya effectiveBidStartegy gibi "geçerli" ön ekine sahiptir.
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: 2023-12-14 UTC.
[null,null,["Son güncelleme tarihi: 2023-12-14 UTC."],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data into your workflows.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports allow you to retrieve only the data that has changed since your last request, making reports smaller and more efficient.\u003c/p\u003e\n"],["\u003cp\u003eIt is recommended to periodically request full reports in addition to incremental reports to ensure all data is captured.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports can be requested based on either changed metrics or changed attributes using specific time range properties.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003echangedAttributesSinceTimestamp\u003c/code\u003e requests provide efficient updates for attributes, changes to parent attributes might not be reflected, necessitating awareness of potential data discrepancies.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows users to build custom reports and integrate data into their applications. It offers incremental reports, which retrieve only data that has changed since the last request, reducing report size. Users can request changes in metrics (`changedMetricsSinceTimestamp`) or attributes (`changedAttributesSinceTimestamp`). Full reports are still recommended periodically to ensure no data is missed. For `changedMetricsSinceTimestamp`, data must be segmented by day and should be requested every seven days. Changed attributes only report changes to the attribute itself, not inherited changes from parent.\n"],null,["# Incremental 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).\nInstead of receiving a dump of all data every time you request a report, you can\nperiodically request only the data that has changed since your last report. These\nincremental reports will likely be significantly smaller than a full report.\n\nIf you request incremental reports, you should be aware of the following:\n\n- It's still a good idea to request a full report every once in a while, just in case some incremental changes are lost. For example, if you request weekly incremental reports during January, at the end of February you should request a full report for January to make sure you get all of the January data.\n- Since it isn't always possible to determine if some entities have changed, an incremental report will contain an entity if Search Ads 360 even *suspects* that the entity has changed. This means that incremental reports might contain data that hasn't changed.\n\n\nTo request an incremental report, specify one of the following ` `[Reports.request.timeRange](/search-ads/v2/reference/reports#request.timeRange)`\n` properties:\n\n`changedMetricsSinceTimestamp=`*timestamp*\n\n: Requests metrics that have changed since the specified timestamp. Because metrics are\n stored at a daily granularity and might change for one day but not another, such\n requests must be segmented by day (the `date` column must be present). For\n example, a `keyword` report with the columns\n `clicks`, `actions`, and `date`, would\n return a row for each keyword and date in which the recorded number of\n clicks or actions has changed since the given timestamp.\n\n\n The timestamp must be no earlier than 8 days before the time of request. To capture\n all of the changing metrics, be sure to make a `changedMetricsSinceTimestamp`\n request at least once every 7 days, and make a full report for each date\n once the metrics have settled (it is safer to wait at least 7 days). An\n example pattern is to create two reports every day: an incremental\n report for metrics that have changed in the last 36 hours, and a full\n report for metrics that occurred 8 days ago.\n\n`changedAttributesSinceTimestamp=`*timestamp*\n\n: Requests attributes that have changed since the given timestamp. A\n `changedAttributesSinceTimestamp` request can only include\n attribute columns (no metric or segment columns), and does not work for\n raw event reports such as\n [`conversion`](/search-ads/v2/report-types/conversion) reports. For example, a\n `campaign` report with the columns `dailyBudget`\n and `campaignStartDate` would return a row for each campaign\n whose daily budget or start date has changed since the given timestamp.\n\n\n Note that changes to parent attributes are not captured in `changedAttributesSinceTimestamp` reports. For example a keyword may inherit its bid strategy from the parent ad group. Even if the ad group is assigned a new bid strategy, this keyword might not appear in the report. Attribute columns whose value depends on parent entities (and therefore could change without getting picked up by `changedAttributesSinceTimestamp` reports) usually have the prefix \"effective\", such as `effectiveLabelIds` or `effectiveBidStartegy`.\n\n \u003cbr /\u003e"]]
