ঘটনা পাঠান

ইভেন্ট ডেটা পাঠানোর সাথে পরিচিত হতে আপনি এই দ্রুত শুরুর মাধ্যমে কাজ করতে পারেন।

নিম্নলিখিত যেকোনো পরিস্থিতিতে ডেটা ম্যানেজার API ব্যবহার করুন:

• আপনার ট্যাগ রূপান্তরের জন্য অতিরিক্ত ডেটা উৎস হিসেবে Google Ads ট্যাগ রূপান্তর বা Google Analytics কী ইভেন্ট পাঠান, যাতে বিজ্ঞাপনের ইন্টারঅ্যাকশন সিগন্যাল সর্বাধিক হয় এবং আপনার ডেটা এবং সামগ্রিক কর্মক্ষমতা শক্তিশালী হয়।

  এই বৈশিষ্ট্যটি শুধুমাত্র অ্যাকাউন্ট এবং অ্যালাউলিস্টের জন্য উপলব্ধ। আপনি যদি আপনার Google বিজ্ঞাপন অ্যাকাউন্ট বা Google Analytics প্রপার্টি যোগ করতে আগ্রহী হন তবে ফর্মটি পূরণ করুন ।

• Google বিজ্ঞাপন অফলাইন রূপান্তরের জন্য ইভেন্ট ডেটা অথবা লিডের জন্য উন্নত রূপান্তর পাঠান।

আপনি যে গাইডটি দেখতে চান তার সংস্করণটি বেছে নিন:

বিজ্ঞাপনদাতার ডেটা পার্টনার

এই কুইকস্টার্টে, আপনি নিম্নলিখিত পদক্ষেপগুলি সম্পন্ন করবেন:

1. ইভেন্ট ডেটা পাওয়ার জন্য একটি Destination প্রস্তুত করুন।
2. পাঠানোর জন্য ইভেন্ট ডেটা প্রস্তুত করুন।
3. ইভেন্টগুলির জন্য একটি IngestionService অনুরোধ তৈরি করুন।
4. গুগল এপিআই এক্সপ্লোরার ব্যবহার করে অনুরোধটি পাঠান।
5. সাফল্য এবং ব্যর্থতার প্রতিক্রিয়াগুলি বুঝুন।

গন্তব্যস্থল প্রস্তুত করুন

ডেটা পাঠানোর আগে, আপনাকে ডেটার জন্য কমপক্ষে একটি Destination প্রস্তুত করতে হবে। এখানে আপনার ব্যবহারের জন্য একটি নমুনা Destination হল:

    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "PRODUCT_DESTINATION_ID"
    }

এখানে একটি Destination ক্ষেত্রগুলি রয়েছে:

operatingAccount

যে অ্যাকাউন্টে ঘটনাগুলি পাওয়া যায়।

অতিরিক্ত ডেটা উৎস হিসেবে পাঠানো ইভেন্টের জন্য, অপারেটিং অ্যাকাউন্টটি Google Ads অ্যাকাউন্ট অথবা Google Analytics প্রপার্টি হতে পারে। accountType কে GOOGLE_ADS অথবা GOOGLE_ANALYTICS_PROPERTY তে সেট করুন এবং accountId Google Ads গ্রাহক আইডি অথবা Google Analytics প্রপার্টি আইডি তে সেট করুন। যদি accountType টি GOOGLE_ANALYTICS_PROPERTY হয়, তাহলে অনুরোধের শংসাপত্রগুলি অবশ্যই এমন একজন Google Analytics ব্যবহারকারীর হতে হবে যার সম্পত্তির জন্য সম্পাদক বা প্রশাসকের ভূমিকা রয়েছে।

অফলাইন রূপান্তর এবং লিডের জন্য উন্নত রূপান্তরের জন্য, অপারেটিং অ্যাকাউন্টটি অবশ্যই একটি Google বিজ্ঞাপন অ্যাকাউন্ট হতে হবে, তাই accountType কে GOOGLE_ADS এ সেট করুন এবং accountId Google বিজ্ঞাপন গ্রাহক আইডিতে সেট করুন।

