Method: customers.uploadConversionAdjustments

প্রদত্ত রূপান্তর সমন্বয় প্রক্রিয়া.

নিক্ষিপ্ত ত্রুটির তালিকা: প্রমাণীকরণ ত্রুটি অনুমোদন ত্রুটি হেডার ত্রুটি অভ্যন্তরীণ ত্রুটি আংশিক ব্যর্থতার ত্রুটি কোটা ত্রুটি অনুরোধ ত্রুটি

HTTP অনুরোধ

POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadConversionAdjustments

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
customerId

string

প্রয়োজন। আপলোড করা গ্রাহকের আইডি।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "jobId": integer
}
ক্ষেত্র
conversionAdjustments[]

object ( ConversionAdjustment )

প্রয়োজন। আপলোড করা হচ্ছে যে রূপান্তর সমন্বয়.

partialFailure

boolean

প্রয়োজন। সত্য হলে, সফল অপারেশন করা হবে এবং অবৈধ অপারেশন ত্রুটি ফিরিয়ে দেবে। যদি মিথ্যা হয়, সমস্ত ক্রিয়াকলাপ একটি লেনদেনে করা হবে যদি এবং শুধুমাত্র যদি সেগুলি বৈধ হয়। এটি সর্বদা সত্য হিসাবে সেট করা উচিত। আংশিক ব্যর্থতা সম্পর্কে আরও তথ্যের জন্য https://developers.google.com/google-ads/api/docs/best-practices/partial-failures দেখুন।

validateOnly

boolean

সত্য হলে, অনুরোধটি যাচাই করা হয় কিন্তু কার্যকর করা হয় না। শুধুমাত্র ত্রুটিগুলি ফেরত দেওয়া হয়, ফলাফল নয়।

jobId

integer

ঐচ্ছিক। কাজের আইডি সেট করতে ঐচ্ছিক ইনপুট। একটি নন-নেতিবাচক সংখ্যা হতে হবে যা প্রদান করা হলে 2^31 এর কম। যদি এই ক্ষেত্রটি প্রদান করা না হয়, তাহলে API [2^31, (2^63)-1] পরিসরে একটি কাজের আইডি তৈরি করবে। এপিআই UploadConversionAdjustmentsResponse রেসপন্সের jobId ক্ষেত্রে এই অনুরোধের মান ফিরিয়ে দেবে।

প্রতিক্রিয়া শরীর

ConversionAdjustmentUploadService.UploadConversionAdjustments এর জন্য প্রতিক্রিয়া বার্তা।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (ConversionAdjustmentResult)
    }
  ],
  "jobId": string
}
ক্ষেত্র
partialFailureError

object ( Status )

আংশিক ব্যর্থতা মোডে রূপান্তর সামঞ্জস্য ব্যর্থতার সাথে সম্পর্কিত ত্রুটি৷ সামঞ্জস্যের ভিতরে সমস্ত ত্রুটি ঘটলে ফিরে আসে। সামঞ্জস্যের বাইরে কোনো ত্রুটি দেখা দিলে (উদাহরণস্বরূপ, প্রমাণীকরণ ত্রুটি), আমরা একটি RPC স্তরের ত্রুটি ফেরত দিই। আংশিক ব্যর্থতা সম্পর্কে আরও তথ্যের জন্য https://developers.google.com/google-ads/api/docs/best-practices/partial-failures দেখুন।

results[]

object ( ConversionAdjustmentResult )

সফলভাবে প্রক্রিয়াকৃত রূপান্তর সমন্বয়ের জন্য ফিরে এসেছে। একটি ত্রুটি প্রাপ্ত সারিগুলির জন্য প্রোটো খালি থাকবে। শুধুমাত্র যাচাই সত্য হলে ফলাফল ফেরত দেওয়া হয় না।

jobId

string ( int64 format)

আপলোড ব্যাচের জন্য কাজের আইডি।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/adwords

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

