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 )

প্রয়োজন। নির্দিষ্ট গন্তব্যে পাঠাতে ইভেন্টের তালিকা। সর্বাধিক 2000 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)
  }
}
ক্ষেত্র
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 )

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

AdIdentifiers

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

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), যুক্তরাজ্য (ইউকে) বা সুইজারল্যান্ড (CH)-এর শেষ ব্যবহারকারীদের জন্য 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

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

transactionDiscount

number

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

items[]

object ( Item )

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

আইটেম

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

JSON প্রতিনিধিত্ব 
{
  "merchantProductId": string,
  "quantity": string,
  "unitPrice": number
}
ক্ষেত্র
merchantProductId

string

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

quantity

string ( int64 format)

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

unitPrice

number

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

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

বিজ্ঞাপন রূপান্তর জন্য কাস্টম পরিবর্তনশীল.

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)
}
ক্ষেত্র
customerType

enum ( CustomerType )

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

customerValueBucket

enum ( CustomerValueBucket )

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

গ্রাহক প্রকার

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

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

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

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

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