loginAccount

যে অ্যাকাউন্টে ক্রেডেনশিয়ালের ব্যবহারকারীর অ্যাক্সেস আছে।

যদি আপনার OAuth শংসাপত্রগুলি এমন কোনও ব্যবহারকারীর জন্য হয় যার Google Ads ম্যানেজার অ্যাকাউন্টে অ্যাক্সেস আছে যার একটি সাবঅ্যাকাউন্ট হিসাবে operatingAccount আছে, তাহলে loginAccount প্রয়োজন। loginAccount এর accountId ম্যানেজার অ্যাকাউন্টের ID তে সেট করুন এবং loginAccount এর accountType GOOGLE_ADS তে সেট করুন।

যদি আপনার OAuth ক্রেডেনশিয়ালগুলি এমন কোনও ব্যবহারকারীর জন্য হয় যার operatingAccount এ সরাসরি অ্যাক্সেস আছে, তাহলে আপনাকে loginAccount সেট করার দরকার নেই এবং এটি ডিফল্টভাবে operatingAccount এ সেট করা হয়। তবে, আমরা loginAccount operatingAccount মতো একই accountId এবং accountType এ সেট করার পরামর্শ দিচ্ছি। ব্যবহারকারী যে অ্যাকাউন্টগুলি অ্যাক্সেস করতে পারে সেগুলি পরিবর্তন করলে সমস্যা এড়াতে এটি সাহায্য করে।

productDestinationId

operatingAccount থাকা সত্তার আইডি যা ইভেন্টগুলি গ্রহণ করে।

অতিরিক্ত ডেটা সোর্স হিসেবে পাঠানো ইভেন্টের জন্য, productDestinationId অবশ্যই WEBPAGE type সহ Google Ads কনভার্সনের আইডি হতে হবে, অথবা Google Analytics ওয়েব স্ট্রিমের পরিমাপ আইডি হতে হবে । আপনি Google Analytics iOS অ্যাপ বা Android অ্যাপ স্ট্রিমে অতিরিক্ত ডেটা সোর্স হিসেবে ইভেন্ট পাঠাতে পারবেন না।

অফলাইন রূপান্তর বা লিডের জন্য উন্নত রূপান্তরের জন্য, productDestinationId অবশ্যই UPLOAD_CLICKS type সহ একটি Google বিজ্ঞাপন রূপান্তর অ্যাকশনের আইডি হতে হবে।

এই নির্দেশিকার উদাহরণে দেখানো হয়েছে কিভাবে এমন একটি অনুরোধ তৈরি করতে হয় যা প্রতিটি ইভেন্টকে একই গন্তব্যে পাঠায়। যদি আপনি একই অনুরোধে একাধিক গন্তব্যের জন্য ইভেন্ট পাঠাতে চান, তাহলে send events for multiple destinations দেখুন।

ইভেন্ট ডেটা প্রস্তুত করুন

নিম্নলিখিত ইভেন্ট ডেটা বিবেচনা করুন। প্রতিটি টেবিল একটি রূপান্তর ইভেন্টের সাথে সম্পর্কিত। প্রতিটি রূপান্তর ইভেন্টে ইভেন্টের একটি টাইমস্ট্যাম্প, তার রূপান্তর ক্রিয়া এবং রূপান্তর মূল্য থাকে।

প্রতিটি ইভেন্টে বিজ্ঞাপন শনাক্তকারী থাকতে পারে, যেমন gclid , অথবা ব্যবহারকারী শনাক্তকারী থাকতে পারে, যেমন ইমেল ঠিকানা, ফোন নম্বর এবং ঠিকানার তথ্য । একটি ইভেন্টে এগুলিও থাকতে পারে:

