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,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
ফিল্ড
requestId

string

অনুরোধের অটোমেটিক জেনারেট করা আইডি।
fieldWarnings[]

object (FieldWarning)

ফিল্ড পাথ সহ বিস্তারিত সারি-লেভেল সতর্কতা।

অনুমোদনের স্কোপ

এটির জন্য নিম্নলিখিত 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,
  "callInfo": {
    object (CallInfo)
  },
  "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)

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

object (UserProperties)

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

string

ঐচ্ছিক। ইভেন্টের নাম। GA4 ইভেন্টের জন্য প্রয়োজন।
clientId

string

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

string

ঐচ্ছিক। বিজ্ঞাপনদাতার দ্বারা সংজ্ঞায়িত ব্যবহারকারীর জন্য একটি অনন্য শনাক্তকারী।
additionalEventParameters[]

object (EventParameter)

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

object (UserData)

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

object (EventLocation)

ঐচ্ছিক। এই ইভেন্ট ঘটার সময় ব্যবহারকারীর লোকেশন সম্পর্কে তথ্য সংগ্রহ করা হয়েছে।
appInstanceId

string

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

object (CallInfo)

ঐচ্ছিক। কল (যদি থাকে) সম্পর্কে তথ্য সংগ্রহ করা হয়েছে যার ফলে এই ইভেন্ট হয়েছে।
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)
    }
  ],
  "ppid": string,
  "visitorPpid": string,
  "leadId": string
}
ফিল্ড
sessionAttributes

string

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

string

ঐচ্ছিক। এই ইভেন্টের সাথে যুক্ত Google ক্লিক আইডি (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)

ঐচ্ছিক। যেকোনও সংখ্যক এনক্রিপ্ট করা ব্যবহারকারীর আইডি।
ppid

string

ঐচ্ছিক। প্রকাশকের দ্বারা সংজ্ঞায়িত, যাচাইকৃত ব্যবহারকারীর (সাইন-ইন করা) জন্য একটি অনন্য শনাক্তকারী।
visitorPpid

string

ঐচ্ছিক। প্রকাশকের দ্বারা সংজ্ঞায়িত, একজন যাচাই না করা ব্যবহারকারীর (যে ব্যবহারকারী সাইন-ইন করেননি) জন্য একটি অনন্য শনাক্তকারী।
leadId

string

ঐচ্ছিক। ব্যবহারকারী লিড ফর্ম জমা দিলে Google-এর তৈরি করা আইডি ইস্যু করা হয়।

EncryptedUserId

অ্যাট্রিবিউশনের জন্য ব্যবহার করার উদ্দেশ্যে ইস্যু করা ইউজার আইডেন্টিফায়ার। এটি ব্যবহার করা হলে সব ফিল্ড পূরণ করতে হবে।

JSON উপস্থাপনা 
{
  "encryptedId": string,
  "entityType": enum (EncryptionEntityType),
  "entityId": string,
  "source": enum (EncryptionSource)
}
ফিল্ড
encryptedId

string

প্রয়োজনীয়। বর্ণসাংখ্যিক এনক্রিপ্ট করা আইডি।
entityType

enum (EncryptionEntityType)

প্রয়োজনীয়। এনক্রিপশন এন্টিটির ধরন। এটি বিজ্ঞাপন পরিষেবা বা ডেটা ট্রান্সফারের জন্য এনক্রিপশন কনফিগারেশনের সাথে ম্যাচ করতে হবে।
entityId

string (int64 format)

প্রয়োজনীয়। এনক্রিপশন এন্টিটি আইডি। এটি বিজ্ঞাপন পরিষেবা বা ডেটা ট্রান্সফারের জন্য এনক্রিপশন কনফিগারেশনের সাথে ম্যাচ করতে হবে।
source

enum (EncryptionSource)

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

EncryptionEntityType

এনক্রিপশন এন্টিটির ধরন।

