Raporlama

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

Raporlama için iki ana mekanizma vardır. İkisi de aynı tür sorguları kabul eder ve esasen sonuçları döndürme şekli açısından farklıdır.

Her iki durumda da aşağıdaki sorguyu kullanırı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, row["campaign.id"] ve row["metrics.impressions"] gibi bir sözlük kullanıyormuş gibi doğrudan erişebilirsiniz. Bu biçimi kullanarak, exportToSheet() yöntemini kullanarak sonuçları doğrudan bir e-tabloya aktarabilirsiniz. Bu, sonuçların Google Ads API tarafından getirildiği yerel 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 alanı olabilen çeşitli alanlara sahip GoogleAdsRow nesne listesini döndürür. Dolayısıyla, verileri getirmek için row.campaign.id ve row.metrics.impressions erişiminiz olur. Bu, verileri programatik olarak işlemeyi planlıyorsanız genellikle daha faydalıdır ve bazı alanlar yalnızca düz gösterime dönüştürülemiyorsa 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;
}

Mümkün olan tüm ayarlar için Adsapp.search belgelerinin tamamına göz atın.