• ইভেন্টের সময় মূল্যায়ন করা ব্যবহারকারী সম্পর্কে তথ্য , যেমন গ্রাহকের মূল্য বা তারা নতুন, ফিরে আসা, নাকি পুনঃনিযুক্ত গ্রাহক।
• শপিং কার্টের তথ্য।
• কোনও গন্তব্যের জন্য অতিরিক্ত ইভেন্ট প্যারামিটার বা ব্যবহারকারীর বৈশিষ্ট্য, যেমন client_id অথবা Google Analytics-এর জন্য user_id ।

ইভেন্টের তথ্য এখানে:

ডেটা ফর্ম্যাট করুন

ফর্ম্যাটিং গাইডে উল্লেখিত পদ্ধতি অনুসারে ক্ষেত্রগুলি ফর্ম্যাট করুন। ফর্ম্যাটিং এর পরে ইভেন্ট ডেটা এখানে রয়েছে:

ডেটা হ্যাশ এবং এনকোড করুন

এছাড়াও, ফর্ম্যাট করা ইমেল ঠিকানা, প্রদত্ত নাম এবং পরিবারের নামগুলি SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ করতে হবে এবং হেক্স অথবা Base64 এনকোডিং ব্যবহার করে এনকোড করতে হবে। হেক্স এনকোডিং ব্যবহার করে ফর্ম্যাট, হ্যাশিং এবং এনকোডিংয়ের পরে ইভেন্ট ডেটা এখানে দেওয়া হল:

ডেটা Event অবজেক্টে রূপান্তর করুন

প্রতিটি ইভেন্টের ফরম্যাট করা এবং হ্যাশ করা ডেটা একটি Event তে রূপান্তর করুন। নির্দেশিত হিসাবে নিম্নলিখিত ক্ষেত্রগুলি পূরণ করুন:

1. ইভেন্টটি সংঘটিত হওয়ার সময়ে eventTimestamp সেট করুন।

   গুগল অ্যানালিটিক্সের ইভেন্টগুলিতে গত ৭২ ঘন্টার মধ্যে একটি eventTimestamp থাকতে হবে।

2. আপনার ব্যবহারের ক্ষেত্রে প্রয়োজনীয় ক্ষেত্রগুলি সেট করুন।

   ব্যবহারের ধরণ	শনাক্তকারী	transactionId	eventSource
   অফলাইন রূপান্তর বা লিডের জন্য উন্নত রূপান্তর	প্রয়োজনীয় । নিম্নলিখিতগুলির মধ্যে অন্তত একটি সেট করুন: gclid , gbraid , wbraid , অথবা sessionAttributes সেটের অন্তত একটি সহ adIdentifiers userData	ঐচ্ছিক	প্রয়োজনীয় । EventSource এর জন্য enum মানগুলির একটিতে সেট করুন।
   Google Ads গন্তব্যে অতিরিক্ত ডেটা উৎস হিসেবে পাঠানো ইভেন্ট	প্রয়োজনীয় । নিম্নলিখিতগুলির মধ্যে অন্তত একটি সেট করুন: gclid , gbraid , অথবা wbraid সেটের অন্তত একটি সহ adIdentifiers userData	প্রয়োজনীয়	ঐচ্ছিক। যদি সেট করা থাকে, তাহলে অবশ্যই WEB হতে হবে।
   Google Analytics গন্তব্যে অতিরিক্ত ডেটা উৎস হিসেবে পাঠানো ইভেন্টগুলি	প্রয়োজনীয় । নিম্নলিখিতগুলির মধ্যে অন্তত একটি সেট করুন: clientId gclid সেট সহ adIdentifiers userData	প্রয়োজনীয়	ঐচ্ছিক। যদি সেট করা থাকে, তাহলে অবশ্যই WEB হতে হবে।

3. ইভেন্টের জন্য আপনার কাছে যে কোনও মান আছে এমন অন্য কোনও ক্ষেত্র পূরণ করুন। উপলব্ধ ক্ষেত্রগুলির সম্পূর্ণ তালিকার জন্য Event রেফারেন্স ডকুমেন্টেশন দেখুন।

গুগল অ্যানালিটিক্স তথ্য যোগ করুন