Enums
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED নির্দিষ্ট নয় এমন এনক্রিপশন এন্টিটির ধরন।
CAMPAIGN_MANAGER_ACCOUNT Campaign Manager 360 অ্যাকাউন্ট।
CAMPAIGN_MANAGER_ADVERTISER Campaign Manager 360 বিজ্ঞাপনদাতা।
DISPLAY_VIDEO_PARTNER Display & Video 360 পার্টনার।
DISPLAY_VIDEO_ADVERTISER Display & Video 360 বিজ্ঞাপনদাতা।
GOOGLE_ADS_CUSTOMER Google Ads গ্রাহক।
GOOGLE_AD_MANAGER_NETWORK_CODE Google Ad Manager নেটওয়ার্ক কোড।

EncryptionSource

এনক্রিপশন সোর্স।

Enums
ENCRYPTION_SOURCE_UNSPECIFIED এনক্রিপশনের উৎস নির্দিষ্ট করা নেই।
AD_SERVING বিজ্ঞাপন পরিবেশনের এনক্রিপশন সোর্স।
DATA_TRANSFER ডেটা ট্রান্সফার এনক্রিপশন সোর্স।

EventSource

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

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

CartData

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

JSON উপস্থাপনা 
{
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "transactionDiscount": number,
  "items": [
    {
      object (Item)
    }
  ],
  "couponCodes": [
    string
  ]
}
ফিল্ড
merchantId

string

ঐচ্ছিক। আইটেমের সাথে যুক্ত Merchant Center আইডি।
merchantFeedLabel

string

ঐচ্ছিক। আইটেমের ফিডের সাথে যুক্ত Merchant Center ফিড লেবেল।
merchantFeedLanguageCode

string

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

number

ঐচ্ছিক। ট্রানজ্যাকশনের সাথে যুক্ত সব ছাড়ের যোগফল।
items[]

object (Item)

ঐচ্ছিক। ইভেন্টের সাথে যুক্ত আইটেমের তালিকা।
couponCodes[]

string

ঐচ্ছিক। কার্টে প্রয়োগ করা কুপন কোডের তালিকা। কার্ট-লেভেল ও আইটেম-লেভেল কুপন কোড একে অপরের থেকে আলাদা।

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

আইটেম

ইভেন্টের সাথে সম্পর্কিত কার্টে থাকা আইটেমকে দেখায়।

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

ঐচ্ছিক। Merchant Center অ্যাকাউন্টে প্রোডাক্ট আইডি।
quantity

string (int64 format)

ঐচ্ছিক। ইভেন্টের সাথে যুক্ত এই আইটেমের সংখ্যা।
unitPrice

number

ঐচ্ছিক। ট্যাক্স, শিপিং ও যেকোনও ট্রানজ্যাকশন লেভেল ডিসকাউন্ট বাদ দিয়ে ইউনিট মূল্য।
itemId

string

ঐচ্ছিক। আইটেম রেফারেন্স করার জন্য একটি অনন্য শনাক্তকারী।
additionalItemParameters[]

object (ItemParameter)

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

string

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

string

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

string

ঐচ্ছিক। ISO 639-1-এ ভাষার কোড Merchant Center ফিডের সাথে যুক্ত যেখানে আপনার আইটেম আপলোড করা হয়।
customVariables[]

object (ItemCustomVariable)

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

number

ঐচ্ছিক। ইভেন্টের মধ্যে এই আইটেমের সাথে যুক্ত কনভার্সন ভ্যালু, যেখানে প্রতিটি আইটেমের জন্য কনভার্সন ভ্যালু আলাদা।

ItemParameter

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

JSON উপস্থাপনা 
{
  "parameterName": string,
  "value": string
}
ফিল্ড
parameterName

string

প্রয়োজনীয়। ব্যবহার করার জন্য প্যারামিটারের নাম।
value

string

প্রয়োজনীয়। সেট করার জন্য প্যারামিটারের ভ্যালুর স্ট্রিং রিপ্রেজেন্টেশন।

ItemCustomVariable

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

JSON উপস্থাপনা 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
ফিল্ড
variable

