এন্টিটি রিড ফাইল থেকে মাইগ্রেট করুন

এন্টিটি রিড ফাইল (ERFs) হল একটি অংশীদারের প্রচারাভিযানের বস্তুর JSON উপস্থাপনা যা অনুরোধের ভিত্তিতে প্রতিদিন তৈরি হয় এবং Google ক্লাউড স্টোরেজের মাধ্যমে উপলব্ধ করা হয়।

ERFগুলি 2021 সালের জুনে বাতিল করা হয়েছিল ৷ 31 অক্টোবর, 2024 থেকে শুরু করে, ERFগুলি আনুষ্ঠানিকভাবে সূর্যাস্ত হবে এবং আর জেনারেট করা হবে না৷ সমস্ত বিদ্যমান এন্টিটি রিড ফাইল ব্যবহারকারীদের ডিসপ্লে এবং ভিডিও 360 রিসোর্স পুনরুদ্ধার করা চালিয়ে যাওয়ার জন্য ডিসপ্লে এবং ভিডিও 360 এপিআইতে স্থানান্তর করতে উত্সাহিত করা হচ্ছে৷

এই নির্দেশিকাটি আলোচনা করে যে কীভাবে এন্টিটি রিড ফাইল থেকে Display & Video 360 API-তে স্থানান্তর করা যায়:

  • দুটি ইন্টারফেসের মধ্যে পার্থক্যগুলির একটি ওভারভিউ দেওয়া
  • API পরিষেবাগুলির সাথে ERF টেবিলের তুলনা করা হচ্ছে
  • API এর মাধ্যমে সত্তা পুনরুদ্ধারের বিষয়ে নির্দেশিকা প্রদান করা
  • বিদ্যমান তথ্য ফাঁক স্বীকার
  • তুলনীয় API রিসোর্স ক্ষেত্রগুলিতে সমস্ত ERF ক্ষেত্রগুলির একটি ম্যাপিং উপস্থাপন করা

ওভারভিউ

ERFs থেকে Display & Video 360 API-তে স্থানান্তরিত করার সময়, বিবেচনা করার জন্য কয়েকটি মূল পার্থক্য রয়েছে, যার মধ্যে রয়েছে:

  • ডেটা সতেজতা। ERFs দৈনিক এবং বাল্ক তৈরি করা হয় যখন API একটি সম্পদের সবচেয়ে আপ-টু-ডেট সংস্করণ পুনরুদ্ধার করে।
  • সম্পদ কাঠামো। API একই রিসোর্স প্রকারের প্রতিনিধিত্ব করতে ERF-এর থেকে ভিন্ন JSON স্ট্রাকচার ব্যবহার করে। কিছু সম্পদ, যেমন পাবলিক টার্গেটিং সেটিংস, একটি ভিন্ন আইডি স্পেস ব্যবহার করতে পারে।
  • পুনরুদ্ধার পদ্ধতি। ডিসপ্লে এবং ভিডিও 360 API শুধুমাত্র ERF দ্বারা প্রদত্ত কাঁচা JSON ফাইলগুলির বিপরীতে, ব্যক্তিগতভাবে, পৃষ্ঠাযুক্ত তালিকায় বা BigQuery ডেটা স্থানান্তরের মাধ্যমে সংস্থানগুলি পুনরুদ্ধার করতে সক্ষম করে৷
  • ব্যাপ্তি। ERF-এর বিপরীতে, যা অংশীদার আইডি দ্বারা স্কোপ করা হয়, বেশিরভাগ API সংস্থান বিজ্ঞাপনদাতা আইডি দ্বারা স্কোপ করা হয়। প্রতিক্রিয়াগুলিতে অন্তর্ভুক্ত সংস্থানগুলি সেই সুযোগের মধ্যে সংস্থানগুলিতে সীমাবদ্ধ।

API এ ERF ডেটা উপস্থাপনা

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

Display & Video 360 API এই দ্বিধাবিভক্তি ব্যবহার করে না, পরিবর্তে বিভিন্ন পরিষেবার মাধ্যমে এবং বিভিন্ন JSON কাঠামো ব্যবহার করে এই সমস্ত তথ্য পুনরুদ্ধারযোগ্য করে তোলে। এই বিভাগটি ডিসপ্লে এবং ভিডিও 360 API সংস্থান এবং পরিষেবাগুলির মাধ্যমে উপলব্ধ করা সর্বজনীন এবং ব্যক্তিগত ERF টেবিলের মাধ্যমে প্রদত্ত তথ্যের তুলনা করে।

পাবলিক তথ্য

ERF পাবলিক টেবিলগুলি ব্যবহারকারীদের তাদের পুনরুদ্ধার করা ব্যক্তিগত সংস্থানগুলির লক্ষ্য নির্ধারণ সেটিংস ব্যাখ্যা করার সময় এবং UI এর মাধ্যমে আপলোড করা স্ট্রাকচার্ড ডেটা ফাইল (SDFs) সংস্করণগুলির একটি উপসেটের মাধ্যমে লক্ষ্য নির্ধারণ করার সময় ব্যবহার করার জন্য রেফারেন্স সামগ্রী সরবরাহ করে৷ এই রেফারেন্স সামগ্রীগুলি সমস্ত ব্যবহারকারীর জন্য একই এবং একটি সংখ্যাসূচক আইডি নিয়ে গঠিত, যা ম্যাপিংয়ের জন্য ব্যবহৃত হয় এবং আরও বর্ণনামূলক বিবরণ, যেমন একটি প্রদর্শন নাম৷

Display & Video 360 API ব্যবহার করার সময়, টার্গেটিং রেফারেন্স তথ্য targetingTypes.targetingOptions পরিষেবার মাধ্যমে পুনরুদ্ধার করা যেতে পারে। পাবলিক টেবিলের মতো, এই পরিষেবাটি একটি নির্দিষ্ট টার্গেটিং ধরণের জন্য আইডি এবং টার্গেটিং বিকল্পগুলির বিশদ প্রদান করে। টার্গেটিং বিকল্প আইডি পুনরুদ্ধার প্রদর্শন করে এমন একটি কোড উদাহরণের জন্য আমাদের বিদ্যমান সেট টার্গেটিং পৃষ্ঠাটি দেখুন।

পাবলিক টেবিল এবং SDF

SDF v7 এর আগে , এন্টিটি রিড ফাইল এবং স্ট্রাকচার্ড ডেটা ফাইল একই আইডি স্পেস টার্গেটিং সেটিংসের জন্য ব্যবহার করে। আপনি যদি SDF ব্যবহার করে টার্গেটিং সেটিংস ব্যাখ্যা বা বরাদ্দ করার জন্য ERF পাবলিক টেবিল ব্যবহার করে একজন SDF ব্যবহারকারী হন, তাহলে আপনি পরিবর্তে Display & Video 360 UI এর মাধ্যমে এই রেফারেন্স উপাদানটি CSV ফর্ম্যাটে ডাউনলোড করতে পারেন।

v7 দিয়ে শুরু করে , স্ট্রাকচার্ড ডেটা ফাইল কলামের একটি উপসেট দ্বারা ব্যবহৃত আইডি স্পেসগুলিকে ERF থেকে SDF ডিকপল করার জন্য এবং Display & Video 360 API-এর সাথে আরও সারিবদ্ধ করার জন্য আপডেট করা হয়েছে। আরও তথ্যের জন্য v7 মাইগ্রেশন গাইড এবং রেফারেন্স ডকুমেন্টেশন দেখুন।

ব্যক্তিগত সম্পদ

ERF ব্যক্তিগত টেবিলগুলি একজন অংশীদারের মালিকানাধীন ব্যক্তিগত সম্পদের বর্তমান সেটিংসের একটি দৈনিক স্ন্যাপশট প্রদান করে। একক অংশীদারের অধীনে তৈরি করা সম্পদের নিছক পরিমাণের কারণে, এই ফাইলগুলি খুব বড় হতে পারে এবং ডাউনলোড এবং প্রক্রিয়া করা কঠিন হতে পারে।

API-এ, প্রতিটি ব্যক্তিগত টেবিলের একটি সংশ্লিষ্ট পরিষেবা রয়েছে যা সেই সংস্থান প্রকারের পুনরুদ্ধার এবং পরিচালনার জন্য শেষ পয়েন্ট প্রদান করে। প্রতিটি পরিষেবার সংশ্লিষ্ট তালিকা পদ্ধতি ব্যবহার করে প্রচুর পরিমাণে সম্পদ পুনরুদ্ধার করা যেতে পারে। প্রতিটি সম্পদের জন্য JSON কাঠামো ERF-এর তুলনায় API-এ ভিন্ন, বিভিন্ন ক্ষেত্রের নাম এবং শেয়ার করা সম্পদ ব্যবহার করে।

রিসোর্সের ERF প্রতিনিধিত্বে উপলব্ধ কিছু তথ্য, যেমন একটি রিসোর্সের অ্যাসাইন করা টার্গেটিং সেটিংস বা চ্যানেলের সাইট , এপিআই-এ মূল রিসোর্সের সন্তান হিসাবে উপস্থাপন করা হয় এবং অতিরিক্ত API অনুরোধের মাধ্যমে পুনরুদ্ধার করা আবশ্যক।

API-এ সত্তা পুনরুদ্ধার

Display & Video 360 রিসোর্স হয় সরাসরি API অনুরোধের মাধ্যমে বা BigQuery- এ স্বয়ংক্রিয় আমদানির মাধ্যমে পুনরুদ্ধার করা যেতে পারে।

সরাসরি API অনুরোধ

প্রতিটি রিসোর্স টাইপ একটি ভিন্ন API পরিষেবার মাধ্যমে পুনরুদ্ধারযোগ্য। যথাক্রমে উপযুক্ত পরিষেবার প্রাপ্ত বা তালিকা পদ্ধতি ব্যবহার করে সংস্থানগুলি পৃথকভাবে বা প্রচুর পরিমাণে পুনরুদ্ধার করা যেতে পারে। Display & Video 360 API তালিকা পদ্ধতির গুরুত্বপূর্ণ বৈশিষ্ট্যগুলির মধ্যে রয়েছে:

  • প্রয়োজনীয় সুযোগ। ERF-এর বিপরীতে, যা অংশীদার দ্বারা স্কোপ করা হয়, API-এর বেশিরভাগ সংস্থান বিজ্ঞাপনদাতার দ্বারা স্কোপ করা হয়। কোনও অংশীদারের অধীনে সমস্ত রিসোর্স প্রকার, যেমন লাইন আইটেমগুলি পুনরুদ্ধার করার জন্য সেই অংশীদারের প্রতিটি শিশু বিজ্ঞাপনদাতার জন্য একটি পৃথক তালিকা অনুরোধের প্রয়োজন হতে পারে। ব্যতিক্রমগুলির মধ্যে একজন অংশীদারের সরাসরি সন্তান, যেমন বিজ্ঞাপনদাতা এবং অংশীদার-মালিকানাধীন চ্যানেল অন্তর্ভুক্ত।
  • পৃষ্ঠা সংখ্যা এপিআই তালিকা পদ্ধতিগুলি নিশ্চিত করার জন্য পেজিনেশন নিয়োগ করে যে প্রতিক্রিয়াগুলি একটি যুক্তিসঙ্গত আকারের মধ্যে, বেশিরভাগ স্বতন্ত্র অনুরোধের প্রতিক্রিয়াগুলি বা পৃষ্ঠাগুলিকে 100টি সংস্থানে সীমাবদ্ধ করে। প্রাসঙ্গিক সংস্থানগুলির সংখ্যা পৃষ্ঠার আকারের চেয়ে বড় হলে, সম্পূর্ণ তালিকা প্রতিক্রিয়ার পরবর্তী পৃষ্ঠাগুলি পুনরুদ্ধার করতে পরপর তালিকা কলের প্রয়োজন হয়৷ একটি তালিকার প্রতিক্রিয়া পেজ করার একটি কোড উদাহরণ আমাদের টার্গেটিং গাইড পৃষ্ঠার একটি বিভাগে উপলব্ধ টার্গেটিং বিকল্পগুলি পুনরুদ্ধারের বিষয়ে প্রদান করা হয়েছে৷
  • লক্ষ্য পুনরুদ্ধারের জন্য অতিরিক্ত অনুরোধের প্রয়োজন। একটি রিসোর্সের টার্গেটিং সেটিংস এর API JSON অবজেক্টে অন্তর্ভুক্ত করা হয় না, কিন্তু এর পরিবর্তে চাইল্ড রিসোর্স অ্যাসাইন করা টার্গেটিং অপশন হিসেবে পরিচিত। এই শিশু সম্পদ একটি পৃথক অনুরোধ মাধ্যমে পুনরুদ্ধার করা আবশ্যক. উদাহরণস্বরূপ, একটি advertisers.lineItems.list অনুরোধের মাধ্যমে পুনরুদ্ধার করা প্রতিটি লাইন আইটেমের জন্য, একটি পৃথক advertisers.lineItems.bulkListAssignedTargetingOptions অনুরোধ করতে হবে সমস্ত টার্গেটিং তথ্য পুনরুদ্ধার করার জন্য৷

সম্পদ পুনরুদ্ধার অপ্টিমাইজ করুন

Display & Video 360 API-এর একাধিক অনুরোধের প্রয়োজন হতে পারে একই পরিমাণ তথ্য পুনরুদ্ধার করার জন্য যা একটি একক সত্তা রিড ফাইলে পাওয়া যায়। আপনি কীভাবে সংস্থানগুলি পুনরুদ্ধার করবেন তা অপ্টিমাইজ করা আপনার প্রয়োজনীয় ডেটা আরও দক্ষতার সাথে পুনরুদ্ধার করতে সহায়তা করতে পারে:

  • এপিআই-এ সমসাময়িক অনুরোধ করুন। Display & Video 360 API প্রকল্পের হার সীমা প্রতি বিজ্ঞাপনদাতার অনুরোধ ব্যবহার করে পরিকাঠামো রক্ষা করে। এই কোটা কাঠামো আপনাকে একাধিক বিজ্ঞাপনদাতাদের মধ্যে একটি মাল্টিথ্রেডেড সমাধান প্রয়োগ করতে দেয় যা সমস্ত প্রয়োজনীয় সংস্থান পুনরুদ্ধার করতে মোট সময় কমিয়ে দেবে। যদিও পেজিনেশনের জন্য একটি নির্দিষ্ট সুযোগের মধ্যে একটি ধরণের সমস্ত সংস্থান পরপর কলের মাধ্যমে পুনরুদ্ধার করা প্রয়োজন, অন্য স্কোপের মধ্যে বা অন্য ধরণের সংস্থানগুলি একই সাথে করা যেতে পারে।
  • শুধুমাত্র প্রাসঙ্গিক সম্পদ পুনরুদ্ধার করার জন্য আপনার তালিকা কলে প্যারামিটার দ্বারা ফিল্টার এবং অর্ডার ব্যবহার করুন । উদাহরণস্বরূপ, যদি আপনি শুধুমাত্র গত দিনে আপডেট করা লাইন আইটেমগুলিতে আগ্রহী হন, তাহলে আপনি advertisers.lineItems.list পদ্ধতির filter প্যারামিটার ব্যবহার করতে পারেন শুধুমাত্র একটি নির্দিষ্ট টাইমস্ট্যাম্পের চেয়ে বেশি updateTime সহ লাইন আইটেমগুলি ফেরত দিতে। এটি করা প্রয়োজন এমন অনুরোধের সংখ্যা উল্লেখযোগ্যভাবে হ্রাস করতে পারে।
  • অপ্রয়োজনীয় API অনুরোধ এড়াতে নিয়মিত ব্যবহৃত আইডি ক্যাশে করুন । নির্দিষ্ট রেফারেন্স তথ্য, যেমন টার্গেটিং বিকল্প আইডি এবং Google অডিয়েন্স আইডি, তুলনামূলকভাবে স্থিতিশীল এবং প্রতিটি ব্যবহারের সময় পুনরুদ্ধারের প্রয়োজন এড়াতে নিরাপদে সংরক্ষণ করা যেতে পারে। যাইহোক, বিরল পরিবর্তন বা অবনমনের জন্য অ্যাকাউন্টে ক্যাশে করা মানগুলি সাপ্তাহিক ভিত্তিতে পরীক্ষা করা উচিত।

