Raporlama

Raporlar, hesabınızdaki tüm farklı kaynaklar hakkında bilgi sağlar. Kampanyalar, reklam grupları ve 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 ayarlamak istediğiniz alanları, metrikleri ve koşulları belirtmek için GAQL'yi kullanır.

Raporlama için iki ana mekanizma vardır. Her ikisi de aynı tür sorguları kabul eder ve temel olarak sonuçları döndürme biçimleri açısı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 düz, sözlük benzeri bir temsilini döndürür. Alanlara sözlük kullanıyormuş gibi erişebilirsiniz (ör. row["campaign.id"] ve row["metrics.impressions"] doğrudan). Bu biçimi kullanarak exportToSheet() yöntemini kullanarak sonuçları doğrudan bir e-tabloya aktarabilirsiniz. Bu, Google Ads API tarafından sonuçların döndürüldüğü doğal 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, her biri alt alanlara sahip olabilecek çeşitli alanlara sahip GoogleAdsRow nesnelerinin bir listesini döndürür. Bu nedenle, verileri almak için row.campaign.id ve row.metrics.impressions öğelerine erişirsiniz. Bu, verileri programatik olarak işlemeyi planlıyorsanız genellikle daha yararlıdır ve bazı alanlar düz bir temsile dönüştürülemiyorsa 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ün kullanımıyla ilgili tüm ayrıntılar için AdsApp.report dokümanlarına 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 Adsapp.search dokümanının tamamını inceleyin.