অতিরিক্ত ডেটা সোর্স হিসেবে পাঠানো কোনও ইভেন্টের গন্তব্যস্থলে যদি Google Analytics প্রপার্টি থাকে, তাহলে নিম্নলিখিত ক্ষেত্রগুলি নির্দেশিতভাবে পূরণ করুন:

eventName

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

transactionId

প্রয়োজনীয় । ইভেন্টের জন্য অনন্য শনাক্তকারী।

কমপক্ষে একটি শনাক্তকারী

নিম্নলিখিত ক্ষেত্রগুলির মধ্যে কমপক্ষে একটি সেট করতে হবে:

• clientId : একটি ওয়েব ক্লায়েন্টের ব্যবহারকারীর উদাহরণের জন্য অনন্য শনাক্তকারী। পরিমাপ প্রোটোকলে ইভেন্ট পাঠান দেখুন।

• adIdentifiers.gclid : একটি গুগল ক্লিক আইডি ।

• userData : ব্যবহারকারীর জন্য শনাক্তকারী, যেমন ইমেল ঠিকানা, ফোন নম্বর, অথবা ঠিকানার তথ্য ।

destinationReferences

অনুরোধ-স্তরের destinations তালিকায় একাধিক Google Analytics Destination থাকলে প্রয়োজন । কোন Google Analytics গন্তব্যস্থলে ইভেন্টটি গ্রহণ করা উচিত তা নির্দিষ্ট করতে destinationReferences এ একটি এন্ট্রি যোগ করুন। গন্তব্যস্থলের রেফারেন্স সম্পর্কে আরও তথ্যের জন্য একাধিক গন্তব্যস্থলে ইভেন্ট পাঠান দেখুন।

যদি destinationReferences সেট না করা থাকে অথবা Google Analytics গন্তব্যস্থলের সাথে সম্পর্কিত একাধিক এন্ট্রি থাকে, তাহলে Data Manager API MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT ত্রুটি সহ ইভেন্টটি প্রত্যাখ্যান করে।

userId

ঐচ্ছিক। ব্যবহারকারীর জন্য ব্যবহারকারী-আইডি ।

additionalEventParameters

ঐচ্ছিক, কিন্তু প্রস্তাবিত। এই তালিকায় এমন যেকোনো Google Analytics ইভেন্ট প্যারামিটার দিয়ে পূর্ণ করুন যা অন্যান্য Event ফিল্ডে ক্যাপচার করা হয়নি। প্যারামিটারগুলিতে purchase ইভেন্ট থেকে অতিরিক্ত প্রস্তাবিত প্যারামিটার অথবা আপনি যে অন্যান্য প্যারামিটার ক্যাপচার করতে চান তা অন্তর্ভুক্ত থাকতে পারে। EventParameter এর parameterName এর জন্য Google Analytics প্যারামিটারের নাম ব্যবহার করুন।

উদাহরণস্বরূপ, যদি আপনার লেনদেনের সাথে কর সম্পর্কিত থাকে, তাহলে additionalEventParameters এ একটি এন্ট্রি যোগ করুন যেখানে parameterName tax তে সেট করা আছে, এবং value tax cost তে সেট করা আছে।

আমরা transactionId , currency , অথবা value Google Analytics ইভেন্ট প্যারামিটারের জন্য এন্ট্রি যোগ করার পরামর্শ দিই না। পরিবর্তে, transactionId , currency , এবং conversionValue of the Event পূরণ করুন, যা additionalEventParameters এর যেকোনো এন্ট্রির চেয়ে অগ্রাধিকার পায়।

ক্রয় ইভেন্টের জন্য কার্ট ডেটা যোগ করুন

Event cartData ফিল্ডে কেনা আইটেমগুলির তথ্য পূরণ করুন। প্রতিটি কেনা আইটেমের জন্য, CartData items তালিকায় একটি Item অবজেক্ট যোগ করুন এবং নির্দেশিত হিসাবে নিম্নলিখিত ক্ষেত্রগুলি পূরণ করুন:

itemId

প্রয়োজনীয় । আইটেমটির জন্য একটি অনন্য শনাক্তকারী।