কিভাবে দক্ষতার সাথে Display & Video 360 API অ্যাক্সেস করতে হয় সে সম্পর্কে আরও তথ্যের জন্য আমাদের কোটা অপ্টিমাইজেশন গাইড দেখুন।

BigQuery-এ আমদানি করুন

Display & Video 360 API BigQuery কানেক্টর আপনাকে দৈনিক ভিত্তিতে সরাসরি BigQuery- এ Display & Video 360 রিসোর্স কনফিগারেশন স্বয়ংক্রিয়ভাবে আমদানি করতে দেয়। Display & Video 360 API রিসোর্স ডিজাইন ব্যবহার করে কনফিগারেশনগুলি BigQuery-এ সংরক্ষণ করা হয়। API সংস্থানগুলির একটি উপসেট সমর্থিত।

Display & Video 360 API BigQuery সংযোগকারী ব্যবহার করার বিষয়ে আরও তথ্যের জন্য নিম্নলিখিত ক্লাউড ডকুমেন্টেশন দেখুন:

পরিচিত API ডেটা ফাঁক

ERF থেকে Display & Video 360 API-তে স্থানান্তরিত করার সময় আপনার সম্মুখীন হতে পারে এমন উল্লেখযোগ্য ডেটা ফাঁক রয়েছে, যেমন:

  • গল্প সন্নিবেশ আদেশ. গল্প সন্নিবেশ আদেশ API এর মাধ্যমে পুনরুদ্ধারযোগ্য নয় এবং অবশ্যই প্রদর্শন এবং ভিডিও 360 UI এর মাধ্যমে পুনরুদ্ধার করতে হবে।
  • সম্পদ ক্ষেত্রের একটি উপসেট। ডিসপ্লে ও ভিডিও 360 এপিআই-এর মাধ্যমে পুনরুদ্ধার করা সংশ্লিষ্ট সংস্থানগুলিতে ERF অবজেক্টে উপস্থিত অল্প সংখ্যক রিসোর্স ফিল্ড উপলব্ধ নেই।

পরিশিষ্ট: API এ ERF ক্ষেত্র ম্যাপিং

পাবলিক টেবিল ম্যাপিং

নীচের সারণীগুলি ডিসপ্লে ও ভিডিও 360 এপিআই-এ বিদ্যমান টার্গেটিং প্রকার এবং টার্গেটিং বিকল্প ক্ষেত্রগুলিতে ERF পাবলিক টেবিলের ক্ষেত্রগুলিকে ম্যাপ করে৷ যদিও একটি ক্ষেত্রের মান অন্য ক্ষেত্রে মানচিত্র হতে পারে, এটি গ্যারান্টি দেয় না যে তারা একই ডেটা টাইপ, এনাম মান বা আইডি স্পেস ব্যবহার করবে।

অ্যাপ সংগ্রহ

টার্গেটিং ধরনের TARGETING_TYPE_APP_CATEGORY এর অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
নাম TargetingOption.appCategoryDetails.displayName ক্ষেত্র।

ব্রাউজার

টার্গেটিং ধরনের TARGETING_TYPE_BROWSER এর অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
is_mobile পাওয়া যায় না।
নাম TargetingOption.browserDetails.displayName ক্ষেত্র।

ডেটা পার্টনার

Display & Video 360 API-এ কোনো সমতুল্য সম্পদ বা ক্ষেত্র উপলব্ধ নেই।

ডিভাইসের মানদণ্ড

TARGETING_TYPE_OPERATING_SYSTEM , TARGETING_TYPE_DEVICE_MAKE_MODEL , এবং TARGETING_TYPE_DEVICE_TYPE টার্গেটিং প্রকারের অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র বা DeviceType enum।
is_mobile পাওয়া যায় না।
নাম TargetingOption.operatingSystemDetails.displayName ক্ষেত্র, TargetingOption.deviceMakeModelDetails.displayName ক্ষেত্র, অথবা DeviceType enum, টার্গেটিং প্রকারের উপর নির্ভর করে।
মানদণ্ড_প্রকার TargetingOption.targetingType ক্ষেত্র।
অপারেটিং_সিস্টেম_আইডি পাওয়া যায় না।
মোবাইল_ব্র্যান্ড_নাম পাওয়া যায় না।
মোবাইল_মডেলের_নাম পাওয়া যায় না।
mobile_make_model_id পাওয়া যায় না।
ডিভাইস_টাইপ DeviceType enum.

ভূ-অবস্থান

TARGETING_TYPE_GEO_REGION টার্গেটিং টাইপের অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
ক্যানোনিকাল_নাম TargetingOption.geoRegionDetails.displayName ক্ষেত্র।
geo_name পাওয়া যায় না।
দেশ_কোড পাওয়া যায় না।
অঞ্চল_কোড পাওয়া যায় না।
শহরের_নাম পাওয়া যায় না।
ডাক_নাম পাওয়া যায় না।
dma_code পাওয়া যায় না।

আইএসপি

টার্গেটিং টাইপ TARGETING_TYPE_CARRIER_AND_ISP এর অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
is_mobile পাওয়া যায় না।
নাম TargetingOption.carrierAndIspDetails.displayName ক্ষেত্র।
মাধ্যমিক_মাপদণ্ড_আইডি TargetingOption.targetingOptionId ক্ষেত্র।

ভাষা

টার্গেটিং ধরনের TARGETING_TYPE_LANGUAGE এর অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
নাম পাওয়া যায় না। একটি ভাষার জন্য সম্পূর্ণ প্রদর্শন নাম TargetingOption.languageDetails.displayName ক্ষেত্রে উপলব্ধ।

SiteToPlacementId

Display & Video 360 API-এ কোনো সমতুল্য সম্পদ বা ক্ষেত্র উপলব্ধ নেই।

সমর্থিত এক্সচেঞ্জ

টার্গেটিং টাইপ TARGETING_TYPE_EXCHANGE এর অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি Exchange enum.
নাম Exchange enum.

ইউনিভার্সাল সাইট

Display & Video 360 API-এ কোনো সমতুল্য সম্পদ বা ক্ষেত্র উপলব্ধ নেই। পৃথক সাইট এবং অ্যাপগুলিকে যথাক্রমে TARGETING_TYPE_URL এবং TARGETING_TYPE_APP এর মধ্যে সরাসরি টার্গেট করা যেতে পারে। Display & Video 360-এ, যেকোনো অ্যাপ বা URL টার্গেট করা যেতে পারে, কিন্তু প্রতিটি অ্যাপ বা URL-এ রিপোর্ট করা যাবে না। আপনি যদি অ-প্রতিবেদনযোগ্য অ্যাপ এবং ইউআরএলগুলিকে খরচ করা থেকে সরিয়ে দিতে চান, তাহলে DV360 সহায়তা কেন্দ্রের নির্দেশাবলী অনুসরণ করুন।

ব্যক্তিগত টেবিল ফিল্ড ম্যাপিং

নীচের সারণীগুলি ডিসপ্লে এবং ভিডিও 360 API-তে বিদ্যমান ক্ষেত্র বা পরিষেবাগুলিতে ERF ব্যক্তিগত টেবিলের ক্ষেত্রগুলিকে ম্যাপ করে৷ যদিও একটি ক্ষেত্রের মান অন্য ক্ষেত্রে মানচিত্র করতে পারে, এটি গ্যারান্টি দেয় না যে তারা একই ডেটা টাইপ, এনাম মান বা আইডি স্পেস ব্যবহার করবে।

বিজ্ঞাপনদাতা

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
common_data.id Advertiser.advertiserId ক্ষেত্র।
common_data.name Advertiser.displayName ক্ষেত্র।
common_data.active Advertiser.entityStatus ক্ষেত্র।
common_data.integration_code Advertiser.integrationDetails.integrationCode ক্ষেত্র।
অংশীদার_আইডি Advertiser.partnerId ক্ষেত্র।
মুদ্রা_কোড Advertiser.generalConfig.currencyCode ক্ষেত্র।
timezone_code Advertiser.generalConfig.timeZone ক্ষেত্র।
landing_page_url Advertiser.generalConfig.domainUrl ক্ষেত্র।
উপলব্ধ_চ্যানেল_আইডি advertisers.channels.list পদ্ধতির মাধ্যমে পুনরুদ্ধারযোগ্য।
blacklist_channel_id টার্গেটিং টাইপ TARGETING_TYPE_CHANNEL এর অধীনে advertisers.targetingTypes.assignedtargetingOptions.list পদ্ধতির মাধ্যমে পুনরুদ্ধারযোগ্য। AssignedTargetingOption.channelDetails.negative সত্য হলে, চ্যানেলটি নেতিবাচকভাবে-লক্ষ্যযুক্ত।
dcm_configuration পাওয়া যায় না।
dcm_network_id Advertiser.adServerConfig.cmHybridConfig.cmAccountId ক্ষেত্র।
dcm_advertiser_id Advertiser.adServerConfig.cmHybridConfig.cmAdvertiserIds ক্ষেত্রটি CM360 বিজ্ঞাপনদাতা আইডিগুলির তালিকা করে যা CM360 ফ্লাডলাইট কনফিগারেশন ভাগ করে।
dcm_floodlight_group_id Advertiser.adServerConfig.cmHybridConfig.cmFloodlightConfigId ক্ষেত্র।
dcm_syncable_site_ids Advertiser.adServerConfig.cmHybridConfig.cmSyncableSiteIds ক্ষেত্র।
সক্রিয়_ওবা_ট্যাগ পাওয়া যায় না।

প্রচারণা

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
common_data.id Campaign.campaignId ক্ষেত্র।
common_data.name Campaign.displayName ক্ষেত্র।
common_data.active Campaign.entityStatus ক্ষেত্র।
common_data.integration_code পাওয়া যায় না।
advertiser_id Campaign.advertiserId ক্ষেত্র।
বাজেট Campaign.campaignFlight এবং Campaign.campaignBudgets ক্ষেত্র।
ফ্রিকোয়েন্সি_ক্যাপ Campaign.frequencyCap ক্ষেত্র।
default_target_list advertisers.campaigns.bulkListCampaignAssignedTargetingOptions পদ্ধতির মাধ্যমে পুনরুদ্ধারযোগ্য।
ভিডিও_সৃজনশীল ব্যবহার করে পাওয়া যায় না।
ব্যবহার_প্রদর্শন_সৃজনশীল পাওয়া যায় না।
অডিও_সৃজনশীল ব্যবহার করে পাওয়া যায় না।
উদ্দেশ্য Campaign.campaignGoal.campaignGoalType ক্ষেত্র।
মেট্রিক Campaign.campaignGoal.performanceGoal.performanceGoalType ক্ষেত্র।
উদ্দেশ্য_বর্ণনা Campaign.campaignGoal.performanceGoal.performanceGoalString ক্ষেত্র।
মেট্রিক_অ্যামাউন্ট_মাইক্রো Campaign.campaignGoal.performanceGoal.performanceGoalAmountMicros ক্ষেত্র।

সৃজনশীল

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
common_data.id Creative.creativeId ক্ষেত্র।
common_data.name Creative.displayName ক্ষেত্র।
common_data.active Creative.entityStatus ক্ষেত্র।
common_data.integration_code Creative.integrationCode ক্ষেত্র।
advertiser_id Creative.advertiserId ক্ষেত্র।
dcm_placement_id Creative.cmPlacementId ক্ষেত্র।
প্রস্থ_পিক্সেল Creative.dimensions.widthPixels ক্ষেত্র।
উচ্চতা_পিক্সেল Creative.dimensions.heightPixels ক্ষেত্র।
অনুমোদন_স্থিতি Creative.reviewStatus ক্ষেত্র।
expanding_direction Creative.expandingDirection ক্ষেত্র।
ক্রিয়েটিভ_টাইপ Creative.creativeType ক্ষেত্র।

কাস্টম অ্যাফিনিটি

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি CustomList.customListId ক্ষেত্র।
নাম CustomList.displayName ক্ষেত্র।
বর্ণনা পাওয়া যায় না।
advertiser_id পাওয়া যায় না।

ফ্লাডলাইট কার্যকলাপ

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
common_data.id FloodlightActivity.floodlightActivityId ক্ষেত্র।
common_data.name FloodlightActivity.displayName ক্ষেত্র।
common_data.active FloodlightActivity.servingStatus ক্ষেত্র।
common_data.integration_code পাওয়া যায় না।
advertiser_id FloodlightActivity.advertiserIds ফিল্ড প্রদত্ত অংশীদারের অধীনে ফ্লাডলাইট কার্যকলাপে অ্যাক্সেস সহ সমস্ত বিজ্ঞাপনদাতাদের তালিকা করে।
অংশীদার_আইডি floodlightGroups.floodlightActivities পরিষেবাতে অনুরোধ করার সময় ব্যবহারকারীর দ্বারা প্রদত্ত।
remarketing_enabled FloodlightActivity.remarketingConfigs ফিল্ড প্রদত্ত অংশীদারের অধীনে ফ্লাডলাইট কার্যকলাপে অ্যাক্সেস সহ প্রতিটি বিজ্ঞাপনদাতার জন্য এই কনফিগারেশনটি তালিকাভুক্ত করে৷
ssl_required FloodlightActivity.sslRequired প্রয়োজনীয় ক্ষেত্র।

সন্নিবেশ আদেশ

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
common_data.id InsertionOrder.insertionOrderId ক্ষেত্র।
common_data.name InsertionOrder.displayName ক্ষেত্র।
common_data.active InsertionOrder.entityStatus ক্ষেত্র।
common_data.integration_code InsertionOrder.integrationDetails.integrationCode ক্ষেত্র।
advertiser_id InsertionOrder.advertiserId ক্ষেত্র।
ক্যাম্পেইন_আইডি InsertionOrder.campaignId ক্ষেত্র।
সামগ্রিক_বাজেট পাওয়া যায় না। InsertionOrder.budget.budgetSegments ক্ষেত্রের বিষয়বস্তু ব্যবহার করে গণনা করা যেতে পারে।
নির্ধারিত_সেগমেন্ট InsertionOrder.budget.budgetSegments ক্ষেত্র।
ফ্রিকোয়েন্সি_ক্যাপ InsertionOrder.frequencyCap ক্ষেত্র।
default_partner_costs InsertionOrder.partnerCosts ক্ষেত্র।
default_target_list advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions পদ্ধতির মাধ্যমে পুনরুদ্ধারযোগ্য।

ইনভেন্টরি সোর্স

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি InventorySource.inventorySourceId ক্ষেত্র।
অশ্রেণীবদ্ধ পাওয়া যায় না।
ইনভেন্টরি_নাম InventorySource.displayName ক্ষেত্র।
বিনিময়_আইডি InventorySource.exchange ক্ষেত্র।
অ্যাক্সেসিং_বিজ্ঞাপনকারীদের InventorySource.readWriteAccessors এবং InventorySource.readAdvertiserIds ক্ষেত্রগুলি।
external_id InventorySource.dealId ক্ষেত্র।
min_cpm_micros InventorySource.rateDetails.rate.nanos ক্ষেত্র, InventorySource.rateDetails.inventorySourceRateType ক্ষেত্রের মানের উপর নির্ভর করে।
min_cpm_currency_code InventorySource.rateDetails.rate.currencyCode ক্ষেত্র।