রূপান্তর সামঞ্জস্য

একটি রূপান্তর সমন্বয়.

JSON প্রতিনিধিত্ব
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
ক্ষেত্র
gclidDateTimePair

object ( GclidDateTimePair )

সামঞ্জস্যের জন্য, স্বতন্ত্রভাবে একটি রূপান্তর সনাক্ত করে যা নির্দিষ্ট অর্ডার আইডি ছাড়া রিপোর্ট করা হয়েছিল। অ্যাডজাস্টমেন্ট টাইপ এনহান্সমেন্ট হলে, এই মান ঐচ্ছিক কিন্তু অর্ডার আইডি ছাড়াও সেট করা হতে পারে।

adjustmentType

enum ( ConversionAdjustmentType )

সমন্বয়ের ধরন।

restatementValue

object ( RestatementValue )

রূপান্তরের মান পুনরুদ্ধার করার জন্য প্রয়োজনীয় তথ্য। পুনঃবিবৃতি জন্য প্রয়োজন. প্রত্যাহার জন্য সরবরাহ করা উচিত নয়. একটি প্রত্যাহারের জন্য প্রদান করা হলে একটি ত্রুটি ফেরত দেওয়া হবে৷ দ্রষ্টব্য: আপনি যদি একটি ভিন্ন সামঞ্জস্যপূর্ণ মান সহ একটি দ্বিতীয় পুনঃবিবৃতি আপলোড করতে চান তবে এটির একটি নতুন, আরও সাম্প্রতিক, সামঞ্জস্য হওয়ার সময় থাকতে হবে৷ অন্যথায়, এটি পূর্ববর্তী পুনঃবিবৃতির একটি নকল হিসাবে বিবেচিত হবে এবং উপেক্ষা করা হবে।

userIdentifiers[]

object ( UserIdentifier )

মূল রূপান্তর উন্নত করতে ব্যবহারকারী শনাক্তকারী। ConversionAdjustmentUploadService শুধুমাত্র বর্ধিতকরণে ব্যবহারকারী শনাক্তকারী গ্রহণ করে। প্রতিটি বর্ধনের জন্য ব্যবহারকারী শনাক্তকারীর সর্বোচ্চ সংখ্যা হল 5 জন৷

orderId

string

রূপান্তরের অর্ডার আইডি সামঞ্জস্য করতে হবে। যদি একটি অর্ডার আইডি নির্দিষ্ট করে কনভার্সন রিপোর্ট করা হয়, তাহলে সেই অর্ডার আইডি এখানে আইডেন্টিফায়ার হিসেবে ব্যবহার করতে হবে। উন্নতির জন্য অর্ডার আইডি প্রয়োজন।

conversionAction

string

এই রূপান্তর সমন্বয়ের সাথে সম্পর্কিত রূপান্তর কর্মের সম্পদের নাম। দ্রষ্টব্য: যদিও এই সংস্থান নামটিতে একটি গ্রাহক আইডি এবং একটি রূপান্তর অ্যাকশন আইডি রয়েছে, তবে বৈধতা গ্রাহক আইডিকে উপেক্ষা করবে এবং রূপান্তর কর্মের একমাত্র শনাক্তকারী হিসাবে রূপান্তর অ্যাকশন আইডি ব্যবহার করবে৷

adjustmentDateTime

string

যে তারিখের সময় সমন্বয় ঘটেছে। রূপান্তর তারিখের পরে হতে হবে। টাইমজোন অবশ্যই উল্লেখ করতে হবে। ফর্ম্যাট হল "yyyy-mm-dd hh:mm:ss+|-hh:mm", উদাহরণস্বরূপ, "2019-01-01 12:32:45-08:00"।

userAgent

string

