রিপোর্টিং

রিপোর্ট আপনার অ্যাকাউন্টের সমস্ত বিভিন্ন রিসোর্স সম্পর্কে তথ্য প্রদান করে। আপনি ক্যাম্পেইন, অ্যাড গ্রুপ ও সেগুলোর পরিসংখ্যান, আপনার অ্যাকাউন্টের পরিবর্তনের ইতিহাস এবং আরও অনেক কিছু সম্পর্কে তথ্য পেতে পারেন। এই রিপোর্টিং পরিকাঠামোটি গুগল অ্যাডস এপিআই (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() মেথড ব্যবহার করে রেজাল্টগুলো সরাসরি একটি স্প্রেডশিটে এক্সপোর্ট করতে পারবেন। এটি গুগল অ্যাডস এপিআই দ্বারা রেজাল্ট ফেরত দেওয়ার ডিফল্ট ফরম্যাট নয়, তাই কিছু ক্ষেত্রে কিছু ফিল্ড এই ফরম্যাটে উপলব্ধ নাও থাকতে পারে। যদি এমন হয়, তবে আপনার পরিবর্তে 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 সম্পূর্ণ ডকুমেন্টেশন দেখুন।