লাইন আইটেম

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
common_data.id LineItem.lineItemId ক্ষেত্র।
common_data.name LineItem.displayName ক্ষেত্র।
common_data.active LineItem.entityStatus ক্ষেত্র।
common_data.integration_code LineItem.integrationDetails.integrationCode ক্ষেত্র।
লাইন_আইটেম_টাইপ LineItem.lineItemType ক্ষেত্র।
সন্নিবেশ_অর্ডার_আইডি LineItem.insertionOrderId ক্ষেত্র।
সৃজনশীল_আইডি LineItem.creativeIds ক্ষেত্র।
max_cpm_advertiser_micros LineItem.bidStrategy.maximizeSpendAutoBid.maxAverageCpmBidAmountMicros বা LineItem.bidStrategy.performanceGoalAutoBid.maxAverageCpmBidAmountMicros ক্ষেত্রগুলি, ব্যবহৃত কৌশল স্কিমের উপর নির্ভর করে৷
কর্মক্ষমতা_লক্ষ্য LineItem.bidStrategy.maximizeSpendAutoBid.performanceGoalType বা LineItem.bidStrategy.performanceGoalAutoBid.performanceGoalType ক্ষেত্রগুলি, ব্যবহৃত কৌশল স্কিমের উপর নির্ভর করে।
লক্ষ্য_বিজ্ঞাপনদাতা_মাইক্রো LineItem.bidStrategy.performanceGoalAutoBid.performanceGoalAmountMicros ক্ষেত্র।
অংশীদার_আয়_মডেল LineItem.partnerRevenueModel ক্ষেত্র।
খরচ_ট্র্যাকিং_পিক্সেল LineItem.conversionCounting.floodlightActivityConfigs ক্ষেত্র।
বাজেট.start_time_usec LineItem.flight.dateRange.startDate ক্ষেত্র।
Budget.end_time_usec LineItem.flight.dateRange.endDate ক্ষেত্র।
Budget.max_impressions LineItem.budget.maxAmount ক্ষেত্র যদি LineItem.budget.budgetUnit BUDGET_UNIT_IMPRESSIONS হয়।
বাজেট.max_spend_advertiser_micros LineItem.budget.maxAmount ক্ষেত্র যদি LineItem.budget.budgetUnit হয় BUDGET_UNIT_CURRENCY ।
বাজেট.পেসিং_টাইপ LineItem.pacing.pacingPeriod ক্ষেত্র।
বাজেট.পেসিং_সর্বোচ্চ_ইম্প্রেশন LineItem.pacing.dailyMaxImpressions ক্ষেত্র।
Budget.pacing_max_spend_advertiser_micros LineItem.pacing.dailyMaxMicros ক্ষেত্র।
বাজেট.পেসিং_ডিস্ট্রিবিউশন LineItem.pacing.pacingType ক্ষেত্র।
ফ্রিকোয়েন্সি_ক্যাপ LineItem.frequencyCap ক্ষেত্র।
অংশীদার_খরচ LineItem.partnerCosts ক্ষেত্র।
লক্ষ্য_তালিকা advertisers.lineItems.bulkListLineItemAssignedTargetingOptions পদ্ধতির মাধ্যমে পুনরুদ্ধারযোগ্য।

নেতিবাচক কীওয়ার্ড তালিকা

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি NegativeKeywordList.negativeKeywordListId ক্ষেত্র।
নাম NegativeKeywordList.displayName ক্ষেত্র।
advertiser_id NegativeKeywordList.advertiserId ক্ষেত্র।

অংশীদার

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
common_data.id Partner.partnerId ক্ষেত্র।
common_data.name Partner.displayName ক্ষেত্র।
common_data.active Partner.entityStatus ক্ষেত্র।
common_data.integration_code পাওয়া যায় না।
মুদ্রা_কোড Partner.generalConfig.currencyCode ক্ষেত্র।
বিনিময়_সেটিংস Partner.exchangeConfig.enabledExchanges ক্ষেত্র।
default_partner_costs পাওয়া যায় না।
default_partner_revenue পাওয়া যায় না।
default_target_list পাওয়া যায় না।

পিক্সেল

Display & Video 360 API-এ কোনো সমতুল্য সম্পদ বা ক্ষেত্র উপলব্ধ নেই।

ইউনিভার্সাল চ্যানেল

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি Channel.channelId ক্ষেত্র।
নাম Channel.displayName ক্ষেত্র।
site_ids owner প্রকারের উপর নির্ভর করে advertisers.channels.sites.list এবং partners.channels.sites.list পদ্ধতির মাধ্যমে পুনরুদ্ধারযোগ্য।
অ্যাক্সেসিং_বিজ্ঞাপনকারীদের পাওয়া যায় না।
মুছে ফেলা হয়েছে পাওয়া যায় না।
is_brand_safe_channel পাওয়া যায় না।

ব্যবহারকারীর তালিকা

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId ফিল্ড।
নাম FirstAndThirdPartyAudience.displayName ক্ষেত্র।
ডেটা_পার্টনার_আইডি পাওয়া যায় না।
অ্যাক্সেসিং_বিজ্ঞাপনকারীদের পাওয়া যায় না।
অংশীদার_মূল্য পাওয়া যায় না।
বিজ্ঞাপনদাতা_মূল্য পাওয়া যায় না।
,

এন্টিটি রিড ফাইল (ERFs) হল একটি অংশীদারের প্রচারাভিযানের বস্তুর JSON উপস্থাপনা যা অনুরোধের ভিত্তিতে প্রতিদিন তৈরি হয় এবং Google ক্লাউড স্টোরেজের মাধ্যমে উপলব্ধ করা হয়।

ERFগুলি 2021 সালের জুনে বাতিল করা হয়েছিল ৷ 31 অক্টোবর, 2024 থেকে শুরু করে, ERFগুলি আনুষ্ঠানিকভাবে সূর্যাস্ত হবে এবং আর জেনারেট করা হবে না৷ সমস্ত বিদ্যমান এন্টিটি রিড ফাইল ব্যবহারকারীদের ডিসপ্লে এবং ভিডিও 360 রিসোর্স পুনরুদ্ধার করা চালিয়ে যাওয়ার জন্য ডিসপ্লে এবং ভিডিও 360 এপিআইতে স্থানান্তর করতে উত্সাহিত করা হচ্ছে৷

এই নির্দেশিকাটি আলোচনা করে যে কীভাবে এন্টিটি রিড ফাইল থেকে Display & Video 360 API-তে স্থানান্তর করা যায়:

  • দুটি ইন্টারফেসের মধ্যে পার্থক্যগুলির একটি ওভারভিউ দেওয়া
  • API পরিষেবাগুলির সাথে ERF টেবিলের তুলনা করা হচ্ছে
  • API এর মাধ্যমে সত্তা পুনরুদ্ধারের বিষয়ে নির্দেশিকা প্রদান করা
  • বিদ্যমান তথ্য ফাঁক স্বীকার
  • তুলনীয় API রিসোর্স ক্ষেত্রগুলিতে সমস্ত ERF ক্ষেত্রগুলির একটি ম্যাপিং উপস্থাপন করা

ওভারভিউ

ERFs থেকে Display & Video 360 API-তে স্থানান্তরিত করার সময়, বিবেচনা করার জন্য কয়েকটি মূল পার্থক্য রয়েছে, যার মধ্যে রয়েছে:

  • ডেটা সতেজতা। ERFs দৈনিক এবং বাল্ক তৈরি করা হয় যখন API একটি সম্পদের সবচেয়ে আপ-টু-ডেট সংস্করণ পুনরুদ্ধার করে।
  • সম্পদ কাঠামো। API একই রিসোর্স প্রকারের প্রতিনিধিত্ব করতে ERF-এর থেকে ভিন্ন JSON স্ট্রাকচার ব্যবহার করে। কিছু সম্পদ, যেমন পাবলিক টার্গেটিং সেটিংস, একটি ভিন্ন আইডি স্পেস ব্যবহার করতে পারে।
  • পুনরুদ্ধার পদ্ধতি। ডিসপ্লে এবং ভিডিও 360 API শুধুমাত্র ERF দ্বারা প্রদত্ত কাঁচা JSON ফাইলগুলির বিপরীতে, ব্যক্তিগতভাবে, পৃষ্ঠাযুক্ত তালিকায় বা BigQuery ডেটা স্থানান্তরের মাধ্যমে সংস্থানগুলি পুনরুদ্ধার করতে সক্ষম করে৷
  • ব্যাপ্তি। ERF-এর বিপরীতে, যা অংশীদার আইডি দ্বারা স্কোপ করা হয়, বেশিরভাগ API সংস্থান বিজ্ঞাপনদাতা আইডি দ্বারা স্কোপ করা হয়। প্রতিক্রিয়াগুলিতে অন্তর্ভুক্ত সংস্থানগুলি সেই সুযোগের মধ্যে সংস্থানগুলিতে সীমাবদ্ধ।

API এ ERF ডেটা উপস্থাপনা

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

Display & Video 360 API এই দ্বিধাবিভক্তি ব্যবহার করে না, পরিবর্তে বিভিন্ন পরিষেবার মাধ্যমে এবং বিভিন্ন JSON কাঠামো ব্যবহার করে এই সমস্ত তথ্য পুনরুদ্ধারযোগ্য করে তোলে। এই বিভাগটি ডিসপ্লে এবং ভিডিও 360 API সংস্থান এবং পরিষেবাগুলির মাধ্যমে উপলব্ধ করা সর্বজনীন এবং ব্যক্তিগত ERF টেবিলের মাধ্যমে প্রদত্ত তথ্যের তুলনা করে।

পাবলিক তথ্য

ERF পাবলিক টেবিলগুলি ব্যবহারকারীদের তাদের পুনরুদ্ধার করা ব্যক্তিগত সংস্থানগুলির লক্ষ্য নির্ধারণ সেটিংস ব্যাখ্যা করার সময় এবং UI এর মাধ্যমে আপলোড করা স্ট্রাকচার্ড ডেটা ফাইল (SDFs) সংস্করণগুলির একটি উপসেটের মাধ্যমে লক্ষ্য নির্ধারণ করার সময় ব্যবহার করার জন্য রেফারেন্স সামগ্রী সরবরাহ করে৷ এই রেফারেন্স সামগ্রীগুলি সমস্ত ব্যবহারকারীর জন্য একই এবং একটি সংখ্যাসূচক আইডি নিয়ে গঠিত, যা ম্যাপিংয়ের জন্য ব্যবহৃত হয় এবং আরও বর্ণনামূলক বিবরণ, যেমন একটি প্রদর্শন নাম৷

Display & Video 360 API ব্যবহার করার সময়, টার্গেটিং রেফারেন্স তথ্য targetingTypes.targetingOptions পরিষেবার মাধ্যমে পুনরুদ্ধার করা যেতে পারে। পাবলিক টেবিলের মতো, এই পরিষেবাটি একটি নির্দিষ্ট টার্গেটিং ধরণের জন্য আইডি এবং টার্গেটিং বিকল্পগুলির বিশদ প্রদান করে। টার্গেটিং বিকল্প আইডি পুনরুদ্ধার প্রদর্শন করে এমন একটি কোড উদাহরণের জন্য আমাদের বিদ্যমান সেট টার্গেটিং পৃষ্ঠাটি দেখুন।

পাবলিক টেবিল এবং SDF

SDF v7 এর আগে , এন্টিটি রিড ফাইল এবং স্ট্রাকচার্ড ডেটা ফাইল একই আইডি স্পেস টার্গেটিং সেটিংসের জন্য ব্যবহার করে। আপনি যদি SDF ব্যবহার করে টার্গেটিং সেটিংস ব্যাখ্যা বা বরাদ্দ করার জন্য ERF পাবলিক টেবিল ব্যবহার করে একজন SDF ব্যবহারকারী হন, তাহলে আপনি পরিবর্তে Display & Video 360 UI এর মাধ্যমে এই রেফারেন্স উপাদানটি CSV ফর্ম্যাটে ডাউনলোড করতে পারেন।

v7 দিয়ে শুরু করে , স্ট্রাকচার্ড ডেটা ফাইল কলামের একটি উপসেট দ্বারা ব্যবহৃত আইডি স্পেসগুলিকে ERF থেকে SDF ডিকপল করার জন্য এবং Display & Video 360 API-এর সাথে আরও সারিবদ্ধ করার জন্য আপডেট করা হয়েছে। আরও তথ্যের জন্য v7 মাইগ্রেশন গাইড এবং রেফারেন্স ডকুমেন্টেশন দেখুন।

ব্যক্তিগত সম্পদ

ERF ব্যক্তিগত টেবিলগুলি একজন অংশীদারের মালিকানাধীন ব্যক্তিগত সম্পদের বর্তমান সেটিংসের একটি দৈনিক স্ন্যাপশট প্রদান করে। একক অংশীদারের অধীনে তৈরি করা সম্পদের নিছক পরিমাণের কারণে, এই ফাইলগুলি খুব বড় হতে পারে এবং ডাউনলোড এবং প্রক্রিয়া করা কঠিন হতে পারে।

API-এ, প্রতিটি ব্যক্তিগত টেবিলের একটি সংশ্লিষ্ট পরিষেবা রয়েছে যা সেই সংস্থান প্রকারের পুনরুদ্ধার এবং পরিচালনার জন্য শেষ পয়েন্ট প্রদান করে। প্রতিটি পরিষেবার সংশ্লিষ্ট তালিকা পদ্ধতি ব্যবহার করে প্রচুর পরিমাণে সম্পদ পুনরুদ্ধার করা যেতে পারে। প্রতিটি সম্পদের জন্য JSON কাঠামো ERF-এর তুলনায় API-এ ভিন্ন, বিভিন্ন ক্ষেত্রের নাম এবং শেয়ার করা সম্পদ ব্যবহার করে।

রিসোর্সের ERF প্রতিনিধিত্বে উপলব্ধ কিছু তথ্য, যেমন একটি রিসোর্সের অ্যাসাইন করা টার্গেটিং সেটিংস বা চ্যানেলের সাইট , এপিআই-এ মূল রিসোর্সের সন্তান হিসাবে উপস্থাপন করা হয় এবং অতিরিক্ত API অনুরোধের মাধ্যমে পুনরুদ্ধার করা আবশ্যক।

API-এ সত্তা পুনরুদ্ধার

Display & Video 360 রিসোর্স হয় সরাসরি API অনুরোধের মাধ্যমে বা BigQuery- এ স্বয়ংক্রিয় আমদানির মাধ্যমে পুনরুদ্ধার করা যেতে পারে।

সরাসরি API অনুরোধ

প্রতিটি সংস্থান প্রকার একটি ভিন্ন API পরিষেবার মাধ্যমে পুনরুদ্ধারযোগ্য। যথাক্রমে উপযুক্ত পরিষেবার প্রাপ্ত বা তালিকা পদ্ধতি ব্যবহার করে সংস্থানগুলি পৃথকভাবে বা প্রচুর পরিমাণে পুনরুদ্ধার করা যেতে পারে। Display & Video 360 API তালিকা পদ্ধতির গুরুত্বপূর্ণ বৈশিষ্ট্যগুলির মধ্যে রয়েছে:

  • প্রয়োজনীয় সুযোগ। ERF-এর বিপরীতে, যা অংশীদার দ্বারা স্কোপ করা হয়, API-এর বেশিরভাগ সংস্থান বিজ্ঞাপনদাতার দ্বারা স্কোপ করা হয়। কোনও অংশীদারের অধীনে সমস্ত রিসোর্স প্রকার, যেমন লাইন আইটেমগুলি পুনরুদ্ধার করার জন্য সেই অংশীদারের প্রতিটি শিশু বিজ্ঞাপনদাতার জন্য একটি পৃথক তালিকা অনুরোধের প্রয়োজন হতে পারে। ব্যতিক্রমগুলির মধ্যে একজন অংশীদারের সরাসরি সন্তান, যেমন বিজ্ঞাপনদাতা এবং অংশীদার-মালিকানাধীন চ্যানেল অন্তর্ভুক্ত।
  • পৃষ্ঠা সংখ্যা এপিআই তালিকা পদ্ধতিগুলি নিশ্চিত করার জন্য পেজিনেশন নিয়োগ করে যে প্রতিক্রিয়াগুলি একটি যুক্তিসঙ্গত আকারের মধ্যে, বেশিরভাগ স্বতন্ত্র অনুরোধের প্রতিক্রিয়াগুলি বা পৃষ্ঠাগুলিকে 100টি সংস্থানে সীমাবদ্ধ করে। প্রাসঙ্গিক সংস্থানগুলির সংখ্যা পৃষ্ঠার আকারের চেয়ে বড় হলে, সম্পূর্ণ তালিকা প্রতিক্রিয়ার পরবর্তী পৃষ্ঠাগুলি পুনরুদ্ধার করতে পরপর তালিকা কলের প্রয়োজন হয়৷ একটি তালিকার প্রতিক্রিয়া পেজ করার একটি কোড উদাহরণ আমাদের টার্গেটিং গাইড পৃষ্ঠার একটি বিভাগে উপলব্ধ টার্গেটিং বিকল্পগুলি পুনরুদ্ধারের বিষয়ে প্রদান করা হয়েছে৷
  • লক্ষ্য পুনরুদ্ধারের জন্য অতিরিক্ত অনুরোধের প্রয়োজন। একটি রিসোর্সের টার্গেটিং সেটিংস এর API JSON অবজেক্টে অন্তর্ভুক্ত করা হয় না, কিন্তু এর পরিবর্তে চাইল্ড রিসোর্স অ্যাসাইন করা টার্গেটিং অপশন হিসেবে পরিচিত। এই শিশু সম্পদ একটি পৃথক অনুরোধ মাধ্যমে পুনরুদ্ধার করা আবশ্যক. উদাহরণস্বরূপ, একটি advertisers.lineItems.list অনুরোধের মাধ্যমে পুনরুদ্ধার করা প্রতিটি লাইন আইটেমের জন্য, একটি পৃথক advertisers.lineItems.bulkListAssignedTargetingOptions অনুরোধ করতে হবে সমস্ত টার্গেটিং তথ্য পুনরুদ্ধার করার জন্য৷

