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,
  "conversionValue": number,
  "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)
    }
  ]
}
ক্ষেত্র
destinationReferences[]

string

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

transactionId

string

ঐচ্ছিক। এই ইভেন্টের জন্য অনন্য শনাক্তকারী। একাধিক ডেটা উৎস ব্যবহার করে রূপান্তরের জন্য প্রয়োজনীয়।

eventTimestamp

string ( Timestamp format)

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

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "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-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "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

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

conversionValue

number

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

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 )

ঐচ্ছিক। ইভেন্টের মধ্যে অন্তর্ভুক্ত করার জন্য এমন যেকোনো ইভেন্ট প্যারামিটারের একটি বাকেট যা ইতিমধ্যে অন্যান্য কাঠামোগত ক্ষেত্র ব্যবহার করে নির্দিষ্ট করা হয়নি।

অ্যাডআইডেন্টিফায়ার

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

JSON উপস্থাপনা 
{
  "sessionAttributes": string,
  "gclid": string,
  "gbraid": string,
  "wbraid": string,
  "landingPageDeviceInfo": {
    object (DeviceInfo)
  }
}
ক্ষেত্র
sessionAttributes

string

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

gclid

string

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

gbraid

string

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

wbraid

string

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

landingPageDeviceInfo

object ( DeviceInfo )

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

ডিভাইস তথ্য

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

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

string

ঐচ্ছিক। প্রদত্ত প্রসঙ্গের জন্য ডিভাইসের ব্যবহারকারী-এজেন্ট স্ট্রিং।

ipAddress

string

ঐচ্ছিক। প্রদত্ত প্রসঙ্গের জন্য ডিভাইসের IP ঠিকানা।

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

ইভেন্টসোর্স

ঘটনার উৎস।

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

কার্টডেটা

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

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

string

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

merchantFeedLabel

string

ঐচ্ছিক। আইটেমগুলির ফিডের সাথে সম্পর্কিত মার্চেন্ট সেন্টার ফিড লেবেল।

merchantFeedLanguageCode

string

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

transactionDiscount

number

ঐচ্ছিক। লেনদেনের সাথে সম্পর্কিত সমস্ত ছাড়ের যোগফল।

items[]

object ( Item )

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

আইটেম

ইভেন্টের সাথে সম্পর্কিত কার্টে থাকা একটি আইটেমকে প্রতিনিধিত্ব করে।

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

string

ঐচ্ছিক। মার্চেন্ট সেন্টার অ্যাকাউন্টের মধ্যে থাকা পণ্য আইডি।

quantity

string ( int64 format)

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

unitPrice

number

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

itemId

string

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

additionalItemParameters[]

object ( ItemParameter )

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

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

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

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 উপস্থাপনা 
{
  "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

প্রয়োজনীয়। সেট করার জন্য প্যারামিটারের মানের স্ট্রিং উপস্থাপনা।