string

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

string

ঐচ্ছিক। কাস্টম ভেরিয়েবেলের জন্য স্টোর করার ভ্যালু।
destinationReferences[]

string

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

CustomVariable

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

JSON উপস্থাপনা 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
ফিল্ড
variable

string

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

string

ঐচ্ছিক। কাস্টম ভেরিয়েবেলের জন্য স্টোর করার ভ্যালু।
destinationReferences[]

string

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

ExperimentalField

পরীক্ষামূলক ফিল্ড যা অনানুষ্ঠানিক ফিল্ডকে উপস্থাপন করে।

JSON উপস্থাপনা 
{
  "field": string,
  "value": string
}
ফিল্ড
field

string

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

string

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

UserProperties

ইভেন্ট ঘটার সময় ব্যবহারকারী সম্পর্কে বিজ্ঞাপনদাতার মূল্যায়ন করা তথ্য। আরও জানতে 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)

ঐচ্ছিক। এই ইভেন্টের সাথে যুক্ত ব্যবহারকারীর জন্য যেকোনও অতিরিক্ত ব্যবহারকারীর প্রপার্টি-এর বাকেট।

CustomerType

ইভেন্টের সাথে যুক্ত গ্রাহকের ধরন।

Enums
CUSTOMER_TYPE_UNSPECIFIED CustomerType উল্লেখ করা হয়নি। কখনও ব্যবহার করা উচিত নয়।
NEW গ্রাহক বিজ্ঞাপনদাতার কাছে নতুন।
RETURNING গ্রাহক বিজ্ঞাপনদাতার কাছে ফিরে আসছেন।
REENGAGED গ্রাহক বিজ্ঞাপনদাতার সাথে আবার এনগেজ হয়েছেন।

CustomerValueBucket

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

Enums
CUSTOMER_VALUE_BUCKET_UNSPECIFIED অনির্দিষ্ট CustomerValueBucket. কখনও ব্যবহার করা উচিত নয়।
LOW গ্রাহকের ভ্যালু কম।
MEDIUM গ্রাহক মাঝারি ভ্যালুর।
HIGH গ্রাহকটি হাই ভ্যালু।

UserProperty

এই ইভেন্টের সাথে যুক্ত ব্যবহারকারীর জন্য যেকোনও অতিরিক্ত ব্যবহারকারীর প্রপার্টি-এর বাকেট।

JSON উপস্থাপনা 
{
  "propertyName": string,
  "value": string
}
ফিল্ড
propertyName

string

প্রয়োজনীয়। ব্যবহার করার জন্য ব্যবহারকারীর প্রপার্টির নাম।
value

string

প্রয়োজনীয়। ব্যবহার করার জন্য ব্যবহারকারীর প্রপার্টির ভ্যালুর স্ট্রিং রিপ্রেজেন্টেশন।

EventParameter

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

JSON উপস্থাপনা 
{
  "parameterName": string,
  "value": string
}
ফিল্ড
parameterName

string

প্রয়োজনীয়। ব্যবহার করার জন্য প্যারামিটারের নাম।
value

string

প্রয়োজনীয়। সেট করার জন্য প্যারামিটারের ভ্যালুর স্ট্রিং রিপ্রেজেন্টেশন।

EventLocation

যে লোকেশনে ইভেন্টটি ঘটেছে।

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

ঐচ্ছিক। যেখানে ইভেন্ট হয়েছে সেখানকার UN M49 ফর্ম্যাটে সাবকন্টিনেন্ট কোড।
continentCode

string

ঐচ্ছিক। যে মহাদেশে ইভেন্টটি ঘটেছে তার UN M49 ফর্ম্যাটে মহাদেশ কোড।

CallInfo

কল (যদি থাকে) সম্পর্কে তথ্য সংগ্রহ করা হয়েছে যার ফলে এই ইভেন্ট হয়েছে।

JSON উপস্থাপনা 
{
  "startTimestamp": string
}
ফিল্ড
startTimestamp

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"।