সম্পদ পুনরুদ্ধার অপ্টিমাইজ করুন

Display & Video 360 API-এর একাধিক অনুরোধের প্রয়োজন হতে পারে একই পরিমাণ তথ্য পুনরুদ্ধার করার জন্য যা একটি একক সত্তা রিড ফাইলে পাওয়া যায়। আপনি কীভাবে সংস্থানগুলি পুনরুদ্ধার করবেন তা অপ্টিমাইজ করা আপনার প্রয়োজনীয় ডেটা আরও দক্ষতার সাথে পুনরুদ্ধার করতে সহায়তা করতে পারে:

  • এপিআই-এ সমসাময়িক অনুরোধ করুন। Display & Video 360 API প্রকল্পের হার সীমা প্রতি বিজ্ঞাপনদাতার অনুরোধ ব্যবহার করে পরিকাঠামো রক্ষা করে। এই কোটা কাঠামো আপনাকে একাধিক বিজ্ঞাপনদাতাদের মধ্যে একটি মাল্টিথ্রেডেড সমাধান প্রয়োগ করতে দেয় যা সমস্ত প্রয়োজনীয় সংস্থান পুনরুদ্ধার করতে মোট সময় কমিয়ে দেবে। যদিও পেজিনেশনের জন্য একটি নির্দিষ্ট সুযোগের মধ্যে একটি ধরণের সমস্ত সংস্থান পরপর কলের মাধ্যমে পুনরুদ্ধার করা প্রয়োজন, অন্য স্কোপের মধ্যে বা অন্য ধরণের সংস্থানগুলি একই সাথে করা যেতে পারে।
  • শুধুমাত্র প্রাসঙ্গিক সম্পদ পুনরুদ্ধার করার জন্য আপনার তালিকা কলে প্যারামিটার দ্বারা ফিল্টার এবং অর্ডার ব্যবহার করুন । উদাহরণস্বরূপ, যদি আপনি শুধুমাত্র গত দিনে আপডেট করা লাইন আইটেমগুলিতে আগ্রহী হন, তাহলে আপনি advertisers.lineItems.list পদ্ধতির filter প্যারামিটার ব্যবহার করতে পারেন শুধুমাত্র একটি নির্দিষ্ট টাইমস্ট্যাম্পের চেয়ে বেশি updateTime সহ লাইন আইটেমগুলি ফেরত দিতে। এটি করা প্রয়োজন এমন অনুরোধের সংখ্যা উল্লেখযোগ্যভাবে হ্রাস করতে পারে।
  • অপ্রয়োজনীয় API অনুরোধ এড়াতে নিয়মিত ব্যবহৃত আইডি ক্যাশে করুন । নির্দিষ্ট রেফারেন্স তথ্য, যেমন টার্গেটিং বিকল্প আইডি এবং Google অডিয়েন্স আইডি, তুলনামূলকভাবে স্থিতিশীল এবং প্রতিটি ব্যবহারের সময় পুনরুদ্ধারের প্রয়োজন এড়াতে নিরাপদে সংরক্ষণ করা যেতে পারে। যাইহোক, বিরল পরিবর্তন বা অবনমনের জন্য অ্যাকাউন্টে ক্যাশে করা মানগুলি সাপ্তাহিক ভিত্তিতে পরীক্ষা করা উচিত।

কিভাবে দক্ষতার সাথে Display & Video 360 API অ্যাক্সেস করতে হয় সে সম্পর্কে আরও তথ্যের জন্য আমাদের কোটা অপ্টিমাইজেশন গাইড দেখুন।

BigQuery-এ আমদানি করুন

Display & Video 360 API BigQuery কানেক্টর আপনাকে দৈনিক ভিত্তিতে সরাসরি BigQuery- এ Display & Video 360 রিসোর্স কনফিগারেশন স্বয়ংক্রিয়ভাবে আমদানি করতে দেয়। Display & Video 360 API রিসোর্স ডিজাইন ব্যবহার করে কনফিগারেশনগুলি BigQuery-এ সংরক্ষণ করা হয়। API সংস্থানগুলির একটি উপসেট সমর্থিত।

Display & Video 360 API BigQuery সংযোগকারী ব্যবহার করার বিষয়ে আরও তথ্যের জন্য নিম্নলিখিত ক্লাউড ডকুমেন্টেশন দেখুন:

পরিচিত API ডেটা ফাঁক

ERF থেকে Display & Video 360 API-তে স্থানান্তরিত করার সময় আপনার সম্মুখীন হতে পারে এমন উল্লেখযোগ্য ডেটা ফাঁক রয়েছে, যেমন:

  • গল্প সন্নিবেশ আদেশ. গল্প সন্নিবেশ আদেশ API এর মাধ্যমে পুনরুদ্ধারযোগ্য নয় এবং অবশ্যই প্রদর্শন এবং ভিডিও 360 UI এর মাধ্যমে পুনরুদ্ধার করতে হবে।
  • সম্পদ ক্ষেত্রের একটি উপসেট। ডিসপ্লে ও ভিডিও 360 এপিআই-এর মাধ্যমে পুনরুদ্ধার করা সংশ্লিষ্ট সংস্থানগুলিতে ERF অবজেক্টে উপস্থিত অল্প সংখ্যক রিসোর্স ফিল্ড উপলব্ধ নেই।

পরিশিষ্ট: API এ ERF ক্ষেত্র ম্যাপিং

পাবলিক টেবিল ম্যাপিং

নীচের সারণীগুলি ডিসপ্লে ও ভিডিও 360 এপিআই-এ বিদ্যমান টার্গেটিং প্রকার এবং টার্গেটিং বিকল্প ক্ষেত্রগুলিতে ERF পাবলিক টেবিলের ক্ষেত্রগুলিকে ম্যাপ করে৷ যদিও একটি ক্ষেত্রের মান অন্য ক্ষেত্রে মানচিত্র হতে পারে, এটি গ্যারান্টি দেয় না যে তারা একই ডেটা টাইপ, এনাম মান বা আইডি স্পেস ব্যবহার করবে।

অ্যাপ সংগ্রহ

টার্গেটিং ধরনের TARGETING_TYPE_APP_CATEGORY এর অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
নাম TargetingOption.appCategoryDetails.displayName ক্ষেত্র।

ব্রাউজার

টার্গেটিং ধরনের TARGETING_TYPE_BROWSER এর অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
is_mobile পাওয়া যায় না।
নাম TargetingOption.browserDetails.displayName ক্ষেত্র।

ডেটা পার্টনার

Display & Video 360 API-এ কোনো সমতুল্য সম্পদ বা ক্ষেত্র উপলব্ধ নেই।

ডিভাইসের মানদণ্ড

TARGETING_TYPE_OPERATING_SYSTEM , TARGETING_TYPE_DEVICE_MAKE_MODEL , এবং TARGETING_TYPE_DEVICE_TYPE টার্গেটিং প্রকারের অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম DV360 API উপলব্ধতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র বা DeviceType enum।
is_mobile পাওয়া যায় না।
নাম TargetingOption.operatingSystemDetails.displayName ক্ষেত্র, TargetingOption.deviceMakeModelDetails.displayName ক্ষেত্র, অথবা DeviceType enum, টার্গেটিং প্রকারের উপর নির্ভর করে।
মানদণ্ড_প্রকার TargetingOption.targetingType ক্ষেত্র।
অপারেটিং_সিস্টেম_আইডি পাওয়া যায় না।
মোবাইল_ব্র্যান্ড_নাম পাওয়া যায় না।
মোবাইল_মডেলের_নাম পাওয়া যায় না।
mobile_make_model_id পাওয়া যায় না।
ডিভাইস_টাইপ DeviceType enum.

ভূ-অবস্থান

টার্গেটিং টাইপ TARGETING_TYPE_GEO_REGION অধীনে পুনরুদ্ধার

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
ক্যানোনিকাল_নাম TargetingOption.geoRegionDetails.displayName নেম ক্ষেত্র।
জিও_নাম পাওয়া যায় না।
দেশ_কোড পাওয়া যায় না।
অঞ্চল_কোড পাওয়া যায় না।
শহরের_নাম পাওয়া যায় না।
ডাক_নাম পাওয়া যায় না।
ডিএমএ_কোড পাওয়া যায় না।

আইএসপি

TARGETING_TYPE_CARRIER_AND_ISP টাইপের অধীনে পুনরুদ্ধারযোগ্য

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
is_mobile পাওয়া যায় না।
নাম TargetingOption.carrierAndIspDetails.displayName নেম ক্ষেত্র।
সেকেন্ডারি_ক্রিটারিয়া_আইডি TargetingOption.targetingOptionId ক্ষেত্র।

ভাষা

টার্গেটিং টাইপ TARGETING_TYPE_LANGUAGE অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
নাম পাওয়া যায় না। কোনও ভাষার জন্য সম্পূর্ণ ডিসপ্লে নাম TargetingOption.languageDetails.displayName নেম ক্ষেত্রে পাওয়া যায়।

সাইটোপ্লেসমেন্টআইডি

ডিসপ্লে এবং ভিডিও 360 এপিআইতে কোনও সমতুল্য সংস্থান বা ক্ষেত্র উপলব্ধ নেই।

সমর্থিত এক্সচেঞ্জ

টার্গেটিং টাইপ TARGETING_TYPE_EXCHANGE অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি Exchange এনাম।
নাম Exchange এনাম।

সর্বজনীন

ডিসপ্লে এবং ভিডিও 360 এপিআইতে কোনও সমতুল্য সংস্থান বা ক্ষেত্র উপলব্ধ নেই। পৃথক সাইট এবং অ্যাপ্লিকেশনগুলি যথাক্রমে TARGETING_TYPE_URL এবং TARGETING_TYPE_APP টার্গেটিং প্রকারের অধীনে সরাসরি লক্ষ্য করা যায়। ডিসপ্লে এবং ভিডিও 360 এ, যে কোনও অ্যাপ্লিকেশন বা ইউআরএল লক্ষ্য করা যায়, তবে প্রতিটি অ্যাপ্লিকেশন বা ইউআরএল রিপোর্ট করা যায় না। আপনি যদি নন-রিপোর্টযোগ্য অ্যাপ্লিকেশন এবং ইউআরএলগুলি ব্যয় থেকে সরাতে চান তবে ডিভি 360 সহায়তা কেন্দ্রের নির্দেশাবলী অনুসরণ করুন।

ব্যক্তিগত টেবিল ফিল্ড ম্যাপিং

নীচের সারণীগুলি ERF ব্যক্তিগত টেবিলগুলির ক্ষেত্রগুলিকে বিদ্যমান ক্ষেত্র বা পরিষেবাগুলিতে প্রদর্শন এবং ভিডিও 360 এপিআইতে মানচিত্র করে। যদিও একটি ক্ষেত্রের মান অন্যটিতে মানচিত্র করতে পারে, এটি গ্যারান্টি দেয় না যে তারা একই ডেটা টাইপ, এনাম মান বা আইডি স্পেস ব্যবহার করে।

বিজ্ঞাপনদাতা

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি Advertiser.advertiserId ফিল্ড।
কমন_ডাটা.নাম Advertiser.displayName নেম ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ Advertiser.entityStatus ফিল্ড।
কমন_ডাটা.ইন্টগ্রেশন_কোড Advertiser.integrationDetails.integrationCode ।
অংশীদার_আইডি Advertiser.partnerId ক্ষেত্র।
মুদ্রা_কোড Advertiser.generalConfig.currencyCode কনফিগ.কুরেন্সি কোড ক্ষেত্র।
টাইমজোন_কোড Advertiser.generalConfig.timeZone ফিল্ড।
landing_page_url Advertiser.generalConfig.domainUrl কনফিগ.ডোমাইনুরল ফিল্ড।
উপলভ্য_চ্যানেল_ডস advertisers.channels.list মাধ্যমে পুনরুদ্ধারযোগ্য। চ্যানেলস.লিস্ট পদ্ধতি।
ব্ল্যাকলিস্ট_চ্যানেল_আইডি advertisers.targetingTypes.assignedtargetingOptions.list মাধ্যমে পুনরুদ্ধারযোগ্য TARGETING_TYPE_CHANNEL যদি AssignedTargetingOption.channelDetails.negative সত্য, চ্যানেলটি নেতিবাচকভাবে লক্ষ্যযুক্ত।
dcm_configration পাওয়া যায় না।
dcm_network_id Advertiser.adServerConfig.cmHybridConfig.cmAccountId ক্ষেত্র।
dcm_advertiser_id Advertiser.adServerConfig.cmHybridConfig.cmAdvertiserIds ।
ডিসিএম_ফ্লুডলাইট_গ্রুপ_আইডি Advertiser.adServerConfig.cmHybridConfig.cmFloodlightConfigId কনফিগিড ক্ষেত্র।
dcm_syncable_site_ids Advertiser.adServerConfig.cmHybridConfig.cmSyncableSiteIds ফিল্ড।
সক্ষম_ওবিএ_ট্যাগগুলি সক্ষম করুন পাওয়া যায় না।

প্রচারণা

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি Campaign.campaignId ফিল্ড।
কমন_ডাটা.নাম Campaign.displayName ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ Campaign.entityStatus ।
কমন_ডাটা.ইন্টগ্রেশন_কোড পাওয়া যায় না।
advertiser_id Campaign.advertiserId ।
বাজেট Campaign.campaignFlight এবং Campaign.campaignBudgets ।
ফ্রিকোয়েন্সি_ক্যাপ Campaign.frequencyCap ক্যাপ ফিল্ড।
Default_target_list advertisers.campaigns.bulkListCampaignAssignedTargetingOptions মাধ্যমে পুনরুদ্ধারযোগ্য C
use_video_creatives পাওয়া যায় না।
ব্যবহার_ডিসপ্লে_ক্রিয়েটিভস পাওয়া যায় না।
ব্যবহার_আডিয়ো_ক্রিটাইভস পাওয়া যায় না।
উদ্দেশ্য Campaign.campaignGoal.campaignGoalType ক্ষেত্র।
মেট্রিক Campaign.campaignGoal.performanceGoal.performanceGoalType ক্ষেত্র।
উদ্দেশ্য_ডেসক্রিপশন Campaign.campaignGoal.performanceGoal.performanceGoalString স্ট্রিং ক্ষেত্র
মেট্রিক_আমাউন্ট_মিক্রোস Campaign.campaignGoal.performanceGoal.performanceGoalAmountMicros ফিল্ড।

সৃজনশীল

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি Creative.creativeId ক্ষেত্র।
কমন_ডাটা.নাম Creative.displayName ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ Creative.entityStatus ক্ষেত্র।
কমন_ডাটা.ইন্টগ্রেশন_কোড Creative.integrationCode ক্ষেত্র।
advertiser_id Creative.advertiserId ক্ষেত্র।
ডিসিএম_প্লেসমেন্ট_আইডি Creative.cmPlacementId ক্ষেত্র।
প্রস্থ_পিক্সেল Creative.dimensions.widthPixels ক্ষেত্র।
উচ্চতা_পিক্সেল Creative.dimensions.heightPixels ক্ষেত্র।
অনুমোদন_স্ট্যাটাস Creative.reviewStatus ফিল্ড।
প্রসারিত_ নির্দেশিকা Creative.expandingDirection ডাইরেকশন ফিল্ড।
ক্রিয়েটিভ_ টাইপ Creative.creativeType ক্ষেত্র।

