এক বা একাধিক কনভার্সন যোগ করতে Conversion.insert()
মেথড কল করুন। কনভার্সন সঠিকভাবে অ্যাট্রিবিউট করতে, আপনার অনুরোধে
ফ্লাডলাইট অ্যাক্টিভিটির নাম উল্লেখ করতে হবে যা বিজ্ঞাপনদাতা অফলাইন কনভার্সন রিপোর্ট করতে ব্যবহার করছেন, এর সাথে ভিজিটের ক্লিক আইডি বা কনভার্সনের কারণ হওয়া কীওয়ার্ডের আইডি উল্লেখ করতে হবে। Search Ads 360 আইডি পাওয়ার ব্যাপারে
তথ্য পেতে, Search Ads 360 আইডি এবং
কনভার্সন দেখুন।
পুরনো কনভার্সন আপলোড করার ক্ষেত্রে বিধিনিষেধ সংক্রান্ত তথ্য Search Ads 360 সহায়তা কেন্দ্র থেকে পাওয়া যাবে।
আপনার Conversion.insert() অনুরোধে একাধিক কনভার্সন উল্লেখ করা থাকলে,
Search Ads 360, সম্পূর্ণ ব্যাচকে 'সব বা কিছুই নয়' ট্রানজ্যাকশন হিসেবে আপলোড করার পরিবর্তে
প্রতিটি কনভার্সন যথাসাধ্য আপলোড করার চেষ্টা করে। কোনও ব্যাচের কিছু কনভার্সন আপলোড করা না গেলেও, অন্যগুলি আপলোড করা যেতে পারে। ভুল অনুরোধ বা নেটওয়ার্ক বা সিস্টেমের সাময়িক সমস্যার কারণে
কনভার্সন আপলোড করা নাও যেতে পারে। তাই, আপলোড সফল হয়েছে কিনা তা নিশ্চিত করতে,
আমরা আপনাকে প্রতিটি যোগ করা কনভার্সনের জন্য উত্তরটি পড়তে
সাজেস্ট করি।
আপলোড করা ডেটা আমি কত তাড়াতাড়ি ব্যবহার করতে পারব?
আপনি যদি কোনও কনভার্সনের জন্য আজকের বা গতকালের
conversionTimestamp উল্লেখ করেন, তাহলে আপলোড করার এক ঘণ্টার মধ্যে
কনভার্সনের মেট্রিক Search Ads 360 UI-তে দেখা যাবে। আপনি যদি
এমন conversionTimestamp উল্লেখ করেন যা গতকালের চেয়ে পুরনো, তাহলে মেট্রিক আপডেট হতে
কয়েক ঘণ্টা সময় লাগবে।
কনভার্সনের জন্য সব টাইমস্ট্যাম্প Epoch টাইম (Unix টাইম নামেও পরিচিত)-এ কনভার্ট করুন।
আমি কি API থেকে Floodlight অ্যাক্টিভিটি তৈরি করতে পারব?
বিজ্ঞাপনদাতা অফলাইন কনভার্সন ট্র্যাক করার জন্য এখনও কোনও Floodlight অ্যাক্টিভিটি তৈরি না করে থাকলে, আপনি Campaign Manager API ব্যবহার করে একটি তৈরি করতে পারেন। আপনি API ব্যবহার করে নির্দিষ্ট করতে পারবেন না যে Floodlight অ্যাক্টিভিটি মূলত অফলাইন কনভার্সনের জন্য ব্যবহার করা হয়, যা একটি পেশাদার পদ্ধতি যখন বিড স্ট্র্যাটেজি কনভার্সন থেকে ডেটা ব্যবহার করবে।
আমরা সাজেস্ট করি যে আপনি Floodlight অ্যাক্টিভিটি তৈরি করার জন্য API ব্যবহার করার পরে, Search Ads 360 ব্যবহারকারী Search Ads 360-তে সাইন-ইন করে অ্যাক্টিভিটির সেটিং পরিবর্তন করে কনভার্সনের প্রাথমিক সোর্স যে অফলাইন অ্যাক্টিভিটি তা উল্লেখ করুন।
কনভার্সন যোগ করার পেশাদার পদ্ধতি
কনভার্সন যোগ করার জন্য আমরা নিম্নলিখিত পেশাদার পদ্ধতি সাজেস্ট করি:
Search Ads 360 ব্যবহারকারীকে Search Ads 360-এ সাইন-ইন করতে বলুন এবং অফলাইন কনভার্সন রিপোর্ট করার জন্য আপনি ব্যবহার করেন এমন প্রতিটি Floodlight অ্যাক্টিভিটির জন্য সেটিংস পরিবর্তন করুন। সেটিংসে উল্লেখ থাকতে হবে যে কনভার্সনের প্রাথমিক সোর্স হল অফলাইন অ্যাক্টিভিটি। নির্দেশাবলীর জন্য Search Ads 360 সহায়তা কেন্দ্র দেখুন।
কনভার্সন উপলভ্য হওয়ার সাথে সাথেই তা আপলোড করুন। আপনি যদি নির্দিষ্ট ভিজিটের জন্য কনভার্সন অ্যাট্রিবিউট করেন, তাহলে কনভার্সন আপলোড করার আগে ভিজিটের পরে অন্তত ৬ ঘণ্টা অপেক্ষা করুন। ভিজিট করার ৬ ঘণ্টার মধ্যে আপলোড করলে, Search Ads 360 ভিজিটের clickID শনাক্ত করতে নাও পারে। খুব কম ক্ষেত্রে, Search Ads 360-এর clickId শনাক্ত করতে আপনাকে ২৪ ঘণ্টা পর্যন্ত অপেক্ষা করতে হতে পারে।
প্রতিটি আপলোডে যেন সবচেয়ে সাম্প্রতিক কনভার্সন থাকে তা নিশ্চিত করুন। একটি আপলোড অনুরোধের মধ্যে, এন্ট্রিগুলি কালানুক্রমিক ক্রমে না থাকলে কোনও সমস্যা নেই। তবে, বিড স্ট্র্যাটেজি হয়ত পুরনো কনভার্সন বিবেচনা করতে পারবে না যা আপনি পরে অন্য অনুরোধে আপলোড করবেন।
যোগ করার অনুরোধ পাঠান
আপনি নিম্নলিখিত যেকোনও একটি কাজ করার জন্য Conversion.insert() অনুরোধ পাঠাতে পারেন:
- নির্দিষ্ট ভিজিটের জন্য কনভার্সন অ্যাট্রিবিউট করা
- শুধুমাত্র একটি কীওয়ার্ডে কনভার্সন অ্যাট্রিবিউট করুন
Conversion.insert() অনুরোধে যেসব ফিল্ড প্রয়োজন তা নির্ভর করে আপনি কোন ইভেন্ট বা আইটেমের জন্য কনভার্সন অ্যাট্রিবিউট করছেন তার উপর। নিম্নলিখিত বিভাগে প্রতিটি ইভেন্ট বা আইটেমের জন্য প্রয়োজনীয়
এবং ঐচ্ছিক ফিল্ডের তালিকা দেওয়া আছে, যার জন্য আপনি কনভার্সন অ্যাট্রিবিউট করতে পারবেন।
নির্দিষ্ট ভিজিটের জন্য কনভার্সন অ্যাট্রিবিউট করা
কোনও গ্রাহক এক বা একাধিক বিজ্ঞাপনে ক্লিক করে বিজ্ঞাপনদাতার সাইটে এলে,
Search Ads 360 বিজ্ঞাপনদাতার সাইটে ব্যবহারকারীর সেশনকে ভিজিট হিসেবে বিবেচনা করে।
কোনও ভিজিটের জন্য কনভার্সন অ্যাট্রিবিউট করতে, আপনার Conversion.insert()
অনুরোধে নিম্নলিখিত তথ্য উল্লেখ করুন:
ফাঁকা রাখা যাবে না
clickId: ভিজিটের ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয় এমন ক্লিক আইডি। ক্লিক আইডির জন্য বিজ্ঞাপনদাতার ওয়েব লগ দেখুন অথবা নতুন Search Ads 360 Reporting API-এর মাধ্যমে অন্য কনভার্সনেরconversion.click_idপুনরুদ্ধার করুন। Search Ads 360, ভিজিট জেনারেট করার জন্য দায়ী কীওয়ার্ড, বিজ্ঞাপন এবং অন্যান্য Search Ads 360 অবজেক্টে কনভার্সন অ্যাট্রিবিউট করবে।
Search Ads 360 কনভার্সন আপলোড করার জন্য ক্লিক আইডি জেনারেট করার পরে কমপক্ষে ৬ ঘণ্টা অপেক্ষা করুন। আপনি যদি "ক্লিক আইডি খুঁজে পাওয়া যায়নি" সংক্রান্ত কোনও সমস্যার মেসেজ পান, তাহলে ২৪ ঘণ্টা অপেক্ষা করুন এবং তারপরে আবার কনভার্সন আপলোড করুন। ক্লিক আইডি তৈরি হওয়ার ৯০ দিনের মধ্যে সব কনভার্সন আপলোড করতে হবে। অন্যথায়, Search Ads 360 API ভিজিট শনাক্ত করতে পারবে না।conversionId: অফলাইন কনভার্সনের জন্য বিজ্ঞাপনদাতারা এই আইডি প্রদান করেন। বিজ্ঞাপনদাতারা তাদের কাছে অর্থপূর্ণ এমন যেকোনও আইডি উল্লেখ করতে পারেন। অনুরোধে প্রতিটি কনভার্সনের জন্য একটি অনন্য আইডি উল্লেখ করতে হবে, এবং আইডি ও টাইমস্ট্যাম্পের কম্বিনেশন বিজ্ঞাপনদাতার মধ্যে সমস্ত কনভার্সনের মধ্যে অনন্য হতে হবে। অনলাইন কনভার্সনের জন্য, Search Ads 360 বিজ্ঞাপনদাতার Floodlight নির্দেশাবলীর উপর নির্ভর করে এই প্রপার্টিতেdsConversionIdবাfloodlightOrderIdকপি করে।conversionTimestamp: কনভার্সন হওয়ার তারিখ ও সময় দেখায়। যেমন, কনভার্সন যদি Fri, 05 Aug 2016 11:53:22 AM Eastern Daylight Savings Time (GMT -4:00)-এ হয়, তাহলে Epoch মিলিসেকেন্ডে টাইমস্ট্যাম্প উল্লেখ করুন:1470412402000।segmentationType: আপনি যে কনভার্সন সিস্টেমে কনভার্সন আপলোড করছেন, তার ধরন উল্লেখ করে। বর্তমানে শুধুমাত্র Floodlight কনভার্সন কাজ করে, তাই এই ফিল্ডে সবসময়FLOODLIGHTউল্লেখ করতে হবে।segmentationName: Floodlight অ্যাক্টিভিটির নাম যা বিজ্ঞাপনদাতা কনভার্সন রিপোর্ট করার জন্য ব্যবহার করছেন।আপনার বিজ্ঞাপনদাতার অ্যাক্টিভিটির নাম একই হলে (অ্যাক্টিভিটিগুলি আলাদা ফ্লাডলাইট গ্রুপের হলে এমন হতে পারে), সাজেস্ট করা অ্যাকশন হল একটি অ্যাক্টিভিটির নাম পরিবর্তন করা।
অন্যথায়, আপনি
segmentationNameফিল্ডে নাম উল্লেখ করার পরিবর্তেsegmentationIdফিল্ডে ফ্লাডলাইট অ্যাক্টিভিটির আইডি উল্লেখ করতে পারেন। Campaign Manager-এর মাধ্যমে Floodlight অ্যাক্টিভিটিতে অ্যাসাইন করা আইডি ব্যবহার করুন। আপনি নতুন Search Ads 360 Reporting API-এরconversion_action.floodlight_settings.activity_idফিল্ড থেকে এই আইডি ফিরিয়ে আনতে পারবেন। কনভার্সন অনুরোধের উত্তরে Search Ads 360 যেsegmentationIdপাঠায় সেটিও গ্রহণ করা হয়।type: কনভার্সনের ধরন, অর্থাৎ, হয়ACTIONঅথবাTRANSACTION। ACTION কনভার্সনের কোনও আর্থিক মূল্য নেই, তবে TRANSACTION কনভার্সনের আছে। উদাহরণ হল ইমেল তালিকার সাইন-আপ (অ্যাকশন) বনাম ই-কমার্স কেনাকাটা (ট্রানজ্যাকশন)।আপনি
TRANSACTIONউল্লেখ করলে, আপনাকে নিম্নলিখিত ফিল্ডও উল্লেখ করতে হবে:revenueMicros: কনভার্সনের আর্থিক মূল্য।
ঐচ্ছিক ফিল্ড
quantityMillis: এই কনভার্সনে আইটেমের সংখ্যা। যেমন, ইমেল নিউজলেটারের জন্য সাইন-আপ করা ব্যক্তির সংখ্যা বা বিক্রি হওয়া আইটেমের মোট পরিমাণ। আপনি ACTION কনভার্সনের জন্য এই ফিল্ড নির্দিষ্ট না করলে, Search Ads 360 অটোমেটিক1000ভ্যালু যোগ করে।currencyCode: ট্রানজ্যাকশন থেকে হওয়া মোট উপার্জনের মুদ্রা। ডিফল্ট হিসেবে, মোট উপার্জন বিজ্ঞাপনদাতার কারেন্সিতে দেখানো হয়। আপনি অন্য কোনও কারেন্সি উল্লেখ করলে, Search Ads 360 উল্লেখ করা মোট উপার্জনের পরিমাণ বিজ্ঞাপনদাতার কারেন্সিতে কনভার্ট করে। আরও জানুন
মুদ্রা নির্দিষ্ট করতে ISO 4217 বর্ণানুক্রমিক (৩-অক্ষর) ফর্ম্যাট ব্যবহার করুন।
শুধুমাত্র ট্রানজ্যাকশন কনভার্সনের ক্ষেত্রে প্রযোজ্য।customMetricএবংcustomDimension: কনভার্সন সম্পর্কে অতিরিক্ত ডেটা আপলোড করে, যেমন কেনা আইটেমটি কোন দেশে পাঠানো হয়েছে, প্রোডাক্ট আইডি বা এমনকি টেলিফোন কলের সময়কাল। কাস্টম Floodlight ভেরিয়েবলের জন্য ডেটা আপলোড করা সম্পর্কে আরও জানুন।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" }] }
Java
/** * 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()); } }
Python
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-তে, কীওয়ার্ড আইডি শুধুমাত্র একটি বিজ্ঞাপন গ্রুপের মধ্যে অনন্য, তাই আপনাকে নতুন Search Ads 360 আইডির সম্পূর্ণ সেট নির্দিষ্ট করতে হবে যা কীওয়ার্ড শনাক্ত করে, সাথে আরও কিছু ফিল্ড:
ফাঁকা রাখা যাবে না
customerId: ক্লায়েন্ট অ্যাকাউন্টের কাস্টমার আইডি যাতে কীওয়ার্ড আছে, যেমন123-456-7890।campaignId: কীওয়ার্ড আছে এমন ক্যাম্পেনের আইডি।adGroupId: কীওয়ার্ড আছে এমন বিজ্ঞাপন গ্রুপের আইডি।criterionId: কীওয়ার্ডের আইডি।কোনও কনভার্সন
customerId,campaignIdবাadGroupIdছাড়াcriterionIdউল্লেখ করলে, এটি0x0000012Eত্রুটি কোড সহ ব্যর্থ হয়। এইসব আইডি পাওয়ার ব্যাপারে আরও জানতে, Search Ads 360 আইডি ও কনভার্সন দেখুন।conversionId: অফলাইন কনভার্সনের জন্য বিজ্ঞাপনদাতারা এই আইডি প্রদান করেন। বিজ্ঞাপনদাতারা তাদের কাছে অর্থপূর্ণ যেকোনও আইডি উল্লেখ করতে পারেন। অনুরোধে প্রতিটি কনভার্সনের জন্য একটি অনন্য আইডি উল্লেখ করতে হবে, এবং আইডি ও টাইমস্ট্যাম্পের কম্বিনেশন বিজ্ঞাপনদাতার মধ্যে সমস্ত কনভার্সনের মধ্যে অনন্য হতে হবে। অনলাইন কনভার্সনের জন্য, Search Ads 360 বিজ্ঞাপনদাতার Floodlight নির্দেশাবলীর উপর নির্ভর করে এই প্রপার্টিতেdsConversionIdবাfloodlightOrderIdকপি করে।conversionTimestamp: কনভার্সন হওয়ার তারিখ ও সময় দেখায়। যেমন, কনভার্সন যদি Fri, 05 Aug 2016 11:53:22 AM Eastern Daylight Savings Time (GMT -4:00)-এ হয়, তাহলে Epoch মিলিসেকেন্ডে টাইমস্ট্যাম্প উল্লেখ করুন:1470412402000।segmentationType: আপনি যে কনভার্সন সিস্টেমে কনভার্সন আপলোড করছেন, তার ধরন উল্লেখ করে। বর্তমানে শুধুমাত্র Floodlight কনভার্সন কাজ করে, তাই এই ফিল্ডে সবসময়FLOODLIGHTউল্লেখ করতে হবে।segmentationName: Floodlight অ্যাক্টিভিটির নাম যা বিজ্ঞাপনদাতা কনভার্সন রিপোর্ট করার জন্য ব্যবহার করছেন।আপনার বিজ্ঞাপনদাতার অ্যাক্টিভিটির নাম একই হলে (অ্যাক্টিভিটিগুলি আলাদা ফ্লাডলাইট গ্রুপের হলে এমন হতে পারে), সাজেস্ট করা অ্যাকশন হল একটি অ্যাক্টিভিটির নাম পরিবর্তন করা।
অন্যথায়, আপনি
segmentationNameফিল্ডে নাম উল্লেখ করার পরিবর্তেsegmentationIdফিল্ডে ফ্লাডলাইট অ্যাক্টিভিটির আইডি উল্লেখ করতে পারেন। Campaign Manager-এর মাধ্যমে Floodlight অ্যাক্টিভিটিতে অ্যাসাইন করা আইডি ব্যবহার করুন। আপনি নতুন Search Ads 360 Reporting API-এরconversion_action.floodlight_settings.activity_idফিল্ড থেকে এই আইডি ফিরিয়ে আনতে পারবেন। কনভার্সন অনুরোধের উত্তরে Search Ads 360 যেsegmentationIdপাঠায় সেটিও গ্রহণ করা হয়।type: কনভার্সনের ধরন, অর্থাৎ, হয়ACTIONঅথবাTRANSACTION। ACTION কনভার্সনের কোনও আর্থিক মূল্য নেই, তবে TRANSACTION কনভার্সনের আছে। উদাহরণ হল ইমেল তালিকার সাইন-আপ (অ্যাকশন) বনাম ই-কমার্স কেনাকাটা (ট্রানজ্যাকশন)।আপনি
TRANSACTIONউল্লেখ করলে, আপনাকে নিম্নলিখিত ফিল্ডও উল্লেখ করতে হবে:revenueMicros: কনভার্সনের আর্থিক মূল্য।
ঐচ্ছিক ফিল্ড
quantityMillis: এই কনভার্সনে আইটেমের সংখ্যা। যেমন, ইমেল নিউজলেটারের জন্য সাইন-আপ করা ব্যক্তির সংখ্যা বা বিক্রি হওয়া আইটেমের মোট পরিমাণ। আপনি ACTION কনভার্সনের জন্য এই ফিল্ড নির্দিষ্ট না করলে, Search Ads 360 অটোমেটিক1000ভ্যালু যোগ করে।currencyCode: ট্রানজ্যাকশন থেকে হওয়া মোট উপার্জনের মুদ্রা। ডিফল্ট হিসেবে, মোট উপার্জন বিজ্ঞাপনদাতার কারেন্সিতে দেখানো হয়। আপনি অন্য কোনও কারেন্সি উল্লেখ করলে, Search Ads 360 উল্লেখ করা মোট উপার্জনের পরিমাণ বিজ্ঞাপনদাতার কারেন্সিতে কনভার্ট করে। আরও জানুন
মুদ্রা নির্দিষ্ট করতে ISO 4217 বর্ণানুক্রমিক (৩-অক্ষর) ফর্ম্যাট ব্যবহার করুন।
শুধুমাত্র ট্রানজ্যাকশন কনভার্সনের ক্ষেত্রে প্রযোজ্য।customMetricএবংcustomDimension: কনভার্সন সম্পর্কে অতিরিক্ত ডেটা আপলোড করে, যেমন কেনা আইটেমটি কোন দেশে পাঠানো হয়েছে, প্রোডাক্ট আইডি বা এমনকি টেলিফোন কলের সময়কাল। কাস্টম Floodlight ভেরিয়েবলের জন্য ডেটা আপলোড করা সম্পর্কে আরও জানুন।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" : [{ "customerId": "123-456-7890", // Replace with your ID "campaignId": "14660344555", // Replace with your ID "adGroupId": "105138634255", // Replace with your ID "criterionId": "948710340465", // 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" }] }
Java
/** * 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, String customerId, Long campaignId, Long adGroupId, Long criterionId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion() .setCustomerId(customerId) .setCampaignId(campaignId) .setAdGroupId(adGroupId) .setCriterionId(criterionId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; }
Python
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': [{ 'customerId': '123-456-7890', // Replace with your ID 'campaignId': '14660344555', // Replace with your ID 'adGroupId': '105138634255', // Replace with your ID 'criterionId': '948710340465', // 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())
থার্ড-পার্টি অ্যাট্রিবিউশন মডেল থেকে ডেটা আপলোড করা
অ্যাট্রিবিউশন মডেল কনভার্সন পাথের সব অ্যাক্টিভিটি জুড়ে কনভার্সনের জন্য ক্রেডিট বণ্টন করে। যেমন, কোনও গ্রাহক কনভার্ট করার আগে একটি পেড সার্চ বিজ্ঞাপন, একটি ডিসপ্লে বিজ্ঞাপন এবং আরেকটি পেড সার্চ বিজ্ঞাপনে ক্লিক করলে, লিনিয়ার অ্যাট্রিবিউশন মডেল প্রতিটি ক্লিককে কনভার্সন ক্রেডিটের ৩৩% দেবে।
Search Ads 360 অ্যাট্রিবিউশন মডেল প্রদান করে, তবে আপনি যদি থার্ড-পার্টি পরিষেবা বা ক্লিকের ক্রেডিট ডিস্ট্রিবিউট করার জন্য আপনার ডেভেলপ করা কোনও পরিষেবা ব্যবহার করেন, তাহলে আপনি থার্ড-পার্টি অ্যাট্রিবিউশন ডেটা Search Ads 360-তে আপলোড করতে এবং রিপোর্ট ও Search Ads 360 বিড স্ট্র্যাটেজিতে ডেটা ব্যবহার করতে পারবেন।
শুরু করার আগে
Campaign Manager-এ, একটি কাস্টম অ্যাট্রিবিউশন মডেল তৈরি করুন এবং মডেলটি Search Ads 360-তে ইমপোর্ট করুন। মডেলের নাম এক্সটার্নাল অ্যাট্রিবিউশন মডেল হিসেবে সেট করতে ভুলবেন না। এটি Search Ads 360 ফিচারকে আপনার আপলোড করা কনভার্সন ডেটায় অ্যাট্রিবিউশন মডেল প্রয়োগ করা হয়েছে কিনা তা শনাক্ত করতে সাহায্য করে। আরও জানুন
ফাঁকা রাখা যাবে না
কোনও কনভার্সনে থার্ড-পার্টি অ্যাট্রিবিউশন মডেল প্রয়োগ করতে, আপনার Conversion.insert() অনুরোধে
নিম্নলিখিত সবকটি উল্লেখ করুন:
clickId: ভিজিটের ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয় এমন ক্লিক আইডি। ক্লিক আইডির জন্য বিজ্ঞাপনদাতার ওয়েব লগ দেখুন অথবা নতুন Search Ads 360 Reporting API-এর মাধ্যমে অন্য কনভার্সনেরconversion.click_idপুনরুদ্ধার করুন। Search Ads 360, ভিজিট জেনারেট করার জন্য দায়ী কীওয়ার্ড, বিজ্ঞাপন এবং অন্যান্য Search Ads 360 অবজেক্টে কনভার্সন অ্যাট্রিবিউট করবে।
কমপক্ষে ৩০ মিনিট অপেক্ষা করুন, Search Ads 360 ক্লিক আইডি তৈরি করার পরে এবং আইডির মাধ্যমে কনভার্সন আপলোড করার আগে। অন্যথায়, Search Ads 360 API ভিজিট শনাক্ত করতে পারবে না।attributionModel: এক্সটার্নাল অ্যাট্রিবিউশন মডেল-এ সেট করা হয়েছে। আরও জানুনcountMillis: এই ক্লিকে ডিস্ট্রিবিউট করার জন্য কনভার্সন ক্রেডিটের পরিমাণ। অনুরোধেattributionModelফিল্ড অন্তর্ভুক্ত থাকলে তবেই প্রযোজ্য।এটিকে
quantityMillis-এর সাথে গুলিয়ে ফেলবেন না, এটি একটি ঐচ্ছিক ফিল্ড যা কনভার্সনে আইটেমের সংখ্যা নির্দিষ্ট করে (যেমন, শপিং কার্ট থেকে কেনাকাটায় আইটেমের সংখ্যা)।conversionId: অফলাইন কনভার্সনের জন্য বিজ্ঞাপনদাতারা এই আইডি প্রদান করেন। বিজ্ঞাপনদাতারা তাদের কাছে অর্থপূর্ণ এমন যেকোনও আইডি উল্লেখ করতে পারেন। অনুরোধে প্রতিটি কনভার্সনের জন্য একটি অনন্য আইডি উল্লেখ করতে হবে, এবং আইডি ও টাইমস্ট্যাম্পের কম্বিনেশন বিজ্ঞাপনদাতার মধ্যে সমস্ত কনভার্সনের মধ্যে অনন্য হতে হবে। অনলাইন কনভার্সনের জন্য, Search Ads 360 বিজ্ঞাপনদাতার Floodlight নির্দেশাবলীর উপর নির্ভর করে এই প্রপার্টিতেdsConversionIdবাfloodlightOrderIdকপি করে।conversionTimestamp: কনভার্সন হওয়ার তারিখ ও সময় দেখায়। যেমন, কনভার্সন যদি Fri, 05 Aug 2016 11:53:22 AM Eastern Daylight Savings Time (GMT -4:00)-এ হয়, তাহলে Epoch মিলিসেকেন্ডে টাইমস্ট্যাম্প উল্লেখ করুন:1470412402000।segmentationType: আপনি যে কনভার্সন সিস্টেমে কনভার্সন আপলোড করছেন, তার ধরন উল্লেখ করে। বর্তমানে শুধুমাত্র Floodlight কনভার্সন কাজ করে, তাই এই ফিল্ডে সবসময়FLOODLIGHTউল্লেখ করতে হবে।segmentationName: Floodlight অ্যাক্টিভিটির নাম যা বিজ্ঞাপনদাতা কনভার্সন রিপোর্ট করার জন্য ব্যবহার করছেন।আপনার বিজ্ঞাপনদাতার অ্যাক্টিভিটির নাম একই হলে (অ্যাক্টিভিটিগুলি আলাদা ফ্লাডলাইট গ্রুপের হলে এমন হতে পারে), সাজেস্ট করা অ্যাকশন হল একটি অ্যাক্টিভিটির নাম পরিবর্তন করা।
অন্যথায়, আপনি
segmentationNameফিল্ডে নাম উল্লেখ করার পরিবর্তেsegmentationIdফিল্ডে ফ্লাডলাইট অ্যাক্টিভিটির আইডি উল্লেখ করতে পারেন। Campaign Manager-এর মাধ্যমে Floodlight অ্যাক্টিভিটিতে অ্যাসাইন করা আইডি ব্যবহার করুন। আপনি নতুন Search Ads 360 Reporting API-এরconversion_action.floodlight_settings.activity_idফিল্ড থেকে এই আইডি ফিরিয়ে আনতে পারবেন। কনভার্সন অনুরোধের উত্তরে Search Ads 360 যেsegmentationIdপাঠায় সেটিও গ্রহণ করা হয়।type: কনভার্সনের ধরন, অর্থাৎ, হয়ACTIONঅথবাTRANSACTION। ACTION কনভার্সনের কোনও আর্থিক মূল্য নেই, তবে TRANSACTION কনভার্সনের আছে। উদাহরণ হল ইমেল তালিকার সাইন-আপ (অ্যাকশন) বনাম ই-কমার্স কেনাকাটা (ট্রানজ্যাকশন)।আপনি
TRANSACTIONউল্লেখ করলে, আপনাকে নিম্নলিখিত ফিল্ডও উল্লেখ করতে হবে:revenueMicros: কনভার্সনের আর্থিক মূল্য।
আপনি কনভার্সন উপার্জন ট্র্যাক করলে, আপনার মডেল যাতে কনভার্সন পাথের প্রতিটি টাচ পয়েন্টে উপার্জন বণ্টন করে তা নিশ্চিত করুন। যেমন, আপনার মডেল যদি লিনিয়ার অ্যাপ্রোচ ব্যবহার করে (প্রতিটি টাচ পয়েন্টে সমানভাবে উপার্জন বণ্টন করা), তাহলে কনভার্সন পাথে ৩টি বিজ্ঞাপন ক্লিক থাকলে, প্রতিটি ক্লিককে কনভার্সনের ৩৩% অ্যাট্রিবিউট করা হবে। কনভার্সন থেকে $১০০ উপার্জন হলে, আপনার মডেল যেন প্রতিটি ক্লিকে $৩৩ করে উপার্জন ডিস্ট্রিবিউট করে, এবং revenueMicros যেন প্রতিটি ক্লিকে শুধু $৩৩ উপার্জন নির্দিষ্ট করে।
ঐচ্ছিক ফিল্ড
quantityMillis: এই কনভার্সনে আইটেমের সংখ্যা। যেমন, ইমেল নিউজলেটারের জন্য সাইন-আপ করা ব্যক্তির সংখ্যা বা বিক্রি হওয়া আইটেমের মোট পরিমাণ। আপনি ACTION কনভার্সনের জন্য এই ফিল্ড নির্দিষ্ট না করলে, Search Ads 360 অটোমেটিক1000ভ্যালু যোগ করে।currencyCode: ট্রানজ্যাকশন থেকে হওয়া মোট উপার্জনের মুদ্রা। ডিফল্ট হিসেবে, মোট উপার্জন বিজ্ঞাপনদাতার কারেন্সিতে দেখানো হয়। আপনি অন্য কোনও কারেন্সি উল্লেখ করলে, Search Ads 360 উল্লেখ করা মোট উপার্জনের পরিমাণ বিজ্ঞাপনদাতার কারেন্সিতে কনভার্ট করে। আরও জানুন
মুদ্রা নির্দিষ্ট করতে ISO 4217 বর্ণানুক্রমিক (৩-অক্ষর) ফর্ম্যাট ব্যবহার করুন।
শুধুমাত্র ট্রানজ্যাকশন কনভার্সনের ক্ষেত্রে প্রযোজ্য।customMetricএবংcustomDimension: কনভার্সন সম্পর্কে অতিরিক্ত ডেটা আপলোড করে, যেমন কেনা আইটেমটি কোন দেশে পাঠানো হয়েছে, প্রোডাক্ট আইডি বা এমনকি টেলিফোন কলের সময়কাল। কাস্টম Floodlight ভেরিয়েবলের জন্য ডেটা আপলোড করা সম্পর্কে আরও জানুন।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" }] }
Search Ads 360-এর উত্তর ম্যানেজ করা
অনুরোধে থাকা সব কনভার্সন সঠিকভাবে যাচাই ও আপলোড করা হলে তবেই Search Ads 360-এর উত্তর থেকে বোঝা যায় যে কাজ সম্পূর্ণ হয়েছে।
অনুরোধ সফল হলে
অনুরোধ সফল হলে, উত্তরে প্রতিটি আপলোড করা কনভার্সনের জন্য সম্পূর্ণ Search Ads 360 ইন্টার্নাল প্রতিনিধিত্ব অন্তর্ভুক্ত থাকে। এই উপস্থাপনা নতুন Search Ads 360 আইডি ব্যবহার করে: ক্লায়েন্ট অ্যাকাউন্টের কাস্টমার আইডি এবং ক্যাম্পেন আইডি, বিজ্ঞাপন গ্রুপ আইডি, কীওয়ার্ড (ক্রাইটেরিয়ন) আইডি এবং বিজ্ঞাপন আইডি যার সাথে কনভার্সন অ্যাট্রিবিউট করা হয়েছে।
ভিজিটের জন্য অ্যাট্রিবিউট করা কনভার্সনের ক্ষেত্রে উত্তরের একটি উদাহরণ এখানে দেওয়া হল:
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"customerId": "123-456-7890",
"campaignId": "14660344555",
"adGroupId": "105138634255",
"criterionId": "948710340465",
"adId": "562719339005",
"clickId": "COiYmPDTv7kCFcP0KgodOzQAAA",
"conversionId": "test_20130906_04",
"state": "ACTIVE",
"type": "TRANSACTION",
"revenueMicros": "10000000",
"currencyCode": "USD",
"segmentationType": "FLOODLIGHT",
"segmentationId": "25700000001464141",
"segmentationName": "Test",
"conversionTimestamp": "1378710000000",
"conversionModifiedTimestamp": "1383157332368",
"floodlightOrderId": "test_20130906_04",
"countMillis": "1000",
"deviceType": "DESKTOP"
},
...
]
}
উত্তরে শুধুমাত্র সেইসব আইডি অন্তর্ভুক্ত থাকে যা কনভার্সনের ক্ষেত্রে প্রযোজ্য। যেমন, কোনও কনভার্সনের জন্য
উত্তর যা শুধুমাত্র একটি কীওয়ার্ডের জন্য অ্যাট্রিবিউট করা হয়, তাতে
clickId এবং adId অন্তর্ভুক্ত থাকে না।
অনুরোধটি সফল না হলে
এক বা একাধিক কনভার্সন যাচাই বা আপলোড করা না গেলে, প্রতিটি ব্যর্থ কনভার্সন আপলোডের জন্য উত্তরে মেসেজ অন্তর্ভুক্ত থাকে। উত্তরে কনভার্সন সম্পর্কে কোনও মেসেজ নেই যা সফলভাবে আপলোড করা হয়েছে।
এখানে এমন একটি অনুরোধের উত্তর দেওয়া হল যা সম্পূর্ণভাবে সফল হয়নি:
{
"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 errors
requestValidation সংক্রান্ত সমস্যা থেকে বোঝা যায় যে কনভার্সন আপলোড করার অনুরোধে ডেটা সংক্রান্ত সমস্যা আছে (যেমন, কনভার্সন আগেই আপলোড করা হয়েছে অথবা clickId খুঁজে পাওয়া যায়নি)। এই ধরনের সমস্যার ক্ষেত্রে, মেসেজের বিবরণে দুটি আইটেম থাকে:
- একটি হেক্সাডেসিমেল কোড যা সমস্যার ধরন শনাক্ত করে। সমস্যা শনাক্ত করতে আপনি নিজের স্ক্রিপ্টে কোড ব্যবহার করতে পারবেন।
- যাচাইকরণ সংক্রান্ত সমস্যার বিবরণ।
আরও তথ্যের জন্য, কোড ও বিবরণের তালিকা দেখুন যা Search Ads 360 কনভার্সন আপলোড সংক্রান্ত সমস্যার জন্য দেখাতে পারে।
সমস্যার অন্যান্য ধরন
অন্য সব ধরনের সমস্যা (internalError, transactionFailed, বা lateStageRequestError) থেকে বোঝা যায় যে Search Ads 360-এ ইন্টার্নাল সমস্যা হয়েছে।
সমস্যার সমাধান করা
অনুরোধটি ব্যর্থ হলে, পরে আবার সম্পূর্ণ অনুরোধ কলটি জমা দেওয়ার চেষ্টা করুন। Search Ads 360 আগে থেকেই আপলোড করা কনভার্সনের জন্য requestValidation সংক্রান্ত সমস্যার রিপোর্ট করবে, তবে এটি বাকি কনভার্সন আপলোড করার চেষ্টা করবে।
আবার জমা দেওয়ার পরেও যদি সমস্যা দেখতে পান, তাহলে কীভাবে এগিয়ে যেতে হবে সেই সম্পর্কে তথ্য পেতে সমস্যার সমাধানকরণ বিভাগ দেখুন।