এক বা একাধিক রূপান্তর যোগ করতে Conversion.insert() পদ্ধতিতে কল করুন। রূপান্তরটিকে সঠিকভাবে অ্যাট্রিবিউট করার জন্য, আপনার অনুরোধে একটি ফ্লাডলাইট কার্যকলাপের নাম উল্লেখ করতে হবে যা বিজ্ঞাপনদাতা অফলাইন রূপান্তর রিপোর্ট করতে ব্যবহার করছেন, সেই সাথে কীওয়ার্ড, বিজ্ঞাপন এবং সম্ভবত সেই ক্লিকের আইডি যা রূপান্তর ঘটিয়েছে। অনুসন্ধান বিজ্ঞাপন 360 আইডি প্রাপ্তির তথ্যের জন্য, অনুসন্ধান বিজ্ঞাপন 360 আইডি এবং রূপান্তরগুলি দেখুন।
ঐতিহাসিক রূপান্তর আপলোড করার বিধিনিষেধ সম্পর্কিত তথ্য অনুসন্ধান বিজ্ঞাপন 360 সহায়তা কেন্দ্রে পাওয়া যাবে।
যদি আপনার Conversion.insert() অনুরোধ একাধিক রূপান্তর নির্দিষ্ট করে, তাহলে Search Ads 360 সম্পূর্ণ ব্যাচকে একটি অল-অর-নথিং লেনদেন হিসাবে আপলোড করার পরিবর্তে সর্বোত্তম প্রচেষ্টার ভিত্তিতে প্রতিটি রূপান্তর আপলোড করার চেষ্টা করে। একটি ব্যাচের কিছু রূপান্তর আপলোড করতে ব্যর্থ হলে, অন্যরা সফলভাবে আপলোড করতে পারে। একটি অবৈধ অনুরোধ বা ক্ষণস্থায়ী নেটওয়ার্ক বা সিস্টেম ব্যর্থতার কারণে রূপান্তর আপলোড ব্যর্থ হতে পারে৷ অতএব, আপলোড সফল হয়েছে তা নিশ্চিত করতে আমরা আপনাকে প্রতিটি সন্নিবেশিত রূপান্তরের প্রতিক্রিয়া পড়ার পরামর্শ দিই।
কত তাড়াতাড়ি আমি আপলোড করা ডেটা ব্যবহার করতে পারি?
আপনি যদি একটি রূপান্তরের জন্য আজকের বা গতকালের একটি conversionTimestamp নির্দিষ্ট করেন, তাহলে আপলোডের এক ঘণ্টার মধ্যে রূপান্তরের মেট্রিক্স Search Ads 360 UI-তে দেখা যাবে। আপনি যদি গতকালের থেকে পুরানো একটি conversionTimestamp নির্দিষ্ট করেন, মেট্রিকগুলি কয়েক ঘন্টার মধ্যে আপডেট করা হবে৷
রূপান্তরের জন্য সমস্ত টাইমস্ট্যাম্পকে যুগান্তরে রূপান্তর করুন (এছাড়াও ইউনিক্স সময় নামে পরিচিত)।
আমি কি API থেকে ফ্লাডলাইট কার্যকলাপ তৈরি করতে পারি?
যদি বিজ্ঞাপনদাতা এখনও অফলাইন রূপান্তরগুলি ট্র্যাক করার জন্য একটি ফ্লাডলাইট কার্যকলাপ তৈরি না করে থাকেন, তাহলে আপনি একটি তৈরি করতে ক্যাম্পেইন ম্যানেজার API ব্যবহার করতে পারেন৷ একটি ফ্লাডলাইট কার্যকলাপ প্রাথমিকভাবে অফলাইন রূপান্তরগুলির জন্য ব্যবহৃত হয় তা নির্দিষ্ট করতে আপনি API ব্যবহার করতে পারবেন না, এটি একটি সর্বোত্তম অনুশীলন যখন বিড কৌশলগুলি রূপান্তর থেকে ডেটা ব্যবহার করবে৷
আমরা সুপারিশ করি যে আপনি ফ্লাডলাইট কার্যকলাপ তৈরি করতে API ব্যবহার করার পরে , একজন অনুসন্ধান বিজ্ঞাপন 360 ব্যবহারকারী অনুসন্ধান বিজ্ঞাপন 360-এ সাইন ইন করে এবং ক্রিয়াকলাপের সেটিং পরিবর্তন করে নির্দেশ করে যে রূপান্তরের প্রাথমিক উত্স অফলাইন কার্যকলাপ ।
রূপান্তর যোগ করার জন্য সর্বোত্তম অনুশীলন
রূপান্তর যোগ করার জন্য আমরা নিম্নলিখিত সর্বোত্তম অনুশীলনগুলি সুপারিশ করি:
একজন Search Ads 360 ব্যবহারকারীকে Search Ads 360-এ সাইন-ইন করতে বলুন এবং অফলাইন কনভার্সন রিপোর্ট করার জন্য ব্যবহার করা প্রতিটি Floodlight অ্যাক্টিভিটির সেটিংস পরিবর্তন করুন। সেটিংসটি নির্দেশ করে যে রূপান্তরগুলির প্রাথমিক উত্স হল অফলাইন কার্যকলাপ৷ নির্দেশাবলীর জন্য Search Ads 360 সহায়তা কেন্দ্র দেখুন।
রূপান্তরগুলি উপলব্ধ হওয়ার সাথে সাথে আপলোড করুন৷ আপনি যদি নির্দিষ্ট ভিজিটগুলিতে রূপান্তরগুলিকে দায়ী করে থাকেন, তাহলে আপনি রূপান্তর আপলোড করার আগে ভিজিটের পরে কমপক্ষে 30 মিনিট অপেক্ষা করুন৷ আপনি ভিজিট করার ৩০ মিনিটের মধ্যে আপলোড করলে Search Ads 360 ভিজিটের ক্লিকআইডি চিনতে নাও পারে। বিরল ক্ষেত্রে, Search Ads 360 ক্লিক আইডি চিনতে পারার আগে আপনাকে 4 ঘন্টা পর্যন্ত অপেক্ষা করতে হতে পারে।
নিশ্চিত করুন যে প্রতিটি আপলোডে সাম্প্রতিকতম রূপান্তরগুলি রয়েছে ৷ একটি একক আপলোড অনুরোধের মধ্যে, যদি এন্ট্রিগুলি কালানুক্রমিক ক্রমে হয় তাহলে ঠিক আছে৷ কিন্তু একটি বিড কৌশল পুরানো রূপান্তরগুলি বিবেচনা করতে সক্ষম নাও হতে পারে যা আপনি পরে একটি ভিন্ন অনুরোধে আপলোড করেন৷
আপনি যদি ফ্লাডলাইট কার্যকলাপের জন্য রূপান্তরগুলি আপলোড করার আগে 24 ঘন্টার বেশি অপেক্ষা করেন তবে একটি উপলব্ধতার টাইমস্ট্যাম্প পাঠান ।
প্রাপ্যতা টাইমস্ট্যাম্প নিম্নলিখিতগুলির মধ্যে একটি হওয়া উচিত:
- আপনি যদি গত 24 ঘন্টার মধ্যে রূপান্তরগুলি রেকর্ড করে থাকেন কিন্তু এখনও সেগুলি আপলোড না করে থাকেন তবে টাইমস্ট্যাম্পটি সেই সময় হওয়া উচিত যেটি শেষ আপলোড করা রূপান্তর ঘটেছে ৷ এটি Search Ads 360 কে বলে যে রূপান্তরগুলি গত 24 ঘন্টার মধ্যে ঘটেছে, কিন্তু আপনি এখনও ডেটা প্রদান করেননি। বিড কৌশল এবং অন্যান্য স্বয়ংক্রিয় সিস্টেম শুধুমাত্র আপনার আপলোড করা শেষ রূপান্তর পর্যন্ত কর্মক্ষমতা ইতিহাস বিবেচনা করবে।
- যদি গত 24 ঘন্টার মধ্যে কোন রূপান্তর না ঘটে থাকে, টাইমস্ট্যাম্পটি বর্তমান সময় এবং তারিখ হওয়া উচিত। এটি Search Ads 360 কে বলে যে গত 24 ঘন্টায় কোন রূপান্তর ঘটেনি। বিড কৌশল এবং অন্যান্য স্বয়ংক্রিয় সিস্টেমগুলি কার্যক্ষমতার ইতিহাসের অংশ হিসাবে শেষ 24 ঘন্টা—রূপান্তর ছাড়াই একটি সম্পূর্ণ দিন-কে অন্তর্ভুক্ত করবে।
একটি সন্নিবেশ অনুরোধ পাঠান
আপনি নিম্নলিখিত যেকোন একটি করার জন্য একটি Conversion.insert() অনুরোধ পাঠাতে পারেন:
- একটি নির্দিষ্ট পরিদর্শন একটি রূপান্তর বৈশিষ্ট্য
- শুধুমাত্র একটি মূলশব্দে একটি রূপান্তর বৈশিষ্ট্য
একটি Conversion.insert() অনুরোধে যে ক্ষেত্রগুলি প্রয়োজন তা নির্ভর করে আপনি যে ইভেন্ট বা আইটেমটিতে রূপান্তরটিকে দায়ী করছেন তার উপর৷ নিম্নলিখিত বিভাগগুলি প্রতিটি ইভেন্ট বা আইটেমের জন্য প্রয়োজনীয় এবং ঐচ্ছিক ক্ষেত্রগুলির তালিকা করে যা আপনি একটি রূপান্তরকে দায়ী করতে পারেন৷
একটি নির্দিষ্ট পরিদর্শন একটি রূপান্তর বৈশিষ্ট্য
যখন একজন গ্রাহক এক বা একাধিক বিজ্ঞাপনে ক্লিক করে এবং বিজ্ঞাপনদাতার সাইটে ল্যান্ড করে, তখন Search Ads 360 বিজ্ঞাপনদাতার সাইটে ব্যবহারকারীর সেশনকে একটি ভিজিট হিসেবে বিবেচনা করে। একটি দর্শনে একটি রূপান্তরকে বৈশিষ্ট্যযুক্ত করতে, আপনার Conversion.insert() অনুরোধে নিম্নলিখিতগুলি উল্লেখ করুন:
প্রয়োজনীয় ক্ষেত্র
-
clickId: ভিজিটের কেস-সংবেদনশীল ক্লিক আইডি । ক্লিক আইডি বা তালিকা রূপান্তরগুলির জন্য বিজ্ঞাপনদাতার ওয়েব লগগুলি দেখুন এবং অন্য রূপান্তর থেকে একটি ক্লিক আইডি ব্যবহার করুন৷ অনুসন্ধান বিজ্ঞাপন 360 কিওয়ার্ড, বিজ্ঞাপন এবং অন্যান্য অনুসন্ধান বিজ্ঞাপন 360 অবজেক্টে রূপান্তরকে দায়ী করবে যা ভিজিট তৈরির জন্য দায়ী।
কনভার্সন আপলোড করতে Search Ads 360 একটি ক্লিক আইডি তৈরি করার পর অন্তত 30 মিনিট অপেক্ষা করুন । আপনি যদি একটি "ক্লিক আইডি পাওয়া যায় না" ত্রুটি পান, 4 ঘন্টা অপেক্ষা করুন এবং তারপরে আবার রূপান্তরগুলি আপলোড করুন৷ ক্লিক আইডি তৈরি হওয়ার 90 দিনের মধ্যে সমস্ত রূপান্তর আপলোড করা উচিত। অন্যথায়, Search Ads 360 API ভিজিটটি চিনতে নাও পারে। -
conversionId: অফলাইন রূপান্তরের জন্য, বিজ্ঞাপনদাতারা এই আইডি প্রদান করে। বিজ্ঞাপনদাতারা তাদের কাছে অর্থপূর্ণ যে কোনো আইডি নির্দিষ্ট করতে পারেন। একটি অনুরোধে প্রতিটি রূপান্তর অবশ্যই একটি অনন্য আইডি নির্দিষ্ট করতে হবে এবং বিজ্ঞাপনদাতার মধ্যে সমস্ত রূপান্তরগুলির মধ্যে ID এবং টাইমস্ট্যাম্পের সমন্বয় অবশ্যই অনন্য হতে হবে৷ অনলাইন রূপান্তরের জন্য, বিজ্ঞাপনদাতার ফ্লাডলাইট নির্দেশাবলীর উপর নির্ভর করে Search Ads 360 এই প্রপার্টিতেdsConversionIdবাfloodlightOrderIdকপি করে। -
conversionTimestamp: যে তারিখ এবং সময় রূপান্তর ঘটেছে তা নির্দেশ করে। উদাহরণস্বরূপ, যদি রূপান্তরটি শুক্র, 05 আগস্ট 2016 11:53:22 AM ইস্টার্ন ডেলাইট সেভিংস টাইম (GMT -4:00) হয়, তাহলে Epoch মিলিসেকেন্ডে টাইমস্ট্যাম্প নির্দিষ্ট করুন:1470412402000। -
segmentationType: আপনি রূপান্তর আপলোড করছেন যে রূপান্তর সিস্টেমের ধরন নির্দিষ্ট করে। বর্তমানে শুধুমাত্র ফ্লাডলাইট রূপান্তরগুলি সমর্থিত, তাই এই ক্ষেত্রটি সর্বদাFLOODLIGHTনির্দিষ্ট করার প্রয়োজন হয়৷ -
segmentationName: ফ্লাডলাইট কার্যকলাপের নাম যা বিজ্ঞাপনদাতা রূপান্তর প্রতিবেদন করতে ব্যবহার করছেন।যদি আপনার বিজ্ঞাপনদাতার একই নামের ক্রিয়াকলাপ থাকে (এটি ঘটতে পারে যদি ক্রিয়াকলাপগুলি বিভিন্ন ফ্লাডলাইট গোষ্ঠীর অন্তর্গত হয়), প্রস্তাবিত পদক্ষেপটি হল একটি ক্রিয়াকলাপের নাম পরিবর্তন করা ।
বিকল্পভাবে, যদি আপনি জানেন যে ID Search Ads 360 একটি ফ্লাডলাইট অ্যাক্টিভিটি অ্যাসাইন করেছে, আপনি
segmentationNameফিল্ডে নাম উল্লেখ না করেsegmentationIdআইডিতে আইডি উল্লেখ করতে পারেন। (ক্যাম্পেন ম্যানেজার ফ্লাডলাইট অ্যাক্টিভিটির জন্য একটি আইডিও বরাদ্দ করে, কিন্তু ক্যাম্পেইন ম্যানেজার আইডি সার্চ অ্যাডস 360 আইডি থেকে আলাদা এবং এটি কনভার্সন অ্যাট্রিবিউট করার জন্য ব্যবহার করা যায় না।) ফ্লাডলাইট অ্যাক্টিভিটির জন্য Search Ads 360 আইডি দেখতে একটি কনভার্সন ডাউনলোড করুন রিপোর্ট (হয় Search Ads 360 UI বা রিপোর্টিং API থেকে)। রিপোর্টের সময়সীমার মধ্যে ফ্লাডলাইট অ্যাক্টিভিটির জন্য যদি অন্তত একটি রূপান্তর দায়ী করা হয়, তাহলে আপনি রিপোর্টে Search Ads 360 ID দেখতে পাবেন। -
type: রূপান্তরের ধরন, যেটি হয়ACTIONবাTRANSACTION। একটি ACTION রূপান্তরের কোনো আর্থিক মূল্য নেই, যখন একটি TRANSACTION রূপান্তর করে৷ উদাহরণ হল ইমেল তালিকা সাইনআপ (ACTION) বনাম ইকমার্স কেনাকাটা (TRANSACTION)।আপনি যদি
TRANSACTIONনির্দিষ্ট করেন, তাহলে আপনাকে নিম্নলিখিত ক্ষেত্রটিও উল্লেখ করতে হবে:-
revenueMicros: রূপান্তরের আর্থিক মূল্য।
-
ঐচ্ছিক ক্ষেত্র
-
quantityMillis: এই রূপান্তর আইটেম সংখ্যা. উদাহরণস্বরূপ, একটি ইমেল নিউজলেটারের জন্য সাইন আপ করা লোকের সংখ্যা বা বিক্রি হওয়া আইটেমগুলির মোট পরিমাণ৷ আপনি যদি ACTION রূপান্তরের জন্য এই ক্ষেত্রটি নির্দিষ্ট না করেন, তাহলে Search Ads 360 স্বয়ংক্রিয়ভাবে1000এর একটি মান সন্নিবেশ করে। -
currencyCode: একটি লেনদেনের আয়ের মুদ্রা। ডিফল্টরূপে, রাজস্ব বিজ্ঞাপনদাতার মুদ্রায় বলে ধরে নেওয়া হয়। আপনি যদি একটি ভিন্ন মুদ্রা উল্লেখ করেন, তাহলে Search Ads 360 নির্দিষ্ট আয়ের পরিমাণ বিজ্ঞাপনদাতার মুদ্রায় রূপান্তর করে। আরও জানুন
মুদ্রা নির্দিষ্ট করতে ISO 4217 বর্ণমালা (3-char) বিন্যাস ব্যবহার করুন।
শুধুমাত্র লেনদেন রূপান্তর জন্য প্রযোজ্য. -
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পেতে পারেন। কীওয়ার্ড আইডি প্রাপ্তির তথ্যের জন্য, অনুসন্ধান বিজ্ঞাপন 360 আইডি এবং রূপান্তরগুলি দেখুন। -
conversionId: অফলাইন রূপান্তরের জন্য, বিজ্ঞাপনদাতারা এই আইডি প্রদান করে। বিজ্ঞাপনদাতারা তাদের কাছে অর্থপূর্ণ যে কোনো আইডি নির্দিষ্ট করতে পারেন। একটি অনুরোধে প্রতিটি রূপান্তর অবশ্যই একটি অনন্য আইডি নির্দিষ্ট করতে হবে এবং বিজ্ঞাপনদাতার মধ্যে সমস্ত রূপান্তরগুলির মধ্যে ID এবং টাইমস্ট্যাম্পের সমন্বয় অবশ্যই অনন্য হতে হবে৷ অনলাইন রূপান্তরের জন্য, বিজ্ঞাপনদাতার ফ্লাডলাইট নির্দেশাবলীর উপর নির্ভর করে Search Ads 360 এই প্রপার্টিতেdsConversionIdবাfloodlightOrderIdকপি করে। -
conversionTimestamp: যে তারিখ এবং সময় রূপান্তর ঘটেছে তা নির্দেশ করে। উদাহরণস্বরূপ, যদি রূপান্তরটি শুক্র, 05 আগস্ট 2016 11:53:22 AM ইস্টার্ন ডেলাইট সেভিংস টাইম (GMT -4:00) হয়, তাহলে Epoch মিলিসেকেন্ডে টাইমস্ট্যাম্প নির্দিষ্ট করুন:1470412402000। -
segmentationType: আপনি রূপান্তর আপলোড করছেন যে রূপান্তর সিস্টেমের ধরন নির্দিষ্ট করে। বর্তমানে শুধুমাত্র ফ্লাডলাইট রূপান্তরগুলি সমর্থিত, তাই এই ক্ষেত্রটি সর্বদাFLOODLIGHTনির্দিষ্ট করার প্রয়োজন হয়৷ -
segmentationName: ফ্লাডলাইট কার্যকলাপের নাম যা বিজ্ঞাপনদাতা রূপান্তর প্রতিবেদন করতে ব্যবহার করছেন।যদি আপনার বিজ্ঞাপনদাতার একই নামের ক্রিয়াকলাপ থাকে (এটি ঘটতে পারে যদি ক্রিয়াকলাপগুলি বিভিন্ন ফ্লাডলাইট গোষ্ঠীর অন্তর্গত হয়), প্রস্তাবিত পদক্ষেপটি হল একটি ক্রিয়াকলাপের নাম পরিবর্তন করা ।
বিকল্পভাবে, যদি আপনি জানেন যে ID Search Ads 360 একটি ফ্লাডলাইট অ্যাক্টিভিটি অ্যাসাইন করেছে, আপনি
segmentationNameফিল্ডে নাম উল্লেখ না করেsegmentationIdআইডিতে আইডি উল্লেখ করতে পারেন। (ক্যাম্পেন ম্যানেজার ফ্লাডলাইট অ্যাক্টিভিটির জন্য একটি আইডিও বরাদ্দ করে, কিন্তু ক্যাম্পেইন ম্যানেজার আইডি সার্চ অ্যাডস 360 আইডি থেকে আলাদা এবং এটি কনভার্সন অ্যাট্রিবিউট করার জন্য ব্যবহার করা যায় না।) ফ্লাডলাইট অ্যাক্টিভিটির জন্য Search Ads 360 আইডি দেখতে একটি কনভার্সন ডাউনলোড করুন রিপোর্ট (হয় Search Ads 360 UI বা রিপোর্টিং API থেকে)। রিপোর্টের সময়সীমার মধ্যে ফ্লাডলাইট অ্যাক্টিভিটির জন্য যদি অন্তত একটি রূপান্তর দায়ী করা হয়, তাহলে আপনি রিপোর্টে Search Ads 360 ID দেখতে পাবেন। -
type: রূপান্তরের ধরন, যেটি হয়ACTIONবাTRANSACTION। একটি ACTION রূপান্তরের কোনো আর্থিক মূল্য নেই, যখন একটি TRANSACTION রূপান্তর করে৷ উদাহরণ হল ইমেল তালিকা সাইনআপ (ACTION) বনাম ইকমার্স কেনাকাটা (TRANSACTION)।আপনি যদি
TRANSACTIONনির্দিষ্ট করেন, তাহলে আপনাকে নিম্নলিখিত ক্ষেত্রটিও উল্লেখ করতে হবে:-
revenueMicros: রূপান্তরের আর্থিক মূল্য।
-
ঐচ্ছিক ক্ষেত্র
-
quantityMillis: এই রূপান্তর আইটেম সংখ্যা. উদাহরণস্বরূপ, একটি ইমেল নিউজলেটারের জন্য সাইন আপ করা লোকের সংখ্যা বা বিক্রি হওয়া আইটেমগুলির মোট পরিমাণ৷ আপনি যদি ACTION রূপান্তরের জন্য এই ক্ষেত্রটি নির্দিষ্ট না করেন, তাহলে Search Ads 360 স্বয়ংক্রিয়ভাবে1000এর একটি মান সন্নিবেশ করে। -
currencyCode: একটি লেনদেনের আয়ের মুদ্রা। ডিফল্টরূপে, রাজস্ব বিজ্ঞাপনদাতার মুদ্রায় বলে ধরে নেওয়া হয়। আপনি যদি একটি ভিন্ন মুদ্রা উল্লেখ করেন, তাহলে Search Ads 360 নির্দিষ্ট আয়ের পরিমাণ বিজ্ঞাপনদাতার মুদ্রায় রূপান্তর করে। আরও জানুন
মুদ্রা নির্দিষ্ট করতে ISO 4217 বর্ণমালা (3-char) বিন্যাস ব্যবহার করুন।
শুধুমাত্র লেনদেন রূপান্তর জন্য প্রযোজ্য. -
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 অ্যাট্রিবিউশন মডেল সরবরাহ করে , আপনি যদি তৃতীয় পক্ষের পরিষেবা ব্যবহার করেন বা ক্লিকগুলিতে ক্রেডিট বিতরণ করার জন্য আপনার তৈরি করা কোনও পরিষেবা ব্যবহার করেন , আপনি তৃতীয়-পক্ষের অ্যাট্রিবিউশন ডেটা অনুসন্ধান বিজ্ঞাপন 360-এ আপলোড করতে পারেন এবং প্রতিবেদনে এবং অনুসন্ধানে ডেটা ব্যবহার করতে পারেন বিজ্ঞাপন 360 বিড কৌশল।
আপনি শুরু করার আগে
ক্যাম্পেইন ম্যানেজারে, একটি কাস্টম অ্যাট্রিবিউশন মডেল তৈরি করুন এবং মডেলটিকে অনুসন্ধান বিজ্ঞাপন 360-এ আমদানি করুন। নিশ্চিত করুন যে আপনি মডেলটির নাম বাহ্যিক অ্যাট্রিবিউশন মডেল রেখেছেন। এটি অনুসন্ধান বিজ্ঞাপন 360 বৈশিষ্ট্যগুলিকে সনাক্ত করতে সক্ষম করে যে আপনার আপলোড করা রূপান্তর ডেটাতে একটি অ্যাট্রিবিউশন মডেল প্রয়োগ করা হয়েছে। আরও জানুন
প্রয়োজনীয় ক্ষেত্র
একটি রূপান্তরে একটি তৃতীয় পক্ষের অ্যাট্রিবিউশন মডেল প্রয়োগ করতে, আপনার Conversion.insert() অনুরোধে নিম্নলিখিত সবগুলি উল্লেখ করুন:
-
clickId: ভিজিটের কেস-সংবেদনশীল ক্লিক আইডি । ক্লিক আইডি বা তালিকা রূপান্তরগুলির জন্য বিজ্ঞাপনদাতার ওয়েব লগগুলি দেখুন এবং অন্য রূপান্তর থেকে একটি ক্লিক আইডি ব্যবহার করুন৷ অনুসন্ধান বিজ্ঞাপন 360 কিওয়ার্ড, বিজ্ঞাপন এবং অন্যান্য অনুসন্ধান বিজ্ঞাপন 360 অবজেক্টে রূপান্তরকে দায়ী করবে যা ভিজিট তৈরির জন্য দায়ী।
আইডির সাথে একটি রূপান্তর আপলোড করার আগে Search Ads 360 একটি ক্লিক আইডি তৈরি করার পরে কমপক্ষে 30 মিনিট অপেক্ষা করুন । অন্যথায়, Search Ads 360 API ভিজিটটি চিনতে নাও পারে। -
attributionModel: এক্সটার্নাল অ্যাট্রিবিউশন মডেলে সেট করুন। আরও জানুন -
countMillis: এই ক্লিকে বিতরণ করার জন্য রূপান্তর ক্রেডিট পরিমাণ। অনুরোধেattributionModelক্ষেত্র অন্তর্ভুক্ত থাকলে শুধুমাত্র প্রযোজ্য।এটিকে
quantityMillisএর সাথে বিভ্রান্ত করবেন না, একটি ঐচ্ছিক ক্ষেত্র যা একটি রূপান্তরে আইটেমের সংখ্যা নির্দিষ্ট করে (যেমন একটি শপিং কার্ট ক্রয়ের আইটেমের সংখ্যা)। -
conversionId: অফলাইন রূপান্তরের জন্য, বিজ্ঞাপনদাতারা এই আইডি প্রদান করে। বিজ্ঞাপনদাতারা তাদের কাছে অর্থপূর্ণ যে কোনো আইডি নির্দিষ্ট করতে পারেন। একটি অনুরোধে প্রতিটি রূপান্তর অবশ্যই একটি অনন্য আইডি নির্দিষ্ট করতে হবে এবং বিজ্ঞাপনদাতার মধ্যে সমস্ত রূপান্তরগুলির মধ্যে ID এবং টাইমস্ট্যাম্পের সমন্বয় অবশ্যই অনন্য হতে হবে৷ অনলাইন রূপান্তরের জন্য, বিজ্ঞাপনদাতার ফ্লাডলাইট নির্দেশাবলীর উপর নির্ভর করে Search Ads 360 এই প্রপার্টিতেdsConversionIdবাfloodlightOrderIdকপি করে। -
conversionTimestamp: যে তারিখ এবং সময় রূপান্তর ঘটেছে তা নির্দেশ করে। উদাহরণস্বরূপ, যদি রূপান্তরটি শুক্র, 05 আগস্ট 2016 11:53:22 AM ইস্টার্ন ডেলাইট সেভিংস টাইম (GMT -4:00) হয়, তাহলে Epoch মিলিসেকেন্ডে টাইমস্ট্যাম্প নির্দিষ্ট করুন:1470412402000। -
segmentationType: আপনি রূপান্তর আপলোড করছেন যে রূপান্তর সিস্টেমের ধরন নির্দিষ্ট করে। বর্তমানে শুধুমাত্র ফ্লাডলাইট রূপান্তরগুলি সমর্থিত, তাই এই ক্ষেত্রটি সর্বদাFLOODLIGHTনির্দিষ্ট করার প্রয়োজন হয়৷ -
segmentationName: ফ্লাডলাইট কার্যকলাপের নাম যা বিজ্ঞাপনদাতা রূপান্তর প্রতিবেদন করতে ব্যবহার করছেন।যদি আপনার বিজ্ঞাপনদাতার একই নামের ক্রিয়াকলাপ থাকে (এটি ঘটতে পারে যদি ক্রিয়াকলাপগুলি বিভিন্ন ফ্লাডলাইট গোষ্ঠীর অন্তর্গত হয়), প্রস্তাবিত পদক্ষেপটি হল একটি ক্রিয়াকলাপের নাম পরিবর্তন করা ।
বিকল্পভাবে, যদি আপনি জানেন যে ID Search Ads 360 একটি ফ্লাডলাইট অ্যাক্টিভিটি অ্যাসাইন করেছে, আপনি
segmentationNameফিল্ডে নাম উল্লেখ না করেsegmentationIdআইডিতে আইডি উল্লেখ করতে পারেন। (ক্যাম্পেন ম্যানেজার ফ্লাডলাইট অ্যাক্টিভিটির জন্য একটি আইডিও বরাদ্দ করে, কিন্তু ক্যাম্পেইন ম্যানেজার আইডি সার্চ অ্যাডস 360 আইডি থেকে আলাদা এবং এটি কনভার্সন অ্যাট্রিবিউট করার জন্য ব্যবহার করা যায় না।) ফ্লাডলাইট অ্যাক্টিভিটির জন্য Search Ads 360 আইডি দেখতে একটি কনভার্সন ডাউনলোড করুন রিপোর্ট (হয় Search Ads 360 UI বা রিপোর্টিং API থেকে)। রিপোর্টের সময়সীমার মধ্যে ফ্লাডলাইট অ্যাক্টিভিটির জন্য যদি অন্তত একটি রূপান্তর দায়ী করা হয়, তাহলে আপনি রিপোর্টে Search Ads 360 ID দেখতে পাবেন। -
type: রূপান্তরের ধরন, যেটি হয়ACTIONবাTRANSACTION। একটি ACTION রূপান্তরের কোনো আর্থিক মূল্য নেই, যখন একটি TRANSACTION রূপান্তর করে৷ উদাহরণ হল ইমেল তালিকা সাইনআপ (ACTION) বনাম ইকমার্স কেনাকাটা (TRANSACTION)।আপনি যদি
TRANSACTIONনির্দিষ্ট করেন, তাহলে আপনাকে নিম্নলিখিত ক্ষেত্রটিও উল্লেখ করতে হবে:-
revenueMicros: রূপান্তরের আর্থিক মূল্য।
-
আপনি যদি রূপান্তর রাজস্ব ট্র্যাক করেন, তাহলে নিশ্চিত হন যে আপনার মডেল একটি রূপান্তর পথের প্রতিটি টাচ পয়েন্ট জুড়ে আয় বিতরণ করে। উদাহরণস্বরূপ, যদি আপনার মডেল একটি রৈখিক পদ্ধতি ব্যবহার করে (প্রতিটি টাচ পয়েন্ট জুড়ে সমানভাবে রাজস্ব বন্টন করে), একটি রূপান্তর পাথ যাতে 3টি বিজ্ঞাপন ক্লিক অন্তর্ভুক্ত থাকে, প্রতিটি ক্লিকের 33% রূপান্তর দ্বারা দায়ী করা হবে। যদি রূপান্তরটি $100 রাজস্ব অর্জন করে, তবে নিশ্চিত করুন যে আপনার মডেলটি প্রতিটি ক্লিকে $33 রাজস্ব বিতরণ করে এবং নিশ্চিত করুন যে রাজস্ব মাইক্রোস প্রতিটি ক্লিকের জন্য মাত্র $33 রাজস্ব নির্দিষ্ট করে৷
ঐচ্ছিক ক্ষেত্র
-
quantityMillis: এই রূপান্তর আইটেম সংখ্যা. উদাহরণস্বরূপ, একটি ইমেল নিউজলেটারের জন্য সাইন আপ করা লোকের সংখ্যা বা বিক্রি হওয়া আইটেমগুলির মোট পরিমাণ৷ আপনি যদি ACTION রূপান্তরের জন্য এই ক্ষেত্রটি নির্দিষ্ট না করেন, তাহলে Search Ads 360 স্বয়ংক্রিয়ভাবে1000এর একটি মান সন্নিবেশ করে। -
currencyCode: একটি লেনদেনের আয়ের মুদ্রা। ডিফল্টরূপে, রাজস্ব বিজ্ঞাপনদাতার মুদ্রায় বলে ধরে নেওয়া হয়। আপনি যদি একটি ভিন্ন মুদ্রা উল্লেখ করেন, তাহলে Search Ads 360 নির্দিষ্ট আয়ের পরিমাণ বিজ্ঞাপনদাতার মুদ্রায় রূপান্তর করে। আরও জানুন
মুদ্রা নির্দিষ্ট করতে ISO 4217 বর্ণমালা (3-char) বিন্যাস ব্যবহার করুন।
শুধুমাত্র লেনদেন রূপান্তর জন্য প্রযোজ্য. -
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-এর প্রতিক্রিয়া শুধুমাত্র সফলতার ইঙ্গিত দেয় যদি অনুরোধের সমস্ত রূপান্তর সফলভাবে যাচাই করা হয় এবং আপলোড করা হয়।
অনুরোধ সফল হলে
অনুরোধটি সফল হলে, প্রতিক্রিয়াটিতে প্রতিটি আপলোড করা রূপান্তরের জন্য সম্পূর্ণ অনুসন্ধান বিজ্ঞাপন 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 থাকতে পারে।
অনুরোধ যাচাইকরণ ত্রুটি
অনুরোধ যাচাইকরণ ত্রুটিগুলি রূপান্তর আপলোডের অনুরোধে ডেটা সমস্যাগুলি নির্দেশ করে (যেমন, রূপান্তরটি ইতিমধ্যেই আপলোড করা হয়েছে, বা ক্লিকআইডি পাওয়া যায়নি)। এই ধরনের ত্রুটিতে, বার্তার বিবরণে দুটি আইটেম থাকে:
- একটি হেক্সাডেসিমেল কোড যা ত্রুটির ধরন সনাক্ত করে। আপনি ত্রুটি সনাক্ত করতে আপনার নিজের স্ক্রিপ্ট কোড ব্যবহার করতে পারেন.
- যাচাইকরণ ত্রুটির একটি বিবরণ।
আরও তথ্যের জন্য, রূপান্তর আপলোড ত্রুটির জন্য Search Ads 360 ফেরত দিতে পারে এমন কোড এবং বিবরণের তালিকা দেখুন।
অন্য ধরনের ত্রুটি
অন্য সব ধরনের ত্রুটি ( internalError , transactionFailed , or lateStageRequestError ) নির্দেশ করে যে Search Ads 360-এ একটি অভ্যন্তরীণ সমস্যা আছে।
একটি ত্রুটির প্রতিক্রিয়া
অনুরোধ ব্যর্থ হলে, পরে সম্পূর্ণ অনুরোধ কল পুনরায় জমা দেওয়ার চেষ্টা করুন। Search Ads 360 আগে থেকে আপলোড করা যেকোন কনভার্সনের জন্য রিকোয়েস্ট ভ্যালিডেশন ত্রুটির রিপোর্ট করবে, কিন্তু বাকি কনভার্সন আপলোড করার চেষ্টা করবে।
যদি আপনি পুনরায় জমা দেওয়ার পরেও ত্রুটিগুলি দেখতে পান, তাহলে কীভাবে এগিয়ে যেতে হবে তার তথ্যের জন্য সমস্যা সমাধান বিভাগটি দেখুন৷