ঘটনা পাঠান

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

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

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

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

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

এই দ্রুত শুরুতে, আপনি নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

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

একটি গন্তব্য প্রস্তুত করুন

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

    {
      "operatingAccount": {
        "product": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  • operatingAccount অ্যাকাউন্টের accountId Google বিজ্ঞাপন অ্যাকাউন্ট আইডিতে সেট করুন যা ইভেন্ট ডেটা পাবে। operatingAccount product GOOGLE_ADS হতে হবে।

  • ইভেন্টগুলির জন্য রূপান্তর কর্মের আইডিতে productDestinationId সেট করুন। অনলাইন ইভেন্টের জন্য, রূপান্তর ক্রিয়াটি WEBPAGE তে সেট করা type সহ একটি Google Ads রূপান্তর ক্রিয়া হতে হবে। অফলাইন ইভেন্টগুলির জন্য, রূপান্তর ক্রিয়াটি অবশ্যই UPLOAD_CLICKS এ type করা একটি Google বিজ্ঞাপন রূপান্তর ক্রিয়া হতে হবে৷

    এই নির্দেশিকাটি দেখায় কিভাবে একটি অনুরোধ তৈরি করতে হয় যা প্রতিটি ইভেন্টকে একই রূপান্তর ক্রিয়ায় পাঠায়। আপনি যদি একই অনুরোধে একাধিক রূপান্তর কর্মের জন্য ইভেন্ট পাঠাতে চান, একাধিক গন্তব্য দেখুন।

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

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

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

এখানে প্রথম ইভেন্টের ডেটা রয়েছে:

ইভেন্ট #1
conversion_time 2025-06-10 15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 1.99
currency USD
gclid GCLID_1
emails
given_name John
family_name Smith-Jones
region_code us
postal_code 94045
customer_type NEW
customer_value_bucket HIGH

এখানে দ্বিতীয় ইভেন্টের ডেটা:

ইভেন্ট #2
conversion_time June 10, 2025 11:42:33PM America/New_York
conversion_action_id 123456789
transaction_id DEF999911111
conversion_value 3.25
currency eur
gclid GCLID_2
emails

zoe@EXAMPLE.COM

cloudy.sanfrancisco@gmail.com

given_name zoë
family_name pérez
region_code PT
postal_code 1229-076
customer_type RETURNING

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

বিন্যাস নির্দেশিকাতে উল্লেখ করা অনুসারে ক্ষেত্রগুলি বিন্যাস করুন। বিন্যাস করার পরে প্রথম ইভেন্টের ডেটা এখানে:

ইভেন্ট #1
conversion_time 2025-06-10 15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 1.99
currency USD
gclid GCLID_1
emails
given_name john
family_name smith-jones
region_code US
postal_code 94045
customer_type NEW
customer_value_bucket HIGH

বিন্যাস করার পরে দ্বিতীয় ইভেন্টের ডেটা এখানে:

ইভেন্ট #2
conversion_time 2025-06-10T23:42:33-05:00
conversion_action_id 123456789
transaction_id DEF999911111
conversion_value 3.25
currency EUR
gclid GCLID_2
emails

zoe@example.com

cloudysanfrancisco@gmail.com

given_name zoë
family_name pérez
region_code PT
postal_code 1229-076
customer_type RETURNING

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

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

ইভেন্ট #1
conversion_time 2025-06-10 15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 1.99
currency USD
gclid GCLID_1
emails
given_name 96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A
family_name DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081
region_code US
postal_code 94045
customer_type NEW
customer_value_bucket HIGH

হেক্স এনকোডিং ব্যবহার করে ফর্ম্যাটিং, হ্যাশিং এবং এনকোডিংয়ের পরে দ্বিতীয় ইভেন্টের ডেটা এখানে রয়েছে:

ইভেন্ট #2
conversion_time 2025-06-10T23:42:33-05:00
conversion_action_id 123456789
transaction_id DEF999911111
conversion_value 3.25
currency EUR
gclid GCLID_2
emails

3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250

223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4

given_name 2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450
family_name 6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F
region_code PT
postal_code 1229-076
customer_type RETURNING

ডেটাকে একটি Event রূপান্তর করুন

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

  • event_timestamp : ইভেন্টটি হওয়ার সময়।
  • transaction_id : ইভেন্টের অনন্য শনাক্তকারী।
  • event_source : ইভেন্টের উৎস। অফলাইন ইভেন্টের জন্য প্রয়োজনীয়। অনলাইন ইভেন্টের জন্য ঐচ্ছিক। একটি অনলাইন ইভেন্টের জন্য নির্দিষ্ট করা হলে, অবশ্যই WEB হতে হবে।
  • ad_identifiers or user_data : ইভেন্টে অবশ্যই একটি বিজ্ঞাপন শনাক্তকারী বা ব্যবহারকারীর ডেটা থাকতে হবে। ইভেন্টের জন্য উভয়ই থাকলে পাঠান।

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

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

{
   "adIdentifiers": {
      "gclid": "GCLID_2"
   },
   "conversionValue": 3.25,
   "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"
      }
   }
}

অনুরোধের বডি তৈরি করুন

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

{
  "destinations": [
    {
      "operatingAccount": {
        "product": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  ],
  "encoding": "HEX",
  "events": [
     {
       "adIdentifiers": {
         "gclid": "GCLID_1"
       },
       "conversionValue": 1.99,
       "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"
       }
     },
     {
       "adIdentifiers": {
         "gclid": "GCLID_2"
       },
       "conversionValue": 3.25,
       "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"
       }
     }
  ],
  "validateOnly": true
}
  1. আপনার অ্যাকাউন্ট এবং গন্তব্যের মানগুলির সাথে OPERATING_ACCOUNT_ID এবং CONVERSION_ACTION_1_ID মতো স্থানধারকগুলিকে আপডেট করুন৷
  2. পরিবর্তনগুলি প্রয়োগ না করেই অনুরোধটি যাচাই করার জন্য validateOnly true সেট করুন৷ আপনি যখন পরিবর্তনগুলি প্রয়োগ করার জন্য প্রস্তুত হবেন, validateOnly সেট করুন false ।
  3. মনে রাখবেন এই উদাহরণটি এনক্রিপশন ব্যবহার করে না।

অনুরোধ পাঠান

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

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

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

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

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

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

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

{
  "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"
          }
        ]
      }
    ]
  }
}

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

{
  "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": {
        "product": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "123456789"
      "reference": "conversion_action_1"
    },
    {
      "operatingAccount": {
        "product": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "777111122"
      "reference": "conversion_action_2"
    }
  ]

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

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

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

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