- HTTP অনুরোধ
- অনুরোধের বডি
- প্রতিক্রিয়ার বডি
- অনুমোদনের স্কোপ
- AdEvent
- EventType
- EventSubtype
- AdType
- AdFormat
- AdPlacement
- TargetingType
- PlatformType
- প্ল্যাটফর্ম
- AttributionHint
- ViewabilityInfo
- ViewType
- MediaQuartile
- এটি ব্যবহার করে দেখুন!
Google Analytics-এ AdEvent রিসোর্সের তালিকা আপলোড করে।
এই ফিচার শুধুমাত্র সেইসব অ্যাকাউন্টের জন্য উপলভ্য যেগুলি অনুমোদিত তালিকায় আছে।
অনুমোদন হেডার:
এই পদ্ধতিতে, API কীভাবে অনুরোধের অ্যাক্সেস অনুমোদন করবে তা নির্ধারণ করার জন্য নিম্নলিখিত হেডারও প্রয়োজন:
login-account: (প্রয়োজনীয়) ডেটা পার্টনার অ্যাকাউন্টের রিসোর্স নেম যেখানে ক্রেডেনশিয়ালের Google অ্যাকাউন্ট হল একজন ব্যবহারকারী। ফর্ম্যাট:accountTypes/DATA_PARTNER/accounts/{loginAccountId}
HTTP অনুরোধ
POST https://datamanager.googleapis.com/v1/adEvents:ingest
URL-এ gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়।
অনুরোধের বডি
অনুরোধের বডিতে নিম্নলিখিত স্ট্রাকচার সহ ডেটা থাকে:
| JSON উপস্থাপনা |
|---|
{ "adEvents": [ { object ( |
| ফিল্ড | |
|---|---|
adEvents[] |
প্রয়োজনীয়। প্রয়োজনীয় (অন্তত ১টি)। বিজ্ঞাপন ইভেন্টের তালিকা। |
encryptionInfo |
ঐচ্ছিক। ডেটা এনক্রিপ্ট করার জন্য ব্যবহৃত এনক্রিপশন কী সম্পর্কে তথ্য। বিজ্ঞাপন ইভেন্টে |
validateOnly |
ঐচ্ছিক। যদি 'true' হয়, তাহলে অনুরোধটি যাচাই করা হয়েছে, কিন্তু কার্যকর করা হয়নি। |
প্রতিক্রিয়ার বডি
সফল হলে, উত্তরের বডি খালি থাকে।
অনুমোদনের স্কোপ
এটির জন্য নিম্নলিখিত OAuth স্কোপ প্রয়োজন:
https://www.googleapis.com/auth/datamanager
AdEvent
বিজ্ঞাপন ইভেন্ট।
| JSON উপস্থাপনা |
|---|
{ "advertiserId": string, "eventType": enum ( |
| ফিল্ড | |
|---|---|
advertiserId |
প্রয়োজনীয়। বিজ্ঞাপন ইভেন্টের জন্য বিজ্ঞাপনদাতার আইডি। লিঙ্ক করার ফ্লোতে পাঠানো আইডির সাথে এটি মিলতে হবে। |
eventType |
প্রয়োজনীয়। ইভেন্টের ধরন। |
timestamp |
প্রয়োজনীয়। ইভেন্টটি যে সময় ঘটেছে। RFC 3339 ব্যবহার করে, যেখানে জেনারেট করা আউটপুট সবসময় Z-নরম্যালাইজ করা হবে এবং ০, ৩, ৬ বা ৯ ফ্র্যাকশনাল ডিজিট ব্যবহার করা হবে। "Z" ছাড়া অন্য অফসেটও গ্রহণ করা হয়। উদাহরণ: |
eventId |
ঐচ্ছিক। কলার তৈরি ও ম্যানেজ করা একটি আইডি যা এই ইভেন্টকে অনন্যভাবে শনাক্ত করে। একাধিক অনুরোধে অন্তর্ভুক্ত বিজ্ঞাপন ইভেন্ট ডুপ্লিকেট করতে চাইলে এটি প্রয়োজন। অন্যথায়, এই ফিল্ডটি ঐচ্ছিক। |
userData |
ঐচ্ছিক। ব্যবহারকারীর দেওয়া একাধিক ডেটা, যা ইভেন্টের সাথে যুক্ত ব্যবহারকারীকে প্রতিনিধিত্ব করে। একই ধরনের ডেটার একাধিক উদাহরণ (যেমন, ইমেল আইডি) দেওয়া সম্ভব। যত বেশি ডেটা প্রদান করা হবে, ম্যাচ খুঁজে পাওয়ার সম্ভাবনা তত বেশি হবে। |
deviceInfo |
প্রয়োজনীয়। বিজ্ঞাপন ইভেন্ট হওয়ার সময় ব্যবহার করা ডিভাইস সম্পর্কে সংগ্রহ করা তথ্য। |
ipAddress |
ঐচ্ছিক। পরিমাপের জন্য ব্যবহৃত IP অ্যাড্রেস। |
mobileDeviceId |
ঐচ্ছিক। যে ডিভাইসে বিজ্ঞাপন দেখানো হয়েছে সেটির ডিভাইস আইডি। |
campaignId |
প্রয়োজনীয়। সম্পর্কিত ক্যাম্পেনের আইডি। |
campaignName |
প্রয়োজনীয়। সংশ্লিষ্ট ক্যাম্পেনের নাম। |
adGroupId |
ঐচ্ছিক। সংশ্লিষ্ট বিজ্ঞাপন গ্রুপের আইডি। |
adId |
ঐচ্ছিক। গ্রুপের মধ্যে সংশ্লিষ্ট বিজ্ঞাপনের আইডি। |
adHeight |
ঐচ্ছিক। পিক্সেলে বিজ্ঞাপনের উচ্চতা। |
adWidth |
ঐচ্ছিক। বিজ্ঞাপনের প্রস্থ পিক্সেলে। |
regionCode |
ঐচ্ছিক। ISO 3166-2 দেশের কোড ও তার সাথে সাবডিভিশন। |
source |
প্রয়োজনীয়। Google Analytics সোর্সের মতো বিজ্ঞাপনের প্ল্যাটফর্ম সোর্স। |
medium |
প্রয়োজনীয়। বিজ্ঞাপনের মাধ্যম, যা Google Analytics-এর মাধ্যমের মতো। |
attributionHint |
ঐচ্ছিক। এই বিজ্ঞাপন ইভেন্টের জন্য পার্টনারের অনুমান করা অ্যাট্রিবিউশন স্ট্যাটাস। পার্টনার কীভাবে অ্যাট্রিবিউশন কাজ করে বলে ধরে নিয়েছেন, এটি শুধুমাত্র সেই বিষয়ে একটি সিগন্যাল হিসেবে কাজ করে এবং চূড়ান্ত রিপোর্টে কোনও ফলাফল জোর করে দেখায় না। |
viewabilityInfo |
প্রয়োজনীয়। পরিবেশিত বিজ্ঞাপনের ভিউয়েবিলিটির বিবরণ। |
ঐচ্ছিক। বিজ্ঞাপন ইভেন্টের ধরন সম্পর্কে অতিরিক্ত ক্লাসিফিকেশন। পিওর এনাম ছাড়া অন্য ভ্যালু ম্যানেজ করার জন্য একটি র স্ট্রিং গ্রহণ করা হয়। সম্ভব হলে enum ব্যবহার করা ভাল। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। কোনও উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে: |
|
eventSubtype |
ইভেন্ট সাবটাইপের জন্য এনুম ভ্যালু। |
eventSubtypeString |
ইভেন্ট সাবটাইপের জন্য স্ট্রিং ভ্যালু। |
| পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের শেষ। | |
ঐচ্ছিক। দেখানো বিজ্ঞাপনের ধরন। পিওর এনাম ছাড়া অন্য ভ্যালু ম্যানেজ করার জন্য একটি র স্ট্রিং গ্রহণ করা হয়। সম্ভব হলে enum ব্যবহার করা ভাল। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। কোনও উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে: |
|
adType |
বিজ্ঞাপনের ধরনের জন্য এনুম ভ্যালু। |
adTypeString |
বিজ্ঞাপনের ধরনের জন্য স্ট্রিং ভ্যালু। |
| পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের শেষ। | |
ঐচ্ছিক। দেখানো বিজ্ঞাপনের ধরন। পিওর এনাম ছাড়া অন্য ভ্যালু ম্যানেজ করার জন্য একটি র স্ট্রিং গ্রহণ করা হয়। সম্ভব হলে enum ব্যবহার করা ভাল। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। কোনও উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে: |
|
adFormat |
বিজ্ঞাপন ফর্ম্যাটের জন্য এনুম ভ্যালু। |
adFormatString |
বিজ্ঞাপন ফর্ম্যাটের জন্য স্ট্রিং ভ্যালু। |
| পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের শেষ। | |
ঐচ্ছিক। পরিবেশিত বিজ্ঞাপনের প্লেসমেন্ট। পিওর এনাম ছাড়া অন্য ভ্যালু ম্যানেজ করার জন্য একটি র স্ট্রিং গ্রহণ করা হয়। সম্ভব হলে enum ব্যবহার করা ভাল। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। কোনও উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে: |
|
adPlacement |
বিজ্ঞাপন প্লেসমেন্টের জন্য এনুম ভ্যালু। |
adPlacementString |
বিজ্ঞাপন প্লেসমেন্টের জন্য স্ট্রিং ভ্যালু। |
| পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের শেষ। | |
ঐচ্ছিক। বিজ্ঞাপন দেখানোর জন্য ব্যবহৃত টার্গেটিংয়ের ধরন। পিওর এনাম ছাড়া অন্য ভ্যালু ম্যানেজ করার জন্য একটি র স্ট্রিং গ্রহণ করা হয়। সম্ভব হলে enum ব্যবহার করা ভাল। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। কোনও উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে: |
|
targetingType |
টার্গেটিংয়ের ধরনের জন্য এনুম ভ্যালু। |
targetingTypeString |
টার্গেটিং ধরনের জন্য স্ট্রিং ভ্যালু। |
| পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের শেষ। | |
ঐচ্ছিক। যে প্ল্যাটফর্মে বিজ্ঞাপন দেখানো হয়েছে তার ধরন। পিওর এনাম ছাড়া অন্য ভ্যালু ম্যানেজ করার জন্য একটি র স্ট্রিং গ্রহণ করা হয়। সম্ভব হলে enum ব্যবহার করা ভাল। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। কোনও উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে: |
|
platformType |
প্ল্যাটফর্মের ধরনের জন্য এনুম ভ্যালু। |
platformTypeString |
প্ল্যাটফর্মের ধরনের জন্য স্ট্রিং ভ্যালু। |
| পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের শেষ। | |
ঐচ্ছিক। যে প্ল্যাটফর্মে বিজ্ঞাপন দেখানো হয়েছে তার আরও বিবরণ। পিওর এনাম ছাড়া অন্য ভ্যালু ম্যানেজ করার জন্য একটি র স্ট্রিং গ্রহণ করা হয়। সম্ভব হলে enum ব্যবহার করা ভাল। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। কোনও উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে: |
|
platform |
প্ল্যাটফর্মের জন্য এনুম ভ্যালু। |
platformString |
প্ল্যাটফর্মের জন্য স্ট্রিং ভ্যালু। |
| পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের শেষ। | |
measurementAllowed |
ঐচ্ছিক। প্রতিনিধিত্ব করে যে সারিটি পরিমাপের উদ্দেশ্যে ব্যবহার করার অনুমতি দেওয়া হয়েছে কিনা, কারণ এটি আঞ্চলিক এখতিয়ারের মধ্যে প্রযোজ্য গোপনীয়তা আইন দ্বারা পরিচালিত হয়। |
EventType
ইভেন্টের ধরন।
| Enums | |
|---|---|
EVENT_TYPE_UNSPECIFIED |
নির্দিষ্ট না করা ইভেন্টের ধরন। |
EVENT_TYPE_VIEW |
ইভেন্ট দেখুন। |
EVENT_TYPE_CLICK |
ইভেন্টে ক্লিক করুন। |
EventSubtype
বিজ্ঞাপন ইভেন্টের ধরন সম্পর্কে অতিরিক্ত ক্লাসিফিকেশন।
| Enums | |
|---|---|
EVENT_SUBTYPE_UNSPECIFIED |
নির্দিষ্ট না করা ইভেন্ট সাবটাইপ। |
EVENT_SUBTYPE_IMPRESSION |
ইম্প্রেশন ইভেন্ট। |
EVENT_SUBTYPE_ENGAGED_VIEW |
এনগেজড ভিউ ইভেন্ট। |
EVENT_SUBTYPE_ONSITE_CLICK |
অনসাইট ক্লিক ইভেন্ট। |
EVENT_SUBTYPE_OUTBOUND_CLICK |
আউটবাউন্ড ক্লিক ইভেন্ট। |
AdType
দেখানো বিজ্ঞাপনের ধরন।
| Enums | |
|---|---|
AD_TYPE_UNSPECIFIED |
বিজ্ঞাপনের ধরন নির্দিষ্ট করা নেই। |
AD_TYPE_DISPLAY |
ডিসপ্লে বিজ্ঞাপন। |
AD_TYPE_TEXT |
টেক্সট বিজ্ঞাপন। |
AD_TYPE_IMAGE |
ছবি যুক্ত বিজ্ঞাপন। |
AD_TYPE_RICH_MEDIA |
রিচ মিডিয়া বিজ্ঞাপন। |
AD_TYPE_HTML |
HTML বিজ্ঞাপন। |
AD_TYPE_AUDIO |
অডিও বিজ্ঞাপন। |
AD_TYPE_VIDEO |
ভিডিও বিজ্ঞাপন। |
AdFormat
পরিবেশিত বিজ্ঞাপনের ফর্ম্যাট।
| Enums | |
|---|---|
AD_FORMAT_UNSPECIFIED |
অনির্দিষ্ট বিজ্ঞাপন ফর্ম্যাট। |
AD_FORMAT_AR |
এ আর (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 |
Shorts বিজ্ঞাপন। |
AD_FORMAT_STORY |
স্টোরি বিজ্ঞাপন। |
AD_FORMAT_SPONSORED |
স্পনসর করা বিজ্ঞাপন। |
AD_FORMAT_VIDEO |
ভিডিও বিজ্ঞাপন। |
AdPlacement
পরিবেশিত বিজ্ঞাপনের প্লেসমেন্ট।
| Enums | |
|---|---|
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 |
স্টোরি প্লেসমেন্ট। |
TargetingType
বিজ্ঞাপন দেখানোর জন্য ব্যবহৃত টার্গেটিংয়ের ধরন।
| Enums | |
|---|---|
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 |
রিমার্কেটিং টার্গেটিং। |
PlatformType
যে প্ল্যাটফর্মে বিজ্ঞাপন দেখানো হয়েছে তার ধরন।
| Enums | |
|---|---|
PLATFORM_TYPE_UNSPECIFIED |
নির্দিষ্ট নয় এমন প্ল্যাটফর্মের ধরন। |
PLATFORM_TYPE_MOBILE |
মোবাইল প্ল্যাটফর্ম। |
PLATFORM_TYPE_DESKTOP |
ডেস্কটপ প্ল্যাটফর্ম। |
PLATFORM_TYPE_CTV |
CTV প্ল্যাটফর্ম। |
PLATFORM_TYPE_PHONE |
ফোন প্ল্যাটফর্ম। |
PLATFORM_TYPE_TABLET |
ট্যাবলেট প্ল্যাটফর্ম। |
প্ল্যাটফর্ম
যে প্ল্যাটফর্মে বিজ্ঞাপন দেখানো হয়েছে তার আরও বিবরণ।
| Enums | |
|---|---|
PLATFORM_UNSPECIFIED |
অনির্দিষ্ট প্ল্যাটফর্ম। |
PLATFORM_IOS |
iOS প্ল্যাটফর্ম। |
PLATFORM_ANDROID |
Android প্ল্যাটফর্ম। |
PLATFORM_WEB |
ওয়েব প্ল্যাটফর্ম। |
AttributionHint
এই বিজ্ঞাপন ইভেন্টের জন্য পার্টনারের অনুমান করা অ্যাট্রিবিউশন স্ট্যাটাস।
| Enums | |
|---|---|
ATTRIBUTION_HINT_UNSPECIFIED |
অ্যাট্রিবিউশন স্ট্যাটাস জানা নেই। |
ATTRIBUTION_HINT_CONVERTED |
কনভার্ট করা স্ট্যাটাস। |
ATTRIBUTION_HINT_NOT_CONVERTED |
কনভার্ট করা হয়নি এমন স্ট্যাটাস। |
ViewabilityInfo
পরিবেশিত বিজ্ঞাপনের ভিউয়েবিলিটির বিবরণ।
| JSON উপস্থাপনা |
|---|
{ "viewType": enum ( |
| ফিল্ড | |
|---|---|
viewType |
প্রয়োজনীয়। ইভেন্টের ধরন। |
viewablePercent |
ঐচ্ছিক। ভিউয়েবল পিক্সেলের সংখ্যাগত শতকরা হার (০-১০০)। |
viewableDuration |
ঐচ্ছিক। বিজ্ঞাপনটি কতক্ষণ দেখা গেছে। ' |
mediaSkippable |
ঐচ্ছিক। বিজ্ঞাপন মিডিয়া স্কিপ করা যায় কিনা। |
mediaQuartile |
ঐচ্ছিক। আলাদা কোয়ার্টাইল হিসেবে চালানো মিডিয়ার পরিমাণ। |
mediaDuration |
ঐচ্ছিক। বিজ্ঞাপন মিডিয়ার সময়সীমা। ' |
mediaVolumePercent |
ঐচ্ছিক। মিডিয়া প্লেব্যাকের ভলিউমের সংখ্যাগত শতাংশ (০-১০০)। |
playbackDuration |
ঐচ্ছিক। বিজ্ঞাপন মিডিয়া কতক্ষণ প্লেব্যাক করা হয়েছে, সেটি দেখা গেছে কিনা তা নির্বিশেষে। ' |
ViewType
ইভেন্টের ধরন।
| Enums | |
|---|---|
VIEW_TYPE_UNSPECIFIED |
নির্দিষ্ট না করা ভিউয়ের ধরন। |
VIEW_TYPE_MRC_VIEWED |
MRC দেখা হয়েছে। |
VIEW_TYPE_MRC_RENDERED |
MRC রেন্ডার করা হয়েছে। |
MediaQuartile
আলাদা কোয়ার্টাইল হিসেবে চালানো মিডিয়ার পরিমাণ।
| Enums | |
|---|---|
MEDIA_QUARTILE_UNSPECIFIED |
অনির্দিষ্ট মিডিয়া কোয়ার্টাইল। |
MEDIA_QUARTILE_START |
শুরু করুন। |
MEDIA_QUARTILE_FIRST_QUARTILE |
প্রথম কোয়ার্টাইল। |
MEDIA_QUARTILE_MIDPOINT |
মিডপয়েন্ট। |
MEDIA_QUARTILE_THIRD_QUARTILE |
তৃতীয় কোয়ার্টাইল। |
MEDIA_QUARTILE_COMPLETE |
সম্পূর্ণ হয়েছে। |