রিপোর্টিং

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