কাস্টম্যাফিনিটি

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি CustomList.customListId ক্ষেত্র।
নাম CustomList.displayName ক্ষেত্র।
বর্ণনা পাওয়া যায় না।
advertiser_id পাওয়া যায় না।

প্লাবনলাইটঅ্যাক্টিভিটি

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি FloodlightActivity.floodlightActivityId ক্ষেত্র।
কমন_ডাটা.নাম FloodlightActivity.displayName নেম ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ FloodlightActivity.servingStatus ফিল্ড।
কমন_ডাটা.ইন্টগ্রেশন_কোড পাওয়া যায় না।
advertiser_id FloodlightActivity.advertiserIds ফিল্ড প্রদত্ত অংশীদারটির অধীনে প্লাবনলাইট ক্রিয়াকলাপে অ্যাক্সেস সহ সমস্ত বিজ্ঞাপনদাতাদের তালিকাভুক্ত করে।
অংশীদার_আইডি floodlightGroups.floodlightActivities সার্ভিসে একটি অনুরোধ করার সময় ব্যবহারকারী দ্বারা সরবরাহ করা।
পুনর্বিবেচনা_এনএবলড FloodlightActivity.remarketingConfigs ফিল্ড প্রদত্ত অংশীদারটির অধীনে প্লাবনলাইট ক্রিয়াকলাপে অ্যাক্সেস সহ প্রতিটি বিজ্ঞাপনদাতার জন্য এই কনফিগারেশনটি তালিকাভুক্ত করে।
ssl_required FloodlightActivity.sslRequired ক্ষেত্র।

সন্নিবেশ অর্ডার

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি InsertionOrder.insertionOrderId ক্ষেত্র।
কমন_ডাটা.নাম InsertionOrder.displayName ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ InsertionOrder.entityStatus ক্ষেত্র।
কমন_ডাটা.ইন্টগ্রেশন_কোড InsertionOrder.integrationDetails.integrationCode ।
advertiser_id InsertionOrder.advertiserId ক্ষেত্র।
ক্যাম্পেইন_আইডি InsertionOrder.campaignId ফিল্ড।
সামগ্রিক_বজেট পাওয়া যায় না। InsertionOrder.budget.budgetSegments ফিল্ডের সামগ্রী ব্যবহার করে গণনা করা যেতে পারে।
তফসিল_সেগমেন্টস InsertionOrder.budget.budgetSegments ফিল্ড।
ফ্রিকোয়েন্সি_ক্যাপ InsertionOrder.frequencyCap ক্যাপ ক্ষেত্র।
Default_partner_costs InsertionOrder.partnerCosts ক্ষেত্র।
Default_target_list advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions মাধ্যমে পুনরুদ্ধারযোগ্য n

ইনভেন্টরিসোর্স

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি InventorySource.inventorySourceId ক্ষেত্র।
অশ্রেণীবদ্ধ পাওয়া যায় না।
ইনভেন্টরি_নাম InventorySource.displayName ক্ষেত্র।
এক্সচেঞ্জ_আইডি InventorySource.exchange ক্ষেত্র।
অ্যাক্সেস_ডভার্টাইজার InventorySource.readWriteAccessors রাইট আইসেসরস এবং InventorySource.readAdvertiserIds ক্ষেত্রগুলি।
বাহ্যিক_আইডি InventorySource.dealId ক্ষেত্র।
min_cpm_micros InventorySource.rateDetails.rate.nanos ফিল্ড, InventorySource.rateDetails.inventorySourceRateType টাইপ ফিল্ডের মানের উপর নির্ভর করে।
MIN_CPM_CURRENCY_CODE InventorySource.rateDetails.rate.currencyCode কোড ফিল্ড।

লাইন আইটেম

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি LineItem.lineItemId ক্ষেত্র।
কমন_ডাটা.নাম LineItem.displayName নেম ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ LineItem.entityStatus ফিল্ড।
কমন_ডাটা.ইন্টগ্রেশন_কোড LineItem.integrationDetails.integrationCode ক্ষেত্র।
লাইন_আইটিএম_ টাইপ LineItem.lineItemType ক্ষেত্র।
সন্নিবেশ_র্ডার_আইডি LineItem.insertionOrderId অর্ডারআইডি ক্ষেত্র।
ক্রিয়েটিভ_ডস LineItem.creativeIds ক্ষেত্র।
max_cpm_advertiser_micros LineItem.bidStrategy.maximizeSpendAutoBid.maxAverageCpmBidAmountMicros বা LineItem.bidStrategy.performanceGoalAutoBid.maxAverageCpmBidAmountMicros ক্ষেত্রগুলি ব্যবহৃত কৌশল স্কিমের উপর নির্ভর করে।
পারফরম্যান্স_গোল LineItem.bidStrategy.maximizeSpendAutoBid.performanceGoalType বা LineItem.bidStrategy.performanceGoalAutoBid.performanceGoalType ক্ষেত্রগুলি, ব্যবহৃত কৌশল প্রকল্পের উপর নির্ভর করে।
লক্ষ্য_এডভার্টাইজার_মিক্রোস LineItem.bidStrategy.performanceGoalAutoBid.performanceGoalAmountMicros ক্ষেত্র।
অংশীদার_রেভেনু_মোডেল LineItem.partnerRevenueModel ক্ষেত্র।
COST_TRACKING_PIXELS LineItem.conversionCounting.floodlightActivityConfigs কনফিগস ফিল্ড।
বাজেট.স্টার্ট_টাইম_উসেক LineItem.flight.dateRange.startDate ক্ষেত্র।
বাজেট.এন্ড_টাইম_উসেক LineItem.flight.dateRange.endDate ক্ষেত্র।
বাজেট.ম্যাক্স_আইপিআরপিএস LineItem.budget.maxAmount ফিল্ড যদি LineItem.budget.budgetUnit হ'ল BUDGET_UNIT_IMPRESSIONS ।
বাজেট LineItem.budget.maxAmount ফিল্ড যদি LineItem.budget.budgetUnit BUDGET_UNIT_CURRENCY ।
বাজেট.প্যাকিং_ টাইপ LineItem.pacing.pacingPeriod ক্ষেত্র।
বাজেট.প্যাকিং_ম্যাক্স_আইপিআরপিএস LineItem.pacing.dailyMaxImpressions ক্ষেত্র।
বাজেট LineItem.pacing.dailyMaxMicros ক্ষেত্র।
বাজেট.প্যাকিং_ডিস্ট্রিবিউশন LineItem.pacing.pacingType টাইপ ক্ষেত্র।
ফ্রিকোয়েন্সি_ক্যাপ LineItem.frequencyCap ক্যাপ ফিল্ড।
অংশীদার_কস্টস LineItem.partnerCosts ফিল্ড।
টার্গেট_লিস্ট advertisers.lineItems.bulkListLineItemAssignedTargetingOptions মাধ্যমে পুনরুদ্ধার

নেতিবাচককওয়ার্ডলিস্ট

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি NegativeKeywordList.negativeKeywordListId ক্ষেত্র।
নাম NegativeKeywordList.displayName ক্ষেত্র।
advertiser_id NegativeKeywordList.advertiserId ক্ষেত্র।

অংশীদার

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি Partner.partnerId ক্ষেত্র।
কমন_ডাটা.নাম Partner.displayName ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ Partner.entityStatus ফিল্ড।
কমন_ডাটা.ইন্টগ্রেশন_কোড পাওয়া যায় না।
মুদ্রা_কোড Partner.generalConfig.currencyCode কোড ক্ষেত্র।
এক্সচেঞ্জ_সেটেটিং Partner.exchangeConfig.enabledExchanges ক্ষেত্র।
Default_partner_costs পাওয়া যায় না।
Default_partner_revenue পাওয়া যায় না।
Default_target_list পাওয়া যায় না।

পিক্সেল

ডিসপ্লে এবং ভিডিও 360 এপিআইতে কোনও সমতুল্য সংস্থান বা ক্ষেত্র উপলব্ধ নেই।

ইউনিভার্সাল চ্যানেল

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি Channel.channelId ক্ষেত্র।
নাম Channel.displayName ক্ষেত্র।
সাইট_ডস advertisers.channels.sites.list মাধ্যমে owner partners.channels.sites.list
অ্যাক্সেস_ডভার্টাইজার পাওয়া যায় না।
is_deleded পাওয়া যায় না।
is_brand_safe_channel পাওয়া যায় না।

ব্যবহারকারীর তালিকা

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId ক্ষেত্র।
নাম FirstAndThirdPartyAudience.displayName ক্ষেত্র।
ডেটা_পার্টনার_আইডি পাওয়া যায় না।
অ্যাক্সেস_ডভার্টাইজার পাওয়া যায় না।
অংশীদার_প্রসিং পাওয়া যায় না।
বিজ্ঞাপনদাতা_প্রসিংস পাওয়া যায় না।
,

সত্তা রিড ফাইলগুলি (ইআরএফএস) হ'ল অংশীদারদের প্রচারের অবজেক্টগুলির জেএসএন উপস্থাপনা যা অনুরোধে, প্রতিদিন উত্পন্ন হয় এবং গুগল ক্লাউড স্টোরেজের মাধ্যমে উপলব্ধ করা হয়।

ইআরএফগুলি 2021 সালের জুনে অবমূল্যায়ন করা হয়েছিল । 31 অক্টোবর, 2024 থেকে, ইআরএফগুলি আনুষ্ঠানিকভাবে সূর্যাস্ত হবে এবং আর উত্পন্ন হবে না। সমস্ত বিদ্যমান সত্তা রিড ফাইল ব্যবহারকারীরা ডিসপ্লে এবং ভিডিও 360 সংস্থান পুনরুদ্ধার চালিয়ে যাওয়ার জন্য ডিসপ্লে এবং ভিডিও 360 এপিআইতে স্থানান্তর করতে উত্সাহিত হয়।

এই গাইডটি কীভাবে সত্তা পড়ার ফাইলগুলি থেকে ডিসপ্লে এবং ভিডিও 360 এপিআইতে স্থানান্তর করতে পারে তা নিয়ে আলোচনা করে:

  • দুটি ইন্টারফেসের মধ্যে পার্থক্যগুলির একটি ওভারভিউ দেওয়া
  • ERF টেবিলগুলি এপিআই পরিষেবাদির সাথে তুলনা করা
  • এপিআইয়ের মাধ্যমে সত্তা পুনরুদ্ধার সম্পর্কে গাইডেন্স প্রদান
  • বিদ্যমান ডেটা ফাঁকগুলি স্বীকার করা
  • তুলনীয় এপিআই রিসোর্স ক্ষেত্রগুলিতে সমস্ত ইআরএফ ক্ষেত্রের একটি ম্যাপিং উপস্থাপন করা

ওভারভিউ

ইআরএফ থেকে ডিসপ্লে এবং ভিডিও 360 এপিআইতে স্থানান্তরিত করার সময়, বিবেচনা করার মতো অনেকগুলি মূল পার্থক্য রয়েছে:

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

এপিআইতে ERF ডেটা উপস্থাপনা

সত্তা পঠন ফাইলগুলি "পাবলিক" এবং "ব্যক্তিগত" টেবিলগুলিতে পৃথক করা হয়। পাবলিক টেবিলগুলি এমন তথ্য সরবরাহ করে যা সমস্ত ব্যবহারকারীর জন্য উপলব্ধ এবং প্রযোজ্য যেমন মানগুলি লক্ষ্য করে। ব্যক্তিগত টেবিলগুলি এমন কোনও ডেটা সরবরাহ করে যা কোনও অংশীদারের জন্য নির্দিষ্ট, যেমন সৃজনশীল বা লাইন আইটেম সংস্থান।

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

পাবলিক তথ্য

ইআরএফ পাবলিক টেবিলগুলি ব্যবহারকারীদের তাদের পুনরুদ্ধার করা বেসরকারী সংস্থানগুলির টার্গেটিং সেটিংস ব্যাখ্যা করার সময় এবং ইউআইয়ের মাধ্যমে আপলোড করা কাঠামোগত ডেটা ফাইলগুলির (এসডিএফএস) সংস্করণগুলির একটি উপসেটের মাধ্যমে লক্ষ্য নির্ধারণের সময় ব্যবহারকারীদের জন্য রেফারেন্স উপকরণ সরবরাহ করে। এই রেফারেন্স উপকরণগুলি সমস্ত ব্যবহারকারীর জন্য একই এবং ম্যাপিংয়ের জন্য ব্যবহৃত একটি সংখ্যাসূচক আইডি এবং আরও বর্ণনামূলক বিবরণ যেমন প্রদর্শনের নাম রয়েছে।

ডিসপ্লে এবং ভিডিও 360 এপিআই ব্যবহার করার সময়, টার্গেটিং রেফারেন্স তথ্যগুলি টার্গেটিং targetingTypes.targetingOptions পরিষেবার মাধ্যমে পুনরুদ্ধার করা যেতে পারে। পাবলিক টেবিলগুলির মতো, এই পরিষেবাটি নির্দিষ্ট টার্গেটিং ধরণের জন্য আইডিএস এবং টার্গেটিং বিকল্পগুলির বিশদ সরবরাহ করে। টার্গেটিং বিকল্প আইডি পুনরুদ্ধার প্রদর্শন করে একটি কোড উদাহরণের জন্য আমাদের বিদ্যমান সেট টার্গেটিং পৃষ্ঠাটি দেখুন।

পাবলিক টেবিল এবং এসডিএফ

এসডিএফ ভি 7 এর আগে , সত্তা ফাইল এবং স্ট্রাকচার্ড ডেটা ফাইলগুলি সেটিংসকে লক্ষ্য করার জন্য একই আইডি স্পেস ব্যবহার করে। আপনি যদি এসডিএফ ব্যবহার করে টার্গেট সেটিংসের ব্যাখ্যা বা নির্ধারণের জন্য ইআরএফ পাবলিক টেবিলগুলি ব্যবহার করে কোনও এসডিএফ ব্যবহারকারী হন তবে আপনি পরিবর্তে এই রেফারেন্স উপাদানটি সিএসভি ফর্ম্যাটে ডিসপ্লে এবং ভিডিও 360 ইউআইয়ের মাধ্যমে ডাউনলোড করতে পারেন।

ভি 7 দিয়ে শুরু করে , কাঠামোগত ডেটা ফাইল কলামগুলির একটি উপসেট দ্বারা ব্যবহৃত আইডি স্পেসগুলি ERFS থেকে এসডিএফকে ডিকলপল করার জন্য আপডেট করা হয়েছে এবং ডিসপ্লে এবং ভিডিও 360 এপিআইয়ের সাথে আরও সারিবদ্ধ হয়েছে। আরও তথ্যের জন্য ভি 7 মাইগ্রেশন গাইড এবং রেফারেন্স ডকুমেন্টেশন দেখুন।

ব্যক্তিগত সম্পদ

ইআরএফ প্রাইভেট টেবিলগুলি অংশীদার দ্বারা মালিকানাধীন বেসরকারী সংস্থার বর্তমান সেটিংসের একটি দৈনিক স্ন্যাপশট সরবরাহ করে। একক অংশীদারের অধীনে তৈরি করা যেতে পারে এমন সংস্থানগুলির নিখুঁত পরিমাণের কারণে, এই ফাইলগুলি ডাউনলোড এবং প্রক্রিয়া করা খুব বড় এবং কঠিন হতে পারে।

এপিআই -তে, প্রতিটি ব্যক্তিগত টেবিলের একটি সম্পর্কিত পরিষেবা রয়েছে যা সেই সংস্থান প্রকারের পুনরুদ্ধার এবং পরিচালনার জন্য শেষ পয়েন্ট সরবরাহ করে। প্রতিটি পরিষেবার সম্পর্কিত তালিকা পদ্ধতি ব্যবহার করে সংস্থানগুলি বাল্কে পুনরুদ্ধার করা যেতে পারে। প্রতিটি সংস্থার জন্য জেএসএন কাঠামো ইআরএফের তুলনায় এপিআইতে পৃথক পৃথক ক্ষেত্রের নাম এবং ভাগ করা সংস্থানগুলি ব্যবহার করে।

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

