إعداد التقارير

توفِّر التقارير معلومات حول جميع الموارد المختلفة في حسابك. يمكنك استرجاع معلومات عن الحملات والمجموعات الإعلانية وإحصاءاتها، وتغيير سجل حسابك وغير ذلك الكثير. يتم دعم البنية الأساسية لإعداد التقارير Google Ads API ويستخدم GAQL لتحديد الحقول والمقاييس والشروط التي تريد ضبطها.

هناك آليتان رئيسيتان للإبلاغ. كلاهما يقبل نفس أنواع مختلفة، وتختلف بشكل أساسي في كيفية عرض النتائج.

في كلتا الحالتين، سنستخدم الاستعلام التالي:

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0
AdsApp.report()
سيؤدي ذلك إلى عرض تمثيل مسطح لبحثك يشبه القاموس نتائجك. يمكنك الوصول إلى الحقول كما لو كنت تستخدم قاموسًا، مثل row["campaign.id"] وrow["metrics.impressions"] مباشرةً من خلال استخدام هذه يمكنك تصدير النتائج مباشرةً إلى جدول بيانات باستخدام طريقة exportToSheet(). وهذا ليس التنسيق الأصلي الذي تظهر فيه النتائج. التي تم إرجاعها بواسطة إعلانات Google API، لذلك في بعض الحالات قد لا تكون بعض الحقول متاحة بهذا التنسيق. في هذه الحالة، عليك استخدام السمة search بدلاً منها.
AdsApp.search()
سيؤدي هذا إلى عرض قائمة بكائنات GoogleAdsRow، التي تحتوي على حقول مختلفة، والتي قد يحتوي كل منها على حقول فرعية. إذًا، ستتمكن من الوصول إلى row.campaign.id row.metrics.impressions لجلب البيانات. يكون هذا بشكل عام أكثر فائدة إذا تخطط لمعالجة البيانات آليًا، وقد لا تكون بعض الحقول متوفرة بالتنسيق search إذا كان لا يمكن تحويلها إلى تنسيق ثابت التمثيل المناسب.

مثال للتقرير

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"];
}

يمكنك إلقاء نظرة على AdsApp.report للحصول على التفاصيل الكاملة حول استخدام طريقة العرض هذه.

مثال على البحث

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;
}

الرجوع إلى المجموعة الكاملة Adsapp.search ووثائق لجميع الإعدادات الممكنة.