ইনক্রিমেন্টাল রিপোর্ট

নতুন Search Ads 360 Reporting API এখন উপলব্ধ। নতুন API কাস্টম রিপোর্ট তৈরি করতে এবং আপনার রিপোর্টিং অ্যাপ্লিকেশন এবং প্রক্রিয়াগুলিতে ডেটা সংহত করার জন্য উন্নত নমনীয়তা প্রদান করে। নতুন Search Ads 360 Reporting API- এ স্থানান্তরিত ও ব্যবহার সম্পর্কে আরও জানুন।

প্রতিবার রিপোর্টের অনুরোধ করার সময় সমস্ত ডেটার ডাম্প পাওয়ার পরিবর্তে, আপনি পর্যায়ক্রমে শুধুমাত্র সেই ডেটার অনুরোধ করতে পারেন যা আপনার শেষ রিপোর্টের পর থেকে পরিবর্তিত হয়েছে। এই ক্রমবর্ধমান প্রতিবেদনগুলি সম্ভবত একটি সম্পূর্ণ প্রতিবেদনের তুলনায় উল্লেখযোগ্যভাবে ছোট হবে।

আপনি যদি ক্রমবর্ধমান প্রতিবেদনের জন্য অনুরোধ করেন, তাহলে আপনাকে নিম্নলিখিত বিষয়ে সচেতন হতে হবে:

  • কিছু ক্রমবর্ধমান পরিবর্তন হারিয়ে গেলে প্রতিবার একবারে একটি সম্পূর্ণ প্রতিবেদনের অনুরোধ করা এখনও ভাল ধারণা। উদাহরণস্বরূপ, আপনি যদি জানুয়ারী মাসে সাপ্তাহিক বর্ধিত প্রতিবেদনের জন্য অনুরোধ করেন, তাহলে ফেব্রুয়ারির শেষে আপনাকে জানুয়ারির জন্য একটি সম্পূর্ণ প্রতিবেদনের অনুরোধ করা উচিত যাতে আপনি জানুয়ারী মাসের সমস্ত ডেটা পান।
  • যেহেতু কিছু এন্টিটি পরিবর্তিত হয়েছে কিনা তা নির্ধারণ করা সবসময় সম্ভব নয়, তাই যদি Search Ads 360 এমনকি এন্টিটি পরিবর্তিত হয়েছে বলে সন্দেহ করে তাহলে একটি বর্ধিত প্রতিবেদনে একটি সত্তা থাকবে। এর মানে হল ক্রমবর্ধমান প্রতিবেদনে এমন ডেটা থাকতে পারে যা পরিবর্তিত হয়নি।

একটি বর্ধিত প্রতিবেদনের অনুরোধ করতে, নিম্নলিখিত Reports.request.timeRange বৈশিষ্ট্যগুলির মধ্যে একটি নির্দিষ্ট করুন:

changedMetricsSinceTimestamp= timestamp

নির্দিষ্ট টাইমস্ট্যাম্পের পর থেকে পরিবর্তিত মেট্রিক্সের অনুরোধ করে। যেহেতু মেট্রিকগুলি একটি দৈনিক গ্রানুলিটিতে সংরক্ষণ করা হয় এবং এটি একদিনের জন্য পরিবর্তিত হতে পারে কিন্তু অন্য দিনের জন্য নয়, এই ধরনের অনুরোধগুলি অবশ্যই দিনে ভাগ করা উচিত ( date কলামটি অবশ্যই উপস্থিত থাকতে হবে)। উদাহরণস্বরূপ, কলাম clicks , actions এবং date সহ একটি keyword রিপোর্ট প্রতিটি কীওয়ার্ড এবং তারিখের জন্য একটি সারি প্রদান করবে যেখানে প্রদত্ত টাইমস্ট্যাম্পের পর থেকে রেকর্ড করা ক্লিক বা অ্যাকশনের সংখ্যা পরিবর্তিত হয়েছে।

টাইমস্ট্যাম্পটি অনুরোধের সময়ের 8 দিনের আগে হওয়া উচিত নয়। পরিবর্তিত সমস্ত মেট্রিক্স ক্যাপচার করতে, প্রতি 7 দিনে অন্তত একবার একটি changedMetricsSinceTimestamp অনুরোধ করতে ভুলবেন না এবং একবার মেট্রিক্স সেটেল হয়ে গেলে প্রতিটি তারিখের জন্য একটি সম্পূর্ণ প্রতিবেদন তৈরি করুন (অন্তত 7 দিন অপেক্ষা করা নিরাপদ)। একটি উদাহরণ প্যাটার্ন হল প্রতিদিন দুটি প্রতিবেদন তৈরি করা: গত 36 ঘণ্টায় পরিবর্তিত মেট্রিকগুলির জন্য একটি বর্ধিত প্রতিবেদন এবং 8 দিন আগে ঘটে যাওয়া মেট্রিকের জন্য একটি সম্পূর্ণ প্রতিবেদন৷

changedAttributesSinceTimestamp= timestamp

প্রদত্ত টাইমস্ট্যাম্প থেকে পরিবর্তিত বৈশিষ্ট্যগুলির অনুরোধ করে৷ একটি changedAttributesSinceTimestamp অনুরোধ শুধুমাত্র বৈশিষ্ট্য কলাম অন্তর্ভুক্ত করতে পারে (কোনও মেট্রিক বা বিভাগ কলাম নেই), এবং conversion প্রতিবেদনের মতো কাঁচা ইভেন্ট রিপোর্টের জন্য কাজ করে না। উদাহরণস্বরূপ, dailyBudget এবং campaignStartDate কলাম সহ একটি campaign প্রতিবেদন প্রতিটি প্রচারের জন্য একটি সারি প্রদান করবে যার দৈনিক বাজেট বা শুরুর তারিখ প্রদত্ত টাইমস্ট্যাম্প থেকে পরিবর্তিত হয়েছে৷

মনে রাখবেন যে প্যারেন্ট অ্যাট্রিবিউটের পরিবর্তনগুলি changedAttributesSinceTimestamp রিপোর্টগুলিতে ক্যাপচার করা হয় না৷ উদাহরণস্বরূপ একটি কীওয়ার্ড মূল বিজ্ঞাপন গোষ্ঠী থেকে তার বিড কৌশল উত্তরাধিকার সূত্রে পেতে পারে। এমনকি বিজ্ঞাপন গোষ্ঠীকে একটি নতুন বিড কৌশল নির্ধারণ করা হলেও, এই কীওয়ার্ডটি প্রতিবেদনে নাও থাকতে পারে। অ্যাট্রিবিউট কলাম যার মান মূল সত্তার উপর নির্ভর করে (এবং সেই কারণে changedAttributesSinceTimestamp রিপোর্টগুলি না নিয়েও পরিবর্তন হতে পারে) সাধারণত "কার্যকর" উপসর্গ থাকে, যেমন effectiveLabelIds বা effectiveBidStartegy