এপিআইতে সত্তা পুনরুদ্ধার

প্রদর্শন এবং ভিডিও 360 সংস্থানগুলি হয় সরাসরি এপিআই অনুরোধগুলি বা বিগকোয়ারিতে স্বয়ংক্রিয় আমদানির মাধ্যমে পুনরুদ্ধার করা যেতে পারে।

সরাসরি API অনুরোধ

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

  • প্রয়োজনীয় সুযোগ। অংশীদার দ্বারা স্কোপ করা ইআরএফএসের বিপরীতে, এপিআইয়ের বেশিরভাগ সংস্থান বিজ্ঞাপনদাতা দ্বারা স্কোপ করা হয়। অংশীদারের অধীনে লাইন আইটেমগুলির মতো সমস্ত রিসোর্স প্রকার পুনরুদ্ধার করার জন্য সেই অংশীদারের প্রতিটি শিশু বিজ্ঞাপনদাতার জন্য পৃথক তালিকার অনুরোধের প্রয়োজন হতে পারে। ব্যতিক্রমগুলির মধ্যে কোনও অংশীদারের সরাসরি শিশু যেমন বিজ্ঞাপনদাতা এবং অংশীদার মালিকানাধীন চ্যানেল অন্তর্ভুক্ত।
  • পৃষ্ঠা সংখ্যা এপিআই তালিকা পদ্ধতিগুলি গ্যারান্টি দেওয়ার জন্য পৃষ্ঠাগুলি নিয়োগ করে যে প্রতিক্রিয়াগুলি একটি যুক্তিসঙ্গত আকারের মধ্যে রয়েছে, বেশিরভাগ পৃথক অনুরোধের প্রতিক্রিয়া বা পৃষ্ঠাগুলিকে 100 টি সংস্থানগুলিতে সীমাবদ্ধ করে। যদি প্রাসঙ্গিক সংস্থানগুলির সংখ্যা পৃষ্ঠার আকারের চেয়ে বড় হয় তবে পূর্ণ তালিকার প্রতিক্রিয়ার পরবর্তী পৃষ্ঠাগুলি পুনরুদ্ধার করতে টানা তালিকা কলগুলির প্রয়োজন। একটি কোড উদাহরণ পেজিং একটি তালিকার প্রতিক্রিয়া উপলব্ধ টার্গেটিং বিকল্পগুলি পুনরুদ্ধার সম্পর্কিত আমাদের টার্গেটিং গাইড পৃষ্ঠার একটি বিভাগে সরবরাহ করা হয়।
  • পুনরুদ্ধারের লক্ষ্যবস্তু করার জন্য অতিরিক্ত অনুরোধগুলি প্রয়োজন। একটি রিসোর্সের টার্গেটিং সেটিংস তার এপিআই জেএসএন অবজেক্টে অন্তর্ভুক্ত নয়, বরং পরিবর্তে শিশু সংস্থানগুলি নির্ধারিত টার্গেটিং বিকল্প হিসাবে পরিচিত। এই শিশু সংস্থানগুলি অবশ্যই পৃথক অনুরোধের মাধ্যমে পুনরুদ্ধার করতে হবে। উদাহরণস্বরূপ, advertisers.lineItems.bulkListAssignedTargetingOptions advertisers.lineItems.list মাধ্যমে পুনরুদ্ধার করা প্রতিটি লাইন আইটেমের জন্য List

রিসোর্স পুনরুদ্ধার অনুকূলিত করুন

ডিসপ্লে এবং ভিডিও 360 এপিআইয়ের জন্য একক সত্তা রিড ফাইলে উপলভ্য একই পরিমাণ তথ্য পুনরুদ্ধার করতে একাধিক অনুরোধের প্রয়োজন হতে পারে। আপনি কীভাবে সংস্থানগুলি পুনরুদ্ধার করবেন তা অনুকূলিতকরণ আপনার প্রয়োজনীয় ডেটা আরও দক্ষতার সাথে পুনরুদ্ধার করতে সহায়তা করতে পারে:

  • এপিআইতে একযোগে অনুরোধ করুন। ডিসপ্লে এবং ভিডিও 360 এপিআই প্রকল্পের হারের সীমা প্রতি বিজ্ঞাপনদাতাকে অনুরোধ ব্যবহার করে অবকাঠামো রক্ষা করে। এই কোটা কাঠামোটি আপনাকে একাধিক বিজ্ঞাপনদাতাদের জুড়ে একটি মাল্টিথ্রেডেড সমাধান প্রয়োগ করতে দেয় যা সমস্ত প্রয়োজনীয় সংস্থান পুনরুদ্ধার করতে মোট সময়কে হ্রাস করবে। যদিও পৃষ্ঠাগুলির প্রয়োজন হয় যে নির্দিষ্ট স্কোপের মধ্যে কোনও ধরণের সমস্ত সংস্থান টানা কলগুলির মাধ্যমে পুনরুদ্ধার করা হয়, অন্য স্কোপের মধ্যে বা অন্য কোনও ধরণের সংস্থান পুনরুদ্ধার একই সাথে করা যেতে পারে।
  • কেবলমাত্র প্রাসঙ্গিক সংস্থান পুনরুদ্ধার করতে আপনার তালিকার কলগুলিতে প্যারামিটারগুলি দ্বারা ফিল্টার এবং অর্ডার ব্যবহার করুন । উদাহরণস্বরূপ, আপনি যদি শেষ দিনে আপডেট হওয়া লাইন আইটেমগুলিতে কেবল আগ্রহী হন তবে আপনি advertisers.lineItems.list filter প্যারামিটার ব্যবহার করতে পারেন Linelineitems.list পদ্ধতিটি কেবলমাত্র প্রদত্ত টাইমস্ট্যাম্পের চেয়ে বেশি updateTime সহ লাইন আইটেমগুলি ফিরিয়ে দিতে। এটি যে অনুরোধগুলি করা দরকার তা উল্লেখযোগ্যভাবে হ্রাস করতে পারে।
  • অপ্রয়োজনীয় এপিআই অনুরোধগুলি এড়াতে ক্যাশে নিয়মিত আইডি ব্যবহার করে । কিছু রেফারেন্স তথ্য, যেমন বিকল্প আইডি এবং গুগল শ্রোতার আইডিগুলিকে লক্ষ্য করে তুলনামূলকভাবে স্থিতিশীল এবং প্রতিটি ব্যবহারের পরে পুনরুদ্ধারের প্রয়োজনীয়তা এড়াতে নিরাপদে সংরক্ষণ করা যেতে পারে। যাইহোক, ক্যাশেড মানগুলি বিরল পরিবর্তন বা অবমূল্যায়নের জন্য অ্যাকাউন্টে সাপ্তাহিক ভিত্তিতে পরীক্ষা করা উচিত।

কীভাবে ডিসপ্লে এবং ভিডিও 360 এপিআই দক্ষতার সাথে অ্যাক্সেস করবেন সে সম্পর্কে আরও তথ্যের জন্য আমাদের কোটা অপ্টিমাইজেশন গাইড দেখুন।

বিগকোয়ারিতে আমদানি করুন

ডিসপ্লে এবং ভিডিও 360 এপিআই বিগকিউরি সংযোগকারী আপনাকে স্বয়ংক্রিয়ভাবে ডিসপ্লে এবং ভিডিও 360 রিসোর্স কনফিগারেশনগুলিকে প্রতিদিনের ভিত্তিতে সরাসরি বিগকোয়ারিতে আমদানি করতে দেয়। কনফিগারেশনগুলি ডিসপ্লে এবং ভিডিও 360 এপিআই রিসোর্স ডিজাইন ব্যবহার করে বিগকোয়ারিতে সংরক্ষণ করা হয়। এপিআই সংস্থানগুলির একটি উপসেট সমর্থিত।

ডিসপ্লে এবং ভিডিও 360 এপিআই বিগকিউরি সংযোগকারী ব্যবহার সম্পর্কে আরও তথ্যের জন্য নিম্নলিখিত ক্লাউড ডকুমেন্টেশন দেখুন:

পরিচিত এপিআই ডেটা ফাঁক

ERF থেকে ডিসপ্লে এবং ভিডিও 360 এপিআইতে স্থানান্তরিত করার সময় আপনি যে উল্লেখযোগ্য ডেটা ফাঁকগুলির মুখোমুখি হতে পারেন, যেমন:

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

পরিশিষ্ট: এপিআই থেকে ইআরএফ ক্ষেত্রগুলি ম্যাপিং

পাবলিক টেবিল ম্যাপিং

নীচের টেবিলগুলি ERF পাবলিক টেবিলগুলির ক্ষেত্রগুলিকে বিদ্যমান লক্ষ্যমাত্রার প্রকারগুলিতে এবং টার্গেটিং বিকল্প ক্ষেত্রগুলিতে প্রদর্শন এবং ভিডিও 360 এপিআইতে মানচিত্র করে। যদিও একটি ক্ষেত্রের মান অন্যটিতে মানচিত্র করতে পারে, এটি গ্যারান্টি দেয় না যে তারা একই ডেটা টাইপ, এনাম মান বা আইডি স্পেস ব্যবহার করে।

অ্যাপ্লিকেশন সংগ্রহ

TARGETING_TYPE_APP_CATEGORY টাইপের অধীনে পুনরুদ্ধারযোগ্য

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
নাম TargetingOption.appCategoryDetails.displayName নেম ক্ষেত্র।

ব্রাউজার

টার্গেটিং টাইপ TARGETING_TYPE_BROWSER অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
is_mobile পাওয়া যায় না।
নাম TargetingOption.browserDetails.displayName নেম ক্ষেত্র।

ডেটাপার্টনার

ডিসপ্লে এবং ভিডিও 360 এপিআইতে কোনও সমতুল্য সংস্থান বা ক্ষেত্র উপলব্ধ নেই।

ডিভাইসক্রিটারিয়া

লক্ষ্যমাত্রার অধীনে পুনরুদ্ধারযোগ্য TARGETING_TYPE_OPERATING_SYSTEM , TARGETING_TYPE_DEVICE_MAKE_MODEL , এবং TARGETING_TYPE_DEVICE_TYPE ।

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র বা DeviceType এনাম।
is_mobile পাওয়া যায় না।
নাম TargetingOption.operatingSystemDetails.displayName নেম ক্ষেত্র, TargetingOption.deviceMakeModelDetails.displayName নেম ক্ষেত্র, বা DeviceType এনাম, লক্ষ্যমাত্রার উপর নির্ভর করে।
মানদণ্ড_ টাইপ TargetingOption.targetingType ক্ষেত্র।
অপারেটিং_সিস্টেম_আইডি পাওয়া যায় না।
মোবাইল_ব্র্যান্ড_নাম পাওয়া যায় না।
মোবাইল_মোডেল_নাম পাওয়া যায় না।
মোবাইল_মেক_মোডেল_আইডি পাওয়া যায় না।
ডিভাইস_টাইপ DeviceType এনাম।

ভূ-অবস্থান

টার্গেটিং টাইপ TARGETING_TYPE_GEO_REGION অধীনে পুনরুদ্ধার

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
ক্যানোনিকাল_নাম TargetingOption.geoRegionDetails.displayName নেম ক্ষেত্র।
জিও_নাম পাওয়া যায় না।
দেশ_কোড পাওয়া যায় না।
অঞ্চল_কোড পাওয়া যায় না।
শহরের_নাম পাওয়া যায় না।
ডাক_নাম পাওয়া যায় না।
ডিএমএ_কোড পাওয়া যায় না।

আইএসপি

TARGETING_TYPE_CARRIER_AND_ISP টাইপের অধীনে পুনরুদ্ধারযোগ্য

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
is_mobile পাওয়া যায় না।
নাম TargetingOption.carrierAndIspDetails.displayName নেম ক্ষেত্র।
সেকেন্ডারি_ক্রিটারিয়া_আইডি TargetingOption.targetingOptionId ক্ষেত্র।

ভাষা

টার্গেটিং টাইপ TARGETING_TYPE_LANGUAGE অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি TargetingOption.targetingOptionId ক্ষেত্র।
নাম পাওয়া যায় না। কোনও ভাষার জন্য সম্পূর্ণ ডিসপ্লে নাম TargetingOption.languageDetails.displayName নেম ক্ষেত্রে পাওয়া যায়।

সাইটোপ্লেসমেন্টআইডি

ডিসপ্লে এবং ভিডিও 360 এপিআইতে কোনও সমতুল্য সংস্থান বা ক্ষেত্র উপলব্ধ নেই।

সমর্থিত এক্সচেঞ্জ

টার্গেটিং টাইপ TARGETING_TYPE_EXCHANGE অধীনে পুনরুদ্ধারযোগ্য।

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি Exchange এনাম।
নাম Exchange এনাম।

সর্বজনীন

ডিসপ্লে এবং ভিডিও 360 এপিআইতে কোনও সমতুল্য সংস্থান বা ক্ষেত্র উপলব্ধ নেই। পৃথক সাইট এবং অ্যাপ্লিকেশনগুলি যথাক্রমে TARGETING_TYPE_URL এবং TARGETING_TYPE_APP টার্গেটিং প্রকারের অধীনে সরাসরি লক্ষ্য করা যায়। ডিসপ্লে এবং ভিডিও 360 এ, যে কোনও অ্যাপ্লিকেশন বা ইউআরএল লক্ষ্য করা যায়, তবে প্রতিটি অ্যাপ্লিকেশন বা ইউআরএল রিপোর্ট করা যায় না। আপনি যদি নন-রিপোর্টযোগ্য অ্যাপ্লিকেশন এবং ইউআরএলগুলি ব্যয় থেকে সরাতে চান তবে ডিভি 360 সহায়তা কেন্দ্রের নির্দেশাবলী অনুসরণ করুন।

ব্যক্তিগত টেবিল ফিল্ড ম্যাপিং

নীচের সারণীগুলি ERF ব্যক্তিগত টেবিলগুলির ক্ষেত্রগুলিকে বিদ্যমান ক্ষেত্র বা পরিষেবাগুলিতে প্রদর্শন এবং ভিডিও 360 এপিআইতে মানচিত্র করে। যদিও একটি ক্ষেত্রের মান অন্যটিতে মানচিত্র করতে পারে, এটি গ্যারান্টি দেয় না যে তারা একই ডেটা টাইপ, এনাম মান বা আইডি স্পেস ব্যবহার করে।

বিজ্ঞাপনদাতা

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি Advertiser.advertiserId ফিল্ড।
কমন_ডাটা.নাম Advertiser.displayName নেম ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ Advertiser.entityStatus ফিল্ড।
কমন_ডাটা.ইন্টগ্রেশন_কোড Advertiser.integrationDetails.integrationCode ।
অংশীদার_আইডি Advertiser.partnerId ক্ষেত্র।
মুদ্রা_কোড Advertiser.generalConfig.currencyCode কনফিগ.কুরেন্সি কোড ক্ষেত্র।
টাইমজোন_কোড Advertiser.generalConfig.timeZone ফিল্ড।
landing_page_url Advertiser.generalConfig.domainUrl কনফিগ.ডোমাইনুরল ফিল্ড।
উপলভ্য_চ্যানেল_ডস advertisers.channels.list মাধ্যমে পুনরুদ্ধারযোগ্য। চ্যানেলস.লিস্ট পদ্ধতি।
ব্ল্যাকলিস্ট_চ্যানেল_আইডি advertisers.targetingTypes.assignedtargetingOptions.list মাধ্যমে পুনরুদ্ধারযোগ্য TARGETING_TYPE_CHANNEL যদি AssignedTargetingOption.channelDetails.negative সত্য, চ্যানেলটি নেতিবাচকভাবে লক্ষ্যযুক্ত।
dcm_configration পাওয়া যায় না।
dcm_network_id Advertiser.adServerConfig.cmHybridConfig.cmAccountId ক্ষেত্র।
dcm_advertiser_id Advertiser.adServerConfig.cmHybridConfig.cmAdvertiserIds ।
ডিসিএম_ফ্লুডলাইট_গ্রুপ_আইডি Advertiser.adServerConfig.cmHybridConfig.cmFloodlightConfigId কনফিগিড ক্ষেত্র।
dcm_syncable_site_ids Advertiser.adServerConfig.cmHybridConfig.cmSyncableSiteIds ফিল্ড।
সক্ষম_ওবিএ_ট্যাগগুলি সক্ষম করুন পাওয়া যায় না।

