Method: events.ingest

প্রদত্ত Destination থেকে Event রিসোর্সের একটি তালিকা আপলোড করে।

HTTP অনুরোধ

POST https://datamanager.googleapis.com/v1/events:ingest

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  }
}
ক্ষেত্র
destinations[]

object ( Destination )

প্রয়োজনীয়। যে গন্তব্যস্থলগুলিতে ইভেন্টগুলি পাঠাতে হবে তার তালিকা।

events[]

object ( Event )

প্রয়োজনীয়। নির্দিষ্ট গন্তব্যগুলিতে পাঠানোর জন্য ইভেন্টগুলির তালিকা। একটি অনুরোধে সর্বাধিক ২০০০টি Event রিসোর্স পাঠানো যাবে।

consent

object ( Consent )

ঐচ্ছিক। অনুরোধ-স্তরের সম্মতি অনুরোধের সকল ব্যবহারকারীর জন্য প্রযোজ্য হবে। ব্যবহারকারী-স্তরের সম্মতি অনুরোধ-স্তরের সম্মতিকে অগ্রাহ্য করে এবং এটি প্রতিটি Event নির্দিষ্ট করা যেতে পারে।

validateOnly

boolean

ঐচ্ছিক। পরীক্ষার উদ্দেশ্যে। যদি true , তাহলে অনুরোধটি যাচাই করা হয় কিন্তু কার্যকর করা হয় না। শুধুমাত্র ত্রুটিগুলো ফেরত দেওয়া হয়, কোনো ফলাফল নয়।

encoding

enum ( Encoding )

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

encryptionInfo

object ( EncryptionInfo )

ঐচ্ছিক। UserData আপলোডের জন্য এনক্রিপশন তথ্য। এটি সেট করা না থাকলে, ধরে নেওয়া হয় যে আপলোড করা শনাক্তকারী তথ্য হ্যাশ করা হয়েছে কিন্তু এনক্রিপ্ট করা হয়নি। নন UserData আপলোডের ক্ষেত্রে এই ফিল্ডটি উপেক্ষা করা হয়।

প্রতিক্রিয়া সংস্থা

IngestEventsRequest থেকে প্রাপ্ত প্রতিক্রিয়া।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "requestId": string
}
ক্ষেত্র
requestId

string

অনুরোধটির স্বয়ংক্রিয়ভাবে তৈরি হওয়া আইডি।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/datamanager

অনুষ্ঠান

একটি ইভেন্ট যা কোনো বিজ্ঞাপনদাতার ওয়েবসাইট বা অ্যাপের সাথে ব্যবহারকারীর মিথস্ক্রিয়াকে নির্দেশ করে।

