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,
  "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 অ্যাপ স্ট্রিমের জন্য অ্যাপ ক্লায়েন্টের ব্যবহারকারীর ইনস্ট্যান্সের অনন্য শনাক্তকারী।

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
}
ফিল্ড
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

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

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

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

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

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

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 ফর্ম্যাটে কোড।