- HTTP অনুরোধ
- পাথ প্যারামিটার
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- অনুমোদনের সুযোগ
- ক্লিক রূপান্তর
- এক্সটার্নাল অ্যাট্রিবিউশন ডেটা
- কার্টডেটা
- আইটেম
- রূপান্তর পরিবেশ
- Conversion Result ক্লিক করুন
- এটা চেষ্টা করুন!
প্রদত্ত ক্লিক রূপান্তর প্রক্রিয়া করে।
নিক্ষিপ্ত ত্রুটির তালিকা: প্রমাণীকরণ ত্রুটি অনুমোদন ত্রুটি রূপান্তর আপলোড ত্রুটি হেডার ত্রুটি অভ্যন্তরীণ ত্রুটি আংশিক ব্যর্থতার ত্রুটি কোটা ত্রুটি অনুরোধের ত্রুটি
HTTP অনুরোধ
POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadClickConversions
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
পাথ প্যারামিটার
পরামিতি | |
---|---|
customerId | প্রয়োজন। আপলোড করা গ্রাহকের আইডি। |
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{
"conversions": [
{
object ( |
ক্ষেত্র | |
---|---|
conversions[] | প্রয়োজন। যে রূপান্তরগুলি আপলোড করা হচ্ছে। |
partialFailure | প্রয়োজন। সত্য হলে, সফল অপারেশন করা হবে এবং অবৈধ অপারেশন ত্রুটি ফিরিয়ে দেবে। যদি মিথ্যা হয়, সমস্ত ক্রিয়াকলাপ একটি লেনদেনে করা হবে যদি এবং শুধুমাত্র যদি সেগুলি বৈধ হয়। এটি সর্বদা সত্য হিসাবে সেট করা উচিত। আংশিক ব্যর্থতা সম্পর্কে আরও তথ্যের জন্য https://developers.google.com/google-ads/api/docs/best-practices/partial-failures দেখুন। |
validateOnly | সত্য হলে, অনুরোধটি যাচাই করা হয় কিন্তু কার্যকর করা হয় না। শুধুমাত্র ত্রুটিগুলি ফেরত দেওয়া হয়, ফলাফল নয়। |
debugEnabled | সত্য হলে, এপিআই সমস্ত আপলোড চেক সঞ্চালন করবে এবং কোনো ত্রুটি পাওয়া গেলে তা ফেরত দেবে। মিথ্যা হলে, এটি শুধুমাত্র মৌলিক ইনপুট যাচাইকরণ করবে, পরবর্তী আপলোড চেকগুলি এড়িয়ে যাবে, এবং প্রদত্ত এই সেটিং শুধুমাত্র লিড আপলোডগুলির জন্য উন্নত রূপান্তরগুলিকে প্রভাবিত করে যেগুলি ডিফল্ট মিথ্যা. |
jobId | ঐচ্ছিক। কাজের আইডি সেট করতে ঐচ্ছিক ইনপুট। একটি নন-নেতিবাচক সংখ্যা হতে হবে যা প্রদান করা হলে 2^31 এর কম। যদি এই ক্ষেত্রটি প্রদান করা না হয়, তাহলে API [2^31, (2^63)-1] পরিসরে একটি কাজের আইডি তৈরি করবে। API |
প্রতিক্রিয়া শরীর
ConversionUploadService.UploadClickConversions
এর জন্য প্রতিক্রিয়া বার্তা।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{ "partialFailureError": { object ( |
ক্ষেত্র | |
---|---|
partialFailureError | আংশিক ব্যর্থতা মোডে রূপান্তর ব্যর্থতার সাথে সম্পর্কিত ত্রুটি৷ রূপান্তরগুলির মধ্যে সমস্ত ত্রুটি ঘটলে ফিরে আসে৷ রূপান্তরের বাইরে কোনো ত্রুটি দেখা দিলে (উদাহরণস্বরূপ, প্রমাণীকরণের ত্রুটি), আমরা একটি RPC স্তরের ত্রুটি ফেরত দিই। আংশিক ব্যর্থতা সম্পর্কে আরও তথ্যের জন্য https://developers.google.com/google-ads/api/docs/best-practices/partial-failures দেখুন। |
results[] | সফলভাবে প্রক্রিয়াকৃত রূপান্তরের জন্য ফিরে এসেছে। একটি ত্রুটি প্রাপ্ত সারিগুলির জন্য প্রোটো খালি থাকবে। শুধুমাত্র যাচাই সত্য হলে ফলাফল ফেরত দেওয়া হয় না। |
jobId | আপলোড ব্যাচের জন্য কাজের আইডি। |
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth সুযোগ প্রয়োজন:
-
https://www.googleapis.com/auth/adwords
আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।
ক্লিক রূপান্তর
একটি ক্লিক রূপান্তর.
JSON প্রতিনিধিত্ব |
---|
{ "gbraid": string, "wbraid": string, "externalAttributionData": { object ( |
ক্ষেত্র | |
---|---|
gbraid | অ্যাপ্লিকেশন রূপান্তরগুলির সাথে যুক্ত ক্লিকের জন্য ক্লিক শনাক্তকারী এবং iOS14 থেকে শুরু করে iOS ডিভাইসগুলি থেকে উদ্ভূত৷ |
wbraid | ওয়েব রূপান্তরগুলির সাথে যুক্ত ক্লিকের জন্য ক্লিক শনাক্তকারী এবং iOS14 থেকে শুরু করে iOS ডিভাইসগুলি থেকে উদ্ভূত৷ |
externalAttributionData | বাহ্যিকভাবে আরোপিত রূপান্তর সম্পর্কে অতিরিক্ত ডেটা। এই ক্ষেত্রটি একটি বাহ্যিকভাবে বৈশিষ্ট্যযুক্ত রূপান্তর ক্রিয়া সহ রূপান্তরগুলির জন্য প্রয়োজনীয়, তবে অন্যথায় সেট করা উচিত নয়৷ |
customVariables[] | এই রূপান্তরের সাথে যুক্ত কাস্টম ভেরিয়েবল। |
cartData | এই রূপান্তরের সাথে যুক্ত কার্ট ডেটা। |
userIdentifiers[] | এই রূপান্তরের সাথে যুক্ত ব্যবহারকারী শনাক্তকারী। রূপান্তর আপলোডের জন্য শুধুমাত্র hashedEmail এবং hashedPhoneNumber সমর্থিত। প্রতিটি রূপান্তরের জন্য ব্যবহারকারী শনাক্তকারীর সর্বাধিক সংখ্যা 5। |
conversionEnvironment | এই রূপান্তরটি যে পরিবেশে রেকর্ড করা হয়েছিল, উদাহরণস্বরূপ, অ্যাপ বা ওয়েব৷ |
consent | ইভেন্টের জন্য সম্মতি সেটিং। |
gclid | এই রূপান্তরের সাথে যুক্ত Google ক্লিক আইডি (gclid)। |
conversionAction | এই রূপান্তরের সাথে সম্পর্কিত রূপান্তর কর্মের সম্পদের নাম। দ্রষ্টব্য: যদিও এই সংস্থান নামটিতে একটি গ্রাহক আইডি এবং একটি রূপান্তর অ্যাকশন আইডি রয়েছে, তবে বৈধতা গ্রাহক আইডিকে উপেক্ষা করবে এবং রূপান্তর কর্মের একমাত্র শনাক্তকারী হিসাবে রূপান্তর অ্যাকশন আইডি ব্যবহার করবে৷ |
conversionDateTime | যে তারিখে রূপান্তর ঘটেছে। ক্লিক সময় পরে হতে হবে. টাইমজোন অবশ্যই উল্লেখ করতে হবে। ফর্ম্যাট হল "yyyy-mm-dd hh:mm:ss+|-hh:mm", উদাহরণস্বরূপ, "2019-01-01 12:32:45-08:00"। |
conversionValue | বিজ্ঞাপনদাতার জন্য রূপান্তরের মান। |
currencyCode | রূপান্তর মানের সাথে সম্পর্কিত মুদ্রা। এটি হল ISO 4217 3-অক্ষরের মুদ্রা কোড। যেমন: USD, EUR। |
orderId | রূপান্তরের সাথে যুক্ত অর্ডার আইডি। একটি অর্ডার আইডি শুধুমাত্র একটি রূপান্তর প্রতি রূপান্তর কর্মের জন্য ব্যবহার করা যেতে পারে। |
এক্সটার্নাল অ্যাট্রিবিউশন ডেটা
বাহ্যিকভাবে আরোপিত রূপান্তর সম্পর্কে অতিরিক্ত তথ্য রয়েছে।
JSON প্রতিনিধিত্ব |
---|
{ "externalAttributionCredit": number, "externalAttributionModel": string } |
ক্ষেত্র | |
---|---|
externalAttributionCredit | Google বিজ্ঞাপন ক্লিকের জন্য দায়ী রূপান্তরের ভগ্নাংশকে প্রতিনিধিত্ব করে। |
externalAttributionModel | অ্যাট্রিবিউশন মডেলের নাম নির্দিষ্ট করে। |
কার্টডেটা
কার্ট ডেটা সম্পর্কে অতিরিক্ত তথ্য রয়েছে।
JSON প্রতিনিধিত্ব |
---|
{
"merchantId": string,
"feedCountryCode": string,
"feedLanguageCode": string,
"localTransactionCost": number,
"items": [
{
object ( |
ক্ষেত্র | |
---|---|
merchantId | বণিক কেন্দ্রের আইডি যেখানে আইটেমগুলি আপলোড করা হয়। |
feedCountryCode | ফিড যেখানে আইটেম আপলোড করা হয় সেই দেশের কোড। |
feedLanguageCode | ফিড যেখানে আইটেম আপলোড করা হয় তার সাথে সম্পর্কিত ভাষার কোড। |
localTransactionCost | সমস্ত লেনদেন স্তরের ছাড়ের সমষ্টি, যেমন সম্পূর্ণ কার্টের জন্য বিনামূল্যে শিপিং এবং কুপন ছাড়৷ কারেন্সি কোডটি ক্লিক কনভার্সন বার্তার মতোই। |
items[] | কেনা আইটেম ডেটা. |
আইটেম
কেনা আইটেম তথ্য ধারণ করে.
JSON প্রতিনিধিত্ব |
---|
{ "productId": string, "quantity": integer, "unitPrice": number } |
ক্ষেত্র | |
---|---|
productId | আইটেমটির শপিং আইডি। মার্চেন্ট সেন্টার পণ্য শনাক্তকারীর সমান হতে হবে। |
quantity | বিক্রিত আইটেম সংখ্যা. |
unitPrice | ট্যাক্স, শিপিং, এবং যেকোনো লেনদেন স্তরের ছাড় ছাড়া ইউনিট মূল্য। কারেন্সি কোডটি ক্লিক কনভার্সন বার্তার মতোই। |
রূপান্তর পরিবেশ
আপলোড করা রূপান্তরের রূপান্তর পরিবেশ।
Enums | |
---|---|
UNSPECIFIED | উল্লিখিত না. |
UNKNOWN | শুধুমাত্র রিটার্ন মান জন্য ব্যবহৃত. এই সংস্করণে অজানা মান প্রতিনিধিত্ব করে। |
APP | রূপান্তরটি একটি অ্যাপে রেকর্ড করা হয়েছিল। |
WEB | রূপান্তরটি একটি ওয়েবসাইটে রেকর্ড করা হয়েছিল। |
Conversion Result ক্লিক করুন
একটি সফলভাবে প্রক্রিয়া করা ক্লিক রূপান্তর জন্য তথ্য সনাক্তকরণ.
JSON প্রতিনিধিত্ব |
---|
{
"gbraid": string,
"wbraid": string,
"userIdentifiers": [
{
object ( |
ক্ষেত্র | |
---|---|
gbraid | অ্যাপ্লিকেশন রূপান্তরগুলির সাথে যুক্ত ক্লিকের জন্য ক্লিক শনাক্তকারী এবং iOS14 থেকে শুরু করে iOS ডিভাইসগুলি থেকে উদ্ভূত৷ |
wbraid | ওয়েব রূপান্তরগুলির সাথে যুক্ত ক্লিকের জন্য ক্লিক শনাক্তকারী এবং iOS14 থেকে শুরু করে iOS ডিভাইসগুলি থেকে উদ্ভূত৷ |
userIdentifiers[] | এই রূপান্তরের সাথে যুক্ত ব্যবহারকারী শনাক্তকারী। রূপান্তর আপলোডের জন্য শুধুমাত্র hashedEmail এবং hashedPhoneNumber সমর্থিত। প্রতিটি রূপান্তরের জন্য ব্যবহারকারী শনাক্তকারীর সর্বাধিক সংখ্যা 5। |
gclid | এই রূপান্তরের সাথে যুক্ত Google ক্লিক আইডি (gclid)। |
conversionAction | এই রূপান্তরের সাথে সম্পর্কিত রূপান্তর কর্মের সম্পদের নাম। |
conversionDateTime | যে তারিখে রূপান্তর ঘটেছে। ফর্ম্যাট হল "yyyy-mm-dd hh:mm:ss+|-hh:mm", উদাহরণস্বরূপ, "2019-01-01 12:32:45-08:00"। |