প্রচারণা

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি Campaign.campaignId ফিল্ড।
কমন_ডাটা.নাম Campaign.displayName ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ Campaign.entityStatus ।
কমন_ডাটা.ইন্টগ্রেশন_কোড পাওয়া যায় না।
advertiser_id Campaign.advertiserId ।
বাজেট Campaign.campaignFlight এবং Campaign.campaignBudgets ।
ফ্রিকোয়েন্সি_ক্যাপ Campaign.frequencyCap ক্যাপ ফিল্ড।
Default_target_list advertisers.campaigns.bulkListCampaignAssignedTargetingOptions মাধ্যমে পুনরুদ্ধারযোগ্য C
use_video_creatives পাওয়া যায় না।
ব্যবহার_ডিসপ্লে_ক্রিয়েটিভস পাওয়া যায় না।
ব্যবহার_আডিয়ো_ক্রিটাইভস পাওয়া যায় না।
উদ্দেশ্য Campaign.campaignGoal.campaignGoalType ক্ষেত্র।
মেট্রিক Campaign.campaignGoal.performanceGoal.performanceGoalType ক্ষেত্র।
উদ্দেশ্য_ডেসক্রিপশন Campaign.campaignGoal.performanceGoal.performanceGoalString স্ট্রিং ক্ষেত্র
মেট্রিক_আমাউন্ট_মিক্রোস Campaign.campaignGoal.performanceGoal.performanceGoalAmountMicros ফিল্ড।

সৃজনশীল

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি Creative.creativeId ক্ষেত্র।
কমন_ডাটা.নাম Creative.displayName ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ Creative.entityStatus ক্ষেত্র।
কমন_ডাটা.ইন্টগ্রেশন_কোড Creative.integrationCode ক্ষেত্র।
advertiser_id Creative.advertiserId ক্ষেত্র।
ডিসিএম_প্লেসমেন্ট_আইডি Creative.cmPlacementId ক্ষেত্র।
প্রস্থ_পিক্সেল Creative.dimensions.widthPixels ক্ষেত্র।
উচ্চতা_পিক্সেল Creative.dimensions.heightPixels ক্ষেত্র।
অনুমোদন_স্ট্যাটাস Creative.reviewStatus ফিল্ড।
প্রসারিত_ নির্দেশিকা Creative.expandingDirection ডাইরেকশন ফিল্ড।
ক্রিয়েটিভ_ টাইপ Creative.creativeType ক্ষেত্র।

কাস্টম্যাফিনিটি

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি CustomList.customListId ক্ষেত্র।
নাম CustomList.displayName ক্ষেত্র।
বর্ণনা পাওয়া যায় না।
advertiser_id পাওয়া যায় না।

প্লাবনলাইটঅ্যাক্টিভিটি

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি FloodlightActivity.floodlightActivityId ক্ষেত্র।
কমন_ডাটা.নাম FloodlightActivity.displayName নেম ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ FloodlightActivity.servingStatus ফিল্ড।
কমন_ডাটা.ইন্টগ্রেশন_কোড পাওয়া যায় না।
advertiser_id FloodlightActivity.advertiserIds ফিল্ড প্রদত্ত অংশীদারটির অধীনে প্লাবনলাইট ক্রিয়াকলাপে অ্যাক্সেস সহ সমস্ত বিজ্ঞাপনদাতাদের তালিকাভুক্ত করে।
অংশীদার_আইডি floodlightGroups.floodlightActivities সার্ভিসে একটি অনুরোধ করার সময় ব্যবহারকারী দ্বারা সরবরাহ করা।
পুনর্বিবেচনা_এনএবলড FloodlightActivity.remarketingConfigs ফিল্ড প্রদত্ত অংশীদারটির অধীনে প্লাবনলাইট ক্রিয়াকলাপে অ্যাক্সেস সহ প্রতিটি বিজ্ঞাপনদাতার জন্য এই কনফিগারেশনটি তালিকাভুক্ত করে।
ssl_required FloodlightActivity.sslRequired ক্ষেত্র।

সন্নিবেশ অর্ডার

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি InsertionOrder.insertionOrderId ক্ষেত্র।
কমন_ডাটা.নাম InsertionOrder.displayName ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ InsertionOrder.entityStatus ক্ষেত্র।
কমন_ডাটা.ইন্টগ্রেশন_কোড InsertionOrder.integrationDetails.integrationCode ।
advertiser_id InsertionOrder.advertiserId ক্ষেত্র।
ক্যাম্পেইন_আইডি InsertionOrder.campaignId ফিল্ড।
সামগ্রিক_বজেট পাওয়া যায় না। InsertionOrder.budget.budgetSegments ফিল্ডের সামগ্রী ব্যবহার করে গণনা করা যেতে পারে।
তফসিল_সেগমেন্টস InsertionOrder.budget.budgetSegments ফিল্ড।
ফ্রিকোয়েন্সি_ক্যাপ InsertionOrder.frequencyCap ক্যাপ ক্ষেত্র।
Default_partner_costs InsertionOrder.partnerCosts ক্ষেত্র।
Default_target_list advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions মাধ্যমে পুনরুদ্ধারযোগ্য n

ইনভেন্টরিসোর্স

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি InventorySource.inventorySourceId ক্ষেত্র।
অশ্রেণীবদ্ধ পাওয়া যায় না।
ইনভেন্টরি_নাম InventorySource.displayName ক্ষেত্র।
এক্সচেঞ্জ_আইডি InventorySource.exchange ক্ষেত্র।
অ্যাক্সেস_ডভার্টাইজার InventorySource.readWriteAccessors রাইট আইসেসরস এবং InventorySource.readAdvertiserIds ক্ষেত্রগুলি।
বাহ্যিক_আইডি InventorySource.dealId ক্ষেত্র।
min_cpm_micros InventorySource.rateDetails.rate.nanos ফিল্ড, InventorySource.rateDetails.inventorySourceRateType টাইপ ফিল্ডের মানের উপর নির্ভর করে।
MIN_CPM_CURRENCY_CODE InventorySource.rateDetails.rate.currencyCode কোড ফিল্ড।

লাইন আইটেম

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি LineItem.lineItemId ক্ষেত্র।
কমন_ডাটা.নাম LineItem.displayName নেম ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ LineItem.entityStatus ফিল্ড।
কমন_ডাটা.ইন্টগ্রেশন_কোড LineItem.integrationDetails.integrationCode ক্ষেত্র।
লাইন_আইটিএম_ টাইপ LineItem.lineItemType ক্ষেত্র।
সন্নিবেশ_র্ডার_আইডি LineItem.insertionOrderId অর্ডারআইডি ক্ষেত্র।
ক্রিয়েটিভ_ডস LineItem.creativeIds ক্ষেত্র।
max_cpm_advertiser_micros LineItem.bidStrategy.maximizeSpendAutoBid.maxAverageCpmBidAmountMicros বা LineItem.bidStrategy.performanceGoalAutoBid.maxAverageCpmBidAmountMicros ক্ষেত্রগুলি ব্যবহৃত কৌশল স্কিমের উপর নির্ভর করে।
পারফরম্যান্স_গোল LineItem.bidStrategy.maximizeSpendAutoBid.performanceGoalType বা LineItem.bidStrategy.performanceGoalAutoBid.performanceGoalType ক্ষেত্রগুলি, ব্যবহৃত কৌশল প্রকল্পের উপর নির্ভর করে।
লক্ষ্য_এডভার্টাইজার_মিক্রোস LineItem.bidStrategy.performanceGoalAutoBid.performanceGoalAmountMicros ক্ষেত্র।
অংশীদার_রেভেনু_মোডেল LineItem.partnerRevenueModel ক্ষেত্র।
COST_TRACKING_PIXELS LineItem.conversionCounting.floodlightActivityConfigs কনফিগস ফিল্ড।
বাজেট.স্টার্ট_টাইম_উসেক LineItem.flight.dateRange.startDate ক্ষেত্র।
বাজেট.এন্ড_টাইম_উসেক LineItem.flight.dateRange.endDate ক্ষেত্র।
বাজেট.ম্যাক্স_আইপিআরপিএস LineItem.budget.maxAmount ফিল্ড যদি LineItem.budget.budgetUnit হ'ল BUDGET_UNIT_IMPRESSIONS ।
বাজেট LineItem.budget.maxAmount ফিল্ড যদি LineItem.budget.budgetUnit BUDGET_UNIT_CURRENCY ।
বাজেট.প্যাকিং_ টাইপ LineItem.pacing.pacingPeriod ক্ষেত্র।
বাজেট.প্যাকিং_ম্যাক্স_আইপিআরপিএস LineItem.pacing.dailyMaxImpressions ক্ষেত্র।
বাজেট LineItem.pacing.dailyMaxMicros ক্ষেত্র।
বাজেট.প্যাকিং_ডিস্ট্রিবিউশন LineItem.pacing.pacingType টাইপ ক্ষেত্র।
ফ্রিকোয়েন্সি_ক্যাপ LineItem.frequencyCap ক্যাপ ফিল্ড।
অংশীদার_কস্টস LineItem.partnerCosts ফিল্ড।
টার্গেট_লিস্ট advertisers.lineItems.bulkListLineItemAssignedTargetingOptions মাধ্যমে পুনরুদ্ধার

নেতিবাচককওয়ার্ডলিস্ট

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি NegativeKeywordList.negativeKeywordListId ক্ষেত্র।
নাম NegativeKeywordList.displayName ক্ষেত্র।
advertiser_id NegativeKeywordList.advertiserId ক্ষেত্র।

অংশীদার

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
কমন_ডাটা.আইডি Partner.partnerId ক্ষেত্র।
কমন_ডাটা.নাম Partner.displayName ক্ষেত্র।
কমন_ডাটা.অ্যাকটিভ Partner.entityStatus ফিল্ড।
কমন_ডাটা.ইন্টগ্রেশন_কোড পাওয়া যায় না।
মুদ্রা_কোড Partner.generalConfig.currencyCode কোড ক্ষেত্র।
এক্সচেঞ্জ_সেটেটিং Partner.exchangeConfig.enabledExchanges ক্ষেত্র।
Default_partner_costs পাওয়া যায় না।
Default_partner_revenue পাওয়া যায় না।
Default_target_list পাওয়া যায় না।

পিক্সেল

ডিসপ্লে এবং ভিডিও 360 এপিআইতে কোনও সমতুল্য সংস্থান বা ক্ষেত্র উপলব্ধ নেই।

ইউনিভার্সাল চ্যানেল

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি Channel.channelId ক্ষেত্র।
নাম Channel.displayName ক্ষেত্র।
সাইট_ডস advertisers.channels.sites.list মাধ্যমে owner partners.channels.sites.list
অ্যাক্সেস_ডভার্টাইজার পাওয়া যায় না।
is_deleded পাওয়া যায় না।
is_brand_safe_channel পাওয়া যায় না।

ব্যবহারকারীর তালিকা

ERF ক্ষেত্রের নাম ডিভি 360 এপিআই উপলভ্যতা
আইডি FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId ক্ষেত্র।
নাম FirstAndThirdPartyAudience.displayName ক্ষেত্র।
ডেটা_পার্টনার_আইডি পাওয়া যায় না।
অ্যাক্সেস_ডভার্টাইজার পাওয়া যায় না।
অংশীদার_প্রসিং পাওয়া যায় না।
বিজ্ঞাপনদাতা_প্রসিংস পাওয়া যায় না।
,

সত্তা রিড ফাইলগুলি (ইআরএফএস) হ'ল অংশীদারদের প্রচারের অবজেক্টগুলির জেএসএন উপস্থাপনা যা অনুরোধে, প্রতিদিন উত্পন্ন হয় এবং গুগল ক্লাউড স্টোরেজের মাধ্যমে উপলব্ধ করা হয়।

ইআরএফগুলি 2021 সালের জুনে অবমূল্যায়ন করা হয়েছিল । 31 অক্টোবর, 2024 থেকে, ইআরএফগুলি আনুষ্ঠানিকভাবে সূর্যাস্ত হবে এবং আর উত্পন্ন হবে না। সমস্ত বিদ্যমান সত্তা রিড ফাইল ব্যবহারকারীরা ডিসপ্লে এবং ভিডিও 360 সংস্থান পুনরুদ্ধার চালিয়ে যাওয়ার জন্য ডিসপ্লে এবং ভিডিও 360 এপিআইতে স্থানান্তর করতে উত্সাহিত হয়।

এই গাইডটি কীভাবে সত্তা পড়ার ফাইলগুলি থেকে ডিসপ্লে এবং ভিডিও 360 এপিআইতে স্থানান্তর করতে পারে তা নিয়ে আলোচনা করে:

  • দুটি ইন্টারফেসের মধ্যে পার্থক্যগুলির একটি ওভারভিউ দেওয়া
  • ERF টেবিলগুলি এপিআই পরিষেবাদির সাথে তুলনা করা
  • এপিআইয়ের মাধ্যমে সত্তা পুনরুদ্ধার সম্পর্কে গাইডেন্স প্রদান
  • বিদ্যমান ডেটা ফাঁকগুলি স্বীকার করা
  • তুলনীয় এপিআই রিসোর্স ক্ষেত্রগুলিতে সমস্ত ইআরএফ ক্ষেত্রের একটি ম্যাপিং উপস্থাপন করা

ওভারভিউ

ইআরএফ থেকে ডিসপ্লে এবং ভিডিও 360 এপিআইতে স্থানান্তরিত করার সময়, বিবেচনা করার মতো অনেকগুলি মূল পার্থক্য রয়েছে:

  • ডেটা সতেজতা। ইআরএফগুলি প্রতিদিন এবং প্রচুর পরিমাণে উত্পাদিত হয় যখন এপিআই কোনও সংস্থার সর্বাধিক আপ-টু-ডেট সংস্করণ পুনরুদ্ধার করে।
  • রিসোর্স কাঠামো। এপিআই একই সংস্থান প্রকারের প্রতিনিধিত্ব করতে ERF এর চেয়ে বিভিন্ন জেএসএন কাঠামো ব্যবহার করে। কিছু সংস্থান, যেমন পাবলিক টার্গেটিং সেটিংস, একটি আলাদা আইডি স্পেস ব্যবহার করতে পারে।
  • পুনরুদ্ধার পদ্ধতি। The Display & Video 360 API only enables the retrieval of resources individually, in paginated lists, or through BigQuery data transfers, in contrast to the raw JSON files provided by ERF.
  • ব্যাপ্তি। As opposed to ERFs, which are scoped by partner ID, most API resources are scoped by advertiser ID. Resources included in responses are limited to resources within that scope.

ERF data representation in the API

Entity Read Files are separated into "Public" and "Private" tables. Public tables provide information that is available and applicable to all users, such as targeting values. Private tables provide data that is specific to a partner, such as creative or line item resources.

The Display & Video 360 API does not use this dichotomy, instead making all of this information retrievable through various services and using different JSON structures. This section compares the information provided through public and private ERF tables to that made available through Display & Video 360 API resources and services.

পাবলিক তথ্য

ERF public tables provide reference materials for users to use when interpreting the targeting settings of their retrieved private resources and assigning targeting through a subset of Structured Data Files (SDFs) versions uploaded through the UI . These reference materials are the same for all users and consist of a numeric ID, used for mapping, and more descriptive details, such as a display name.

When using the Display & Video 360 API, targeting reference information can be retrieved through the targetingTypes.targetingOptions service. Similar to the public tables, this service provides the IDs and details of targeting options for a specific targeting type. Refer to our existing Set Targeting page for a code example demonstrating targeting option ID retrieval.

Public tables and SDFs

Before SDF v7 , Entity Read Files and Structured Data Files use the same ID space for targeting settings. If you are an SDF user using ERF public tables for interpreting or assigning targeting settings using SDF, you can instead download this reference material in CSV format through the Display & Video 360 UI.

Starting with v7 , the ID spaces used by a subset of Structured Data Files columns have been updated to decouple SDF from the ERFs and further align with Display & Video 360 API. See the v7 migration guide and reference documentation for more information.

