Search Ads 360-এ প্রসেস করা কনভার্সন অবজেক্টের একটি তালিকা ফেরত দিতে Conversion.get() এ কল করুন। আপনি বিজ্ঞাপনদাতার ইঞ্জিন অ্যাকাউন্টে সমস্ত রূপান্তরের অনুরোধ করতে পারেন বা নির্দিষ্ট প্রচারাভিযান, বিজ্ঞাপন গোষ্ঠী, বিজ্ঞাপন বা কীওয়ার্ডে সুযোগ সংকুচিত করতে পারেন।
আপনি অনুরোধে যে Search Ads 360 আইডিগুলি নির্দিষ্ট করেছেন সেগুলি প্রতিক্রিয়ার সুযোগ নির্ধারণ করে৷ উদাহরণ স্বরূপ:
- একটি ইঞ্জিন অ্যাকাউন্টে সমস্ত রূপান্তর দেখতে, এই আইডিগুলি নির্দিষ্ট করুন:
-
agencyId -
advertiserId -
engineAccountId
-
- একটি নির্দিষ্ট প্রচারাভিযানে রূপান্তর দেখতে, এই আইডিগুলি নির্দিষ্ট করুন:
-
agencyId -
advertiserId -
engineAccountId -
campaignId
-
- একটি নির্দিষ্ট বিজ্ঞাপন এবং কীওয়ার্ডের জন্য দায়ী রূপান্তরগুলি দেখতে, এই আইডিগুলি নির্দিষ্ট করুন:
-
agencyId -
advertiserId -
engineAccountId -
campaignId -
adGroupId(যদি বিজ্ঞাপন গোষ্ঠী স্তরে কীওয়ার্ড বিদ্যমান থাকে) -
adId -
criterionId
-
আপনার বিজ্ঞাপনদাতার জন্য অনুসন্ধান বিজ্ঞাপন 360 আইডি পাওয়ার বিষয়ে তথ্যের জন্য, অনুসন্ধান বিজ্ঞাপন 360 আইডি এবং রূপান্তরগুলি দেখুন৷
আপনি অনুরোধ পাঠানোর পরে, Search Ads 360 অনুরোধটি যাচাই করে, অবজেক্টের তালিকা তৈরি করে এবং প্রতিক্রিয়া বডিতে একটি ConversionList সম্পদ হিসাবে তালিকাটি ফেরত দেয়।
উদাহরণ পান অনুরোধ
নিম্নলিখিত উদাহরণটি একটি নির্দিষ্ট প্রচারাভিযানে 15 নভেম্বর থেকে 31 ডিসেম্বর, 2012 পর্যন্ত হওয়া রূপান্তরগুলির তালিকার অনুরোধ করে৷
JSON
আপনি যখন রূপান্তরগুলির একটি তালিকা পুনরুদ্ধার করার জন্য একটি URL তৈরি করেন, তখন রূপান্তর সংস্থানের পথের অংশ হিসাবে প্রথম তিনটি প্যারামিটার—এজেন্সিআইডি, বিজ্ঞাপনদাতা আইডি এবং ইঞ্জিনআইডি-কে ফর্ম্যাট করুন৷ URL ক্যোয়ারী প্যারামিটার হিসাবে অবশিষ্ট প্যারামিটার নির্দিষ্ট করুন.
GET https://www.googleapis.com/doubleclicksearch/v2/agency/12300000000000456/advertiser/45600000000010291/engine/700000000042441/conversion?campaign=71700000001899732&startDate=20121115&endDate=20121231&startRow=0&rowCount=10
জাভা
/**
* Instantiate the Doubleclicksearch service, request a list of conversions in a specific campaign,
* and print the list to standard out.
*/
public static void main(String[] args) throws Exception {
Doubleclicksearch service = getService(); // See Set Up Your Application.
ConversionList conversionList = listConversions(service);
outputList(conversionList);
}
/**
* Request a list of the first 10 conversions in a specific campaign.
*/
private static ConversionList listConversions(Doubleclicksearch service) throws IOException {
try {
Get getRequest = service.conversion().get(
new Long(12300000000000456L), // Replace with your agency ID
new Long(45600000000010291L), // Replace with your advertiser ID
new Long(700000000042441L), // Replace with your engine account ID
new Integer(20121231), // End date
new Integer(10), // Number of rows
new Integer(20121115), // Start date
new Long(0L)); // Starting row
getRequest.setCampaignId(71700000002044839L); // Optional parameter
return getRequest.execute();
} 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());
return null; // Unreachable code.
}
}
/**
* Print to standard out.
*/
privte static void outputList(ConversionList conversionList) {
for (Conversion conversion : conversionList.getConversion()) {
if (null != conversion) {
System.out.println(conversion.toString());
}
}
}
পাইথন
def get_conversion(service):
"""Request the first 10 conversions in a specific campaign
and print the list.
Args:
service: An authorized Doubleclicksearch service. See Set Up Your Application.
"""
request = service.conversion().get(
agencyId='12300000000000456', // Replace with your ID
advertiserId='45600000000010291', // Replace with your ID
engineAccountId='700000000042441', // Replace with your ID
campaignId='71700000002044839', // Replace with your ID
startDate=20131115,
endDate=20131231,
startRow=0,
rowCount=10
)
pprint.pprint(request.execute())
উদাহরণ প্রতিক্রিয়া পান
অনুরোধের যাচাইকরণ সফল হলে, Search Ads 360 রেসপন্স বডিতে একটি ConversionList রিসোর্স ফেরত দেয়।
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"agencyId": "12300000000000456",
"advertiserId": "45600000000010291",
"engineAccountId": "700000000042441",
"campaignId": "71700000002044839",
"adGroupId": "58700000032026064",
"criterionId": "43700003491981017",
"adId": "0",
"dsConversionId": "48752623802180029",
"conversionId": "ag5zfmV2ZW50YXBpZGVtb3ITCxILVHJhbnNhY3Rpb24YgfQDDA",
"state": "ACTIVE",
"type": "TRANSACTION",
"revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
"currencyCode": "USD",
"quantityMillis": "0",
"segmentationType": "FLOODLIGHT",
"segmentationId": "25700000001081555",
"segmentationName": "Customer Call",
"conversionTimestamp": "1355776573000",
"conversionModifiedTimestamp": "1355776580813"
},
{
"agencyId": "12300000000000456",
"advertiserId": "45600000000010291",
"engineAccountId": "700000000042441",
"campaignId": "71700000002044839",
"adGroupId": "58700000032026064",
"criterionId": "43700003491981017",
"adId": "44700000155906860",
"dsConversionId": "48752623802180029",
"conversionId": "ag5zfmV2ZW50YXBpZGVtb3ITCxILVHJhbnNhY3Rpb24YgfQDDA",
"state": "ACTIVE",
"type": "TRANSACTION",
"revenueMicros": "20000000",
"currencyCode": "USD",
"quantityMillis": "0",
"segmentationType": "FLOODLIGHT",
"segmentationId": "25700000001081555",
"segmentationName": "Customer Call",
"conversionTimestamp": "1355776573000",
"conversionModifiedTimestamp": "1355776580813"
},
...
]
}যদি বৈধতা ব্যর্থ হয়
যদি রিপোর্টটি যাচাইকরণ না করে, তাহলে Search Ads 360 একটি "নট ফাউন্ড" ত্রুটি দেখায়। উদাহরণস্বরূপ, যদি উপরের উদাহরণের অনুরোধটি একটি বাস্তব সংস্থা নির্দিষ্ট না করে থাকে:
Not Found