unitPrice

প্রয়োজনীয় । কর, শিপিং এবং ইভেন্ট স্কোপড (লেনদেন-স্তরের) ছাড় বাদে ইউনিট মূল্য।

যদি কোনও আইটেমের স্কোপড ডিসকাউন্ট থাকে, তাহলে ডিসকাউন্ট করা ইউনিট মূল্য ব্যবহার করুন। উদাহরণস্বরূপ, যদি কোনও আইটেমের ইউনিট মূল্য 27.67 এবং ইউনিট ডিসকাউন্ট 6.66 হয়, তাহলে unitPrice 21.01 এ সেট করুন।

quantity

প্রয়োজনীয় । এই নির্দিষ্ট আইটেমের জন্য কেনা ইউনিটের পরিমাণ।

additionalItemParameters

এই তালিকায় এমন যেকোনো আইটেম স্কোপড প্যারামিটার দিয়ে পূর্ণ করুন যা অন্যান্য Item ফিল্ডে ক্যাপচার করা হয়নি। ItemParameter এর parameterName এর জন্য Google Analytics আইটেম প্যারামিটারের নাম ব্যবহার করুন।

উদাহরণস্বরূপ, যদি আপনার কাছে কোনও আইটেমের ব্র্যান্ড এবং বিভাগ থাকে, তাহলে আইটেমের additionalItemParameters একটি এন্ট্রি যোগ করুন যেখানে parameterName item_brand তে সেট করা আছে এবং value ব্র্যান্ড নামে সেট করা আছে, এবং parameterName item_category তে সেট করা আছে এবং value আইটেমের বিভাগে সেট করা আছে এমন আরেকটি এন্ট্রি যোগ করুন।

আমরা quantity , price , অথবা item_id Google Analytics আইটেম প্যারামিটারের জন্য এন্ট্রি যোগ করার পরামর্শ দিই না। পরিবর্তে, itemId , unitPrice , এবং Item এর quantity পূরণ করুন, যা additionalItemParameters এর যেকোনো এন্ট্রির চেয়ে অগ্রাধিকার পায়।

দ্বিতীয় ইভেন্টের ফর্ম্যাটেড, হ্যাশড এবং এনকোডেড ডেটার জন্য এখানে একটি নমুনা Event হল, যার সাথে গুগল অ্যানালিটিক্সের জন্য অতিরিক্ত ডেটাও দেওয়া হল:

{
  "adIdentifiers": {
     "gclid": "GCLID_2"
  },
  "conversionValue": 42.02,
  "currency": "EUR",
  "eventTimestamp": "2025-06-10T23:42:33-05:00",
  "transactionId": "DEF999911111",
  "eventSource": "WEB",
  "userData": {
    "userIdentifiers": [
      {
        "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
      },
      {
        "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
      },
      {
        "address": {
          "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
          "familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
          "regionCode": "PT",
          "postalCode": "1229-076"
        }
      }
    ],
  },
  "userProperties": {
    "customerType": "RETURNING"
  },
  "eventName": "purchase",
  "clientId": "9876543210.1761582117",
  "userId": "user_DEF9876",
  "additionalEventParameters": [
    {
      "parameterName": "ad_unit_name",
      "value": "Banner_02"
    }
  ],
  "cartData": {
    "transactionDiscount": 6.66,
    "items": [
      {
        "itemId": "SKU_12346",
        "quantity": 2,
        "unitPrice": 21.01,
        "additionalItemParameters": [
          {
            "parameterName": "item_name",
            "value": "Google Grey Women's Tee"
          },
          {
            "parameterName": "affiliation",
            "value": "Google Merchandise Store"
          },
          {
            "parameterName": "coupon",
            "value": "SUMMER_FUN"
          },
          {
            "parameterName": "discount",
            "value": "3.33"
          },
          {
            "parameterName": "index",
            "value": "1"
          },
          {
            "parameterName": "item_brand",
            "value": "Google"
          },
          {
            "parameterName": "item_category",
            "value": "Apparel"
          },
          {
            "parameterName": "item_category2",
            "value": "Adult"
          },
          {
            "parameterName": "item_category3",
            "value": "Shirts"
          },
          {
            "parameterName": "item_category4",
            "value": "Crew"
          },
          {
            "parameterName": "item_category5",
            "value": "Short sleeve"
          },
          {
            "parameterName": "item_list_id",
            "value": "related_products"
          },
          {
            "parameterName": "item_list_name",
            "value": "Related Products"
          }
        ]
      }
    ]
  }
}