Private resources

ERF private tables provide a daily snapshot of the current settings of private resources owned by a partner. Due to the sheer volume of resources that can be created under a single partner, these files can grow to be very large and difficult to download and process.

In the API, each private table has a corresponding service that provides endpoints for retrieval and management of that resource type. Resources can be retrieved in bulk using each service's respective list method. The JSON structure for each resource is different in the API compared to ERF, utilizing different field names and shared resources.

Certain information available in the ERF representation of a resource, such as a resource's assigned targeting settings or a channel's sites , are represented in the API as children of the original resource and must be retrieved through additional API requests.

Entity retrieval in the API

Display & Video 360 resources can either be retrieved through direct API requests or automatic imports into BigQuery .

সরাসরি API অনুরোধ

Each resource type is retrievable through a different API service. Resources can be retrieved individually or in bulk using the appropriate service's get or list method, respectively. Important properties of Display & Video 360 API list methods include:

  • Required scope. Unlike ERFs, which are scoped by partner , most resources in the API are scoped by advertiser . Retrieving all of a resource type, such as line items, under a partner may require an individual list request for each child advertiser of that partner. Exceptions include direct children of a partner, such as advertisers and partner-owned channels.
  • পৃষ্ঠা সংখ্যা API list methods employ pagination to guarantee that responses are within a reasonable size, limiting most individual request responses, or pages, to 100 resources. If the number of relevant resources is larger than the page size, consecutive list calls are required to retrieve subsequent pages of the full list response. A code example paging a list response is provided in a section of our Targeting guide page regarding retrieving available targeting options .
  • Additional requests required for targeting retrieval. A resource's targeting settings are not included in its API JSON object, but are instead child resources known as assigned targeting options . These child resources must be retrieved through a separate request. For example, for each line item retrieved through an advertisers.lineItems.list request, a separate advertisers.lineItems.bulkListAssignedTargetingOptions request must be made to retrieve all targeting information.

Optimize resource retrieval

The Display & Video 360 API may require multiple requests to retrieve the same amount of information that is available in a single Entity Read File. Optimizing how you retrieve resources can help retrieve the data you need more efficiently:

  • Make concurrent requests to the API. The Display & Video 360 API protects infrastructure using requests per advertiser per project rate limits . This quota structure lets you implement a multithreaded solution across multiple advertisers that will reduce the total time it takes to retrieve all necessary resources. Although pagination requires that all resources of a type within a certain scope are retrieved through consecutive calls, retrieval of resources within another scope or of another type can be done concurrently.
  • Utilize filters and order by parameters in your list calls to retrieve only relevant resources. For example, if you are only interested in line items that have been updated in the last day, you can use the filter parameter of the advertisers.lineItems.list method to only return line items with an updateTime greater than a given timestamp. This can significantly reduce the number of requests that need to be made.
  • Cache regularly used IDs to avoid unnecessary API requests. Certain reference information, such as targeting options IDs and Google Audience IDs, are relatively stable and can be safely stored to avoid the need for retrieval upon every use. However, cached values should be checked on a weekly basis to account for infrequent changes or deprecations.

See our Quota Optimization guide for more information on how to access the Display & Video 360 API efficiently.

Import into BigQuery

The Display & Video 360 API BigQuery Connector lets you automatically import Display & Video 360 resource configurations directly into BigQuery on a daily basis. The configurations are stored in BigQuery using Display & Video 360 API resource design. A subset of API resources are supported.

See the following cloud documentation for more information about using the Display & Video 360 API BigQuery Connector:

Known API data gaps

There are notable data gaps you might encounter when migrating from ERF to Display & Video 360 API, such as:

  • Story insertion orders. Story insertion orders are not retrievable through the API and must be retrieved through the Display & Video 360 UI.
  • A subset of resource fields. A small number of resource fields present in ERF objects are not available in the corresponding resources retrieved through the Display & Video 360 API.

Appendix: Mapping ERF Fields to API

Public table mapping

The tables below map the fields of ERF public tables to existing targeting types and targeting option fields in the Display & Video 360 API. Although the value of one field might map to another, that does not guarantee that they utilize the same data type, enum values, or ID space.

App Collection

Retrievable under targeting type TARGETING_TYPE_APP_CATEGORY .

ERF Field Name DV360 API Availability
আইডি TargetingOption.targetingOptionId field.
নাম TargetingOption.appCategoryDetails.displayName field.

ব্রাউজার

Retrievable under targeting type TARGETING_TYPE_BROWSER .

ERF Field Name DV360 API Availability
আইডি TargetingOption.targetingOptionId field.
is_mobile পাওয়া যায় না।
নাম TargetingOption.browserDetails.displayName field.

DataPartner

There is no equivalent resource or fields available in Display & Video 360 API.

DeviceCriteria

Retrievable under targeting types TARGETING_TYPE_OPERATING_SYSTEM , TARGETING_TYPE_DEVICE_MAKE_MODEL , and TARGETING_TYPE_DEVICE_TYPE .

ERF Field Name DV360 API Availability
আইডি TargetingOption.targetingOptionId field or DeviceType enum.
is_mobile পাওয়া যায় না।
নাম TargetingOption.operatingSystemDetails.displayName field, TargetingOption.deviceMakeModelDetails.displayName field, or DeviceType enum, depending on targeting type.
criteria_type TargetingOption.targetingType field.
operating_system_id পাওয়া যায় না।
mobile_brand_name পাওয়া যায় না।
mobile_model_name পাওয়া যায় না।
mobile_make_model_id পাওয়া যায় না।
ডিভাইস_টাইপ DeviceType enum.

ভূ-অবস্থান

Retrievable under targeting type TARGETING_TYPE_GEO_REGION .

ERF Field Name DV360 API Availability
আইডি TargetingOption.targetingOptionId field.
canonical_name TargetingOption.geoRegionDetails.displayName field.
geo_name পাওয়া যায় না।
দেশ_কোড পাওয়া যায় না।
region_code পাওয়া যায় না।
শহরের_নাম পাওয়া যায় না।
postal_name পাওয়া যায় না।
dma_code পাওয়া যায় না।

আইএসপি

Retrievable under targeting type TARGETING_TYPE_CARRIER_AND_ISP .

ERF Field Name DV360 API Availability
আইডি TargetingOption.targetingOptionId field.
is_mobile পাওয়া যায় না।
নাম TargetingOption.carrierAndIspDetails.displayName field.
secondary_criteria_id TargetingOption.targetingOptionId field.

ভাষা

Retrievable under targeting type TARGETING_TYPE_LANGUAGE .

ERF Field Name DV360 API Availability
আইডি TargetingOption.targetingOptionId field.
নাম পাওয়া যায় না। Full display name for a language is available at TargetingOption.languageDetails.displayName field.

SiteToPlacementId

There is no equivalent resource or fields available in Display & Video 360 API.

SupportedExchange

Retrievable under targeting type TARGETING_TYPE_EXCHANGE .

ERF Field Name DV360 API Availability
আইডি Exchange enum.
নাম Exchange enum.

UniversalSite

There is no equivalent resource or fields available in Display & Video 360 API. Individual sites and apps can be targeted directly under targeting types TARGETING_TYPE_URL and TARGETING_TYPE_APP , respectively. In Display & Video 360, any app or URL can be targeted, but not every app or URL can be reported on. If you would like to remove non-reportable apps and URLs from spending, follow the instructions on the DV360 Help Center .

Private table field mapping

The tables below map the fields of ERF private tables to existing fields or services in the Display & Video 360 API. Although the value of one field may map to another, that does not guarantee that they utilize the same data type, enum values or ID space.

বিজ্ঞাপনদাতা

ERF Field Name DV360 API Availability
common_data.id Advertiser.advertiserId field.
common_data.name Advertiser.displayName field.
common_data.active Advertiser.entityStatus field.
common_data.integration_code Advertiser.integrationDetails.integrationCode field.
অংশীদার_আইডি Advertiser.partnerId field.
currency_code Advertiser.generalConfig.currencyCode field.
timezone_code Advertiser.generalConfig.timeZone field.
landing_page_url Advertiser.generalConfig.domainUrl field.
available_channel_ids Retrievable through advertisers.channels.list method.
blacklist_channel_id Retrievable through advertisers.targetingTypes.assignedtargetingOptions.list method under targeting type TARGETING_TYPE_CHANNEL . If AssignedTargetingOption.channelDetails.negative is true, the channel is negatively-targeted.
dcm_configuration পাওয়া যায় না।
dcm_network_id Advertiser.adServerConfig.cmHybridConfig.cmAccountId field.
dcm_advertiser_id The Advertiser.adServerConfig.cmHybridConfig.cmAdvertiserIds field lists the CM360 Advertiser IDs that share the CM360 Floodlight configuration.
dcm_floodlight_group_id Advertiser.adServerConfig.cmHybridConfig.cmFloodlightConfigId field.
dcm_syncable_site_ids Advertiser.adServerConfig.cmHybridConfig.cmSyncableSiteIds field.
enable_oba_tags পাওয়া যায় না।

প্রচারণা

ERF Field Name DV360 API Availability
common_data.id Campaign.campaignId field.
common_data.name Campaign.displayName field.
common_data.active Campaign.entityStatus field.
common_data.integration_code পাওয়া যায় না।
advertiser_id Campaign.advertiserId field.
বাজেট Campaign.campaignFlight and Campaign.campaignBudgets fields.
frequency_cap Campaign.frequencyCap field.
default_target_list Retrievable through advertisers.campaigns.bulkListCampaignAssignedTargetingOptions method.
uses_video_creatives পাওয়া যায় না।
uses_display_creatives পাওয়া যায় না।
uses_audio_creatives Not available.
উদ্দেশ্য Campaign.campaignGoal.campaignGoalType field.
মেট্রিক Campaign.campaignGoal.performanceGoal.performanceGoalType field.
objective_description Campaign.campaignGoal.performanceGoal.performanceGoalString field.
metric_amount_micros Campaign.campaignGoal.performanceGoal.performanceGoalAmountMicros field.

সৃজনশীল

ERF Field Name DV360 API Availability
common_data.id Creative.creativeId field.
common_data.name Creative.displayName field.
common_data.active Creative.entityStatus field.
common_data.integration_code Creative.integrationCode field.
advertiser_id Creative.advertiserId field.
dcm_placement_id Creative.cmPlacementId field.
width_pixels Creative.dimensions.widthPixels field.
height_pixels Creative.dimensions.heightPixels field.
approval_status Creative.reviewStatus field.
expanding_direction Creative.expandingDirection field.
creative_type Creative.creativeType field.

CustomAffinity

ERF Field Name DV360 API Availability
আইডি CustomList.customListId field.
নাম CustomList.displayName field.
বর্ণনা পাওয়া যায় না।
advertiser_id পাওয়া যায় না।

FloodlightActivity

ERF Field Name DV360 API Availability
common_data.id FloodlightActivity.floodlightActivityId field.
common_data.name FloodlightActivity.displayName field.
common_data.active FloodlightActivity.servingStatus field.
common_data.integration_code পাওয়া যায় না।
advertiser_id The FloodlightActivity.advertiserIds field lists all advertisers with access to the floodlight activity under the given partner.
অংশীদার_আইডি Provided by the user when making a request to the floodlightGroups.floodlightActivities service.
remarketing_enabled The FloodlightActivity.remarketingConfigs field lists this configuration for each advertiser with access to the floodlight activity under the given partner.
ssl_required FloodlightActivity.sslRequired field.

InsertionOrder

ERF Field Name DV360 API Availability
common_data.id InsertionOrder.insertionOrderId field.
common_data.name InsertionOrder.displayName field.
common_data.active InsertionOrder.entityStatus field.
common_data.integration_code InsertionOrder.integrationDetails.integrationCode field.
advertiser_id InsertionOrder.advertiserId field.
ক্যাম্পেইন_আইডি InsertionOrder.campaignId field.
overall_budget Not available. Can be calculated using contents of the InsertionOrder.budget.budgetSegments field.
scheduled_segments InsertionOrder.budget.budgetSegments field.
frequency_cap InsertionOrder.frequencyCap field.
default_partner_costs InsertionOrder.partnerCosts field.
default_target_list Retrievable through advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions method.

InventorySource

ERF Field Name DV360 API Availability
আইডি InventorySource.inventorySourceId field.
অশ্রেণীবদ্ধ Not available.
inventory_name InventorySource.displayName field.
exchange_id InventorySource.exchange field.
accessing_advertisers InventorySource.readWriteAccessors and InventorySource.readAdvertiserIds fields.
external_id InventorySource.dealId field.
min_cpm_micros InventorySource.rateDetails.rate.nanos field, depending on the value of the InventorySource.rateDetails.inventorySourceRateType field.
min_cpm_currency_code InventorySource.rateDetails.rate.currencyCode field.

লাইন আইটেম

ERF Field Name DV360 API Availability
common_data.id LineItem.lineItemId field.
common_data.name LineItem.displayName field.
common_data.active LineItem.entityStatus field.
common_data.integration_code LineItem.integrationDetails.integrationCode field.
line_item_type LineItem.lineItemType field.
insertion_order_id LineItem.insertionOrderId field.
creative_ids LineItem.creativeIds field.
max_cpm_advertiser_micros LineItem.bidStrategy.maximizeSpendAutoBid.maxAverageCpmBidAmountMicros or LineItem.bidStrategy.performanceGoalAutoBid.maxAverageCpmBidAmountMicros fields, depending on the strategy scheme used.
performance_goal LineItem.bidStrategy.maximizeSpendAutoBid.performanceGoalType or LineItem.bidStrategy.performanceGoalAutoBid.performanceGoalType fields, depending on the strategy scheme used.
goal_advertiser_micros LineItem.bidStrategy.performanceGoalAutoBid.performanceGoalAmountMicros field.
partner_revenue_model LineItem.partnerRevenueModel field.
cost_tracking_pixels LineItem.conversionCounting.floodlightActivityConfigs field.
budget.start_time_usec LineItem.flight.dateRange.startDate field.
budget.end_time_usec LineItem.flight.dateRange.endDate field.
budget.max_impressions LineItem.budget.maxAmount field if LineItem.budget.budgetUnit is BUDGET_UNIT_IMPRESSIONS .
budget.max_spend_advertiser_micros LineItem.budget.maxAmount field if LineItem.budget.budgetUnit is BUDGET_UNIT_CURRENCY .
budget.pacing_type LineItem.pacing.pacingPeriod field.
budget.pacing_max_impressions LineItem.pacing.dailyMaxImpressions field.
budget.pacing_max_spend_advertiser_micros LineItem.pacing.dailyMaxMicros field.
budget.pacing_distribution LineItem.pacing.pacingType field.
frequency_cap LineItem.frequencyCap field.
partner_costs LineItem.partnerCosts field.
target_list Retrievable through advertisers.lineItems.bulkListLineItemAssignedTargetingOptions method.

NegativeKeywordList

ERF Field Name DV360 API Availability
আইডি NegativeKeywordList.negativeKeywordListId field.
নাম NegativeKeywordList.displayName field.
advertiser_id NegativeKeywordList.advertiserId field.

অংশীদার

ERF Field Name DV360 API Availability
common_data.id Partner.partnerId field.
common_data.name Partner.displayName field.
common_data.active Partner.entityStatus field.
common_data.integration_code Not available.
currency_code Partner.generalConfig.currencyCode field.
exchange_settings Partner.exchangeConfig.enabledExchanges field.
default_partner_costs Not available.
default_partner_revenue Not available.
default_target_list Not available.

পিক্সেল

There is no equivalent resource or fields available in Display & Video 360 API.

UniversalChannel

ERF Field Name DV360 API Availability
আইডি Channel.channelId field.
নাম Channel.displayName field.
site_ids Retrievable through advertisers.channels.sites.list and partners.channels.sites.list methods, depending on the type of owner .
accessing_advertisers Not available.
is_deleted পাওয়া যায় না।
is_brand_safe_channel Not available.

ব্যবহারকারীর তালিকা

ERF Field Name DV360 API Availability
আইডি FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId field.
নাম FirstAndThirdPartyAudience.displayName field.
data_partner_id Not available.
accessing_advertisers Not available.
partner_pricing Not available.
advertiser_pricings Not available.