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 ayarlamak istediğiniz alanları, metrikleri ve koşulları belirtmek için GAQL'i kullanır.

Bildirimde bulunmak 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, arama sonuçlarınızın düz, sözlük benzeri bir temsilini 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, sonuçların Google Ads API tarafından döndürüldüğü varsayılan biçim değildir. Bu nedenle, bazı durumlarda bazı alanlar bu biçimde kullanılamayabilir. Bu durumda search kullanmanız gerekir.
AdsApp.search()
Bu işlem, her biri alt alanlara sahip olabilen çeşitli alanlara sahip GoogleAdsRow nesnelerinin listesini döndürür. Bu nedenle, verileri getirmek için row.campaign.id ve row.metrics.impressions adreslerine erişmeniz gerekir. Bu genellikle verileri programatik olarak işlemeyi planlıyorsanız daha kullanışlı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ü kullanmayla ilgili tüm ayrıntılar için AdsApp.report belgelerine 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;
}

Tüm olası ayarlar için tam Adsapp.search belgelerine bakın.