অনুরোধের মূল অংশ তৈরি করুন

অনুরোধের মূল অংশের জন্য Destination এবং Events একত্রিত করুন:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  ],
  "encoding": "HEX",
  "events": [
     {
       "adIdentifiers": {
         "gclid": "GCLID_1"
       },
       "conversionValue": 30.03,
       "currency": "USD",
       "eventTimestamp": "2025-06-10T20:07:01Z",
       "transactionId": "ABC798654321",
       "eventSource": "WEB",
       "userData": {
         "userIdentifiers": [
           {
             "address": {
               "givenName": "96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A",
               "familyName": "DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081",
               "regionCode": "US",
               "postalCode": "94045"
             }
           }
         ]
       },
       "userProperties": {
         "customerType": "NEW",
         "customerValueBucket": "HIGH"
       },
       "eventName": "purchase",
       "clientId": "1234567890.1761581763",
       "userId": "user_ABC12345",
       "additionalEventParameters": [
         {
           "parameterName": "ad_unit_name",
           "value": "Banner_01"
         }
       ],
       "cartData": {
         "transactionDiscount": 6.66,
         "items": [
           {
             "itemId": "SKU_12345",
             "quantity": 3,
             "unitPrice": 10.01,
             "additionalItemParameters": [
               {
                 "parameterName": "item_name",
                 "value": "Stan and Friends Tee"
               },
               {
                 "parameterName": "affiliation",
                 "value": "Google Merchandise Store"
               },
               {
                 "parameterName": "coupon",
                 "value": "SUMMER_FUN"
               },
               {
                 "parameterName": "discount",
                 "value": "2.22"
               },
               {
                 "parameterName": "index",
                 "value": "0"
               },
               {
                 "parameterName": "item_brand",
                 "value": "Google"
               },
               {
                 "parameterName": "item_category",
                 "value": "Apparel"
               },
               {
                 "parameterName": "item_category2",
                 "value": "Adult"
               },
               {
                 "parameterName": "item_category3",
                 "value": "Shirts"
               },
               {
                 "parameterName": "item_category4",
                 "value": "Crew"
               },
               {
                 "parameterName": "item_category5",
                 "value": "Short sleeve"
               },
               {
                 "parameterName": "item_list_id",
                 "value": "related_products"
               },
               {
                 "parameterName": "item_list_name",
                 "value": "Related Products"
               }
             ]
           }
         ]

       }
     },
     {
       "adIdentifiers": {
         "gclid": "GCLID_2"
       },
       "conversionValue": 42.02,
       "currency": "EUR",
       "eventTimestamp": "2025-06-11T04:42:33Z",
       "transactionId": "DEF999911111",
       "eventSource": "WEB",
       "userData": {
         "userIdentifiers": [
           {
             "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
           },
           {
             "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
           },
           {
             "address": {
               "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
               "familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
               "regionCode": "PT",
               "postalCode": "1229-076"
             }
           }
         ]
       },
       "userProperties": {
         "customerType": "RETURNING"
       },
       "eventName": "purchase",
       "clientId": "9876543210.1761582117",
       "userId": "user_DEF9876",
       "additionalEventParameters": [
         {
           "parameterName": "ad_unit_name",
           "value": "Banner_02"
         }
       ],
       "cartData": {
         "transactionDiscount": 6.66,
         "items": [
           {
             "itemId": "SKU_12346",
             "quantity": 2,
             "unitPrice": 21.01,
             "additionalItemParameters": [
               {
                 "parameterName": "item_name",
                 "value": "Google Grey Women's Tee"
               },
               {
                 "parameterName": "affiliation",
                 "value": "Google Merchandise Store"
               },
               {
                 "parameterName": "coupon",
                 "value": "SUMMER_FUN"
               },
               {
                 "parameterName": "discount",
                 "value": "3.33"
               },
               {
                 "parameterName": "index",
                 "value": "1"
               },
               {
                 "parameterName": "item_brand",
                 "value": "Google"
               },
               {
                 "parameterName": "item_category",
                 "value": "Apparel"
               },
               {
                 "parameterName": "item_category2",
                 "value": "Adult"
               },
               {
                 "parameterName": "item_category3",
                 "value": "Shirts"
               },
               {
                 "parameterName": "item_category4",
                 "value": "Crew"
               },
               {
                 "parameterName": "item_category5",
                 "value": "Short sleeve"
               },
               {
                 "parameterName": "item_list_id",
                 "value": "related_products"
               },
               {
                 "parameterName": "item_list_name",
                 "value": "Related Products"
               }
             ]
           }
         ]
       }
     }
  ],
  "validateOnly": true
}

