Raporlama

Raporlar, hesabınızdaki tüm farklı kaynaklar hakkında bilgi sağlar. Kampanyalar, reklam grupları ve bunların istatistikleri, hesabınızın değişiklik geçmişi ve daha fazlası hakkında bilgi alabilirsiniz. Raporlama altyapısı, Google Ads API tarafından desteklenir ve hangi alanları, metrikleri ve koşulları ayarlamak istediğinizi belirtmek için GAQL'yi kullanır.

Bildirme için iki ana mekanizma vardır. Her ikisi de aynı türdeki sorguları kabul eder ve sonuçları döndürme şekilleri bakımından farklılık gösterir.

Her iki durumda da aşağıdaki sorguyu kullanacağız:

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0
AdsApp.report()
Bu işlem, arama sonuçlarınızın sözlük benzeri bir gösterimini döndürür. Alanlara doğrudan row["campaign.id"] ve row["metrics.impressions"] gibi bir sözlük kullanıyormuş gibi erişebilirsiniz. Bu biçimi kullanarak sonuçları exportToSheet() yöntemini kullanarak doğrudan bir e-tabloya aktarabilirsiniz. Bu, Google Ads API'nin sonuçları döndürdüğü varsayılan biçim değildir. Bu nedenle, bazı durumlarda bazı alanlar bu biçimde kullanılamayabilir. Bu durumda bunun yerine search kullanmalısınız.
AdsApp.search()
Bu işlem, çeşitli alanlara sahip GoogleAdsRow nesnelerinin listesini döndürür. Bu alanların her birinde alt alanlar olabilir. Bu nedenle, verileri getirmek için row.campaign.id ve row.metrics.impressions kısayollarını kullanırsınız. Bu yöntem, verileri programatik olarak işlemeyi planlıyorsanız genellikle daha kullanışlıdır. Bazı alanlar, düz bir gösterime dönüştürülemezse yalnızca search biçiminde kullanılabilir.

Rapor Örneği

let report = AdsApp.report(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

let rows = report.rows();
while (rows.hasNext()) {
    let row = rows.next();
    let query = row["search_term_view.search_term"];
    let impressions = row["metrics.impressions"];
}

Bu görünümü kullanmayla ilgili tüm ayrıntılar için AdsApp.report belgelere göz atın.

Arama örneği

let search = AdsApp.search(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

while (search.hasNext()) {
    let row = search.next();
    let query = row.searchTermView.searchTerm;
    let impressions = row.metrics.impressions;
}

Olası tüm ayarlar için tam Adsapp.search dokümanları inceleyin.