एक या उससे ज़्यादा कन्वर्ज़न जोड़ने के लिए, Conversion.insert()
मेथड को कॉल करें. कन्वर्ज़न को सही तरीके से एट्रिब्यूट करने के लिए, आपके अनुरोध में उस Floodlight गतिविधि का नाम बताना ज़रूरी है जिसका इस्तेमाल विज्ञापन देने वाला व्यक्ति या कंपनी, ऑफ़लाइन कन्वर्ज़न की रिपोर्ट करने के लिए कर रही है. साथ ही, विज़िट का क्लिक आईडी या कन्वर्ज़न के लिए ज़िम्मेदार कीवर्ड के आईडी भी बताने ज़रूरी हैं. Search Ads 360 आईडी पाने के बारे में जानकारी के लिए, Search Ads 360 आईडी और कन्वर्ज़न देखें.
पुराने कन्वर्ज़न अपलोड करने से जुड़ी पाबंदियों के बारे में जानकारी, Search Ads 360 के सहायता केंद्र पर मिल सकती है.
अगर आपके Conversion.insert() अनुरोध में कई कन्वर्ज़न की जानकारी दी गई है, तो Search Ads 360 हर कन्वर्ज़न को अपलोड करने की पूरी कोशिश करता है. इसके बजाय, वह पूरे बैच को एक साथ अपलोड नहीं करता. अगर किसी बैच में कुछ कन्वर्ज़न अपलोड नहीं हो पाते हैं, तो हो सकता है कि अन्य कन्वर्ज़न अपलोड हो जाएं. अमान्य अनुरोध या कुछ समय के लिए नेटवर्क या सिस्टम में आई गड़बड़ियों की वजह से, कन्वर्ज़न अपलोड नहीं हो पाते. इसलिए, हमारा सुझाव है कि आप हर डाले गए कन्वर्ज़न के लिए जवाब पढ़ें, ताकि यह पक्का किया जा सके कि अपलोड पूरा हो गया है.
अपलोड किए गए डेटा का इस्तेमाल कब किया जा सकेगा?
अगर किसी कन्वर्ज़न के लिए आज या बीते हुए कल का
conversionTimestamp तय किया जाता है, तो कन्वर्ज़न की मेट्रिक, अपलोड करने के एक घंटे में Search Ads 360 के यूज़र इंटरफ़ेस (यूआई) पर दिखेंगी. अगर आपने ऐसा conversionTimestamp डाला है जो बीते हुए कल से पहले का है, तो मेट्रिक कुछ घंटों में अपडेट हो जाएंगी.
कन्वर्ज़न के सभी टाइमस्टैंप को Epoch टाइम में बदलें. इसे यूनिक्स टाइम भी कहा जाता है.
क्या एपीआई से Floodlight गतिविधियां बनाई जा सकती हैं?
अगर विज्ञापन देने वाले व्यक्ति या कंपनी ने ऑफ़लाइन कन्वर्ज़न ट्रैक करने के लिए, अब तक कोई Floodlight गतिविधि नहीं बनाई है, तो Campaign Manager API का इस्तेमाल करके, Floodlight गतिविधि बनाई जा सकती है. एपीआई का इस्तेमाल करके यह नहीं बताया जा सकता कि Floodlight गतिविधि का इस्तेमाल मुख्य रूप से ऑफ़लाइन कन्वर्ज़न के लिए किया जाता है. यह सबसे सही तरीका है, जब बिडिंग की रणनीतियां कन्वर्ज़न के डेटा का इस्तेमाल करेंगी.
हमारा सुझाव है कि Floodlight गतिविधि बनाने के लिए एपीआई का इस्तेमाल करने के बाद, Search Ads 360 का कोई उपयोगकर्ता Search Ads 360 में साइन इन करे और गतिविधि की सेटिंग को बदलकर यह बताए कि कन्वर्ज़न का मुख्य सोर्स, ऑफ़लाइन गतिविधि है.
कन्वर्ज़न जोड़ने के सबसे सही तरीके
कन्वर्ज़न जोड़ने के लिए, हम आपको ये सबसे सही तरीके अपनाने का सुझाव देते हैं:
Search Ads 360 के किसी उपयोगकर्ता से, Search Ads 360 में साइन इन करने और हर उस Floodlight गतिविधि की सेटिंग बदलने के लिए कहें जिसका इस्तेमाल करके ऑफ़लाइन कन्वर्ज़न को रिपोर्ट किया जाता है. सेटिंग से यह पता चलना चाहिए कि कन्वर्ज़न का मुख्य सोर्स, ऑफ़लाइन गतिविधि है. निर्देशों के लिए, Search Ads 360 सहायता केंद्र पर जाएं.
कन्वर्ज़न उपलब्ध होते ही उन्हें अपलोड करें. अगर कन्वर्ज़न को किसी खास विज़िट को एट्रिब्यूट किया जा रहा है, तो कन्वर्ज़न अपलोड करने से पहले, विज़िट के बाद कम से कम छह घंटे इंतज़ार करें. अगर विज़िट के छह घंटे के अंदर अपलोड किया जाता है, तो हो सकता है कि Search Ads 360, विज़िट के clickID की पहचान न कर पाए. कुछ मामलों में, Search Ads 360 को clickId की पहचान करने में 24 घंटे लग सकते हैं.
पक्का करें कि हर अपलोड में सबसे हाल ही के कन्वर्ज़न शामिल हों. अपलोड करने के एक अनुरोध में, अगर एंट्री समय के हिसाब से क्रम में नहीं हैं, तो कोई बात नहीं. हालांकि, ऐसा हो सकता है कि बिडिंग की रणनीति, उन पुराने कन्वर्ज़न को ध्यान में न रखे जिन्हें आपने बाद में किसी दूसरे अनुरोध में अपलोड किया है.
इंसर्ट करने का अनुरोध भेजना
इनमें से कोई भी काम करने के लिए, 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 के क्लिक आईडी जनरेट करने के बाद, कम से कम छह घंटे इंतज़ार करें. अगर आपको "क्लिक आईडी नहीं मिला" गड़बड़ी मिलती है, तो 24 घंटे इंतज़ार करें. इसके बाद, कन्वर्ज़न फिर से अपलोड करें. सभी कन्वर्ज़न, क्लिक आईडी जनरेट होने के 90 दिनों के अंदर अपलोड किए जाने चाहिए. ऐसा न होने पर, हो सकता है कि Search Ads 360 API, विज़िट की पहचान न कर पाए.conversionId: ऑफ़लाइन कन्वर्ज़न के लिए, विज्ञापन देने वाले लोग या कंपनियां यह आईडी उपलब्ध कराती हैं. विज्ञापन देने वाले लोग या कंपनियां, अपनी पसंद का कोई भी आईडी डाल सकती हैं. अनुरोध में मौजूद हर कन्वर्ज़न के लिए, एक यूनीक आईडी होना चाहिए. साथ ही, विज्ञापन देने वाले व्यक्ति या कंपनी के सभी कन्वर्ज़न के लिए, आईडी और टाइमस्टैंप का कॉम्बिनेशन यूनीक होना चाहिए. ऑनलाइन कन्वर्ज़न के लिए, Search Ads 360 इस प्रॉपर्टी मेंdsConversionIdयाfloodlightOrderIdको कॉपी करता है. यह विज्ञापन देने वाले व्यक्ति या कंपनी के Floodlight निर्देशों पर निर्भर करता है.conversionTimestamp: इससे कन्वर्ज़न होने की तारीख और समय का पता चलता है. उदाहरण के लिए, अगर कन्वर्ज़न शुक्रवार, 05 अगस्त, 2016 को सुबह 11:53:22 बजे ईस्टर्न डेलाइट सेविंग टाइम (जीएमटी -4:00) के हिसाब से होता है, तो टाइमस्टैंप को Epoch मिलीसेकंड में इस तरह डालें:1470412402000.segmentationType: इससे उस कन्वर्ज़न सिस्टम के टाइप के बारे में पता चलता है जिसमें कन्वर्ज़न अपलोड किया जा रहा है. फ़िलहाल, सिर्फ़ Floodlight कन्वर्ज़न इस्तेमाल किए जा सकते हैं. इसलिए,FLOODLIGHTको तय करने के लिए, यह फ़ील्ड हमेशा ज़रूरी होता है.segmentationName: Floodlight गतिविधि का वह नाम जिसका इस्तेमाल, विज्ञापन देने वाला व्यक्ति या कंपनी कन्वर्ज़न की रिपोर्ट करने के लिए कर रही है.अगर विज्ञापन देने वाले व्यक्ति या कंपनी के पास एक ही नाम वाली गतिविधियां हैं, तो सुझाई गई कार्रवाई यह है कि किसी एक गतिविधि का नाम बदलें. ऐसा तब हो सकता है, जब गतिविधियां अलग-अलग Floodlight ग्रुप से जुड़ी हों.
इसके अलावा,
segmentationNameफ़ील्ड में नाम डालने के बजाय,segmentationIdफ़ील्ड में Floodlight गतिविधि का आईडी डाला जा सकता है. उस आईडी का इस्तेमाल करें जिसे 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 के मुताबिक अक्षरों वाले (तीन वर्णों में) फ़ॉर्मैट का इस्तेमाल करें.
यह सिर्फ़ TRANSACTION कन्वर्ज़न के लिए लागू होता है.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 इस प्रॉपर्टी मेंdsConversionIdयाfloodlightOrderIdको कॉपी करता है. यह विज्ञापन देने वाले व्यक्ति या कंपनी के Floodlight निर्देशों पर निर्भर करता है.conversionTimestamp: इससे कन्वर्ज़न होने की तारीख और समय का पता चलता है. उदाहरण के लिए, अगर कन्वर्ज़न शुक्रवार, 05 अगस्त, 2016 को सुबह 11:53:22 बजे ईस्टर्न डेलाइट सेविंग टाइम (जीएमटी -4:00) के हिसाब से होता है, तो टाइमस्टैंप को Epoch मिलीसेकंड में इस तरह डालें:1470412402000.segmentationType: इससे उस कन्वर्ज़न सिस्टम के टाइप के बारे में पता चलता है जिसमें कन्वर्ज़न अपलोड किया जा रहा है. फ़िलहाल, सिर्फ़ Floodlight कन्वर्ज़न इस्तेमाल किए जा सकते हैं. इसलिए,FLOODLIGHTको तय करने के लिए, यह फ़ील्ड हमेशा ज़रूरी होता है.segmentationName: Floodlight गतिविधि का वह नाम जिसका इस्तेमाल, विज्ञापन देने वाला व्यक्ति या कंपनी कन्वर्ज़न की रिपोर्ट करने के लिए कर रही है.अगर विज्ञापन देने वाले व्यक्ति या कंपनी के पास एक ही नाम वाली गतिविधियां हैं, तो सुझाई गई कार्रवाई यह है कि किसी एक गतिविधि का नाम बदलें. ऐसा तब हो सकता है, जब गतिविधियां अलग-अलग Floodlight ग्रुप से जुड़ी हों.
इसके अलावा,
segmentationNameफ़ील्ड में नाम डालने के बजाय,segmentationIdफ़ील्ड में Floodlight गतिविधि का आईडी डाला जा सकता है. उस आईडी का इस्तेमाल करें जिसे 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 के मुताबिक अक्षरों वाले (तीन वर्णों में) फ़ॉर्मैट का इस्तेमाल करें.
यह सिर्फ़ TRANSACTION कन्वर्ज़न के लिए लागू होता है.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())
तीसरे पक्ष के एट्रिब्यूशन मॉडल से डेटा अपलोड करना
एट्रिब्यूशन मॉडल, कन्वर्ज़न पाथ में मौजूद सभी गतिविधियों के बीच कन्वर्ज़न का क्रेडिट बांटता है. उदाहरण के लिए, अगर कोई उपभोक्ता कन्वर्ज़न से पहले, पेड सर्च वाले किसी विज्ञापन, डिसप्ले विज्ञापन, और पेड सर्च वाले किसी दूसरे विज्ञापन पर क्लिक करता है, तो लीनियर एट्रिब्यूशन मॉडल हर क्लिक को कन्वर्ज़न क्रेडिट का 33% हिस्सा देगा.
Search Ads 360, एट्रिब्यूशन मॉडल उपलब्ध कराता है. हालांकि, अगर आपने क्लिक को क्रेडिट देने के लिए किसी तीसरे पक्ष की सेवा या खुद की तैयार की गई सेवा का इस्तेमाल किया है, तो तीसरे पक्ष के एट्रिब्यूशन डेटा को Search Ads 360 में अपलोड किया जा सकता है. साथ ही, इस डेटा का इस्तेमाल रिपोर्ट और Search Ads 360 की बिडिंग की रणनीतियों में किया जा सकता है.
शुरू करने से पहले
Campaign Manager में कस्टम एट्रिब्यूशन मॉडल बनाएं और उसे Search Ads 360 में इंपोर्ट करें. पक्का करें कि आपने मॉडल का नाम External एट्रिब्यूशन मॉडल रखा हो. इससे Search Ads 360 की सुविधाओं को यह पता चल जाता है कि आपके अपलोड किए गए कन्वर्ज़न डेटा पर एट्रिब्यूशन मॉडल लागू किया गया है. ज़्यादा जानें
ज़रूरी फ़ील्ड
किसी कन्वर्ज़न पर तीसरे पक्ष का एट्रिब्यूशन मॉडल लागू करने के लिए, अपने Conversion.insert() अनुरोध में ये सभी चीज़ें बताएं:
clickId: विज़िट का केस-सेंसिटिव क्लिक आईडी. क्लिक आईडी के लिए, विज्ञापन देने वाले व्यक्ति या कंपनी के वेब लॉग देखें या Search Ads 360 के नए वर्शन के Reporting API की मदद से, किसी दूसरे कन्वर्ज़न काconversion.click_idवापस पाएं. Search Ads 360, कन्वर्ज़न को उस कीवर्ड, विज्ञापन, और Search Ads 360 के अन्य ऑब्जेक्ट को एट्रिब्यूट करेगा जो विज़िट जनरेट करने के लिए ज़िम्मेदार थे.
Search Ads 360 से क्लिक आईडी जनरेट होने के बाद, उस आईडी के साथ कन्वर्ज़न अपलोड करने से पहले, कम से कम 30 मिनट इंतज़ार करें. ऐसा न होने पर, हो सकता है कि Search Ads 360 API, विज़िट की पहचान न कर पाए.attributionModel: External Attribution Model पर सेट करें. ज़्यादा जानेंcountMillis: इस क्लिक को दिया जाने वाला कन्वर्ज़न क्रेडिट. यह सिर्फ़ तब लागू होता है, जब अनुरोध मेंattributionModelफ़ील्ड भी शामिल हो.इसे
quantityMillisके साथ न मिलाएं. यह एक वैकल्पिक फ़ील्ड है, जो कन्वर्ज़न में आइटम की संख्या बताता है. जैसे, शॉपिंग कार्ट में खरीदारी के लिए मौजूद आइटम की संख्या.conversionId: ऑफ़लाइन कन्वर्ज़न के लिए, विज्ञापन देने वाले लोग या कंपनियां यह आईडी उपलब्ध कराती हैं. विज्ञापन देने वाले लोग या कंपनियां, अपनी पसंद का कोई भी आईडी डाल सकती हैं. अनुरोध में मौजूद हर कन्वर्ज़न के लिए, एक यूनीक आईडी होना चाहिए. साथ ही, विज्ञापन देने वाले व्यक्ति या कंपनी के सभी कन्वर्ज़न के लिए, आईडी और टाइमस्टैंप का कॉम्बिनेशन यूनीक होना चाहिए. ऑनलाइन कन्वर्ज़न के लिए, Search Ads 360 इस प्रॉपर्टी मेंdsConversionIdयाfloodlightOrderIdको कॉपी करता है. यह विज्ञापन देने वाले व्यक्ति या कंपनी के Floodlight निर्देशों पर निर्भर करता है.conversionTimestamp: इससे कन्वर्ज़न होने की तारीख और समय का पता चलता है. उदाहरण के लिए, अगर कन्वर्ज़न शुक्रवार, 05 अगस्त, 2016 को सुबह 11:53:22 बजे ईस्टर्न डेलाइट सेविंग टाइम (जीएमटी -4:00) के हिसाब से होता है, तो टाइमस्टैंप को Epoch मिलीसेकंड में इस तरह डालें:1470412402000.segmentationType: इससे उस कन्वर्ज़न सिस्टम के टाइप के बारे में पता चलता है जिसमें कन्वर्ज़न अपलोड किया जा रहा है. फ़िलहाल, सिर्फ़ Floodlight कन्वर्ज़न इस्तेमाल किए जा सकते हैं. इसलिए,FLOODLIGHTको तय करने के लिए, यह फ़ील्ड हमेशा ज़रूरी होता है.segmentationName: Floodlight गतिविधि का वह नाम जिसका इस्तेमाल, विज्ञापन देने वाला व्यक्ति या कंपनी कन्वर्ज़न की रिपोर्ट करने के लिए कर रही है.अगर विज्ञापन देने वाले व्यक्ति या कंपनी के पास एक ही नाम वाली गतिविधियां हैं, तो सुझाई गई कार्रवाई यह है कि किसी एक गतिविधि का नाम बदलें. ऐसा तब हो सकता है, जब गतिविधियां अलग-अलग Floodlight ग्रुप से जुड़ी हों.
इसके अलावा,
segmentationNameफ़ील्ड में नाम डालने के बजाय,segmentationIdफ़ील्ड में Floodlight गतिविधि का आईडी डाला जा सकता है. उस आईडी का इस्तेमाल करें जिसे 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: कन्वर्ज़न की मॉनेटरी वैल्यू.
अगर आपको कन्वर्ज़न से मिलने वाले रेवेन्यू को ट्रैक करना है, तो पक्का करें कि आपका मॉडल, कन्वर्ज़न पाथ के हर टचपॉइंट पर रेवेन्यू को बांटता हो.उदाहरण के लिए, अगर आपका मॉडल लीनियर तरीके का इस्तेमाल करता है (हर टच पॉइंट पर रेवेन्यू को बराबर बांटना), तो कन्वर्ज़न पाथ में शामिल तीन विज्ञापन पर क्लिक में से हर क्लिक को कन्वर्ज़न का 33% एट्रिब्यूट किया जाएगा. अगर कन्वर्ज़न से 100 डॉलर का रेवेन्यू मिला है, तो पक्का करें कि आपका मॉडल हर क्लिक को 33 डॉलर का रेवेन्यू डिस्ट्रिब्यूट करे. साथ ही, पक्का करें कि revenueMicros हर क्लिक के लिए सिर्फ़ 33 डॉलर का रेवेन्यू दिखाए.
ये फ़ील्ड ज़रूरी नहीं हैं
quantityMillis: इस कन्वर्ज़न में मौजूद आइटम की संख्या. उदाहरण के लिए, ईमेल न्यूज़लेटर के लिए साइन अप करने वाले लोगों की संख्या या बेचे गए आइटम की कुल संख्या. अगर ACTION कन्वर्ज़न के लिए इस फ़ील्ड में कोई वैल्यू नहीं डाली जाती है, तो Search Ads 360 अपने-आप1000वैल्यू डाल देता है.currencyCode: लेन-देन से मिले रेवेन्यू की मुद्रा. डिफ़ॉल्ट रूप से, रेवेन्यू को विज्ञापन देने वाले की मुद्रा में माना जाता है. अगर आपने कोई दूसरी मुद्रा चुनी है, तो Search Ads 360, रेवेन्यू की रकम को विज्ञापन देने वाले व्यक्ति या कंपनी की मुद्रा में बदल देता है. ज़्यादा जानें
मुद्रा की जानकारी देने के लिए, ISO 4217 के मुताबिक अक्षरों वाले (तीन वर्णों में) फ़ॉर्मैट का इस्तेमाल करें.
यह सिर्फ़ TRANSACTION कन्वर्ज़न के लिए लागू होता है.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 से जुड़ी गड़बड़ियां
requestValidation गड़बड़ियों से, कन्वर्ज़न अपलोड करने के अनुरोध में डेटा से जुड़ी समस्याओं का पता चलता है. उदाहरण के लिए, कन्वर्ज़न पहले ही अपलोड हो चुका है या clickId नहीं मिला. इस तरह की गड़बड़ी में, मैसेज के ब्यौरे में दो आइटम होते हैं:
- एक हेक्साडेसिमल कोड, जिससे गड़बड़ी के टाइप का पता चलता है. गड़बड़ियों की पहचान करने के लिए, अपनी स्क्रिप्ट में कोड का इस्तेमाल किया जा सकता है.
- पुष्टि करने में हुई गड़बड़ी की जानकारी.
ज़्यादा जानकारी के लिए, कोड और ब्यौरों की सूची देखें. Search Ads 360, कन्वर्ज़न अपलोड करने से जुड़ी गड़बड़ियों के लिए, यह सूची दिखा सकता है.
अन्य तरह की गड़बड़ियां
अन्य सभी तरह की गड़बड़ियां (internalError, transactionFailed या lateStageRequestError) बताती हैं कि Search Ads 360 में कोई अंदरूनी समस्या है.
किसी गड़बड़ी का जवाब देना
अगर अनुरोध पूरा नहीं हो पाता है, तो बाद में पूरा अनुरोध फिर से सबमिट करें. Search Ads 360, पहले से अपलोड किए गए किसी भी कन्वर्ज़न के लिए, requestValidation गड़बड़ियों की रिपोर्ट करेगा. हालांकि, यह बाकी कन्वर्ज़न अपलोड करने की कोशिश करेगा.
अगर फिर से सबमिट करने के बाद भी गड़बड़ियां दिखती हैं, तो आगे बढ़ने का तरीका जानने के लिए, समस्या हल करना सेक्शन देखें.