মূল রূপান্তর উন্নত করতে ব্যবহারকারী এজেন্ট। এটি আপনার ব্যবহারকারীর HTTP অনুরোধ শিরোনামে পাওয়া যেতে পারে যখন তারা আপনার ওয়েব পৃষ্ঠায় রূপান্তর করে। উদাহরণ, "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)"। ব্যবহারকারী এজেন্ট শুধুমাত্র ব্যবহারকারী শনাক্তকারীর সাথে উন্নতকরণে নির্দিষ্ট করা যেতে পারে। এটি মূল রূপান্তরটি পাঠানো অনুরোধের ব্যবহারকারী এজেন্টের সাথে মিলিত হওয়া উচিত যাতে রূপান্তর এবং এর বর্ধিতকরণ উভয়ই একই-ডিভাইস হিসাবে বা উভয়ই ক্রস-ডিভাইস হিসাবে অ্যাট্রিবিউট করা হয়।

GclidDateTimePair

একটি নির্দিষ্ট অর্ডার আইডি ছাড়া রিপোর্ট করা একটি রূপান্তরকে স্বতন্ত্রভাবে চিহ্নিত করে।

JSON প্রতিনিধিত্ব
{
  "gclid": string,
  "conversionDateTime": string
}
ক্ষেত্র
gclid

string

এই সমন্বয়ের জন্য মূল রূপান্তরের সাথে যুক্ত Google ক্লিক আইডি (gclid)।

conversionDateTime

string

এই সামঞ্জস্যের জন্য মূল রূপান্তরের তারিখের সময়। টাইমজোন অবশ্যই উল্লেখ করতে হবে। ফর্ম্যাট হল "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

number

পুনর্নির্ধারিত রূপান্তর মান। এটি পুনর্বিবেচনার পরে রূপান্তরের মান। উদাহরণস্বরূপ, একটি রূপান্তরের মান 100 থেকে 70 এ পরিবর্তন করতে, 70 এর একটি সামঞ্জস্যপূর্ণ মান রিপোর্ট করা উচিত। দ্রষ্টব্য: আপনি যদি একটি ভিন্ন সামঞ্জস্যপূর্ণ মান সহ একটি দ্বিতীয় পুনঃবিবৃতি আপলোড করতে চান তবে এটির একটি নতুন, আরও সাম্প্রতিক, সামঞ্জস্য হওয়ার সময় থাকতে হবে৷ অন্যথায়, এটি পূর্ববর্তী পুনঃবিবৃতির একটি নকল হিসাবে বিবেচিত হবে এবং উপেক্ষা করা হবে।

currencyCode

string

পুনঃনির্ধারিত মূল্যের মুদ্রা। যদি প্রদান না করা হয়, তাহলে রূপান্তর ক্রিয়া থেকে ডিফল্ট মুদ্রা ব্যবহার করা হয়, এবং যদি এটি সেট না করা হয় তাহলে অ্যাকাউন্ট মুদ্রা ব্যবহার করা হয়। এটি হল ISO 4217 3-অক্ষরের মুদ্রা কোড, উদাহরণস্বরূপ, USD বা EUR৷

রূপান্তর সামঞ্জস্য ফলাফল

একটি সফলভাবে প্রক্রিয়াকৃত রূপান্তর সমন্বয় সনাক্তকারী তথ্য।

JSON প্রতিনিধিত্ব
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
ক্ষেত্র
gclidDateTimePair

object ( GclidDateTimePair )

রূপান্তরের gclid এবং রূপান্তরের তারিখের সময়।

orderId

string

রূপান্তরের অর্ডার আইডি সামঞ্জস্য করতে হবে।

adjustmentType

enum ( ConversionAdjustmentType )

সমন্বয়ের ধরন।

conversionAction

string

এই রূপান্তর সমন্বয়ের সাথে সম্পর্কিত রূপান্তর কর্মের সম্পদের নাম।

adjustmentDateTime

string

যে তারিখের সময় সমন্বয় ঘটেছে। ফর্ম্যাট হল "yyyy-mm-dd hh:mm:ss+|-hh:mm", উদাহরণস্বরূপ, "2019-01-01 12:32:45-08:00"।