রিপোর্ট করা হচ্ছে

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

AdsApp.search()

এর ফলে GoogleAdsRow অবজেক্টের একটি তালিকা রিটার্ন করা হবে, যার মধ্যে বিভিন্ন ফিল্ড থাকবে, প্রতিটি ফিল্ডের মধ্যে আবার সাব-ফিল্ড থাকতে পারে। তাই ডেটা পেতে আপনি row.campaign.id এবং row.metrics.impressions অ্যাক্সেস করবেন। আপনি যদি প্রোগ্রাম্যাটিক উপায়ে ডেটা প্রসেস করার পরিকল্পনা করেন, তাহলে এটি সাধারণত আরও বেশি উপযোগী হয় এবং কিছু ফিল্ড ফ্ল্যাট প্রতিনিধিত্বে কনভার্ট করা না গেলে, সেগুলি শুধুমাত্র search ফর্ম্যাটেই উপলভ্য হতে পারে।

মনে রাখবেন: AdsApp.search ব্যবহার করার সময়, রিটার্ন করা ফিল্ডগুলি lowerCamelCase-এ থাকবে, যদিও সেগুলি কোয়েরিতে underscore_case-এ নির্দিষ্ট করা আছে। যেমন, কোয়েরিতে আপনার ফিল্ড campaign.start_date হলে, সারি থেকে ফলাফল পেতে, আপনাকে campaign.startDate ব্যবহার করতে হবে।

অভিযোগের উদাহরণ

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 ডকুমেন্টেশন দেখুন।