- HTTP অনুরোধ
- অনুরোধকারী শরীর
- প্রতিক্রিয়া সংস্থা
- অনুমোদনের পরিধি
- অ্যাডইভেন্ট
- ইভেন্টের ধরণ
- ইভেন্টসাবটাইপ
- AdType
- AdFormat
- অ্যাডপ্লেসমেন্ট
- টার্গেটিং টাইপ
- প্ল্যাটফর্মের ধরন
- প্ল্যাটফর্ম
- অ্যাট্রিবিউশনহিন্ট
- ভিউবিলিটিইনফো
- ভিউটাইপ
- মিডিয়াকোয়ার্টাইল
- চেষ্টা করে দেখুন!
AdEvent রিসোর্সসমূহের একটি তালিকা গুগল অ্যানালিটিক্সে আপলোড করে।
এই ফিচারটি শুধুমাত্র অনুমোদিত তালিকায় থাকা অ্যাকাউন্টগুলোর জন্য উপলব্ধ।
HTTP অনুরোধ
POST https://datamanager.googleapis.com/v1/adEvents:ingest
URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।
অনুরোধকারী শরীর
অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:
| JSON উপস্থাপনা |
|---|
{ "adEvents": [ { object ( |
| ক্ষেত্র | |
|---|---|
adEvents[] | আবশ্যক। আবশ্যক (কমপক্ষে ১টি)। বিজ্ঞাপন ইভেন্টের একটি তালিকা। |
encryptionInfo | ঐচ্ছিক। ডেটা এনক্রিপ্ট করতে ব্যবহৃত এনক্রিপশন কী-গুলো সম্পর্কিত তথ্য। |
validateOnly | ঐচ্ছিক। সত্য হলে, অনুরোধটি যাচাই করা হয়, কিন্তু কার্যকর করা হয় না। |
প্রতিক্রিয়া সংস্থা
সফল হলে, প্রতিক্রিয়া অংশটি খালি থাকে।
অনুমোদনের পরিধি
নিম্নলিখিত OAuth স্কোপ প্রয়োজন:
-
https://www.googleapis.com/auth/datamanager
অ্যাডইভেন্ট
একটি বিজ্ঞাপনমূলক ঘটনা।
| JSON উপস্থাপনা |
|---|
{ "advertiserId": string, "eventType": enum ( |
| ক্ষেত্র | |
|---|---|
advertiserId | প্রয়োজনীয়। বিজ্ঞাপন ইভেন্টের জন্য বিজ্ঞাপনদাতার আইডি। এটি অবশ্যই লিঙ্কিং ফ্লোতে পাঠানো আইডির সাথে মিলতে হবে। |
eventType | আবশ্যক। অনুষ্ঠানের ধরণ। |
timestamp | প্রয়োজনীয়। ঘটনাটি ঘটার সময়। RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: |
eventId | ঐচ্ছিক। আহ্বানকারী দ্বারা তৈরি ও পরিচালিত একটি আইডি, যা এই ইভেন্টটিকে অনন্যভাবে শনাক্ত করে। একাধিক অনুরোধে অন্তর্ভুক্ত বিজ্ঞাপন ইভেন্টগুলো থেকে পুনরাবৃত্তি দূর করতে চাইলে এটি আবশ্যক। অন্যথায়, এই ক্ষেত্রটি ঐচ্ছিক। |
userData | ঐচ্ছিক। ব্যবহারকারীর দেওয়া একাধিক তথ্য, যা ইভেন্টটির সাথে সংশ্লিষ্ট ব্যবহারকারীকে প্রতিনিধিত্ব করে। একই ধরনের ডেটার একাধিক উদাহরণ দেওয়া সম্ভব (যেমন ইমেল ঠিকানা)। যত বেশি ডেটা দেওয়া হবে, মিল খুঁজে পাওয়ার সম্ভাবনা তত বেশি থাকবে। |
deviceInfo | ঐচ্ছিক। বিজ্ঞাপনটি ঘটার সময় ব্যবহৃত ডিভাইসটি সম্পর্কে সংগৃহীত তথ্য। |
mobileDeviceId | ঐচ্ছিক। যে ডিভাইসে বিজ্ঞাপনটি দেখানো হয়েছিল, তার ডিভাইস আইডি। |
campaignId | প্রয়োজনীয়। সংশ্লিষ্ট ক্যাম্পেইনের আইডি। |
campaignName | প্রয়োজনীয়। সংশ্লিষ্ট প্রচারণার নাম। |
adGroupId | ঐচ্ছিক। সংশ্লিষ্ট বিজ্ঞাপন গোষ্ঠীর আইডি। |
adId | ঐচ্ছিক। গ্রুপের মধ্যে সংশ্লিষ্ট বিজ্ঞাপনের আইডি। |
adHeight | ঐচ্ছিক। বিজ্ঞাপনের উচ্চতা (পিক্সেল এককে)। |
adWidth | ঐচ্ছিক। বিজ্ঞাপনের প্রস্থ (পিক্সেল-এ)। |
regionCode | আবশ্যক। আইএসও ৩১৬৬-২ দেশ ও উপবিভাগ। |
source | আবশ্যক। বিজ্ঞাপনের প্ল্যাটফর্ম উৎস, যা গুগল অ্যানালিটিক্স উৎসের অনুরূপ। |
medium | আবশ্যক। বিজ্ঞাপনের মাধ্যমটি, যা গুগল অ্যানালিটিক্স মাধ্যমের অনুরূপ। |
attributionHint | ঐচ্ছিক। এই বিজ্ঞাপন ইভেন্টের জন্য অংশীদার কর্তৃক গৃহীত অ্যাট্রিবিউশন স্ট্যাটাস। এটি শুধুমাত্র একটি সংকেত হিসেবে কাজ করে যে অংশীদার কর্তৃক আরোপিত দায় কীভাবে কার্যকর হয়েছে, এবং চূড়ান্ত প্রতিবেদনে কোনো চূড়ান্ত ফলাফল চাপিয়ে দেয় না। |
viewabilityInfo | প্রয়োজনীয়। পরিবেশিত বিজ্ঞাপনটির দৃশ্যমানতার বিবরণ। |
ইউনিয়ন ফিল্ড বিশুদ্ধ এনাম (enum) ব্যতীত অন্য মান পরিচালনার জন্য একটি র স্ট্রিং (raw string) গ্রহণ করা হয়। সম্ভব হলে এনাম ব্যবহার করাই শ্রেয়। | |
eventSubtype | ইভেন্ট সাবটাইপের জন্য এনাম ভ্যালু। |
eventSubtypeString | ইভেন্ট সাবটাইপের জন্য স্ট্রিং মান। |
ইউনিয়ন ফিল্ড বিশুদ্ধ এনাম (enum) ব্যতীত অন্য মান পরিচালনার জন্য একটি র স্ট্রিং (raw string) গ্রহণ করা হয়। সম্ভব হলে এনাম ব্যবহার করাই শ্রেয়। | |
adType | বিজ্ঞাপনের প্রকারের জন্য এনাম মান। |
adTypeString | বিজ্ঞাপনের ধরনের জন্য স্ট্রিং মান। |
ইউনিয়ন ফিল্ড বিশুদ্ধ এনাম (enum) ব্যতীত অন্য মানগুলির জন্য একটি র স্ট্রিং (raw string) গ্রহণ করা হয়। সম্ভব হলে এনাম ব্যবহার করাই শ্রেয়। | |
adFormat | বিজ্ঞাপনের ফরম্যাটের জন্য এনাম ভ্যালু। |
adFormatString | বিজ্ঞাপনের ফরম্যাটের জন্য স্ট্রিং ভ্যালু। |
ইউনিয়ন ফিল্ড বিশুদ্ধ এনাম (enum) ব্যতীত অন্য মানগুলির জন্য একটি র স্ট্রিং (raw string) গ্রহণ করা হয়। সম্ভব হলে এনাম ব্যবহার করাই শ্রেয়। | |
adPlacement | বিজ্ঞাপন স্থাপনের জন্য এনাম ভ্যালু। |
adPlacementString | বিজ্ঞাপন স্থাপনের জন্য স্ট্রিং ভ্যালু। |
ইউনিয়ন ফিল্ড বিশুদ্ধ এনাম (enum) ব্যতীত অন্য মানগুলির জন্য একটি র স্ট্রিং (raw string) গ্রহণ করা হয়। সম্ভব হলে এনাম ব্যবহার করাই শ্রেয়। | |
targetingType | টার্গেটিং টাইপের জন্য এনাম ভ্যালু। |
targetingTypeString | টার্গেটিং টাইপের জন্য স্ট্রিং ভ্যালু। |
ইউনিয়ন ফিল্ড বিশুদ্ধ এনাম (enum) ব্যতীত অন্য মান পরিচালনার জন্য একটি র স্ট্রিং (raw string) গ্রহণ করা হয়। সম্ভব হলে এনাম ব্যবহার করাই শ্রেয়। | |
platformType | প্ল্যাটফর্ম প্রকারের জন্য এনাম মান। |
platformTypeString | প্ল্যাটফর্ম টাইপের জন্য স্ট্রিং ভ্যালু। |
ইউনিয়ন ফিল্ড বিশুদ্ধ এনাম (enum) ব্যতীত অন্য মানগুলির জন্য একটি র স্ট্রিং (raw string) গ্রহণ করা হয়। সম্ভব হলে এনাম ব্যবহার করাই শ্রেয়। | |
platform | প্ল্যাটফর্মের জন্য Enum মান। |
platformString | প্ল্যাটফর্মের জন্য স্ট্রিং মান। |
measurementAllowed | ঐচ্ছিক। এটি নির্দেশ করে যে, আঞ্চলিক এখতিয়ারের মধ্যে প্রযোজ্য গোপনীয়তা আইন দ্বারা পরিচালিত হয়ে সারিটি পরিমাপের উদ্দেশ্যে ব্যবহার করার অনুমতি আছে কিনা। |
ইভেন্টের ধরণ
ঘটনাটির ধরণ।
| এনাম | |
|---|---|
EVENT_TYPE_UNSPECIFIED | অনির্দিষ্ট ইভেন্টের ধরণ। |
EVENT_TYPE_VIEW | ইভেন্টটি দেখুন। |
EVENT_TYPE_CLICK | ক্লিক ইভেন্ট। |
ইভেন্টসাবটাইপ
বিজ্ঞাপন ইভেন্টের ধরণ সম্পর্কে অতিরিক্ত শ্রেণিবিন্যাস।
| এনাম | |
|---|---|
EVENT_SUBTYPE_UNSPECIFIED | অনির্দিষ্ট ইভেন্টের উপপ্রকার। |
EVENT_SUBTYPE_IMPRESSION | প্রভাব সৃষ্টিকারী ঘটনা। |
EVENT_SUBTYPE_ENGAGED_VIEW | সক্রিয় দেখার ঘটনা। |
EVENT_SUBTYPE_ONSITE_CLICK | অনসাইট ক্লিক ইভেন্ট। |
EVENT_SUBTYPE_OUTBOUND_CLICK | বহির্গামী ক্লিক ইভেন্ট। |
AdType
পরিবেশিত বিজ্ঞাপনের ধরণ।
| এনাম | |
|---|---|
AD_TYPE_UNSPECIFIED | অনির্দিষ্ট বিজ্ঞাপনের ধরণ। |
AD_TYPE_DISPLAY | বিজ্ঞাপন প্রদর্শন করুন। |
AD_TYPE_TEXT | টেক্সট বিজ্ঞাপন। |
AD_TYPE_IMAGE | ছবির বিজ্ঞাপন। |
AD_TYPE_RICH_MEDIA | রিচ মিডিয়া বিজ্ঞাপন। |
AD_TYPE_HTML | এইচটিএমএল বিজ্ঞাপন। |
AD_TYPE_AUDIO | অডিও বিজ্ঞাপন। |
AD_TYPE_VIDEO | ভিডিও বিজ্ঞাপন। |
AdFormat
পরিবেশিত বিজ্ঞাপনের বিন্যাস।
| এনাম | |
|---|---|
AD_FORMAT_UNSPECIFIED | অনির্দিষ্ট বিজ্ঞাপন ফরম্যাট। |
AD_FORMAT_AR | এআর বিজ্ঞাপন। |
AD_FORMAT_AUDIO | অডিও বিজ্ঞাপন। |
AD_FORMAT_BANNER | ব্যানার বিজ্ঞাপন। |
AD_FORMAT_BUMPER | বাম্পার বিজ্ঞাপন। |
AD_FORMAT_CAROUSEL | ক্যারোসেলের বিজ্ঞাপন। |
AD_FORMAT_COLLECTION | সংগ্রহ বিজ্ঞাপন। |
AD_FORMAT_IMAGE | ছবির বিজ্ঞাপন। |
AD_FORMAT_INTERACTIVE | ইন্টারেক্টিভ বিজ্ঞাপন। |
AD_FORMAT_INTERSTITIAL | ইন্টারস্টিশিয়াল অ্যাড। |
AD_FORMAT_IN_FEED | ইন-ফিড বিজ্ঞাপন। |
AD_FORMAT_IN_STREAM | ইন-স্ট্রিম বিজ্ঞাপন। |
AD_FORMAT_IN_STREAM_SKIPPABLE | লাইভস্ট্রিমের মধ্যে স্কিপ করা যায় এমন বিজ্ঞাপন। |
AD_FORMAT_IN_STREAM_NON_SKIPPABLE | লাইভস্ট্রিমের মধ্যে প্রদর্শিত বিজ্ঞাপন, যা স্কিপ করা যাবে না। |
AD_FORMAT_NATIVE | স্থানীয় বিজ্ঞাপন। |
AD_FORMAT_SHORTS | শর্টসের বিজ্ঞাপন। |
AD_FORMAT_STORY | গল্পের বিজ্ঞাপন। |
AD_FORMAT_SPONSORED | স্পনসরকৃত বিজ্ঞাপন। |
AD_FORMAT_VIDEO | ভিডিও বিজ্ঞাপন। |
অ্যাডপ্লেসমেন্ট
বিজ্ঞাপনটির স্থান নির্ধারণ করা হয়েছে।
| এনাম | |
|---|---|
AD_PLACEMENT_UNSPECIFIED | অনির্দিষ্ট বিজ্ঞাপন স্থান। |
AD_PLACEMENT_DISCOVER | স্থান নির্ধারণ সম্পর্কে জানুন। |
AD_PLACEMENT_FEED | খাদ্য স্থাপন। |
AD_PLACEMENT_FOOTER | ফুটার প্লেসমেন্ট। |
AD_PLACEMENT_HEADER | হেডারের অবস্থান। |
AD_PLACEMENT_HOME | গৃহে স্থাপন। |
AD_PLACEMENT_IN_CONTENT | কন্টেন্টের মধ্যে স্থাপন। |
AD_PLACEMENT_PROMOTED | পদোন্নতিপ্রাপ্ত পদায়ন। |
AD_PLACEMENT_SEARCH | অনুসন্ধান স্থান নির্ধারণ। |
AD_PLACEMENT_STORY | গল্পের অবস্থান। |
টার্গেটিং টাইপ
বিজ্ঞাপনটি পরিবেশন করতে ব্যবহৃত টার্গেটিংয়ের ধরণ।
| এনাম | |
|---|---|
TARGETING_TYPE_UNSPECIFIED | অনির্দিষ্ট লক্ষ্যবস্তুর ধরণ। |
TARGETING_TYPE_AUDIENCE | দর্শক লক্ষ্যকরণ। |
TARGETING_TYPE_CONTEXTUAL | প্রাসঙ্গিক লক্ষ্য নির্ধারণ। |
TARGETING_TYPE_DEMOGRAPHIC | জনসংখ্যাতাত্ত্বিক লক্ষ্য নির্ধারণ। |
TARGETING_TYPE_DEVICE | ডিভাইস টার্গেটিং। |
TARGETING_TYPE_GEO | ভূ-লক্ষ্য নির্ধারণ। |
TARGETING_TYPE_INTEREST | আগ্রহ লক্ষ্যকরণ। |
TARGETING_TYPE_PURCHASE_INTENT | ক্রয়ের অভিপ্রায় টার্গেটিং। |
TARGETING_TYPE_REMARKETING | রিমার্কেটিং টার্গেটিং। |
প্ল্যাটফর্মের ধরন
যে প্ল্যাটফর্মে বিজ্ঞাপনটি পরিবেশন করা হয়েছিল তার ধরন।
| এনাম | |
|---|---|
PLATFORM_TYPE_UNSPECIFIED | অনির্দিষ্ট প্ল্যাটফর্মের ধরণ। |
PLATFORM_TYPE_MOBILE | মোবাইল প্ল্যাটফর্ম। |
PLATFORM_TYPE_DESKTOP | ডেস্কটপ প্ল্যাটফর্ম। |
PLATFORM_TYPE_CTV | সিটিভি প্ল্যাটফর্ম। |
PLATFORM_TYPE_PHONE | ফোন প্ল্যাটফর্ম। |
PLATFORM_TYPE_TABLET | ট্যাবলেট প্ল্যাটফর্ম। |
প্ল্যাটফর্ম
যে প্ল্যাটফর্মে বিজ্ঞাপনটি দেখানো হয়েছিল, তার আরও বিস্তারিত বিবরণ।
| এনাম | |
|---|---|
PLATFORM_UNSPECIFIED | অনির্দিষ্ট প্ল্যাটফর্ম। |
PLATFORM_IOS | আইওএস প্ল্যাটফর্ম। |
PLATFORM_ANDROID | অ্যান্ড্রয়েড প্ল্যাটফর্ম। |
PLATFORM_WEB | ওয়েব প্ল্যাটফর্ম। |
অ্যাট্রিবিউশনহিন্ট
এই বিজ্ঞাপন ইভেন্টের জন্য অংশীদার-স্বীকৃত অ্যাট্রিবিউশন স্ট্যাটাস।
| এনাম | |
|---|---|
ATTRIBUTION_HINT_UNSPECIFIED | অজ্ঞাত উৎস অবস্থা। |
ATTRIBUTION_HINT_CONVERTED | অবস্থা রূপান্তরিত হয়েছে। |
ATTRIBUTION_HINT_NOT_CONVERTED | রূপান্তরিত হয়নি অবস্থা। |
ভিউবিলিটিইনফো
পরিবেশিত বিজ্ঞাপনটির দৃশ্যমানতার বিবরণ।
| JSON উপস্থাপনা |
|---|
{ "viewType": enum ( |
| ক্ষেত্র | |
|---|---|
viewType | আবশ্যক। অনুষ্ঠানের ধরণ। |
viewablePercent | ঐচ্ছিক। দৃশ্যমান পিক্সেলগুলোর সংখ্যাসূচক শতাংশ (০-১০০)। |
viewableDuration | ঐচ্ছিক। বিজ্ঞাপনটি যে পরিমাণ সময় ধরে দেখা গিয়েছিল। সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' |
mediaSkippable | ঐচ্ছিক। বিজ্ঞাপনটি এড়িয়ে যাওয়ার যোগ্য ছিল কি না। |
mediaQuartile | ঐচ্ছিক। মিডিয়ার যে পরিমাণ অংশ আলাদা আলাদা চতুর্থাংশে দেখানো হয়েছে। |
mediaDuration | ঐচ্ছিক। বিজ্ঞাপন মাধ্যমের সময়কাল। সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' |
mediaVolumePercent | ঐচ্ছিক। মিডিয়া প্লেব্যাকের ভলিউমের সংখ্যাসূচক শতাংশ (০-১০০)। |
playbackDuration | ঐচ্ছিক। বিজ্ঞাপনটি দেখা গেছে কি না, তা নির্বিশেষে এর প্রদর্শনের সময়কাল। সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' |
ভিউটাইপ
ঘটনাটির ধরণ।
| এনাম | |
|---|---|
VIEW_TYPE_UNSPECIFIED | অনির্দিষ্ট ভিউ টাইপ। |
VIEW_TYPE_MRC_VIEWED | এমআরসি দেখেছে। |
VIEW_TYPE_MRC_RENDERED | এমআরসি প্রদান করেছে। |
মিডিয়াকোয়ার্টাইল
যে পরিমাণ মিডিয়া চালানো হয়েছিল, তা পৃথক চতুর্থাংশে বিভক্ত।
| এনাম | |
|---|---|
MEDIA_QUARTILE_UNSPECIFIED | অনির্দিষ্ট মধ্যক চতুর্থাংশ। |
MEDIA_QUARTILE_START | শুরু করুন। |
MEDIA_QUARTILE_FIRST_QUARTILE | প্রথম চতুর্থাংশ। |
MEDIA_QUARTILE_MIDPOINT | মধ্যবিন্দু। |
MEDIA_QUARTILE_THIRD_QUARTILE | তৃতীয় কোয়ার্টাইল। |
MEDIA_QUARTILE_COMPLETE | সম্পূর্ণ। |