1. আপনার অ্যাকাউন্ট এবং গন্তব্যের মান সহ OPERATING_ACCOUNT_ID এবং PRODUCT_DESTINATION_ID মতো বডির স্থানধারকগুলি আপডেট করুন।
2. পরিবর্তনগুলি প্রয়োগ না করেই অনুরোধটি যাচাই করতে validateOnly কে true এ সেট করুন। পরিবর্তনগুলি প্রয়োগ করার জন্য প্রস্তুত হলে, validateOnly কে false এ সেট করুন।
3. মনে রাখবেন এই উদাহরণটি এনক্রিপশন ব্যবহার করে না।

অনুরোধটি পাঠান

1. নমুনার উপরের ডানদিকে কপি বোতামটি ব্যবহার করে অনুরোধের মূল অংশটি অনুলিপি করুন।
2. টুলবারে API বোতামে ক্লিক করুন।
3. কপি করা রিকোয়েস্ট বডিটি রিকোয়েস্ট বডি বক্সে পেস্ট করুন।
4. এক্সিকিউট বোতামে ক্লিক করুন, অনুমোদনের প্রম্পটগুলি সম্পূর্ণ করুন এবং প্রতিক্রিয়া পর্যালোচনা করুন।

সাফল্যের প্রতিক্রিয়া

একটি সফল অনুরোধ একটি requestId ধারণকারী একটি বস্তুর সাথে একটি প্রতিক্রিয়া ফেরত দেয়।

{
  "requestId": "126365e1-16d0-4c81-9de9-f362711e250a"
}

অনুরোধের প্রতিটি গন্তব্য প্রক্রিয়াকরণের সাথে সাথে ডায়াগনস্টিকগুলি পুনরুদ্ধার করতে আপনি ফিরে আসা requestId রেকর্ড করুন।

ব্যর্থতার প্রতিক্রিয়া

একটি ব্যর্থ অনুরোধের ফলে 400 Bad Request এর মতো একটি ত্রুটি প্রতিক্রিয়া স্থিতি কোড এবং ত্রুটির বিবরণ সহ একটি প্রতিক্রিয়া দেখা যায়।

উদাহরণস্বরূপ, একটি emailAddress যাতে হেক্স এনকোডেড মানের পরিবর্তে একটি প্লেইন টেক্সট স্ট্রিং থাকে, নিম্নলিখিত প্রতিক্রিয়া তৈরি করে:

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "events.events[0].user_data.user_identifiers",
            "description": "Email is not hex encoded.",
            "reason": "INVALID_HEX_ENCODING"
          }
        ]
      }
    ]
  }
}

একটি emailAddress যা হ্যাশ করা হয় না এবং শুধুমাত্র হেক্স এনকোডেড থাকে তা নিম্নলিখিত প্রতিক্রিয়া তৈরি করে:

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "events.events[0]",
            "reason": "INVALID_SHA256_FORMAT"
          }
        ]
      }
    ]
  }
}

