- HTTP অনুরোধ
- পাথ প্যারামিটার
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- অনুমোদনের সুযোগ
- রূপান্তর সামঞ্জস্য
- GclidDateTimePair
- কনভার্সন অ্যাডজাস্টমেন্ট টাইপ
- রিস্টেটমেন্ট ভ্যালু
- রূপান্তর সামঞ্জস্য ফলাফল
- এটা চেষ্টা করুন!
প্রদত্ত রূপান্তর সমন্বয় প্রক্রিয়া.
নিক্ষিপ্ত ত্রুটির তালিকা: প্রমাণীকরণ ত্রুটি অনুমোদন ত্রুটি হেডার ত্রুটি অভ্যন্তরীণ ত্রুটি আংশিক ব্যর্থতার ত্রুটি কোটা ত্রুটি অনুরোধ ত্রুটি
HTTP অনুরোধ
POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadConversionAdjustments
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
পাথ প্যারামিটার
পরামিতি | |
---|---|
customerId | প্রয়োজন। আপলোড করা গ্রাহকের আইডি। |
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{
"conversionAdjustments": [
{
object ( |
ক্ষেত্র | |
---|---|
conversionAdjustments[] | প্রয়োজন। আপলোড করা হচ্ছে যে রূপান্তর সমন্বয়. |
partialFailure | প্রয়োজন। সত্য হলে, সফল অপারেশন করা হবে এবং অবৈধ অপারেশন ত্রুটি ফিরিয়ে দেবে। যদি মিথ্যা হয়, সমস্ত ক্রিয়াকলাপ একটি লেনদেনে করা হবে যদি এবং শুধুমাত্র যদি সেগুলি বৈধ হয়। এটি সর্বদা সত্য হিসাবে সেট করা উচিত। আংশিক ব্যর্থতা সম্পর্কে আরও তথ্যের জন্য https://developers.google.com/google-ads/api/docs/best-practices/partial-failures দেখুন। |
validateOnly | সত্য হলে, অনুরোধটি যাচাই করা হয় কিন্তু কার্যকর করা হয় না। শুধুমাত্র ত্রুটিগুলি ফেরত দেওয়া হয়, ফলাফল নয়। |
jobId | ঐচ্ছিক। কাজের আইডি সেট করতে ঐচ্ছিক ইনপুট। একটি নন-নেতিবাচক সংখ্যা হতে হবে যা প্রদান করা হলে 2^31 এর কম। যদি এই ক্ষেত্রটি প্রদান করা না হয়, তাহলে API [2^31, (2^63)-1] পরিসরে একটি কাজের আইডি তৈরি করবে। এপিআই |
প্রতিক্রিয়া শরীর
ConversionAdjustmentUploadService.UploadConversionAdjustments
এর জন্য প্রতিক্রিয়া বার্তা।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
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 প্রতিনিধিত্ব |
---|
{ "gclidDateTimePair": { object ( |
ক্ষেত্র | |
---|---|
gclidDateTimePair | সামঞ্জস্যের জন্য, স্বতন্ত্রভাবে একটি রূপান্তর সনাক্ত করে যা নির্দিষ্ট অর্ডার আইডি ছাড়া রিপোর্ট করা হয়েছিল। অ্যাডজাস্টমেন্ট টাইপ এনহান্সমেন্ট হলে, এই মান ঐচ্ছিক কিন্তু অর্ডার আইডি ছাড়াও সেট করা হতে পারে। |
adjustmentType | সমন্বয়ের ধরন। |
restatementValue | রূপান্তরের মান পুনরুদ্ধার করার জন্য প্রয়োজনীয় তথ্য। পুনঃবিবৃতি জন্য প্রয়োজন. প্রত্যাহার জন্য সরবরাহ করা উচিত নয়. একটি প্রত্যাহারের জন্য প্রদান করা হলে একটি ত্রুটি ফেরত দেওয়া হবে৷ দ্রষ্টব্য: আপনি যদি একটি ভিন্ন সামঞ্জস্যপূর্ণ মান সহ একটি দ্বিতীয় পুনঃবিবৃতি আপলোড করতে চান তবে এটির একটি নতুন, আরও সাম্প্রতিক, সামঞ্জস্য হওয়ার সময় থাকতে হবে৷ অন্যথায়, এটি পূর্ববর্তী পুনঃবিবৃতির একটি নকল হিসাবে বিবেচিত হবে এবং উপেক্ষা করা হবে। |
userIdentifiers[] | মূল রূপান্তর উন্নত করতে ব্যবহারকারী শনাক্তকারী। ConversionAdjustmentUploadService শুধুমাত্র বর্ধিতকরণে ব্যবহারকারী শনাক্তকারী গ্রহণ করে। প্রতিটি বর্ধনের জন্য ব্যবহারকারী শনাক্তকারীর সর্বোচ্চ সংখ্যা হল 5 জন৷ |
orderId | রূপান্তরের অর্ডার আইডি সামঞ্জস্য করতে হবে। যদি একটি অর্ডার আইডি নির্দিষ্ট করে কনভার্সন রিপোর্ট করা হয়, তাহলে সেই অর্ডার আইডি এখানে আইডেন্টিফায়ার হিসেবে ব্যবহার করতে হবে। উন্নতির জন্য অর্ডার আইডি প্রয়োজন। |
conversionAction | এই রূপান্তর সমন্বয়ের সাথে সম্পর্কিত রূপান্তর কর্মের সম্পদের নাম। দ্রষ্টব্য: যদিও এই সংস্থান নামটিতে একটি গ্রাহক আইডি এবং একটি রূপান্তর অ্যাকশন আইডি রয়েছে, তবে বৈধতা গ্রাহক আইডিকে উপেক্ষা করবে এবং রূপান্তর কর্মের একমাত্র শনাক্তকারী হিসাবে রূপান্তর অ্যাকশন আইডি ব্যবহার করবে৷ |
adjustmentDateTime | যে তারিখের সময় সমন্বয় ঘটেছে। রূপান্তর তারিখের পরে হতে হবে। টাইমজোন অবশ্যই উল্লেখ করতে হবে। ফর্ম্যাট হল "yyyy-mm-dd hh:mm:ss+|-hh:mm", উদাহরণস্বরূপ, "2019-01-01 12:32:45-08:00"। |
userAgent | মূল রূপান্তর উন্নত করতে ব্যবহারকারী এজেন্ট। এটি আপনার ব্যবহারকারীর HTTP অনুরোধ শিরোনামে পাওয়া যেতে পারে যখন তারা আপনার ওয়েব পৃষ্ঠায় রূপান্তর করে। উদাহরণ, "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)"। ব্যবহারকারী এজেন্ট শুধুমাত্র ব্যবহারকারী শনাক্তকারীর সাথে উন্নতকরণে নির্দিষ্ট করা যেতে পারে। এটি মূল রূপান্তরটি পাঠানো অনুরোধের ব্যবহারকারী এজেন্টের সাথে মিলিত হওয়া উচিত যাতে রূপান্তর এবং এর বর্ধিতকরণ উভয়ই একই-ডিভাইস হিসাবে বা উভয়ই ক্রস-ডিভাইস হিসাবে অ্যাট্রিবিউট করা হয়। |
GclidDateTimePair
একটি নির্দিষ্ট অর্ডার আইডি ছাড়া রিপোর্ট করা একটি রূপান্তরকে স্বতন্ত্রভাবে চিহ্নিত করে।
JSON প্রতিনিধিত্ব |
---|
{ "gclid": string, "conversionDateTime": string } |
ক্ষেত্র | |
---|---|
gclid | এই সমন্বয়ের জন্য মূল রূপান্তরের সাথে যুক্ত Google ক্লিক আইডি (gclid)। |
conversionDateTime | এই সামঞ্জস্যের জন্য মূল রূপান্তরের তারিখের সময়। টাইমজোন অবশ্যই উল্লেখ করতে হবে। ফর্ম্যাট হল "yyyy-mm-dd hh:mm:ss+|-hh:mm", উদাহরণস্বরূপ, "2019-01-01 12:32:45-08:00"। |
কনভার্সন অ্যাডজাস্টমেন্ট টাইপ
বিজ্ঞাপনদাতারা ইতিমধ্যে রিপোর্ট করা রূপান্তরগুলি সামঞ্জস্য করতে বিভিন্ন পদক্ষেপ নিতে পারে৷ প্রত্যাহার একটি রূপান্তরকে অস্বীকার করে। পুনঃবিবৃতি একটি রূপান্তরের মান পরিবর্তন করে।
Enums | |
---|---|
UNSPECIFIED | উল্লিখিত না. |
UNKNOWN | এই সংস্করণে অজানা মান প্রতিনিধিত্ব করে। |
RETRACTION | একটি রূপান্তরকে অস্বীকার করে যাতে এর মোট মান এবং গণনা উভয়ই শূন্য হয়৷ |
RESTATEMENT | একটি রূপান্তরের মান পরিবর্তন করে। |
ENHANCEMENT | প্রদত্ত ব্যবহারকারী শনাক্তকারী এবং ব্যবহারকারী এজেন্টের সাথে একটি বিদ্যমান রূপান্তর পরিপূরক, যা Google রূপান্তর সংখ্যা বাড়াতে ব্যবহার করতে পারে। |
রিস্টেটমেন্ট ভ্যালু
একটি রূপান্তরের মান পুনরুদ্ধার করার জন্য প্রয়োজনীয় তথ্য রয়েছে৷
JSON প্রতিনিধিত্ব |
---|
{ "adjustedValue": number, "currencyCode": string } |
ক্ষেত্র | |
---|---|
adjustedValue | পুনর্নির্ধারিত রূপান্তর মান। এটি পুনর্বিবেচনার পরে রূপান্তরের মান। উদাহরণস্বরূপ, একটি রূপান্তরের মান 100 থেকে 70 এ পরিবর্তন করতে, 70 এর একটি সামঞ্জস্যপূর্ণ মান রিপোর্ট করা উচিত। দ্রষ্টব্য: আপনি যদি একটি ভিন্ন সামঞ্জস্যপূর্ণ মান সহ একটি দ্বিতীয় পুনঃবিবৃতি আপলোড করতে চান তবে এটির একটি নতুন, আরও সাম্প্রতিক, সামঞ্জস্য হওয়ার সময় থাকতে হবে৷ অন্যথায়, এটি পূর্ববর্তী পুনঃবিবৃতির একটি নকল হিসাবে বিবেচিত হবে এবং উপেক্ষা করা হবে। |
currencyCode | পুনঃনির্ধারিত মূল্যের মুদ্রা। যদি প্রদান না করা হয়, তাহলে রূপান্তর ক্রিয়া থেকে ডিফল্ট মুদ্রা ব্যবহার করা হয়, এবং যদি এটি সেট না করা হয় তাহলে অ্যাকাউন্ট মুদ্রা ব্যবহার করা হয়। এটি হল ISO 4217 3-অক্ষরের মুদ্রা কোড, উদাহরণস্বরূপ, USD বা EUR৷ |
রূপান্তর সামঞ্জস্য ফলাফল
একটি সফলভাবে প্রক্রিয়াকৃত রূপান্তর সমন্বয় সনাক্তকারী তথ্য।
JSON প্রতিনিধিত্ব |
---|
{ "gclidDateTimePair": { object ( |
ক্ষেত্র | |
---|---|
gclidDateTimePair | রূপান্তরের gclid এবং রূপান্তরের তারিখের সময়। |
orderId | রূপান্তরের অর্ডার আইডি সামঞ্জস্য করতে হবে। |
adjustmentType | সমন্বয়ের ধরন। |
conversionAction | এই রূপান্তর সমন্বয়ের সাথে সম্পর্কিত রূপান্তর কর্মের সম্পদের নাম। |
adjustmentDateTime | যে তারিখের সময় সমন্বয় ঘটেছে। ফর্ম্যাট হল "yyyy-mm-dd hh:mm:ss+|-hh:mm", উদাহরণস্বরূপ, "2019-01-01 12:32:45-08:00"। |