এক বা একাধিক রূপান্তর যোগ করার জন্য Conversion.insert() পদ্ধতিতে কল করুন। রূপান্তরটি সঠিকভাবে অ্যাট্রিবিউট করার জন্য, আপনার অনুরোধে বিজ্ঞাপনদাতা অফলাইন রূপান্তর রিপোর্ট করার জন্য যে Floodlight কার্যকলাপ ব্যবহার করছেন তার নাম উল্লেখ করতে হবে, সেই সাথে কীওয়ার্ড, বিজ্ঞাপন এবং সম্ভবত রূপান্তরের দিকে পরিচালিত ক্লিকের আইডিও উল্লেখ করতে হবে। Search Ads 360 ID পাওয়ার বিষয়ে তথ্যের জন্য, Search Ads 360 ID এবং Conversions দেখুন।
ঐতিহাসিক রূপান্তর আপলোড করার উপর বিধিনিষেধ সম্পর্কিত তথ্য অনুসন্ধান বিজ্ঞাপন 360 সহায়তা কেন্দ্রে পাওয়া যাবে।
যদি আপনার Conversion.insert() অনুরোধে একাধিক রূপান্তর উল্লেখ করা থাকে, তাহলে Search Ads 360 সম্পূর্ণ ব্যাচটিকে "অথবা কিছুই নয়" লেনদেন হিসেবে আপলোড করার পরিবর্তে সর্বোচ্চ প্রচেষ্টার ভিত্তিতে প্রতিটি রূপান্তর আপলোড করার চেষ্টা করে। যদি একটি ব্যাচের কিছু রূপান্তর আপলোড করতে ব্যর্থ হয়, তবে অন্যগুলি সফলভাবে আপলোড হতে পারে। একটি অবৈধ অনুরোধ বা ক্ষণস্থায়ী নেটওয়ার্ক বা সিস্টেম ব্যর্থতার কারণে রূপান্তর আপলোড ব্যর্থ হতে পারে। অতএব, আপলোড সফল হয়েছে কিনা তা নিশ্চিত করার জন্য আমরা আপনাকে প্রতিটি সন্নিবেশিত রূপান্তরের প্রতিক্রিয়া পড়ার পরামর্শ দিচ্ছি।
আপলোড করা ডেটা কতদিনের মধ্যে ব্যবহার করতে পারব?
যদি আপনি কোনও রূপান্তরের জন্য আজ বা গতকালের একটি conversionTimestamp নির্দিষ্ট করেন, তাহলে আপলোডের এক ঘন্টার মধ্যে রূপান্তরের মেট্রিক্স অনুসন্ধান বিজ্ঞাপন 360 UI তে প্রদর্শিত হবে। যদি আপনি গতকালের চেয়ে পুরানো একটি conversionTimestamp নির্দিষ্ট করেন, তাহলে মেট্রিক্স কয়েক ঘন্টার মধ্যে আপডেট হবে।
রূপান্তরের জন্য সমস্ত টাইমস্ট্যাম্পকে ইপোক টাইমে রূপান্তর করুন (যা ইউনিক্স টাইম নামেও পরিচিত)।
আমি কি API থেকে ফ্লাডলাইট অ্যাক্টিভিটি তৈরি করতে পারি?
যদি বিজ্ঞাপনদাতা এখনও অফলাইন রূপান্তর ট্র্যাক করার জন্য Floodlight কার্যকলাপ তৈরি না করে থাকেন, তাহলে আপনি Campaign Manager API ব্যবহার করে একটি তৈরি করতে পারেন। Floodlight কার্যকলাপ মূলত অফলাইন রূপান্তরের জন্য ব্যবহৃত হয় তা নির্দিষ্ট করার জন্য আপনি API ব্যবহার করতে পারবেন না, যা বিড কৌশলগুলি রূপান্তর থেকে ডেটা ব্যবহার করার সময় একটি সর্বোত্তম অনুশীলন।
আমরা সুপারিশ করছি যে আপনি API ব্যবহার করে Floodlight অ্যাক্টিভিটি তৈরি করার পরে , একজন Search Ads 360 ব্যবহারকারী Search Ads 360-এ সাইন ইন করুন এবং অ্যাক্টিভিটির সেটিং পরিবর্তন করে নির্দেশ করুন যে রূপান্তরের প্রাথমিক উৎস হল অফলাইন অ্যাক্টিভিটি ।
রূপান্তর যোগ করার জন্য সেরা অনুশীলন
রূপান্তর যোগ করার জন্য আমরা নিম্নলিখিত সেরা অনুশীলনগুলি সুপারিশ করছি:
একজন Search Ads 360 ব্যবহারকারীকে Search Ads 360-এ সাইন ইন করতে এবং অফলাইন রূপান্তর রিপোর্ট করার জন্য আপনার ব্যবহৃত প্রতিটি Floodlight কার্যকলাপের সেটিংস পরিবর্তন করতে বলুন। সেটিংসে উল্লেখ করা উচিত যে রূপান্তরের প্রাথমিক উৎস হল অফলাইন কার্যকলাপ। নির্দেশাবলীর জন্য Search Ads 360 সহায়তা কেন্দ্র দেখুন।
রূপান্তরগুলি উপলব্ধ হওয়ার সাথে সাথেই আপলোড করুন। যদি আপনি নির্দিষ্ট ভিজিটের জন্য রূপান্তরগুলি দায়ী করেন , তাহলে রূপান্তর আপলোড করার আগে ভিজিটের কমপক্ষে 6 ঘন্টা অপেক্ষা করুন। ভিজিটের 6 ঘন্টারও বেশি সময় পরে আপলোড করলে Search Ads 360 ভিজিটের ক্লিক আইডি চিনতে নাও পারে। বিরল ক্ষেত্রে, Search Ads 360 ক্লিক আইডি চিনতে পারার আগে আপনাকে 24 ঘন্টা পর্যন্ত অপেক্ষা করতে হতে পারে।
প্রতিটি আপলোডে সাম্প্রতিকতম রূপান্তরগুলি রয়েছে কিনা তা নিশ্চিত করুন। একটি আপলোড অনুরোধের মধ্যে, যদি এন্ট্রিগুলি কালানুক্রমিকভাবে না থাকে তবে তা ঠিক আছে। কিন্তু একটি বিড কৌশল হয়তো আপনার দ্বারা পরে অন্য অনুরোধে আপলোড করা পুরানো রূপান্তরগুলি বিবেচনা করতে সক্ষম নাও হতে পারে।
একটি সন্নিবেশ অনুরোধ পাঠান
আপনি নিম্নলিখিত যেকোনো একটি করার জন্য একটি Conversion.insert() অনুরোধ পাঠাতে পারেন:
- একটি নির্দিষ্ট ভিজিটের সাথে একটি রূপান্তরকে যুক্ত করুন
- শুধুমাত্র একটি কীওয়ার্ডের সাথে একটি রূপান্তরকে অ্যাট্রিবিউট করুন
Conversion.insert() অনুরোধে প্রয়োজনীয় ফিল্ডগুলি আপনি যে ইভেন্ট বা আইটেমের সাথে কনভার্সনটি অ্যাট্রিবিউট করছেন তার উপর নির্ভর করে। নিম্নলিখিত বিভাগগুলিতে প্রতিটি ইভেন্ট বা আইটেমের জন্য প্রয়োজনীয় এবং ঐচ্ছিক ফিল্ড তালিকাভুক্ত করা হয়েছে যার সাথে আপনি কনভার্সন অ্যাট্রিবিউট করতে পারেন।
একটি নির্দিষ্ট ভিজিটের সাথে একটি রূপান্তরকে যুক্ত করুন
যখন একজন গ্রাহক এক বা একাধিক বিজ্ঞাপনে ক্লিক করেন এবং বিজ্ঞাপনদাতার সাইটে যান, তখন Search Ads 360 বিজ্ঞাপনদাতার সাইটে ব্যবহারকারীর সেশনটিকে একটি ভিজিট হিসেবে বিবেচনা করে। একটি ভিজিটের সাথে একটি রূপান্তরকে যুক্ত করতে, আপনার Conversion.insert() অনুরোধে নিম্নলিখিতগুলি উল্লেখ করুন:
প্রয়োজনীয় ক্ষেত্রগুলি
-
clickId: ভিজিটের কেস-সংবেদনশীল ক্লিক আইডি । ক্লিক আইডি বা তালিকাভুক্ত রূপান্তরগুলির জন্য বিজ্ঞাপনদাতার ওয়েব লগগুলি দেখুন এবং অন্য রূপান্তর থেকে একটি ক্লিক আইডি ব্যবহার করুন। Search Ads 360 রূপান্তরটি কীওয়ার্ড, বিজ্ঞাপন এবং অন্যান্য Search Ads 360 অবজেক্টের সাথে সম্পর্কিত করবে যারা ভিজিট তৈরির জন্য দায়ী ছিল।
Search Ads 360 একটি ক্লিক আইডি তৈরি করার পর কমপক্ষে 6 ঘন্টা অপেক্ষা করুন এবং কনভার্সন আপলোড করুন। যদি আপনি "ক্লিক আইডি পাওয়া যায়নি" ত্রুটি পান, তাহলে 24 ঘন্টা অপেক্ষা করুন এবং তারপরে আবার কনভার্সনগুলি আপলোড করুন। ক্লিক আইডি তৈরি হওয়ার 90 দিনের মধ্যে সমস্ত কনভার্সন আপলোড করা উচিত। অন্যথায়, Search Ads 360 API ভিজিটটি চিনতে নাও পারে। -
conversionId: অফলাইন রূপান্তরের জন্য, বিজ্ঞাপনদাতারা এই আইডি প্রদান করে। বিজ্ঞাপনদাতারা তাদের কাছে অর্থপূর্ণ যেকোনো আইডি নির্দিষ্ট করতে পারেন। অনুরোধে প্রতিটি রূপান্তরের জন্য একটি অনন্য আইডি নির্দিষ্ট করতে হবে এবং বিজ্ঞাপনদাতার মধ্যে থাকা সমস্ত রূপান্তরের মধ্যে আইডি এবং টাইমস্ট্যাম্পের সমন্বয় অবশ্যই অনন্য হতে হবে। অনলাইন রূপান্তরের জন্য, Search Ads 360 বিজ্ঞাপনদাতার Floodlight নির্দেশাবলীর উপর নির্ভর করে এই সম্পত্তিতেdsConversionIdবাfloodlightOrderIdকপি করে। -
conversionTimestamp: রূপান্তরটি যে তারিখ এবং সময়ে ঘটেছে তা নির্দেশ করে। উদাহরণস্বরূপ, যদি রূপান্তরটি শুক্রবার, 05 আগস্ট 2016 11:53:22 AM Eastern Daylight Savings Time (GMT -4:00) এ ঘটে, তাহলে Epoch মিলিসেকেন্ডে টাইমস্ট্যাম্পটি উল্লেখ করুন:1470412402000। -
segmentationType: আপনি যে ধরণের রূপান্তর সিস্টেমে রূপান্তর আপলোড করছেন তা নির্দিষ্ট করে। বর্তমানে শুধুমাত্র Floodlight রূপান্তর সমর্থিত, তাইFLOODLIGHTনির্দিষ্ট করার জন্য এই ক্ষেত্রটি সর্বদা প্রয়োজন। -
segmentationName: বিজ্ঞাপনদাতা রূপান্তর রিপোর্ট করার জন্য যে ফ্লাডলাইট অ্যাক্টিভিটি ব্যবহার করছেন তার নাম।যদি আপনার বিজ্ঞাপনদাতার একই নামের কার্যকলাপ থাকে (যদি কার্যকলাপগুলি বিভিন্ন Floodlight গ্রুপের হয় তবে এটি ঘটতে পারে), তাহলে প্রস্তাবিত পদক্ষেপ হল কার্যকলাপগুলির একটির নাম পরিবর্তন করা ।
বিকল্পভাবে, যদি আপনি জানেন যে Search Ads 360 কোন ফ্লাডলাইট অ্যাক্টিভিটির জন্য কোন আইডি বরাদ্দ করেছে, তাহলে আপনি
segmentationNameফিল্ডে নাম উল্লেখ না করেsegmentationIdএ আইডি নির্দিষ্ট করতে পারেন। (ক্যাম্পেইন ম্যানেজার ফ্লাডলাইট অ্যাক্টিভিটির জন্য একটি আইডিও বরাদ্দ করে, কিন্তু ক্যাম্পেইন ম্যানেজার আইডিটি Search Ads 360 আইডি থেকে আলাদা এবং এটি রূপান্তরগুলিকে অ্যাট্রিবিউট করার জন্য ব্যবহার করা যাবে না।) Floodlight অ্যাক্টিভিটির জন্য Search Ads 360 আইডি দেখতে, একটি রূপান্তর প্রতিবেদন ডাউনলোড করুন (হয় Search Ads 360 UI অথবা রিপোর্টিং API থেকে)। যদি রিপোর্টের সময়সীমার মধ্যে কমপক্ষে একটি রূপান্তর Floodlight অ্যাক্টিভিটির জন্য অ্যাট্রিবিউট করা হয়ে থাকে, তাহলে আপনি রিপোর্টে Search Ads 360 আইডি দেখতে পাবেন। -
type: রূপান্তরের ধরণ, অর্থাৎ,ACTIONঅথবাTRANSACTION। একটি ACTION রূপান্তরের কোনও আর্থিক মূল্য নেই, যখন একটি TRANSACTION রূপান্তরের থাকে। উদাহরণ হল ইমেল তালিকা সাইনআপ (ACTION) বনাম ই-কমার্স ক্রয় (TRANSACTION)।যদি আপনি
TRANSACTIONউল্লেখ করেন, তাহলে আপনাকে নিম্নলিখিত ক্ষেত্রটিও উল্লেখ করতে হবে:-
revenueMicros: রূপান্তরের আর্থিক মূল্য।
-
ঐচ্ছিক ক্ষেত্র
-
quantityMillis: এই রূপান্তরে আইটেমের সংখ্যা। উদাহরণস্বরূপ, একটি ইমেল নিউজলেটারের জন্য সাইন আপ করা লোকের সংখ্যা বা বিক্রি হওয়া আইটেমের মোট পরিমাণ। যদি আপনি ACTION রূপান্তরের জন্য এই ক্ষেত্রটি নির্দিষ্ট না করেন, তাহলে Search Ads 360 স্বয়ংক্রিয়ভাবে1000এর মান সন্নিবেশ করবে। -
currencyCode: একটি লেনদেনের আয়ের মুদ্রা। ডিফল্টরূপে, আয় বিজ্ঞাপনদাতার মুদ্রায় বলে ধরে নেওয়া হয়। আপনি যদি অন্য কোনও মুদ্রা নির্দিষ্ট করেন, তাহলে Search Ads 360 নির্দিষ্ট আয়ের পরিমাণকে বিজ্ঞাপনদাতার মুদ্রায় রূপান্তর করে। আরও জানুন
মুদ্রা নির্দিষ্ট করতে ISO 4217 বর্ণমালা (3-অক্ষর) ফর্ম্যাট ব্যবহার করুন।
শুধুমাত্র TRANSACTION রূপান্তরের জন্য প্রযোজ্য। -
customMetricএবংcustomDimension: একটি রূপান্তর সম্পর্কে অতিরিক্ত তথ্য আপলোড করে, যেমন কোন দেশে একটি ক্রয়কৃত আইটেম পাঠানো হচ্ছে, পণ্য আইডি, এমনকি একটি টেলিফোন কলের সময়কাল। কাস্টম ফ্লাডলাইট ভেরিয়েবলের জন্য ডেটা আপলোড করার বিষয়ে আরও জানুন। -
deviceType: কোন ধরণের ডিভাইসে রূপান্তরটি ঘটেছে তা নির্দিষ্ট করে। এই ক্ষেত্রের জন্য গৃহীত মানের তালিকা দেখুন।
JSON সম্পর্কে
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site "conversionId" : "test_20130906_04", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue "currencyCode": "USD" }] }
জাভা
/** * Instantiate the Doubleclicksearch service, create conversions, and upload them. */ public static void main(String[] args) throws Exception { Doubleclicksearch service = getService(); // See Set Up Your Application. // Set up a List to keep track of each conversion you create. List<Conversion> conversions = new Vector<Conversion>(); // Add a conversion to the List. addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site "test_" + System.currentTimeMillis(), 10000000L, 1378710000000L); // Upload the List and handle the response. uploadConversions(conversions, service); } /** * Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes * the segmentation name and currency. You probably wouldn't want your production code to be so brittle. */ private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions, String clickId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion().setClickId(clickId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; } /** * Convert the List of conversions to a DS ConversionList, send an insert request to DS, * and output the response to a file. */ private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service) throws IOException { FileOutputStream outputStream = new FileOutputStream(new File("./", "InsertConversionsResponse.txt")); final PrintStream printStream = new PrintStream(outputStream); try { // Convert the List to a ConversionList. ConversionList conversionList = new ConversionList().setConversion(conversions); // Insert an upload request and download the response to a file. service.conversion().insert(conversionList).executeAndDownloadTo(printStream); printStream.close(); } catch (GoogleJsonResponseException e) { System.err.println("Get request was rejected."); for (ErrorInfo error : e.getDetails().getErrors()) { System.err.println(error.getMessage()); } System.exit(e.getStatusCode()); } }
পাইথন
def insert_conversion(service): """Create and upload a TRANSACTION conversion that is attributed to a visit. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().insert( body= { 'conversion': [{ 'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site 'conversionId': 'test_20140206_00', 'conversionTimestamp': '1378710000000', 'segmentationType': 'FLOODLIGHT', 'segmentationName': 'Test', 'type': 'TRANSACTION', 'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue 'currencyCode': 'USD' }] } ) pprint.pprint(request.execute())
শুধুমাত্র একটি কীওয়ার্ডের সাথে একটি রূপান্তরকে অ্যাট্রিবিউট করুন
যদি আপনার প্রধান উদ্বেগের বিষয় হল কীওয়ার্ডের সাথে রূপান্তরের বৈশিষ্ট্য যুক্ত করা—এবং আপনি বিজ্ঞাপনের সাথে সম্পর্কিত হওয়া নিয়ে চিন্তিত না হন—তবে আপনি বেশিরভাগ Search Ads 360 শনাক্তকারী বাদ দিতে পারেন এবং কেবল কয়েকটি অন্যান্য ক্ষেত্রের সাথে কীওয়ার্ডের শনাক্তকারী উল্লেখ করতে পারেন:
প্রয়োজনীয় ক্ষেত্রগুলি
-
criterionId: এটি হল কীওয়ার্ড শনাক্তকারী। আপনার ল্যান্ডিং পৃষ্ঠার URL-এTrackerIdম্যাক্রো যোগ করে আপনিcriterionIdপেতে পারেন। কীওয়ার্ড আইডি পাওয়ার বিষয়ে তথ্যের জন্য, Search Ads 360 ID এবং Conversions দেখুন। -
conversionId: অফলাইন রূপান্তরের জন্য, বিজ্ঞাপনদাতারা এই আইডি প্রদান করে। বিজ্ঞাপনদাতারা তাদের কাছে অর্থপূর্ণ যেকোনো আইডি নির্দিষ্ট করতে পারেন। অনুরোধে প্রতিটি রূপান্তরের জন্য একটি অনন্য আইডি নির্দিষ্ট করতে হবে এবং বিজ্ঞাপনদাতার মধ্যে থাকা সমস্ত রূপান্তরের মধ্যে আইডি এবং টাইমস্ট্যাম্পের সমন্বয় অবশ্যই অনন্য হতে হবে। অনলাইন রূপান্তরের জন্য, Search Ads 360 বিজ্ঞাপনদাতার Floodlight নির্দেশাবলীর উপর নির্ভর করে এই সম্পত্তিতেdsConversionIdবাfloodlightOrderIdকপি করে। -
conversionTimestamp: রূপান্তরটি যে তারিখ এবং সময়ে ঘটেছে তা নির্দেশ করে। উদাহরণস্বরূপ, যদি রূপান্তরটি শুক্রবার, 05 আগস্ট 2016 11:53:22 AM Eastern Daylight Savings Time (GMT -4:00) এ ঘটে, তাহলে Epoch মিলিসেকেন্ডে টাইমস্ট্যাম্পটি উল্লেখ করুন:1470412402000। -
segmentationType: আপনি যে ধরণের রূপান্তর সিস্টেমে রূপান্তর আপলোড করছেন তা নির্দিষ্ট করে। বর্তমানে শুধুমাত্র Floodlight রূপান্তর সমর্থিত, তাইFLOODLIGHTনির্দিষ্ট করার জন্য এই ক্ষেত্রটি সর্বদা প্রয়োজন। -
segmentationName: বিজ্ঞাপনদাতা রূপান্তর রিপোর্ট করার জন্য যে ফ্লাডলাইট অ্যাক্টিভিটি ব্যবহার করছেন তার নাম।যদি আপনার বিজ্ঞাপনদাতার একই নামের কার্যকলাপ থাকে (যদি কার্যকলাপগুলি বিভিন্ন Floodlight গ্রুপের হয় তবে এটি ঘটতে পারে), তাহলে প্রস্তাবিত পদক্ষেপ হল কার্যকলাপগুলির একটির নাম পরিবর্তন করা ।
বিকল্পভাবে, যদি আপনি জানেন যে Search Ads 360 কোন ফ্লাডলাইট অ্যাক্টিভিটির জন্য কোন আইডি বরাদ্দ করেছে, তাহলে আপনি
segmentationNameফিল্ডে নাম উল্লেখ না করেsegmentationIdএ আইডি নির্দিষ্ট করতে পারেন। (ক্যাম্পেইন ম্যানেজার ফ্লাডলাইট অ্যাক্টিভিটির জন্য একটি আইডিও বরাদ্দ করে, কিন্তু ক্যাম্পেইন ম্যানেজার আইডিটি Search Ads 360 আইডি থেকে আলাদা এবং এটি রূপান্তরগুলিকে অ্যাট্রিবিউট করার জন্য ব্যবহার করা যাবে না।) Floodlight অ্যাক্টিভিটির জন্য Search Ads 360 আইডি দেখতে, একটি রূপান্তর প্রতিবেদন ডাউনলোড করুন (হয় Search Ads 360 UI অথবা রিপোর্টিং API থেকে)। যদি রিপোর্টের সময়সীমার মধ্যে কমপক্ষে একটি রূপান্তর Floodlight অ্যাক্টিভিটির জন্য অ্যাট্রিবিউট করা হয়ে থাকে, তাহলে আপনি রিপোর্টে Search Ads 360 আইডি দেখতে পাবেন। -
type: রূপান্তরের ধরণ, অর্থাৎ,ACTIONঅথবাTRANSACTION। একটি ACTION রূপান্তরের কোনও আর্থিক মূল্য নেই, যখন একটি TRANSACTION রূপান্তরের থাকে। উদাহরণ হল ইমেল তালিকা সাইনআপ (ACTION) বনাম ই-কমার্স ক্রয় (TRANSACTION)।যদি আপনি
TRANSACTIONউল্লেখ করেন, তাহলে আপনাকে নিম্নলিখিত ক্ষেত্রটিও উল্লেখ করতে হবে:-
revenueMicros: রূপান্তরের আর্থিক মূল্য।
-
ঐচ্ছিক ক্ষেত্র
-
quantityMillis: এই রূপান্তরে আইটেমের সংখ্যা। উদাহরণস্বরূপ, একটি ইমেল নিউজলেটারের জন্য সাইন আপ করা লোকের সংখ্যা বা বিক্রি হওয়া আইটেমের মোট পরিমাণ। যদি আপনি ACTION রূপান্তরের জন্য এই ক্ষেত্রটি নির্দিষ্ট না করেন, তাহলে Search Ads 360 স্বয়ংক্রিয়ভাবে1000এর মান সন্নিবেশ করবে। -
currencyCode: একটি লেনদেনের আয়ের মুদ্রা। ডিফল্টরূপে, আয় বিজ্ঞাপনদাতার মুদ্রায় বলে ধরে নেওয়া হয়। আপনি যদি অন্য কোনও মুদ্রা নির্দিষ্ট করেন, তাহলে Search Ads 360 নির্দিষ্ট আয়ের পরিমাণকে বিজ্ঞাপনদাতার মুদ্রায় রূপান্তর করে। আরও জানুন
মুদ্রা নির্দিষ্ট করতে ISO 4217 বর্ণমালা (3-অক্ষর) ফর্ম্যাট ব্যবহার করুন।
শুধুমাত্র TRANSACTION রূপান্তরের জন্য প্রযোজ্য। -
customMetricএবংcustomDimension: একটি রূপান্তর সম্পর্কে অতিরিক্ত তথ্য আপলোড করে, যেমন কোন দেশে একটি ক্রয়কৃত আইটেম পাঠানো হচ্ছে, পণ্য আইডি, এমনকি একটি টেলিফোন কলের সময়কাল। কাস্টম ফ্লাডলাইট ভেরিয়েবলের জন্য ডেটা আপলোড করার বিষয়ে আরও জানুন। -
deviceType: কোন ধরণের ডিভাইসে রূপান্তরটি ঘটেছে তা নির্দিষ্ট করে। এই ক্ষেত্রের জন্য গৃহীত মানের তালিকা দেখুন।
JSON সম্পর্কে
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "criterionId": "43700003491981017", // Replace with your ID "conversionId": "customerTransaction73126", "conversionTimestamp": "1351196386000", "segmentationType": "FLOODLIGHT", "segmentationName": "Offline Purchase", "type": "TRANSACTION", "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue "currencyCode": "USD" }] }
জাভা
/** * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>. * The example in the preceding section contains the uploadConversions method, * which can submit the list as an insert() request. */ private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions, Long criterionId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion() .setCriterionId(criterionId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; }
পাইথন
def insert_conversion(service): """Create and upload a TRANSACTION conversion that is attributed to a keyword only. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().insert( body= { 'conversion': [{ 'criterionId': '43700004289911004', // Replace with your ID 'conversionId': 'test_1378710000000', 'conversionTimestamp': '1378710000000', 'segmentationType': 'FLOODLIGHT', 'segmentationName': 'Test', 'type': 'TRANSACTION', 'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue 'currencyCode': 'USD' }] } ) pprint.pprint(request.execute())
থার্ড-পার্টি অ্যাট্রিবিউশন মডেল থেকে ডেটা আপলোড করুন
একটি অ্যাট্রিবিউশন মডেল একটি রূপান্তর পথের সমস্ত কার্যকলাপে রূপান্তরের জন্য ক্রেডিট বিতরণ করে। উদাহরণস্বরূপ, যদি কোনও গ্রাহক রূপান্তর করার আগে একটি অর্থপ্রদত্ত অনুসন্ধান বিজ্ঞাপন, একটি প্রদর্শন বিজ্ঞাপন এবং অন্য একটি অর্থপ্রদত্ত অনুসন্ধান বিজ্ঞাপনে ক্লিক করেন, তাহলে একটি রৈখিক অ্যাট্রিবিউশন মডেল প্রতিটি ক্লিককে রূপান্তর ক্রেডিটের 33% দেবে।
যদিও Search Ads 360 অ্যাট্রিবিউশন মডেল প্রদান করে , আপনি যদি কোনও তৃতীয় পক্ষের পরিষেবা বা ক্লিকগুলিতে ক্রেডিট বিতরণের জন্য আপনার তৈরি কোনও পরিষেবা ব্যবহার করেন , তাহলে আপনি তৃতীয় পক্ষের অ্যাট্রিবিউশন ডেটা Search Ads 360-এ আপলোড করতে পারেন এবং রিপোর্ট এবং Search Ads 360 বিড কৌশলগুলিতে ডেটা ব্যবহার করতে পারেন।
শুরু করার আগে
ক্যাম্পেইন ম্যানেজারে, একটি কাস্টম অ্যাট্রিবিউশন মডেল তৈরি করুন এবং মডেলটি Search Ads 360-এ ইম্পোর্ট করুন। মডেলটির নাম External Attribution Model রেখেছেন কিনা তা নিশ্চিত করুন। এটি Search Ads 360 বৈশিষ্ট্যগুলিকে সনাক্ত করতে সক্ষম করে যে আপনার আপলোড করা রূপান্তর ডেটাতে একটি অ্যাট্রিবিউশন মডেল প্রয়োগ করা হয়েছে। আরও জানুন
প্রয়োজনীয় ক্ষেত্রগুলি
একটি রূপান্তরে একটি তৃতীয় পক্ষের অ্যাট্রিবিউশন মডেল প্রয়োগ করতে, আপনার Conversion.insert() অনুরোধে নিম্নলিখিত সমস্ত কিছু উল্লেখ করুন:
-
clickId: ভিজিটের কেস-সংবেদনশীল ক্লিক আইডি । ক্লিক আইডি বা তালিকাভুক্ত রূপান্তরগুলির জন্য বিজ্ঞাপনদাতার ওয়েব লগগুলি দেখুন এবং অন্য রূপান্তর থেকে একটি ক্লিক আইডি ব্যবহার করুন। Search Ads 360 রূপান্তরটি কীওয়ার্ড, বিজ্ঞাপন এবং অন্যান্য Search Ads 360 অবজেক্টের সাথে সম্পর্কিত করবে যারা ভিজিট তৈরির জন্য দায়ী ছিল।
Search Ads 360 একটি ক্লিক আইডি তৈরি করার পর কমপক্ষে 30 মিনিট অপেক্ষা করুন এবং তারপর আইডি দিয়ে একটি রূপান্তর আপলোড করুন। অন্যথায়, Search Ads 360 API ভিজিটটি চিনতে নাও পারে। -
attributionModel: এক্সটার্নাল অ্যাট্রিবিউশন মডেলে সেট করুন। আরও জানুন -
countMillis: এই ক্লিকে বিতরণ করা রূপান্তর ক্রেডিটের পরিমাণ। অনুরোধেattributionModelক্ষেত্রটি অন্তর্ভুক্ত থাকলেই প্রযোজ্য।এটিকে
quantityMillisসাথে গুলিয়ে ফেলবেন না, এটি একটি ঐচ্ছিক ক্ষেত্র যা একটি রূপান্তরে আইটেমের সংখ্যা নির্দিষ্ট করে (যেমন একটি শপিং কার্ট ক্রয়ে আইটেমের সংখ্যা)। -
conversionId: অফলাইন রূপান্তরের জন্য, বিজ্ঞাপনদাতারা এই আইডি প্রদান করে। বিজ্ঞাপনদাতারা তাদের কাছে অর্থপূর্ণ যেকোনো আইডি নির্দিষ্ট করতে পারেন। অনুরোধে প্রতিটি রূপান্তরের জন্য একটি অনন্য আইডি নির্দিষ্ট করতে হবে এবং বিজ্ঞাপনদাতার মধ্যে থাকা সমস্ত রূপান্তরের মধ্যে আইডি এবং টাইমস্ট্যাম্পের সমন্বয় অবশ্যই অনন্য হতে হবে। অনলাইন রূপান্তরের জন্য, Search Ads 360 বিজ্ঞাপনদাতার Floodlight নির্দেশাবলীর উপর নির্ভর করে এই সম্পত্তিতেdsConversionIdবাfloodlightOrderIdকপি করে। -
conversionTimestamp: রূপান্তরটি যে তারিখ এবং সময়ে ঘটেছে তা নির্দেশ করে। উদাহরণস্বরূপ, যদি রূপান্তরটি শুক্রবার, 05 আগস্ট 2016 11:53:22 AM Eastern Daylight Savings Time (GMT -4:00) এ ঘটে, তাহলে Epoch মিলিসেকেন্ডে টাইমস্ট্যাম্পটি উল্লেখ করুন:1470412402000। -
segmentationType: আপনি যে ধরণের রূপান্তর সিস্টেমে রূপান্তর আপলোড করছেন তা নির্দিষ্ট করে। বর্তমানে শুধুমাত্র Floodlight রূপান্তর সমর্থিত, তাইFLOODLIGHTনির্দিষ্ট করার জন্য এই ক্ষেত্রটি সর্বদা প্রয়োজন। -
segmentationName: বিজ্ঞাপনদাতা রূপান্তর রিপোর্ট করার জন্য যে ফ্লাডলাইট অ্যাক্টিভিটি ব্যবহার করছেন তার নাম।যদি আপনার বিজ্ঞাপনদাতার একই নামের কার্যকলাপ থাকে (যদি কার্যকলাপগুলি বিভিন্ন Floodlight গ্রুপের হয় তবে এটি ঘটতে পারে), তাহলে প্রস্তাবিত পদক্ষেপ হল কার্যকলাপগুলির একটির নাম পরিবর্তন করা ।
বিকল্পভাবে, যদি আপনি জানেন যে Search Ads 360 কোন ফ্লাডলাইট অ্যাক্টিভিটির জন্য কোন আইডি বরাদ্দ করেছে, তাহলে আপনি
segmentationNameফিল্ডে নাম উল্লেখ না করেsegmentationIdএ আইডি নির্দিষ্ট করতে পারেন। (ক্যাম্পেইন ম্যানেজার ফ্লাডলাইট অ্যাক্টিভিটির জন্য একটি আইডিও বরাদ্দ করে, কিন্তু ক্যাম্পেইন ম্যানেজার আইডিটি Search Ads 360 আইডি থেকে আলাদা এবং এটি রূপান্তরগুলিকে অ্যাট্রিবিউট করার জন্য ব্যবহার করা যাবে না।) Floodlight অ্যাক্টিভিটির জন্য Search Ads 360 আইডি দেখতে, একটি রূপান্তর প্রতিবেদন ডাউনলোড করুন (হয় Search Ads 360 UI অথবা রিপোর্টিং API থেকে)। যদি রিপোর্টের সময়সীমার মধ্যে কমপক্ষে একটি রূপান্তর Floodlight অ্যাক্টিভিটির জন্য অ্যাট্রিবিউট করা হয়ে থাকে, তাহলে আপনি রিপোর্টে Search Ads 360 আইডি দেখতে পাবেন। -
type: রূপান্তরের ধরণ, অর্থাৎ,ACTIONঅথবাTRANSACTION। একটি ACTION রূপান্তরের কোনও আর্থিক মূল্য নেই, যখন একটি TRANSACTION রূপান্তরের থাকে। উদাহরণ হল ইমেল তালিকা সাইনআপ (ACTION) বনাম ই-কমার্স ক্রয় (TRANSACTION)।যদি আপনি
TRANSACTIONউল্লেখ করেন, তাহলে আপনাকে নিম্নলিখিত ক্ষেত্রটিও উল্লেখ করতে হবে:-
revenueMicros: রূপান্তরের আর্থিক মূল্য।
-
যদি আপনি রূপান্তরের রাজস্ব ট্র্যাক করেন, তাহলে নিশ্চিত করুন যে আপনার মডেলটি প্রতিটি স্পর্শ বিন্দুতে একটি রূপান্তর পথে রাজস্ব বিতরণ করে। উদাহরণস্বরূপ, যদি আপনার মডেল একটি রৈখিক পদ্ধতি ব্যবহার করে (প্রতিটি স্পর্শ বিন্দুতে সমানভাবে রাজস্ব বিতরণ করে), তাহলে এমন একটি রূপান্তর পথে যেখানে 3টি বিজ্ঞাপন ক্লিক থাকে, প্রতিটি ক্লিক রূপান্তরের 33% এর সাথে যুক্ত হবে। যদি রূপান্তরটি $100 আয় করে, তাহলে নিশ্চিত করুন যে আপনার মডেল প্রতিটি ক্লিকের জন্য $33 আয় বিতরণ করে এবং নিশ্চিত করুন যে revenueMicros প্রতিটি ক্লিকের জন্য শুধুমাত্র $33 আয় নির্দিষ্ট করে।
ঐচ্ছিক ক্ষেত্র
-
quantityMillis: এই রূপান্তরে আইটেমের সংখ্যা। উদাহরণস্বরূপ, একটি ইমেল নিউজলেটারের জন্য সাইন আপ করা লোকের সংখ্যা বা বিক্রি হওয়া আইটেমের মোট পরিমাণ। যদি আপনি ACTION রূপান্তরের জন্য এই ক্ষেত্রটি নির্দিষ্ট না করেন, তাহলে Search Ads 360 স্বয়ংক্রিয়ভাবে1000এর মান সন্নিবেশ করবে। -
currencyCode: একটি লেনদেনের আয়ের মুদ্রা। ডিফল্টরূপে, আয় বিজ্ঞাপনদাতার মুদ্রায় বলে ধরে নেওয়া হয়। আপনি যদি অন্য কোনও মুদ্রা নির্দিষ্ট করেন, তাহলে Search Ads 360 নির্দিষ্ট আয়ের পরিমাণকে বিজ্ঞাপনদাতার মুদ্রায় রূপান্তর করে। আরও জানুন
মুদ্রা নির্দিষ্ট করতে ISO 4217 বর্ণমালা (3-অক্ষর) ফর্ম্যাট ব্যবহার করুন।
শুধুমাত্র TRANSACTION রূপান্তরের জন্য প্রযোজ্য। -
customMetricএবংcustomDimension: একটি রূপান্তর সম্পর্কে অতিরিক্ত তথ্য আপলোড করে, যেমন কোন দেশে একটি ক্রয়কৃত আইটেম পাঠানো হচ্ছে, পণ্য আইডি, এমনকি একটি টেলিফোন কলের সময়কাল। কাস্টম ফ্লাডলাইট ভেরিয়েবলের জন্য ডেটা আপলোড করার বিষয়ে আরও জানুন। -
deviceType: কোন ধরণের ডিভাইসে রূপান্তরটি ঘটেছে তা নির্দিষ্ট করে। এই ক্ষেত্রের জন্য গৃহীত মানের তালিকা দেখুন।
উদাহরণ
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site "conversionId" : "test_20130906_04", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "attributionModel": "External Attribution Model", "countMillis": "330", "revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue "currencyCode": "USD" }] }
সার্চ বিজ্ঞাপন ৩৬০ প্রতিক্রিয়া পরিচালনা করুন
অনুসন্ধান বিজ্ঞাপন 360 এর প্রতিক্রিয়া শুধুমাত্র তখনই সফলতার ইঙ্গিত দেয় যদি অনুরোধের সমস্ত রূপান্তর সফলভাবে যাচাই করা হয় এবং আপলোড করা হয়।
যদি অনুরোধটি সফল হয়
যদি অনুরোধটি সফল হয়, তাহলে প্রতিক্রিয়ায় প্রতিটি আপলোড করা রূপান্তরের জন্য সম্পূর্ণ অনুসন্ধান বিজ্ঞাপন 360 অভ্যন্তরীণ উপস্থাপনা অন্তর্ভুক্ত থাকবে, যেমন প্রচারাভিযান আইডি, বিজ্ঞাপন গ্রুপ আইডি এবং কীওয়ার্ড (মানদণ্ড) আইডি।
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"agencyId": "12300000000000456",
"advertiserId": "45600000000010291",
"engineAccountId": "700000000042441",
"campaignId": "71700000002044839",
"adGroupId": "58700000032026064",
"criterionId": "43700004289911004",
"adId": "0",
"dsConversionId": "48719131694768384",
"conversionId": "test_1383157331951",
"state": "ACTIVE",
"type": "TRANSACTION",
"revenueMicros": "20000000",
"currencyCode": "USD",
"segmentationType": "FLOODLIGHT",
"segmentationId": "25700000001464141",
"segmentationName": "Test",
"conversionTimestamp": "1378710000000",
"conversionModifiedTimestamp": "1383157332368"
},
...
]
}
যদি অনুরোধটি সফল না হয়
যদি এক বা একাধিক রূপান্তর যাচাই বা আপলোড করতে ব্যর্থ হয়, তাহলে প্রতিক্রিয়ায় প্রতিটি ব্যর্থ রূপান্তর আপলোডের জন্য বার্তা অন্তর্ভুক্ত থাকে। প্রতিক্রিয়াতে সফলভাবে আপলোড করা রূপান্তর সম্পর্কে কোনও বার্তা থাকে না।
সম্পূর্ণরূপে সফল না হওয়া একটি অনুরোধের উত্তরের উদাহরণ এখানে দেওয়া হল:
{
"error": {
"errors": [
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..."
},
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x00000101: Click ID ..."
}
]
}
}
প্রতিটি ব্যর্থতার বার্তায় দুটি গুরুত্বপূর্ণ ক্ষেত্র থাকে: একটি কারণ এবং একটি বিস্তারিত ত্রুটির বার্তা। কারণ ক্ষেত্রটিতে requestValidation , internalError , transactionFailed , অথবা lateStageRequestError থাকতে পারে।
অনুরোধ যাচাইকরণ ত্রুটি
requestValidation ত্রুটিগুলি রূপান্তর আপলোড অনুরোধে ডেটা সমস্যা নির্দেশ করে (যেমন, রূপান্তরটি ইতিমধ্যেই আপলোড করা হয়েছে, অথবা ক্লিকআইডি পাওয়া যায়নি)। এই ধরণের ত্রুটিতে, বার্তার বিবরণে দুটি আইটেম থাকে:
- একটি হেক্সাডেসিমেল কোড যা ত্রুটির ধরণ সনাক্ত করে। আপনি ত্রুটিগুলি সনাক্ত করতে আপনার নিজস্ব স্ক্রিপ্টে কোডটি ব্যবহার করতে পারেন।
- যাচাইকরণ ত্রুটির একটি বর্ণনা।
আরও তথ্যের জন্য, রূপান্তর আপলোড ত্রুটির জন্য Search Ads 360 যেসব কোড এবং বর্ণনা ফেরত দিতে পারে তার তালিকা দেখুন।
অন্যান্য ধরণের ত্রুটি
অন্য সকল ধরণের ত্রুটি ( internalError , transactionFailed , অথবা lateStageRequestError ) নির্দেশ করে যে Search Ads 360-এ একটি অভ্যন্তরীণ সমস্যা রয়েছে।
একটি ত্রুটির জবাব দেওয়া
যদি অনুরোধটি ব্যর্থ হয়, তাহলে পরে সম্পূর্ণ অনুরোধ কলটি পুনরায় জমা দেওয়ার চেষ্টা করুন। Search Ads 360 ইতিমধ্যেই আপলোড করা যেকোনো রূপান্তরের জন্য requestValidation ত্রুটি রিপোর্ট করবে, তবে এটি অবশিষ্ট রূপান্তরগুলি আপলোড করার চেষ্টা করবে।
পুনরায় জমা দেওয়ার পরেও যদি আপনি ত্রুটি দেখতে পান, তাহলে কীভাবে এগিয়ে যাবেন সে সম্পর্কে তথ্যের জন্য সমস্যা সমাধান বিভাগটি দেখুন।