Method: customers.uploadClickConversions

প্রদত্ত ক্লিক রূপান্তর প্রক্রিয়া করে।

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

HTTP অনুরোধ

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadClickConversions

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

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

পরামিতি
customerId

string

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

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

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

JSON প্রতিনিধিত্ব
{
  "conversions": [
    {
      object (ClickConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "debugEnabled": boolean
}
ক্ষেত্র
conversions[]

object ( ClickConversion )

প্রয়োজন। যে রূপান্তরগুলি আপলোড করা হচ্ছে।

partialFailure

boolean

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

validateOnly

boolean

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

debugEnabled

boolean

সত্য হলে, এপিআই সমস্ত আপলোড চেক সঞ্চালন করবে এবং কোনো ত্রুটি পাওয়া গেলে তা ফেরত দেবে। মিথ্যা হলে, এটি শুধুমাত্র মৌলিক ইনপুট যাচাইকরণ করবে, পরবর্তী আপলোড চেকগুলি এড়িয়ে যাবে, এবং প্রদত্ত userIdentifiers জন্য কোনো ক্লিক না পাওয়া গেলেও সাফল্য ফিরিয়ে দেবে।

এই সেটিং শুধুমাত্র লিড আপলোডগুলির জন্য উন্নত রূপান্তরগুলিকে প্রভাবিত করে যেগুলি GCLID , GBRAID , বা WBRAID এর পরিবর্তে userIdentifiers ব্যবহার করে৷ লিডের জন্য বর্ধিত রূপান্তর আপলোড করার সময়, আপনাকে API-তে সমস্ত রূপান্তর ইভেন্ট আপলোড করতে হবে, যেগুলি Google বিজ্ঞাপন প্রচারাভিযান থেকে নাও আসতে পারে। একটি Google বিজ্ঞাপন প্রচারাভিযান থেকে নয় এমন একটি ইভেন্ট আপলোড করলে একটি CLICK_NOT_FOUND ত্রুটি দেখা দেবে যদি এই ক্ষেত্রটি true সেট করা থাকে৷ যেহেতু এই ধরনের ইভেন্টগুলির জন্য এই ত্রুটিগুলি প্রত্যাশিত, তাই এই ক্ষেত্রটিকে false সেট করুন যাতে আপনি নিশ্চিত করতে পারেন যে আপনার আপলোডগুলি সঠিকভাবে ফর্ম্যাট করা হয়েছে তবে Google বিজ্ঞাপন প্রচারাভিযান থেকে নয় এমন সমস্ত রূপান্তরগুলির CLICK_NOT_FOUND ত্রুটিগুলি উপেক্ষা করুন৷ এটি আপনাকে কেবলমাত্র সেই ত্রুটিগুলির উপর ফোকাস করার অনুমতি দেবে যা আপনি সমাধান করতে পারেন৷

ডিফল্ট মিথ্যা.

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

ConversionUploadService.UploadClickConversions এর জন্য প্রতিক্রিয়া বার্তা।

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

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

object ( Status )

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

results[]

object ( ClickConversionResult )

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

jobId

string ( int64 format)

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

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

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

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

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

ক্লিক রূপান্তর

একটি ক্লিক রূপান্তর.

JSON প্রতিনিধিত্ব
{
  "gbraid": string,
  "wbraid": string,
  "externalAttributionData": {
    object (ExternalAttributionData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "cartData": {
    object (CartData)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "conversionEnvironment": enum (ConversionEnvironment),
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string,
  "orderId": string
}
ক্ষেত্র
gbraid

string

অ্যাপ্লিকেশন রূপান্তরগুলির সাথে যুক্ত ক্লিকের জন্য ক্লিক শনাক্তকারী এবং iOS14 থেকে শুরু করে iOS ডিভাইসগুলি থেকে উদ্ভূত৷

wbraid

string

ওয়েব রূপান্তরগুলির সাথে যুক্ত ক্লিকের জন্য ক্লিক শনাক্তকারী এবং iOS14 থেকে শুরু করে iOS ডিভাইসগুলি থেকে উদ্ভূত৷

externalAttributionData

object ( ExternalAttributionData )

বাহ্যিকভাবে আরোপিত রূপান্তর সম্পর্কে অতিরিক্ত ডেটা। এই ক্ষেত্রটি একটি বাহ্যিকভাবে বৈশিষ্ট্যযুক্ত রূপান্তর ক্রিয়া সহ রূপান্তরগুলির জন্য প্রয়োজনীয়, তবে অন্যথায় সেট করা উচিত নয়৷

customVariables[]

object ( CustomVariable )

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

cartData

object ( CartData )

এই রূপান্তরের সাথে যুক্ত কার্ট ডেটা।

userIdentifiers[]

object ( UserIdentifier )

এই রূপান্তরের সাথে যুক্ত ব্যবহারকারী শনাক্তকারী। রূপান্তর আপলোডের জন্য শুধুমাত্র hashedEmail এবং hashedPhoneNumber সমর্থিত। প্রতিটি রূপান্তরের জন্য ব্যবহারকারী শনাক্তকারীর সর্বাধিক সংখ্যা 5।

conversionEnvironment

enum ( ConversionEnvironment )

এই রূপান্তরটি যে পরিবেশে রেকর্ড করা হয়েছিল, উদাহরণস্বরূপ, অ্যাপ বা ওয়েব৷

gclid

string

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

conversionAction

string

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

conversionDateTime

string

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

conversionValue

number

বিজ্ঞাপনদাতার জন্য রূপান্তরের মান।

currencyCode

string

রূপান্তর মানের সাথে সম্পর্কিত মুদ্রা। এটি হল ISO 4217 3-অক্ষরের মুদ্রা কোড। যেমন: USD, EUR।

orderId

string

রূপান্তরের সাথে যুক্ত অর্ডার আইডি। একটি অর্ডার আইডি শুধুমাত্র একটি রূপান্তর প্রতি রূপান্তর কর্মের জন্য ব্যবহার করা যেতে পারে।

এক্সটার্নাল অ্যাট্রিবিউশন ডেটা

বাহ্যিকভাবে আরোপিত রূপান্তর সম্পর্কে অতিরিক্ত তথ্য রয়েছে।

JSON প্রতিনিধিত্ব
{
  "externalAttributionCredit": number,
  "externalAttributionModel": string
}
ক্ষেত্র
externalAttributionCredit

number

Google বিজ্ঞাপন ক্লিকের জন্য দায়ী রূপান্তরের ভগ্নাংশকে প্রতিনিধিত্ব করে।

externalAttributionModel

string

অ্যাট্রিবিউশন মডেলের নাম নির্দিষ্ট করে।

কার্টডেটা

কার্ট ডেটা সম্পর্কে অতিরিক্ত তথ্য রয়েছে।

JSON প্রতিনিধিত্ব
{
  "merchantId": string,
  "feedCountryCode": string,
  "feedLanguageCode": string,
  "localTransactionCost": number,
  "items": [
    {
      object (Item)
    }
  ]
}
ক্ষেত্র
merchantId

string ( int64 format)

বণিক কেন্দ্রের আইডি যেখানে আইটেমগুলি আপলোড করা হয়।

feedCountryCode

string

ফিড যেখানে আইটেম আপলোড করা হয় সেই দেশের কোড।

feedLanguageCode

string

ফিড যেখানে আইটেম আপলোড করা হয় তার সাথে সম্পর্কিত ভাষার কোড।

localTransactionCost

number

সমস্ত লেনদেন স্তরের ছাড়ের সমষ্টি, যেমন সম্পূর্ণ কার্টের জন্য বিনামূল্যে শিপিং এবং কুপন ছাড়৷ কারেন্সি কোডটি ক্লিক কনভার্সন বার্তার মতোই।

items[]

object ( Item )

কেনা আইটেম ডেটা.

আইটেম

কেনা আইটেম তথ্য ধারণ করে.

JSON প্রতিনিধিত্ব
{
  "productId": string,
  "quantity": integer,
  "unitPrice": number
}
ক্ষেত্র
productId

string

আইটেমটির শপিং আইডি। মার্চেন্ট সেন্টার পণ্য শনাক্তকারীর সমান হতে হবে।

quantity

integer

বিক্রিত আইটেম সংখ্যা.

unitPrice

number

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

রূপান্তর পরিবেশ

আপলোড করা রূপান্তরের রূপান্তর পরিবেশ।

এনামস
UNSPECIFIED উল্লিখিত না.
UNKNOWN শুধুমাত্র রিটার্ন মান জন্য ব্যবহৃত. এই সংস্করণে অজানা মান প্রতিনিধিত্ব করে।
APP রূপান্তরটি একটি অ্যাপে রেকর্ড করা হয়েছিল।
WEB রূপান্তরটি একটি ওয়েবসাইটে রেকর্ড করা হয়েছিল।

Conversion Result ক্লিক করুন

একটি সফলভাবে প্রক্রিয়া করা ক্লিক রূপান্তর জন্য তথ্য সনাক্তকরণ.

JSON প্রতিনিধিত্ব
{
  "gbraid": string,
  "wbraid": string,
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string
}
ক্ষেত্র
gbraid

string

অ্যাপ্লিকেশন রূপান্তরগুলির সাথে যুক্ত ক্লিকের জন্য ক্লিক শনাক্তকারী এবং iOS14 থেকে শুরু করে iOS ডিভাইসগুলি থেকে উদ্ভূত৷

wbraid

string

ওয়েব রূপান্তরগুলির সাথে যুক্ত ক্লিকের জন্য ক্লিক শনাক্তকারী এবং iOS14 থেকে শুরু করে iOS ডিভাইসগুলি থেকে উদ্ভূত৷

userIdentifiers[]

object ( UserIdentifier )

এই রূপান্তরের সাথে যুক্ত ব্যবহারকারী শনাক্তকারী। রূপান্তর আপলোডের জন্য শুধুমাত্র hashedEmail এবং hashedPhoneNumber সমর্থিত। প্রতিটি রূপান্তরের জন্য ব্যবহারকারী শনাক্তকারীর সর্বাধিক সংখ্যা 5।

gclid

string

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

conversionAction

string

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

conversionDateTime

string

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