একাধিক গন্তব্যের জন্য ইভেন্ট পাঠান

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

উদাহরণস্বরূপ, যদি আপনার কাছে রূপান্তর অ্যাকশন আইডি 123456789 এর জন্য একটি ইভেন্ট এবং রূপান্তর অ্যাকশন আইডি 777111122 এর জন্য আরেকটি ইভেন্ট থাকে, তাহলে প্রতিটি Destination reference সেট করে উভয় ইভেন্টকে একটি একক অনুরোধে পাঠান। reference ব্যবহারকারী-সংজ্ঞায়িত। একমাত্র প্রয়োজনীয়তা হল প্রতিটি Destination একটি অনন্য reference থাকা। অনুরোধের জন্য পরিবর্তিত destinations তালিকা এখানে দেওয়া হল:

  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "PRODUCT_DESTINATION_ID",
      "reference": "destination_a"
    },
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_2_TYPE",
        "accountId": "OPERATING_ACCOUNT_2_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_2_TYPE",
        "accountId": "LOGIN_ACCOUNT_2_ID"
      },

      "productDestinationId": "777111122",
      "reference": "destination_b"
    }
  ]

প্রতিটি Event destinationReferences সেট করুন যাতে এটি এক বা একাধিক নির্দিষ্ট গন্তব্যে পাঠানো যায়। উদাহরণস্বরূপ, এখানে একটি Event রয়েছে যা শুধুমাত্র প্রথম Destination এর জন্য, তাই এর destinationReferences তালিকায় শুধুমাত্র প্রথম Destination এর reference রয়েছে:

{
   "adIdentifiers": {
      "gclid": "GCLID_1"
   },
   "conversionValue": 1.99,
   "currency": "USD",
   "eventTimestamp": "2025-06-10T20:07:01Z",
   "transactionId": "ABC798654321",
   "eventSource": "WEB",
   "destinationReferences": [
      "destination_a"
   ]
}

destinationReferences ক্ষেত্রটি একটি তালিকা, তাই আপনি একটি ইভেন্টের জন্য একাধিক গন্তব্য নির্দিষ্ট করতে পারেন। যদি আপনি একটি Event destinationReferences সেট না করেন, তাহলে Data Manager API অনুরোধের সমস্ত গন্তব্যে ইভেন্টটি পাঠায়।

যদি কোনও ইভেন্টের একাধিক গন্তব্য থাকে, তাহলে ডেটা ম্যানেজার API প্রতিটি গন্তব্যে প্রাসঙ্গিক ক্ষেত্র পাঠায়। উদাহরণস্বরূপ, যদি কোনও ইভেন্টের একটি Google Ads গন্তব্য এবং একটি Google Analytics গন্তব্য থাকে, তাহলে Google Analytics গন্তব্যে ইভেন্ট পাঠানোর সময় API-তে clientId বা eventName এর মতো Google Analytics ক্ষেত্র অন্তর্ভুক্ত থাকে এবং Google Ads গন্তব্যে ইভেন্ট পাঠানোর সময় customVariables এর মতো Google Ads ক্ষেত্র অন্তর্ভুক্ত থাকে।

পরবর্তী পদক্ষেপ

• প্রমাণীকরণ কনফিগার করুন এবং একটি ক্লায়েন্ট লাইব্রেরি দিয়ে আপনার পরিবেশ সেটআপ করুন।
• প্রতিটি ধরণের ডেটার জন্য ফর্ম্যাটিং, হ্যাশিং এবং এনকোডিংয়ের প্রয়োজনীয়তা সম্পর্কে জানুন।
• ব্যবহারকারীর ডেটা কীভাবে এনক্রিপ্ট করতে হয় তা শিখুন।
• আপনার অনুরোধের জন্য ডায়াগনস্টিকস কীভাবে পুনরুদ্ধার করবেন তা শিখুন।
• সেরা অনুশীলন সম্পর্কে জানুন।
• সীমা এবং কোটা সম্পর্কে জানুন।