JSON উপস্থাপনা 
{
  "destinationReferences": [
    string
  ],
  "transactionId": string,
  "eventTimestamp": string,
  "lastUpdatedTimestamp": string,
  "userData": {
    object (UserData)
  },
  "consent": {
    object (Consent)
  },
  "adIdentifiers": {
    object (AdIdentifiers)
  },
  "currency": string,
  "eventSource": enum (EventSource),
  "eventDeviceInfo": {
    object (DeviceInfo)
  },
  "cartData": {
    object (CartData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "experimentalFields": [
    {
      object (ExperimentalField)
    }
  ],
  "userProperties": {
    object (UserProperties)
  },
  "eventName": string,
  "clientId": string,
  "userId": string,
  "additionalEventParameters": [
    {
      object (EventParameter)
    }
  ],
  "thirdPartyUserData": {
    object (UserData)
  },
  "eventLocation": {
    object (EventLocation)
  },
  "appInstanceId": string,
  "conversionValue": number,
  "conversionCount": number
}
ক্ষেত্র
destinationReferences[]

string

ঐচ্ছিক। গন্তব্য নির্ধারণ করতে ব্যবহৃত রেফারেন্স স্ট্রিং। এটি খালি থাকলে, ইভেন্টটি অনুরোধে থাকা সমস্ত destinations পাঠানো হবে।

transactionId

string

ঐচ্ছিক। এই ইভেন্টের অনন্য শনাক্তকারী। ট্যাগ রূপান্তরের জন্য অতিরিক্ত ডেটা উৎস হিসেবে পাঠানো ইভেন্টগুলোর ক্ষেত্রে এটি আবশ্যক।

eventTimestamp

string ( Timestamp format)

প্রয়োজনীয়। ঘটনাটি ঘটার সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

lastUpdatedTimestamp

string ( Timestamp format)

ঐচ্ছিক। ইভেন্টটি সর্বশেষ আপডেট করার সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

userData

object ( UserData )

ঐচ্ছিক। ব্যবহারকারীর দেওয়া তথ্যের অংশবিশেষ, যা ইভেন্টটির সাথে সংশ্লিষ্ট ব্যবহারকারীকে প্রতিনিধিত্ব করে।

consent

object ( Consent )

ঐচ্ছিক। সংশ্লিষ্ট ব্যবহারকারী বিভিন্ন ধরনের সম্মতি প্রদান করেছেন কিনা, সে সম্পর্কিত তথ্য।

adIdentifiers

object ( AdIdentifiers )

ঐচ্ছিক। শনাক্তকারী এবং অন্যান্য তথ্য যা রূপান্তর ঘটনাটিকে অন্যান্য অনলাইন কার্যকলাপের (যেমন বিজ্ঞাপনে ক্লিক) সাথে মেলাতে ব্যবহৃত হয়।

currency

string

ঐচ্ছিক। এই ইভেন্টের অন্তর্ভুক্ত সকল আর্থিক মূল্যের সাথে সংশ্লিষ্ট মুদ্রা কোড।

eventSource

enum ( EventSource )

ঐচ্ছিক। ঘটনাটি কোথায় ঘটেছে তার সংকেত দিন (ওয়েব, অ্যাপ, দোকানে, ইত্যাদি)।

eventDeviceInfo

object ( DeviceInfo )

ঐচ্ছিক। ঘটনাটি ঘটার সময় ব্যবহৃত ডিভাইস (যদি থাকে) সম্পর্কে সংগৃহীত তথ্য।

cartData

object ( CartData )

ঐচ্ছিক। লেনদেন এবং ঘটনাটির সাথে সংশ্লিষ্ট আইটেম সম্পর্কিত তথ্য।

customVariables[]

object ( CustomVariable )

ঐচ্ছিক। রূপান্তর কন্টেইনারগুলিতে (রূপান্তর অ্যাকশন বা FL অ্যাক্টিভিটি) পাঠানোর জন্য অতিরিক্ত কী/ভ্যালু পেয়ার তথ্য।

experimentalFields[]

object ( ExperimentalField )

ঐচ্ছিক। পরীক্ষামূলক ক্ষেত্রগুলির জন্য কী/ভ্যালু জোড়ের একটি তালিকা, যেগুলি অবশেষে এপিআই-এর অংশ হিসেবে উন্নীত হতে পারে।

userProperties

object ( UserProperties )

ঐচ্ছিক। ঘটনাটি ঘটার সময়ে ব্যবহারকারী সম্পর্কে বিজ্ঞাপনদাতা কর্তৃক মূল্যায়নকৃত তথ্য।

eventName

string

ঐচ্ছিক। অনুষ্ঠানের নাম। GA4 অনুষ্ঠানগুলোর জন্য আবশ্যক।

clientId

string

ঐচ্ছিক। এই GA4 ওয়েব স্ট্রিমের জন্য ওয়েব ক্লায়েন্টের ব্যবহারকারী ইনস্ট্যান্সের একটি অনন্য শনাক্তকারী।

userId

string

ঐচ্ছিক। বিজ্ঞাপনদাতা কর্তৃক নির্ধারিত ব্যবহারকারীর একটি অনন্য শনাক্তকারী।

additionalEventParameters[]

object ( EventParameter )

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

thirdPartyUserData

object ( UserData )

ঐচ্ছিক। userData-তে প্রদত্ত একই ধরনের ডেটা, কিন্তু এটিকে স্পষ্টভাবে তৃতীয় পক্ষের মালিকানাধীন ডেটা হিসাবে চিহ্নিত করা হয় এবং এটি কোনো প্রথম পক্ষের বিজ্ঞাপনদাতার ডেটা নয়।

eventLocation

object ( EventLocation )

ঐচ্ছিক। এই ঘটনাটি ঘটার সময় ব্যবহারকারীর অবস্থান সম্পর্কে সংগৃহীত তথ্য।

appInstanceId

string

ঐচ্ছিক। এই GA4 অ্যাপ স্ট্রিমের জন্য অ্যাপ ক্লায়েন্টের ব্যবহারকারী ইনস্ট্যান্সের একটি অনন্য শনাক্তকারী।

conversionValue

number

ঐচ্ছিক। মান-ভিত্তিক রূপান্তরের জন্য, ইভেন্টটির সাথে সংশ্লিষ্ট রূপান্তর মান।

conversionCount

number

ঐচ্ছিক। গণনা-ভিত্তিক রূপান্তরের জন্য, ইভেন্টটির সাথে যুক্ত রূপান্তরের পরিমাণ।

AdIdentifiers

রূপান্তর ঘটনাটিকে অন্যান্য অনলাইন কার্যকলাপের (যেমন বিজ্ঞাপনে ক্লিক) সাথে মেলানোর জন্য ব্যবহৃত শনাক্তকারী এবং অন্যান্য তথ্য।

JSON উপস্থাপনা 
{
  "sessionAttributes": string,
  "gclid": string,
  "gbraid": string,
  "wbraid": string,
  "landingPageDeviceInfo": {
    object (DeviceInfo)
  },
  "mobileDeviceId": string,
  "dclid": string,
  "impressionId": string,
  "matchId": string,
  "encryptedUserIds": [
    {
      object (EncryptedUserId)
    }
  ]
}
ক্ষেত্র
sessionAttributes

string

ঐচ্ছিক। ইভেন্ট অ্যাট্রিবিউশন এবং মডেলিংয়ের জন্য সেশন অ্যাট্রিবিউটসমূহ।

gclid

string

ঐচ্ছিক। এই ইভেন্টের সাথে যুক্ত গুগল ক্লিক আইডি (gclid)।

gbraid

string

ঐচ্ছিক। iOS14 থেকে শুরু করে, অ্যাপ ইভেন্টের সাথে যুক্ত এবং iOS ডিভাইস থেকে উদ্ভূত ক্লিকের জন্য ক্লিক শনাক্তকারী।

wbraid

string

ঐচ্ছিক। iOS14 থেকে শুরু করে, ওয়েব ইভেন্টের সাথে যুক্ত এবং iOS ডিভাইস থেকে উদ্ভূত ক্লিকের জন্য ক্লিক শনাক্তকারী।

landingPageDeviceInfo

object ( DeviceInfo )

ঐচ্ছিক। বিজ্ঞাপনের সাথে মিথস্ক্রিয়ার পর বিজ্ঞাপনদাতার সাইটে প্রবেশ করার সময়ে ব্যবহৃত ডিভাইস (যদি থাকে) সম্পর্কে সংগৃহীত তথ্য।

mobileDeviceId

string

ঐচ্ছিক। বিজ্ঞাপনদাতাদের জন্য মোবাইল শনাক্তকারী। এটি iOS-এ IDFA, Android-এ AdID, বা বিজ্ঞাপনদাতাদের জন্য অন্যান্য প্ল্যাটফর্মের শনাক্তকারী হতে পারে।

dclid

string

ঐচ্ছিক। এই ইভেন্টের সাথে যুক্ত ডিসপ্লে ক্লিক আইডি।

impressionId

string

ঐচ্ছিক। এই ইভেন্টের সাথে যুক্ত ইম্প্রেশন আইডি।

matchId

string

ঐচ্ছিক। এই ইভেন্টটিকে পূর্ববর্তী কোনো ইভেন্টের সাথে যুক্ত করতে ম্যাচ আইডি ফিল্ডটি ব্যবহৃত হয়।

encryptedUserIds[]

object ( EncryptedUserId )

ঐচ্ছিক। যেকোনো সংখ্যক এনক্রিপ্টেড ইউজার আইডি।

ডিভাইসইনফো

ঘটনাটি ঘটার সময় ব্যবহৃত ডিভাইস সম্পর্কিত তথ্য (যদি থাকে)।

JSON উপস্থাপনা 
{
  "userAgent": string,
  "ipAddress": string,
  "category": string,
  "languageCode": string,
  "screenHeight": integer,
  "screenWidth": integer,
  "operatingSystem": string,
  "operatingSystemVersion": string,
  "model": string,
  "brand": string,
  "browser": string,
  "browserVersion": string
}
ক্ষেত্র
userAgent

string

ঐচ্ছিক। প্রদত্ত প্রেক্ষাপটের জন্য ডিভাইসটির ইউজার-এজেন্ট স্ট্রিং।

ipAddress

string

ঐচ্ছিক। প্রদত্ত প্রেক্ষাপটের জন্য ডিভাইসটির আইপি ঠিকানা।

দ্রষ্টব্য: গুগল অ্যাডস ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য (UK), বা সুইজারল্যান্ড (CH)-এর ব্যবহারকারীদের জন্য আইপি অ্যাড্রেস মেলানো সমর্থন করে না। এই অঞ্চলগুলির ব্যবহারকারীদের আইপি অ্যাড্রেস শর্তসাপেক্ষে শেয়ার করা থেকে বাদ দেওয়ার জন্য লজিক যোগ করুন এবং নিশ্চিত করুন যে আপনি আপনার সাইট, অ্যাপ এবং অন্যান্য প্রপার্টিতে সংগৃহীত ডেটা সম্পর্কে ব্যবহারকারীদের স্পষ্ট ও বিস্তারিত তথ্য প্রদান করছেন এবং আইন বা প্রযোজ্য গুগল নীতিমালার দ্বারা যেখানে প্রয়োজন সেখানে সম্মতি নিচ্ছেন। আরও বিস্তারিত তথ্যের জন্য ‘অফলাইন কনভার্সন ইমপোর্ট সম্পর্কে’ পৃষ্ঠাটি দেখুন।

category

string

ঐচ্ছিক। ডিভাইসের বিভাগ। যেমন, “ডেস্কটপ”, “ট্যাবলেট”, “মোবাইল”, “স্মার্ট টিভি”।

languageCode

string

ঐচ্ছিক। ডিভাইসটি যে ভাষাটি ISO 639-1 ফরম্যাটে ব্যবহার করে।

screenHeight

integer

ঐচ্ছিক। স্ক্রিনের উচ্চতা, পিক্সেল এককে।

screenWidth

integer

ঐচ্ছিক। স্ক্রিনের প্রস্থ, পিক্সেল এককে।

operatingSystem

string

ঐচ্ছিক। ডিভাইসটির অপারেটিং সিস্টেম বা প্ল্যাটফর্ম।

operatingSystemVersion

string

ঐচ্ছিক। অপারেটিং সিস্টেম বা প্ল্যাটফর্মের সংস্করণ।

model

string

ঐচ্ছিক। ডিভাইসটির মডেল।

brand

string

ঐচ্ছিক। ডিভাইসটির ব্র্যান্ড।

browser

string

ঐচ্ছিক। ব্রাউজারের ব্র্যান্ড বা ধরন।

browserVersion

string

ঐচ্ছিক। ব্রাউজারের সংস্করণ।

এনক্রিপ্টেডইউজারআইডি

ব্যবহারকারীর পরিচয় শনাক্তকরণের জন্য প্রদত্ত একটি শনাক্তকারী। এটি ব্যবহার করা হলে সমস্ত ক্ষেত্র পূরণ করা আবশ্যক।

JSON উপস্থাপনা 
{
  "encryptedId": string,
  "entityType": enum (EncryptionEntityType),
  "entityId": string,
  "source": enum (EncryptionSource)
}
ক্ষেত্র
encryptedId

string

আবশ্যক। বর্ণ ও সংখ্যা দিয়ে এনক্রিপ্ট করা আইডি।

entityType

enum ( EncryptionEntityType )

আবশ্যক। এনক্রিপশন এনটিটি টাইপ। এটি অবশ্যই বিজ্ঞাপন পরিবেশন বা ডেটা স্থানান্তরের এনক্রিপশন কনফিগারেশনের সাথে মিলতে হবে।

entityId

string ( int64 format)

আবশ্যক। এনক্রিপশন এনটিটি আইডি। এটি অবশ্যই বিজ্ঞাপন পরিবেশন বা ডেটা স্থানান্তরের এনক্রিপশন কনফিগারেশনের সাথে মিলতে হবে।

source

enum ( EncryptionSource )

আবশ্যক। এটি বর্ণনা করে যে এনক্রিপ্টেড কুকিটি বিজ্ঞাপন পরিবেশন (%m ম্যাক্রো) থেকে নাকি ডেটা ট্রান্সফার থেকে পাওয়া গেছে।

এনক্রিপশনএন্টিটিটাইপ

এনক্রিপশন সত্তার প্রকার।

এনাম
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED অনির্দিষ্ট এনক্রিপশন সত্তার ধরণ।
CAMPAIGN_MANAGER_ACCOUNT ক্যাম্পেইন ম্যানেজার ৩৬০ অ্যাকাউন্ট।
CAMPAIGN_MANAGER_ADVERTISER ক্যাম্পেইন ম্যানেজার ৩৬০ বিজ্ঞাপনদাতা।
DISPLAY_VIDEO_PARTNER ডিসপ্লে ও ভিডিও ৩৬০ পার্টনার।
DISPLAY_VIDEO_ADVERTISER ডিসপ্লে ও ভিডিও ৩৬০ বিজ্ঞাপনদাতা।
GOOGLE_ADS_CUSTOMER গুগল অ্যাডস গ্রাহক।
GOOGLE_AD_MANAGER_NETWORK_CODE গুগল অ্যাড ম্যানেজার নেটওয়ার্ক কোড।

এনক্রিপশন উৎস

এনক্রিপশনের উৎস।

এনাম
ENCRYPTION_SOURCE_UNSPECIFIED অনির্দিষ্ট এনক্রিপশন উৎস।
AD_SERVING বিজ্ঞাপন পরিবেশনের এনক্রিপশন উৎস।
DATA_TRANSFER ডেটা স্থানান্তর এনক্রিপশনের উৎস।

ইভেন্টসোর্স

ঘটনাটির উৎস।

এনাম
EVENT_SOURCE_UNSPECIFIED অনির্দিষ্ট ইভেন্ট সোর্স। এটি কখনোই ব্যবহার করা উচিত নয়।
WEB ইভেন্টটি একটি ওয়েব ব্রাউজার থেকে তৈরি করা হয়েছিল।
APP ইভেন্টটি একটি অ্যাপ থেকে তৈরি করা হয়েছিল।
IN_STORE ঘটনাটি দোকানের ভেতরের একটি লেনদেন থেকে তৈরি হয়েছিল।
PHONE একটি ফোন কল থেকে ইভেন্টটি তৈরি হয়েছিল।
MESSAGE ইভেন্টটি একটি বার্তা থেকে তৈরি হয়েছিল।
OTHER ঘটনাটি অন্যান্য উৎস থেকে তৈরি করা হয়েছিল।

কার্ট ডেটা

ইভেন্টটির সাথে সম্পর্কিত কার্টের ডেটা।

JSON উপস্থাপনা 
{
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "transactionDiscount": number,
  "items": [
    {
      object (Item)
    }
  ],
  "couponCodes": [
    string
  ]
}
ক্ষেত্র
merchantId

string

ঐচ্ছিক। আইটেমগুলোর সাথে সংশ্লিষ্ট মার্চেন্ট সেন্টার আইডি।

merchantFeedLabel

string

ঐচ্ছিক। আইটেমগুলোর ফিডের সাথে সংশ্লিষ্ট মার্চেন্ট সেন্টার ফিড লেবেল।

merchantFeedLanguageCode

string

ঐচ্ছিক। আপনার আইটেমগুলো যেখানে আপলোড করা হয়, সেই মার্চেন্ট সেন্টার ফিডের সাথে যুক্ত ISO 639-1 অনুযায়ী ভাষা কোড।

transactionDiscount

number

ঐচ্ছিক। লেনদেনটির সাথে সংশ্লিষ্ট সকল ছাড়ের সমষ্টি।

items[]

object ( Item )

ঐচ্ছিক। অনুষ্ঠানটির সাথে সংশ্লিষ্ট আইটেমগুলোর তালিকা।

couponCodes[]

string

ঐচ্ছিক। কার্টে প্রয়োগ করা কুপন কোডগুলির তালিকা। কার্ট-স্তরের এবং আইটেম-স্তরের কুপন কোডগুলি স্বাধীন।

ইভেন্টটি যদি গুগল অ্যানালিটিক্স-এর জন্য হয়, তবে শুধুমাত্র একটি কুপন কোড দিন। গুগল অ্যানালিটিক্স অতিরিক্ত কুপন কোড উপেক্ষা করে।

আইটেম

এটি ইভেন্টের সাথে যুক্ত কার্টে থাকা একটি আইটেমকে নির্দেশ করে।

JSON উপস্থাপনা 
{
  "merchantProductId": string,
  "quantity": string,
  "unitPrice": number,
  "itemId": string,
  "additionalItemParameters": [
    {
      object (ItemParameter)
    }
  ],
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "customVariables": [
    {
      object (ItemCustomVariable)
    }
  ],
  "conversionValue": number
}
ক্ষেত্র
merchantProductId

string

ঐচ্ছিক। মার্চেন্ট সেন্টার অ্যাকাউন্টের অন্তর্ভুক্ত প্রোডাক্ট আইডি।

quantity

string ( int64 format)

ঐচ্ছিক। অনুষ্ঠানটির সাথে সংশ্লিষ্ট এই আইটেমটির সংখ্যা।

unitPrice

number

ঐচ্ছিক। একক মূল্য, কর, পরিবহন খরচ এবং লেনদেন-স্তরের কোনো ছাড় অন্তর্ভুক্ত নয়।

itemId

string

ঐচ্ছিক। আইটেমটি উল্লেখ করার জন্য একটি অনন্য শনাক্তকারী।

additionalItemParameters[]

object ( ItemParameter )

ঐচ্ছিক। ইভেন্টের অন্তর্ভুক্ত করার জন্য কোনো আইটেম সম্পর্কিত এমন যেকোনো ইভেন্ট প্যারামিটারের একটি বাকেট, যা অন্য স্ট্রাকচার্ড ফিল্ড ব্যবহার করে আগে থেকেই নির্দিষ্ট করা হয়নি।

merchantId

string

ঐচ্ছিক। আইটেমটির সাথে যুক্ত মার্চেন্ট সেন্টার আইডি। স্টোর সেলস ইভেন্টের ক্ষেত্রে এটি কার্ট লেভেলে সেট করা মানকে ওভাররাইড করবে। অন্যান্য ইভেন্টের জন্য এই ফিল্ডটি উপেক্ষা করা হয়।

merchantFeedLabel

string

ঐচ্ছিক। মার্চেন্ট সেন্টার ফিডের ফিড লেবেল। যদি এখনও দেশ ব্যবহার করা হয়, তবে এর পরিবর্তে ISO-3166-1 alpha-2-এর ২-অক্ষরের দেশের কোড ব্যবহার করা যেতে পারে। স্টোর সেলস ইভেন্টের জন্য এটি কার্ট লেভেলে সেট করা মানকে ওভাররাইড করবে। অন্যান্য ইভেন্টের জন্য এই ফিল্ডটি উপেক্ষা করা হয়।

merchantFeedLanguageCode

string

ঐচ্ছিক। মার্চেন্ট সেন্টার ফিডের সাথে যুক্ত ISO 639-1 অনুযায়ী ভাষা কোড, যেখানে আপনার আইটেমগুলো আপলোড করা হয়।

customVariables[]

object ( ItemCustomVariable )

ঐচ্ছিক। প্রতি-আইটেম রূপান্তর ট্র্যাক করার সময়, রূপান্তর কন্টেইনারগুলিতে (রূপান্তর অ্যাকশন বা ফ্ল্যাডলাইট অ্যাক্টিভিটি) পাঠানোর জন্য অতিরিক্ত কী/ভ্যালু পেয়ার তথ্য।

conversionValue

number

ঐচ্ছিক। ইভেন্টের মধ্যে এই আইটেমটির সাথে যুক্ত রূপান্তর মান, সেইসব ক্ষেত্রে যেখানে প্রতিটি আইটেমের জন্য রূপান্তর মান ভিন্ন হয়।

আইটেমপ্যারামিটার

ইভেন্টের অন্তর্ভুক্ত করার জন্য কোনো আইটেমের সাথে সম্পর্কিত এমন যেকোনো ইভেন্ট প্যারামিটারের একটি বাকেট, যা অন্য কোনো স্ট্রাকচার্ড ফিল্ড ব্যবহার করে আগে থেকেই নির্দিষ্ট করা হয়নি।

JSON উপস্থাপনা 
{
  "parameterName": string,
  "value": string
}
ক্ষেত্র
parameterName

string

আবশ্যক। যে প্যারামিটারটি ব্যবহার করতে হবে তার নাম।

value

string

আবশ্যক। সেট করার জন্য প্যারামিটারের মানের স্ট্রিং উপস্থাপনা।

আইটেমকাস্টমভেরিয়েবল

বিজ্ঞাপনের রূপান্তরের জন্য আইটেম-স্তরের কাস্টম ভেরিয়েবল।

JSON উপস্থাপনা 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
ক্ষেত্র
variable

string

ঐচ্ছিক। যে কাস্টম ভেরিয়েবলটি সেট করতে চান, তার নাম। প্রদত্ত গন্তব্যের জন্য ভেরিয়েবলটি খুঁজে না পাওয়া গেলে, এটি উপেক্ষা করা হবে।

value

string

ঐচ্ছিক। কাস্টম ভেরিয়েবলের জন্য সংরক্ষণ করার মান।

destinationReferences[]

string

ঐচ্ছিক। কাস্টম ভেরিয়েবলটি Event.destination_references এর কোনটিতে পাঠানো হবে তা নির্ধারণ করতে ব্যবহৃত রেফারেন্স স্ট্রিং। এটি খালি থাকলে, Event.destination_references ব্যবহৃত হবে।

কাস্টম ভেরিয়েবল

বিজ্ঞাপনের রূপান্তরের জন্য কাস্টম ভেরিয়েবল।

JSON উপস্থাপনা 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
ক্ষেত্র
variable

string

ঐচ্ছিক। যে কাস্টম ভেরিয়েবলটি সেট করতে চান, তার নাম। প্রদত্ত গন্তব্যের জন্য ভেরিয়েবলটি খুঁজে না পাওয়া গেলে, এটি উপেক্ষা করা হবে।

value

string

ঐচ্ছিক। কাস্টম ভেরিয়েবলের জন্য সংরক্ষণ করার মান।

destinationReferences[]

string

ঐচ্ছিক। কাস্টম ভেরিয়েবলটি Event.destination_references এর কোনটিতে পাঠানো হবে তা নির্ধারণ করতে ব্যবহৃত রেফারেন্স স্ট্রিং। এটি খালি থাকলে, Event.destination_references ব্যবহৃত হবে।

পরীক্ষামূলক ক্ষেত্র

পরীক্ষামূলক ক্ষেত্র যা অনানুষ্ঠানিক ক্ষেত্রগুলির প্রতিনিধিত্ব করে।

JSON উপস্থাপনা 
{
  "field": string,
  "value": string
}
ক্ষেত্র
field

string

ঐচ্ছিক। যে ফিল্ডটি ব্যবহার করতে চান তার নাম।

value

string

ঐচ্ছিক। যে মানটি ফিল্ডে সেট করতে হবে।

ব্যবহারকারীর বৈশিষ্ট্য

ঘটনাটি ঘটার সময়ে বিজ্ঞাপনদাতা কর্তৃক ব্যবহারকারী সম্পর্কে মূল্যায়নকৃত তথ্য। আরও বিস্তারিত জানতে https://support.google.com/google-ads/answer/14007601 দেখুন।

JSON উপস্থাপনা 
{
  "customerType": enum (CustomerType),
  "customerValueBucket": enum (CustomerValueBucket),
  "additionalUserProperties": [
    {
      object (UserProperty)
    }
  ]
}
ক্ষেত্র
customerType

enum ( CustomerType )

ঐচ্ছিক। ইভেন্টের সাথে যুক্ত গ্রাহকের ধরণ।

customerValueBucket

enum ( CustomerValueBucket )

ঐচ্ছিক। বিজ্ঞাপনদাতা কর্তৃক নির্ধারিত গ্রাহকের মূল্য।

additionalUserProperties[]

object ( UserProperty )

ঐচ্ছিক। এই ইভেন্টের সাথে যুক্ত ব্যবহারকারীর যেকোনো অতিরিক্ত বৈশিষ্ট্যের একটি বাকেট।

গ্রাহকের ধরণ

ইভেন্টটির সাথে সংশ্লিষ্ট গ্রাহকের ধরণ।

এনাম
CUSTOMER_TYPE_UNSPECIFIED অনির্দিষ্ট গ্রাহক প্রকার। এটি কখনই ব্যবহার করা উচিত নয়।
NEW গ্রাহকটি বিজ্ঞাপনদাতার কাছে নতুন।
RETURNING গ্রাহক বিজ্ঞাপনদাতার কাছে ফিরে আসছেন।
REENGAGED গ্রাহক বিজ্ঞাপনদাতার সাথে পুনরায় যোগাযোগ করেছেন।

কাস্টমারভ্যালুবাকেট

বিজ্ঞাপনদাতা কর্তৃক নির্ধারিত গ্রাহকের মূল্য।

এনাম
CUSTOMER_VALUE_BUCKET_UNSPECIFIED অনির্দিষ্ট কাস্টমারভ্যালুবাকেট। এটি কখনই ব্যবহার করা উচিত নয়।
LOW গ্রাহকটি স্বল্পমূল্যের।
MEDIUM গ্রাহকটি মাঝারি মানের।
HIGH গ্রাহক অত্যন্ত মূল্যবান।

ব্যবহারকারীর সম্পত্তি

এই ইভেন্টের সাথে যুক্ত ব্যবহারকারীর যেকোনো অতিরিক্ত বৈশিষ্ট্য সম্বলিত একটি বাকেট।

JSON উপস্থাপনা 
{
  "propertyName": string,
  "value": string
}
ক্ষেত্র
propertyName

string

আবশ্যক। যে ইউজার প্রপার্টিটি ব্যবহার করতে হবে তার নাম।

value

string

আবশ্যক। ব্যবহারযোগ্য ইউজার প্রপার্টির মানের স্ট্রিং উপস্থাপনা।

ইভেন্টপ্যারামিটার

GA4 ইভেন্টগুলির জন্য ইভেন্ট প্যারামিটার।

JSON উপস্থাপনা 
{
  "parameterName": string,
  "value": string
}
ক্ষেত্র
parameterName

string

আবশ্যক। যে প্যারামিটারটি ব্যবহার করতে হবে তার নাম।

value

string

আবশ্যক। সেট করার জন্য প্যারামিটারের মানের স্ট্রিং উপস্থাপনা।

ইভেন্টের অবস্থান

যে স্থানে ঘটনাটি ঘটেছিল।

JSON উপস্থাপনা 
{
  "storeId": string,
  "city": string,
  "subdivisionCode": string,
  "regionCode": string,
  "subcontinentCode": string,
  "continentCode": string
}
ক্ষেত্র
storeId

string

ঐচ্ছিক। স্টোর বিক্রয়ের জন্য আবশ্যক। যে ভৌত স্টোরে ঘটনাটি ঘটেছে, সেটিকে প্রতিনিধিত্বকারী শনাক্তকারী।

city

string

ঐচ্ছিক। যে শহরে ঘটনাটি ঘটেছিল, সেই শহরের নাম।

subdivisionCode

string

ঐচ্ছিক। যে স্থানে ঘটনাটি ঘটেছে, সেখানকার ISO 3166-2 উপবিভাগ কোড।

regionCode

string

ঐচ্ছিক। ব্যবহারকারীর ঠিকানার ২-অক্ষরের CLDR অঞ্চল কোড।

subcontinentCode

string

ঐচ্ছিক। ঘটনাটি যে উপমহাদেশে ঘটেছে, তার কোড (ইউএন এম৪৯ ফরম্যাটে)।

continentCode

string

ঐচ্ছিক। ঘটনাটি যেখানে ঘটেছে, সেই মহাদেশের কোড (ইউএন এম৪৯ ফরম্যাটে)।