एक या उससे ज़्यादा मौजूदा कन्वर्ज़न में इस तरह के बदलाव करने के लिए, Conversion.update() तरीके को कॉल करें:
- रेवेन्यू, करंसी कोड या संख्या में बदलाव करें.
- विज्ञापन देने वाले व्यक्ति या कंपनी से मिले ऑर्डर आईडी और किसी भी कस्टम Floodlight वैरिएबल में बदलाव करें.
conversion.stateकोACTIVEसेREMOVEDमें बदलकर, कन्वर्ज़न को हटाएं.
Search Ads 360 में, इनमें बदलाव नहीं किया जा सकता:
- कन्वर्ज़न की तारीख.
- कन्वर्ज़न टाइप.
- वह कीवर्ड या विज़िट जिसे कन्वर्ज़न के लिए क्रेडिट दिया गया है.
- Floodlight गतिविधि या गतिविधि का नाम.
हालांकि, किसी भी समय किसी मौजूदा कन्वर्ज़न को 'हटाया गया' के तौर पर मार्क किया जा सकता है. साथ ही, अपडेट की गई तारीख, टाइप, एट्रिब्यूशन आईडी या Floodlight गतिविधि के साथ, कोई नया कन्वर्ज़न अपलोड किया जा सकता है. इसके लिए, नया conversionId भी तय करें.
Search Ads 360 API (ऑफ़लाइन कन्वर्ज़न) के ज़रिए अपलोड किए गए कन्वर्ज़न और Search Ads 360 ने Floodlight टैग (ऑनलाइन कन्वर्ज़न) के ज़रिए रिकॉर्ड किए गए कन्वर्ज़न, दोनों में बदलाव किया जा सकता है. हालांकि, इसके लिए यहां दी गई समयसीमाएं लागू होती हैं:
-
अगर कन्वर्ज़न की पहचान
clickIdसे की जाती है, तो क्लिक आईडी पिछले 60 दिनों के अंदर जनरेट किया गया होना चाहिए. ऐसा न होने पर, गड़बड़ी का कोड0x0000012Fदिखेगा. -
Floodlight टैग से रिकॉर्ड किए गए कन्वर्ज़न में,
conversionTimestampके 28 दिनों के अंदर ही बदलाव किया जा सकता है. ऐसा न करने पर,0x00000125गड़बड़ी का कोड दिखेगा.
Conversion.insert() की तरह ही, अगर अपडेट के अनुरोध में कई कन्वर्ज़न की जानकारी दी गई है, तो Search Ads 360 हर कन्वर्ज़न को अपडेट करने की पूरी कोशिश करता है. हालांकि, वह पूरे बैच को एक साथ अपडेट नहीं करता. अगर बैच में कुछ अपडेट नहीं हो पाते हैं, तो हो सकता है कि अन्य अपडेट हो जाएं. हमारा सुझाव है कि अपडेट किए गए हर कन्वर्ज़न के लिए, जवाब पढ़ें. इससे यह पक्का किया जा सकेगा कि अपडेट पूरा हो गया है.
dsConversionId के इस्तेमाल पर रोक
dsConversionId फ़ील्ड अब काम नहीं करता. इसका इस्तेमाल, कन्वर्ज़न की पहचान करने के लिए नहीं किया जा सकता. Search Ads 360 Conversion API में कन्वर्ज़न में बदलाव करने के लिए, आपको conversionId (विज्ञापन देने वाले व्यक्ति या कंपनी का कन्वर्ज़न आईडी) का इस्तेमाल करना होगा. अगर कन्वर्ज़न इनमें से कोई एक है, तो Conversion.update() उसे अस्वीकार कर देता है. साथ ही, गड़बड़ी का कोड 0x0000013C (Conversion editing using
integer DS conversion ID is deprecated) दिखाता है:
dsConversionIdफ़ील्ड की जानकारी देता है याconversionIdफ़ील्ड में Search Ads 360 कन्वर्ज़न आईडी (17 अंकों वाला आईडी, जिसे Search Ads 360 हर कन्वर्ज़न के लिए जनरेट करता है) पास करता है.
मुख्य बदलाव:
-
dsConversionIdका इस्तेमाल बंद करना:dsConversionIDका इस्तेमाल, अब Search Ads 360 Conversion API, Search Ads 360 Reporting API (इसेconversion.idकहा जाता है) या रिपोर्टिंग यूज़र इंटरफ़ेस (इसे "कन्वर्ज़न आईडी" कहा जाता है) में नहीं किया जा सकता. -
conversionIdज़रूरी शर्त: Search Ads 360 Conversion API की मदद से कन्वर्ज़न में बदलाव करने के लिए,conversionIdफ़ील्ड भरना ज़रूरी है.
conversionId पाने का तरीका:
-
Search Ads 360 API की मदद से अपलोड किए गए कन्वर्ज़न: उस
conversionIdका इस्तेमाल करें जिसे आपने कन्वर्ज़न डालते समय तय किया था. -
Floodlight टैग की मदद से रिकॉर्ड किए गए कन्वर्ज़न: Floodlight ऑर्डर आईडी (
ordवैल्यू) का इस्तेमाल करें. इसे Floodlight टैग ने कन्वर्ज़न के लिए रिपोर्ट किया है. उदाहरण के लिए, Floodlight बिक्री गतिविधि का ऑर्डर या लेन-देन आईडी. -
Search Ads 360 Reporting API: Search Ads 360 Reporting API का इस्तेमाल करके,
advertiser_conversion_idको वापस पाया जा सकता है. यह वैल्यू, बदलाव करने के लिए ज़रूरीconversionIdसे मेल खाती है. -
Search Ads 360 का यूज़र इंटरफ़ेस (यूआई): Search Ads 360 के यूज़र इंटरफ़ेस में, कन्वर्ज़न रिपोर्टिंग पेज पर जाकर, “विज्ञापन देने वाले व्यक्ति या कंपनी का कन्वर्ज़न आईडी” देखा जा सकता है.
अपडेट का अनुरोध भेजना
Conversion.update() में बताए गए ज़्यादातर फ़ील्ड का इस्तेमाल, उन कन्वर्ज़न की पहचान करने के लिए किया जाता है जिन्हें आपको अपडेट करना है. किसी मौजूदा कन्वर्ज़न की पहचान करने के लिए, इनमें से किसी भी तरीके का इस्तेमाल किया जा सकता है:
- कन्वर्ज़न का
clickIdबताएं- बदलाव किए गए सभी कन्वर्ज़न, क्लिक आईडी जनरेट होने के 60 दिनों के अंदर होने चाहिए.
- कन्वर्ज़न का कीवर्ड बताएं (
customerId,campaignId,adGroupId, औरcriterionId)
दोनों तकनीकों के लिए, आपको कन्वर्ज़न की conversionId, conversionTimestamp, और ट्रांज़ैक्शन type की जानकारी देनी होगी. conversionTimestamp, मौजूदा कन्वर्ज़न का टाइमस्टैंप होना चाहिए. यह टाइमस्टैंप, Epoch मिलीसेकंड यूटीसी में होना चाहिए. अगर टाइमस्टैंप, मौजूदा कन्वर्ज़न से मैच नहीं करता है, तो Search Ads 360 को कन्वर्ज़न नहीं मिलता और वह गड़बड़ी का कोड 0x0000011B दिखाता है. उदाहरण के लिए, ऐसा तब हो सकता है, जब टाइमस्टैंप को स्थानीय टाइम ज़ोन से बदला गया हो.
Search Ads 360 ने Floodlight टैग की मदद से जो कन्वर्ज़न रिकॉर्ड किए हैं उनके लिए, आपको कन्वर्ज़न की Floodlight गतिविधि (segmentationType और segmentationName या segmentationId) भी बतानी होगी. ऐसा न करने पर, गड़बड़ी के कोड 0x0000010C के साथ अनुरोध पूरा नहीं हो पाता. हमारा सुझाव है कि आप अपडेट के हर अनुरोध में, Floodlight गतिविधि की जानकारी दें.
इसके अलावा, अगर ओरिजनल कन्वर्ज़न में revenueMicros और currencyCode या quantityMillis की जानकारी दी गई है, तो अपडेट के अनुरोध में यह डेटा देना ज़रूरी है. भले ही, इसमें कोई बदलाव न किया जा रहा हो.
क्लिक आईडी के हिसाब से कन्वर्ज़न की पहचान करना
अगर किसी कन्वर्ज़न में मूल रूप से क्लिक आईडी की जानकारी दी गई है, तो Conversion.update()
का अनुरोध भेजा जा सकता है. इसमें ये फ़ील्ड शामिल होने चाहिए:
clickIdconversionIdconversionTimestamptypesegmentationTypeऔरsegmentationName(याsegmentationId) (Floodlight टैग की मदद से रिकॉर्ड किए गए कन्वर्ज़न के लिए ज़रूरी है. साथ ही, सभी कन्वर्ज़न के लिए इसका सुझाव दिया जाता है)state(सिर्फ़ तब ज़रूरी है, जब आपको स्थिति को 'हटाया गया' या 'चालू है' में बदलना हो)quantityMillis(सिर्फ़ तब, जब ओरिजनल कन्वर्ज़न में बताया गया हो)revenueMicros(सिर्फ़ तब, जब ओरिजनल कन्वर्ज़न में बताया गया हो)currencyCode(सिर्फ़ तब, जब ओरिजनल कन्वर्ज़न में बताया गया हो)
उदाहरण
यहां दो मौजूदा कन्वर्ज़न का उदाहरण दिया गया है:
{ "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", "conversionId" : "test_20130906_10", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "revenueMicros": "100000000", // 100 million revenueMicros is equivalent to $100 of revenue "currencyCode": "USD" }, { "clickId": "COiYmPDTv7kCFcP0KgodOzQAAA", "conversionId": "test_1383337059137", "conversionTimestamp": "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "ACTION", "quantityMillis": "1000" }] }
यहां दिए गए अनुरोध से, पिछले उदाहरण में मौजूद कन्वर्ज़न में से एक को अपडेट किया जाता है और दूसरे को हटाया जाता है:
JSON
ध्यान दें कि Conversion.update() अनुरोध, PUT एचटीटीपी तरीके का इस्तेमाल करता है.
PUT 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 data from your site "conversionId": "test_20130906_10", "conversionTimestamp": "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "revenueMicros": "90000000", // 90 million revenueMicros is equivalent to $90 of revenue "currencyCode": "USD" }, { "clickId": "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with data from your site "conversionId": "test_1383337059137", "conversionTimestamp": "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "ACTION", "quantityMillis": "1000", "state": "REMOVED" } ] }
Java
/** * Instantiate the Doubleclicksearch service, create a conversion that updates an existing conversion, * and upload the conversions. */ 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>(); // Create a conversion and add it to the conversion list. // Just to get a little fancy, the updateConversionFromVisit() method can be used for all // visit conversions, including conversions that don't specify quantity, revenue, or currency. // If quantityMillis wasn't specified in the original conversion, specify -1L for the // quantityMillis parameter. Likewise, if revenueMicros wasn't specified originally, // specify -1L for the revenueMicros parameter and an empty string for currency. conversionList = updateConversionFromVisit( conversionList, "COiYmPDTv7kCFcP0KgodOzQAAA", // clickId. Replace with data from your site "test_20130906_10", // conversionId 1378710000000L, // timeStamp "TRANSACTION", // type "", // state -1L, // quantityMillis 90000000L, // revenueMicros. Equivalent to $90 of revenue "USD"); // currencyCode // Here's a conversion that needs to be removed. Just set the state parameter to "REMOVED". conversionList = updateConversionFromVisit( conversionList, "COiYmPDTv7kCFcP0KgodOzQAAA", // clickId. Replace with data from your site "test_1383337059137", // conversionId 1378710000000L, // timeStamp "ACTION", // type "REMOVED", // state 1000L, // quantityMillis -1L, // revenueMicros ""); // currencyCode // Upload the List and handle the response. uploadConversions(conversions, service); // See an example in Add New Conversions. } /** * Create a conversion and add it to a List<Conversion>. */ private static List<Conversion> updateConversionFromVisit(List<Conversion> conversions, String clickId, String conversionId, Long timeStamp, String type, String state, Long quantity, Long revenue, String currency) { // Identifies the existing conversion. This sample hard-codes the segmentation name. Conversion conversion = new Conversion() .setClickId(clickId) .setConversionId(conversionId) .setConversionTimestamp(BigInteger.valueOf(timeStamp)) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType(type); // Only add these fields if the value is not empty greater than -1. if(!state.isEmpty()) conversion.setState(state); if (quantity > -1L) { conversion.setQuantityMillis(quantity); } if (revenue > -1L) { conversion.setRevenueMicros(revenue); if (!currency.isEmpty()) { conversion.setCurrencyCode(currency); } else { System.err.println(String.format( "Can't add conversion %s. It specifies revenue but no currency.", conversion.getConversionId())); return conversions; } } conversions.add(conversion); return conversions; }
Python
def update_conversion(service): """Change the revenue for one existing conversion and remove another. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().update( body= { 'conversion' : [{ 'clickId' : 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with data from your site 'conversionId' : 'test_20130906_13', 'conversionTimestamp' : '1378710000000', 'segmentationType' : 'FLOODLIGHT', 'segmentationName' : 'Test', 'type': 'TRANSACTION', 'revenueMicros': '90000000', // 90 million revenueMicros is equivalent to $90 of revenue 'currencyCode': 'USD' }, { 'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with data from your site 'conversionId': 'test_1383337059137_01', 'conversionTimestamp': '1378710000000', 'segmentationType' : 'FLOODLIGHT', 'segmentationName' : 'Test', 'type': 'ACTION', 'quantityMillis': '1000', 'state': 'REMOVED' }] } ) pprint.pprint(request.execute())
कीवर्ड आईडी से कन्वर्ज़न की पहचान करना
अगर आपके पास क्लिक आईडी का ऐक्सेस नहीं है या कोई कन्वर्ज़न मूल रूप से किसी कीवर्ड या कीवर्ड/विज्ञापन को एट्रिब्यूट किया गया था, तो Conversion.update() अनुरोध भेजा जा सकता है. इसमें ये फ़ील्ड शामिल होने चाहिए:
customerId,campaignId,adGroupId, औरcriterionId(Search Ads 360 के नए वर्शन के आईडी, जो कीवर्ड की पहचान करते हैं)conversionIdconversionTimestamptypestate(सिर्फ़ तब ज़रूरी है, जब आपको स्थिति को 'हटाया गया' या 'चालू है' में बदलना हो)quantityMillis(सिर्फ़ तब, जब ओरिजनल कन्वर्ज़न में बताया गया हो)revenueMicros(सिर्फ़ तब, जब ओरिजनल कन्वर्ज़न में बताया गया हो)currencyCode(सिर्फ़ तब, जब ओरिजनल कन्वर्ज़न में बताया गया हो)
कीवर्ड आईडी, सिर्फ़ किसी विज्ञापन ग्रुप में यूनीक होते हैं. इसलिए, आपको चारों आईडी की जानकारी देनी होगी.
अगर किसी कन्वर्ज़न में customerId, campaignId या adGroupId के बिना criterionId की जानकारी दी जाती है, तो अपडेट नहीं हो पाता और गड़बड़ी का कोड 0x0000012E दिखता है. आपको अन्य आईडी बताने की ज़रूरत नहीं है. जैसे, कन्वर्ज़न का विज्ञापन आईडी.
उदाहरण
यहां किसी मौजूदा कन्वर्ज़न का उदाहरण दिया गया है:
{ "kind": "doubleclicksearch#conversionList", "conversion" : [{ "customerId": "123-456-7890", "campaignId": "14660344555", "adGroupId": "105138634255", "criterionId": "948710340465", "conversionId": "test_1383157519886", "conversionTimestamp": "1378710000000", "type": "ACTION", "quantityMillis": "1000", "segmentationType": "FLOODLIGHT", "segmentationName": "Test" }] }
इस अनुरोध से, कन्वर्ज़न की संख्या अपडेट होती है:
JSON
ध्यान दें कि Conversion.update() अनुरोध, PUT एचटीटीपी तरीके का इस्तेमाल करता है.
PUT 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": "test_1383157519886", "conversionTimestamp": "1378710000000", "type": "ACTION", "quantityMillis": "3000" } ] }
Java
// Send conversion data to updateConversion, which creates a conversion and adds it // to the conversion list. conversionList = updateConversionFromKeyword(conversionList, "123-456-7890", // customerId. Replace with your ID 14660344555L, // campaignId. Replace with your ID 105138634255L, // adGroupId. Replace with your ID 948710340465L, // criterionId. Replace with your ID "test_1383157519886", // conversionId 1378710000000L, // timeStamp "ACTION", // type "", // state 3000L, // quantityMillis -1L, // revenueMicros ""); // currencyCode private static List<Conversion> updateConversionFromKeyword(List<Conversion> conversions, String customerId, Long campaignId, Long adGroupId, Long criterionId, String conversionId, Long timeStamp, String type, String state, Long quantity, Long revenue, String currency ) { Conversion conversion = new Conversion() .setCustomerId(customerId) .setCampaignId(campaignId) .setAdGroupId(adGroupId) .setCriterionId(criterionId) .setConversionId(conversionId) .setConversionTimestamp(BigInteger.valueOf(timeStamp)) .setType(type); // Only add these fields if the value is not empty greater than -1. if(!state.isEmpty()) conversion.setState(state); if (quantity > -1L) { conversion.setQuantityMillis(quantity); } if (revenue > -1L) { conversion.setRevenueMicros(revenue); if (!currency.isEmpty()) { conversion.setCurrencyCode(currency); } else { System.err.println(String.format( "Can't add conversion %s. It specifies revenue but no currency.", conversion.getConversionId())); return conversions; } } conversions.add(conversion); return conversions; }
Python
def update_conversion(service): """Change the quantity of a conversion. Use the keyword's IDs (customerId, campaignId, adGroupId, and criterionId) to identify the conversion. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().update( 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_1383157519886', 'conversionTimestamp': '1378710000000', 'type': 'ACTION', 'quantityMillis': '3000' }] } ) pprint.pprint(request.execute())
Search Ads 360 के रिस्पॉन्स मैनेज करना
अपडेट करने के अनुरोध का जवाब, इंसर्ट करने के अनुरोध के जवाब जैसा ही होता है: Search Ads 360 सिर्फ़ तब सफल होने का संकेत देता है, जब अनुरोध में शामिल सभी कन्वर्ज़न को अपडेट कर दिया गया हो.
अगर अनुरोध पूरा हो जाता है, तो जवाब में अपडेट किए गए हर कन्वर्ज़न के लिए, Search Ads 360 के इंटरनल डेटा की पूरी जानकारी शामिल होती है. जैसे, Search Ads 360 का नया ग्राहक आईडी, कैंपेन आईडी, विज्ञापन ग्रुप आईडी, और कीवर्ड (शर्त) आईडी.
अगर एक या उससे ज़्यादा अपडेट की पुष्टि नहीं हो पाती है या उन्हें अपलोड नहीं किया जा सकता, तो जवाब में हर अपडेट के लिए गड़बड़ी के मैसेज शामिल होते हैं. जवाब में, अपडेट किए गए कन्वर्ज़न के बारे में मैसेज शामिल नहीं हैं. इन गड़बड़ियों के बारे में ज़्यादा जानकारी के लिए, इंसर्ट करने के अनुरोधों के लिए Search Ads 360 के जवाबों को मैनेज करना लेख पढ़ें.