नए कन्वर्ज़न जोड़ें

एक या उससे ज़्यादा कन्वर्ज़न जोड़ने के लिए, 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 गतिविधि बनाने के लिए एपीआई का इस्तेमाल करने के बाद, Search Ads 360 का उपयोगकर्ता Search Ads 360 में साइन इन करें और गतिविधि की सेटिंग में बदलाव करके, यह दिखाएं कि कन्वर्ज़न का मुख्य सोर्स ऑफ़लाइन गतिविधि है.

कन्वर्ज़न जोड़ने के सबसे सही तरीके

कन्वर्ज़न जोड़ने के लिए, हम आपको इन सबसे सही तरीकों का सुझाव देते हैं:

  1. Search Ads 360 के उपयोगकर्ता को Search Ads 360 में साइन इन करने के लिए कहें. इसके बाद, हर उस Floodlight गतिविधि की सेटिंग बदलें जिसका इस्तेमाल ऑफ़लाइन कन्वर्ज़न को रिपोर्ट करने के लिए किया जाता है. सेटिंग से यह पता चलना चाहिए कि ऑफ़लाइन गतिविधि, कन्वर्ज़न का मुख्य सोर्स है. निर्देशों के लिए, Search Ads 360 के सहायता केंद्र पर जाएं.

  2. कन्वर्ज़न उपलब्ध होते ही अपलोड करें. अगर खास विज़िट के लिए कन्वर्ज़न एट्रिब्यूट किया जा रहा है, तो कन्वर्ज़न अपलोड करने से पहले, विज़िट के बाद 30 मिनट तक इंतज़ार करें. अगर विज़िट के 30 मिनट से पहले अपलोड किया जाता है, तो हो सकता है कि Search Ads 360, विज़िट के क्लिक आईडी की पहचान न कर पाए. बहुत कम मामलों में ऐसा होता है कि Search Ads 360, clickId की पहचान कर सके, इसके लिए आपको चार घंटे तक इंतज़ार करना पड़ सकता है.

    पक्का करें कि हर अपलोड में सबसे हाल ही के कन्वर्ज़न शामिल हों. अपलोड करने के एक ही अनुरोध में, सबमिट किया गया एंट्री समय के हिसाब से सही नहीं है. हालांकि, बिडिंग की रणनीति, बाद में किसी दूसरे अनुरोध में अपलोड किए गए पुराने कन्वर्ज़न को शामिल नहीं कर सकती.

  3. अगर किसी Floodlight गतिविधि के लिए कन्वर्ज़न अपलोड करने से पहले, आपको 24 घंटे से ज़्यादा इंतज़ार करना पड़ता है, तो उपलब्धता का टाइमस्टैंप भेजें.

    उपलब्धता का टाइमस्टैंप इनमें से कोई एक होना चाहिए:

    • अगर आपने पिछले 24 घंटों के दौरान कन्वर्ज़न रिकॉर्ड किए हैं, लेकिन उन्हें अब तक अपलोड नहीं किया है, तो टाइमस्टैंप पिछली बार अपलोड किए गए कन्वर्ज़न के समय का होना चाहिए. इससे Search Ads 360 को पता चलता है कि हो सकता है कि पिछले 24 घंटों में कन्वर्ज़न हुए हों, लेकिन आपने अब तक डेटा न दिया हो. बिडिंग की रणनीतियां और अन्य ऑटोमेटेड सिस्टम, परफ़ॉर्मेंस के इतिहास के आधार पर ही आपके अपलोड किए गए पिछले कन्वर्ज़न को ध्यान में रखेंगे.
    • अगर पिछले 24 घंटों में कोई कन्वर्ज़न नहीं हुआ है, तो टाइमस्टैंप मौजूदा समय और तारीख के तौर पर होना चाहिए. इससे Search Ads 360 को पता चलता है कि पिछले 24 घंटों में कोई कन्वर्ज़न नहीं हुआ है. बिडिंग की रणनीतियों और अन्य ऑटोमेटेड सिस्टम (कार्रवाइयों को अपने-आप पूरा करने वाले सिस्टम) में, पिछले 24 घंटों का डेटा शामिल होगा. इस पूरे दिन से कन्वर्ज़न नहीं हुए हैं. यह डेटा परफ़ॉर्मेंस के इतिहास में शामिल होता है.

शामिल करने का अनुरोध भेजें

इनमें से कोई भी काम करने के लिए, Conversion.insert() का अनुरोध भेजा जा सकता है:

  • कन्वर्ज़न को किसी खास विज़िट के लिए एट्रिब्यूट करें
  • कन्वर्ज़न का श्रेय सिर्फ़ कीवर्ड को दें

Conversion.insert() अनुरोध में ज़रूरी फ़ील्ड, उस इवेंट या आइटम पर निर्भर करते हैं जिसके लिए कन्वर्ज़न का क्रेडिट दिया जा रहा है. नीचे दिए गए सेक्शन में, हर उस इवेंट या आइटम के लिए ज़रूरी और वैकल्पिक फ़ील्ड की सूची दी गई है जिसे कन्वर्ज़न एट्रिब्यूट किया जा सकता है.

कन्वर्ज़न को किसी खास विज़िट के लिए एट्रिब्यूट करें

जब कोई ग्राहक एक या उससे ज़्यादा विज्ञापनों पर क्लिक करके, विज्ञापन देने वाली किसी कंपनी की साइट पर पहुंचता है, तो Search Ads 360, विज्ञापन देने वाले की साइट पर हुए उपयोगकर्ता सेशन को विज़िट मानता है. किसी विज़िट को कन्वर्ज़न एट्रिब्यूट करने के लिए, अपने Conversion.insert() अनुरोध में यह जानकारी दें:

ज़रूरी फ़ील्ड

  • clickId: विज़िट की केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) क्लिक आईडी. विज्ञापन देने वाले के वेब लॉग में क्लिक आईडी या कन्वर्ज़न की सूची बनाएं देखें और किसी दूसरे कन्वर्ज़न के क्लिक आईडी का इस्तेमाल करें. Search Ads 360, कन्वर्ज़न का क्रेडिट उन कीवर्ड, विज्ञापन, और Search Ads 360 के अन्य ऑब्जेक्ट को देगा जो विज़िट जनरेट करने के लिए ज़िम्मेदार थे.
    Search Ads 360 से क्लिक आईडी जनरेट होने के बाद, कन्वर्ज़न अपलोड करने के लिए कम से कम 30 मिनट इंतज़ार करें. अगर आपको "क्लिक आईडी नहीं मिला" गड़बड़ी मिलती है, तो चार घंटे इंतज़ार करें. इसके बाद, कन्वर्ज़न को फिर से अपलोड करें. सभी कन्वर्ज़न, क्लिक आईडी जनरेट होने के 90 दिनों के अंदर अपलोड कर दिए जाने चाहिए. ऐसा न करने पर, हो सकता है कि Search Ads 360 API, विज़िट की पहचान न कर पाए.
  • conversionId: ऑफ़लाइन कन्वर्ज़न के लिए, विज्ञापन देने वाले यह आईडी देते हैं. विज्ञापन देने वाले अपने लिए काम का कोई भी आईडी दे सकते हैं. अनुरोध में शामिल हर कन्वर्ज़न के लिए एक यूनीक आईडी तय करना ज़रूरी है. साथ ही, विज्ञापन देने वाले के सभी कन्वर्ज़न में आईडी और टाइमस्टैंप का कॉम्बिनेशन अलग-अलग होना चाहिए. ऑनलाइन कन्वर्ज़न के लिए Search Ads 360, विज्ञापन देने वाले के Floodlight निर्देशों के आधार पर dsConversionId या floodlightOrderId को इस प्रॉपर्टी में कॉपी करता है.
  • conversionTimestamp: कन्वर्ज़न की तारीख और समय दिखाता है. उदाहरण के लिए, अगर कन्वर्ज़न शुक्रवार, 5 अगस्त, 2016 को सुबह 11:53:22 बजे ईस्टर्न डेलाइट सेविंग टाइम (जीएमटी -4:00) को होता है, तो टाइमस्टैंप को Epoch मिलीसेकंड में बताएं: 1470412402000.
  • segmentationType: इससे उस कन्वर्ज़न सिस्टम का पता चलता है जिसमें कन्वर्ज़न अपलोड किया जा रहा है. फ़िलहाल, सिर्फ़ Floodlight कन्वर्ज़न डेटा काम करता है. इसलिए, FLOODLIGHT की जानकारी देना हमेशा ज़रूरी होता है.
  • segmentationName: उस Floodlight गतिविधि का नाम जिसका इस्तेमाल विज्ञापन देने वाला कन्वर्ज़न रिपोर्ट करने के लिए कर रहा है.

    अगर विज्ञापन देने वाले व्यक्ति या कंपनी में एक ही नाम वाली गतिविधियां हैं, तो ऐसा तब हो सकता है, जब वे गतिविधियां अलग-अलग Floodlight ग्रुप से जुड़ी हों. ऐसे में, आपको किसी एक ऐक्टिविटी का नाम बदलकर कार्रवाई करने का सुझाव दिया जाता है.

    इसके अलावा, अगर आपको पता है कि Search Ads 360 ने किसी Floodlight गतिविधि के लिए असाइन किया है, तो segmentationName फ़ील्ड में नाम डालने के बजाय, segmentationId में आईडी की जानकारी दी जा सकती है. (Campaign Manager, Floodlight गतिविधि के लिए भी एक आईडी असाइन करता है, लेकिन Campaign Manager आईडी, Search Ads 360 आईडी से अलग होता है. इसका इस्तेमाल कन्वर्ज़न को एट्रिब्यूट करने के लिए नहीं किया जा सकता.) किसी Floodlight गतिविधि के लिए Search Ads 360 आईडी देखने के लिए, कन्वर्ज़न रिपोर्ट डाउनलोड करें. (Search Ads 360 यूज़र इंटरफ़ेस (यूआई) से या Reporting API से). अगर रिपोर्ट की समयसीमा के दौरान, Floodlight गतिविधि के लिए कम से कम एक कन्वर्ज़न को एट्रिब्यूट किया गया है, तो आपको रिपोर्ट में Search Ads 360 आईडी दिखेगा.

  • type: कन्वर्ज़न का टाइप, यानी कि ACTION या TRANSACTION. ACTION कन्वर्ज़न में कोई मॉनेटरी वैल्यू नहीं होती, जबकि पेमेंट वाले कन्वर्ज़न में कोई मॉनेटरी वैल्यू नहीं होती. ईमेल सूची में साइन अप (कार्रवाई) बनाम ई-कॉमर्स खरीदारी (लेन-देन) के उदाहरण.

    अगर TRANSACTION का इस्तेमाल किया जाता है, तो आपको नीचे दिए गए फ़ील्ड के बारे में भी बताना होगा:

    • revenueMicros: कन्वर्ज़न की मॉनेटरी वैल्यू.

वैकल्पिक फ़ील्ड

  • quantityMillis: इस कन्वर्ज़न में आइटम की संख्या. उदाहरण के लिए, ईमेल न्यूज़लेटर के लिए साइन अप करने वाले लोगों की संख्या या बेचे गए आइटम की कुल संख्या. अगर ACTION कन्वर्ज़न के लिए इस फ़ील्ड की जानकारी नहीं दी जाती है, तो Search Ads 360 अपने-आप 1000 की वैल्यू डाल देता है.
  • currencyCode: लेन-देन से मिलने वाले रेवेन्यू की मुद्रा. डिफ़ॉल्ट रूप से, रेवेन्यू को विज्ञापन देने वाले की मुद्रा में माना जाता है. अगर किसी दूसरी मुद्रा की जानकारी दी जाती है, तो Search Ads 360, तय की गई आय की रकम को विज्ञापन देने वाले की मुद्रा में बदल देता है. ज़्यादा जानें
    मुद्रा की जानकारी देने के लिए, ISO 4217 अक्षर (3-वर्ण) फ़ॉर्मैट का इस्तेमाल करें.
    सिर्फ़ 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 के ज़्यादातर आइडेंटिफ़ायर को हटाकर, सिर्फ़ कुछ अन्य फ़ील्ड के साथ कीवर्ड के आइडेंटिफ़ायर की जानकारी दें:

ज़रूरी फ़ील्ड

  • criterionId: यह कीवर्ड आइडेंटिफ़ायर है. अपने लैंडिंग पेज यूआरएल में TrackerId मैक्रो जोड़कर, criterionId पाया जा सकता है. कीवर्ड आईडी पाने के बारे में जानकारी के लिए, Search Ads 360 आईडी और कन्वर्ज़न देखें.
  • conversionId: ऑफ़लाइन कन्वर्ज़न के लिए, विज्ञापन देने वाले यह आईडी देते हैं. विज्ञापन देने वाले अपने लिए काम का कोई भी आईडी दे सकते हैं. अनुरोध में शामिल हर कन्वर्ज़न के लिए एक यूनीक आईडी तय करना ज़रूरी है. साथ ही, विज्ञापन देने वाले के सभी कन्वर्ज़न में आईडी और टाइमस्टैंप का कॉम्बिनेशन अलग-अलग होना चाहिए. ऑनलाइन कन्वर्ज़न के लिए Search Ads 360, विज्ञापन देने वाले के Floodlight निर्देशों के आधार पर dsConversionId या floodlightOrderId को इस प्रॉपर्टी में कॉपी करता है.
  • conversionTimestamp: कन्वर्ज़न की तारीख और समय दिखाता है. उदाहरण के लिए, अगर कन्वर्ज़न शुक्रवार, 5 अगस्त, 2016 को सुबह 11:53:22 बजे ईस्टर्न डेलाइट सेविंग टाइम (जीएमटी -4:00) को होता है, तो टाइमस्टैंप को Epoch मिलीसेकंड में बताएं: 1470412402000.
  • segmentationType: इससे उस कन्वर्ज़न सिस्टम का पता चलता है जिसमें कन्वर्ज़न अपलोड किया जा रहा है. फ़िलहाल, सिर्फ़ Floodlight कन्वर्ज़न डेटा काम करता है. इसलिए, FLOODLIGHT की जानकारी देना हमेशा ज़रूरी होता है.
  • segmentationName: उस Floodlight गतिविधि का नाम जिसका इस्तेमाल विज्ञापन देने वाला कन्वर्ज़न रिपोर्ट करने के लिए कर रहा है.

    अगर विज्ञापन देने वाले व्यक्ति या कंपनी में एक ही नाम वाली गतिविधियां हैं, तो ऐसा तब हो सकता है, जब वे गतिविधियां अलग-अलग Floodlight ग्रुप से जुड़ी हों. ऐसे में, आपको किसी एक ऐक्टिविटी का नाम बदलकर कार्रवाई करने का सुझाव दिया जाता है.

    इसके अलावा, अगर आपको पता है कि Search Ads 360 ने किसी Floodlight गतिविधि के लिए असाइन किया है, तो segmentationName फ़ील्ड में नाम डालने के बजाय, segmentationId में आईडी की जानकारी दी जा सकती है. (Campaign Manager, Floodlight गतिविधि के लिए भी एक आईडी असाइन करता है, लेकिन Campaign Manager आईडी, Search Ads 360 आईडी से अलग होता है. इसका इस्तेमाल कन्वर्ज़न को एट्रिब्यूट करने के लिए नहीं किया जा सकता.) किसी Floodlight गतिविधि के लिए Search Ads 360 आईडी देखने के लिए, कन्वर्ज़न रिपोर्ट डाउनलोड करें. (Search Ads 360 यूज़र इंटरफ़ेस (यूआई) से या Reporting API से). अगर रिपोर्ट की समयसीमा के दौरान, Floodlight गतिविधि के लिए कम से कम एक कन्वर्ज़न को एट्रिब्यूट किया गया है, तो आपको रिपोर्ट में Search Ads 360 आईडी दिखेगा.

  • type: कन्वर्ज़न का टाइप, यानी कि ACTION या TRANSACTION. ACTION कन्वर्ज़न में कोई मॉनेटरी वैल्यू नहीं होती, जबकि पेमेंट वाले कन्वर्ज़न में कोई मॉनेटरी वैल्यू नहीं होती. ईमेल सूची में साइन अप (कार्रवाई) बनाम ई-कॉमर्स खरीदारी (लेन-देन) के उदाहरण.

    अगर TRANSACTION का इस्तेमाल किया जाता है, तो आपको नीचे दिए गए फ़ील्ड के बारे में भी बताना होगा:

    • revenueMicros: कन्वर्ज़न की मॉनेटरी वैल्यू.

वैकल्पिक फ़ील्ड

  • quantityMillis: इस कन्वर्ज़न में आइटम की संख्या. उदाहरण के लिए, ईमेल न्यूज़लेटर के लिए साइन अप करने वाले लोगों की संख्या या बेचे गए आइटम की कुल संख्या. अगर ACTION कन्वर्ज़न के लिए इस फ़ील्ड की जानकारी नहीं दी जाती है, तो Search Ads 360 अपने-आप 1000 की वैल्यू डाल देता है.
  • currencyCode: लेन-देन से मिलने वाले रेवेन्यू की मुद्रा. डिफ़ॉल्ट रूप से, रेवेन्यू को विज्ञापन देने वाले की मुद्रा में माना जाता है. अगर किसी दूसरी मुद्रा की जानकारी दी जाती है, तो Search Ads 360, तय की गई आय की रकम को विज्ञापन देने वाले की मुद्रा में बदल देता है. ज़्यादा जानें
    मुद्रा की जानकारी देने के लिए, ISO 4217 अक्षर (3-वर्ण) फ़ॉर्मैट का इस्तेमाल करें.
    सिर्फ़ 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" : [{
    "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"
  }]
}

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,
      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;
  }

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': [{
              '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 एट्रिब्यूशन मॉडल उपलब्ध कराता है. हालांकि, क्लिक को क्रेडिट देने के लिए किसी तीसरे पक्ष की सेवा या डेवलप की गई किसी सेवा का इस्तेमाल करने पर, Search Ads 360 में तीसरे पक्ष के एट्रिब्यूशन डेटा को अपलोड किया जा सकता है. साथ ही, इस डेटा का इस्तेमाल रिपोर्ट और Search Ads 360 की बिडिंग की रणनीतियों में किया जा सकता है.

शुरू करने से पहले

Campaign Manager में, कस्टम एट्रिब्यूशन मॉडल बनाएं और मॉडल को Search Ads 360 में इंपोर्ट करें. पक्का करें कि आपने मॉडल को बाहरी एट्रिब्यूशन मॉडल का नाम दिया है. यह Search Ads 360 की सुविधाओं को चालू करके यह पता लगाता है कि जो कन्वर्ज़न डेटा अपलोड किया गया है उस पर एट्रिब्यूशन मॉडल लागू किया गया है. ज़्यादा जानें

ज़रूरी फ़ील्ड

किसी कन्वर्ज़न में तीसरे पक्ष का एट्रिब्यूशन मॉडल लागू करने के लिए, अपने Conversion.insert() अनुरोध में यह जानकारी दें:

  • clickId: विज़िट की केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) क्लिक आईडी. विज्ञापन देने वाले के वेब लॉग में क्लिक आईडी या कन्वर्ज़न की सूची बनाएं देखें और किसी दूसरे कन्वर्ज़न के क्लिक आईडी का इस्तेमाल करें. Search Ads 360, कन्वर्ज़न का क्रेडिट उन कीवर्ड, विज्ञापन, और Search Ads 360 के अन्य ऑब्जेक्ट को देगा जो विज़िट जनरेट करने के लिए ज़िम्मेदार थे.
    Search Ads 360 के क्लिक आईडी जनरेट करने के बाद, आईडी की मदद से कन्वर्ज़न अपलोड करने से पहले, कम से कम 30 मिनट इंतज़ार करें. ऐसा न करने पर, हो सकता है कि Search Ads 360 API, विज़िट की पहचान न कर पाए.
  • attributionModel: बाहरी एट्रिब्यूशन मॉडल पर सेट करें. ज़्यादा जानें
  • countMillis: इस क्लिक को बांटने के लिए कन्वर्ज़न क्रेडिट की रकम. यह सिर्फ़ तब लागू होता है, जब अनुरोध में attributionModel फ़ील्ड भी शामिल हो.

    इसे quantityMillis से भ्रम में न डालें. यह एक वैकल्पिक फ़ील्ड है, जो कन्वर्ज़न में आइटम की संख्या बताता है (जैसे, शॉपिंग कार्ट से खरीदे गए आइटम की संख्या).

  • conversionId: ऑफ़लाइन कन्वर्ज़न के लिए, विज्ञापन देने वाले यह आईडी देते हैं. विज्ञापन देने वाले अपने लिए काम का कोई भी आईडी दे सकते हैं. अनुरोध में शामिल हर कन्वर्ज़न के लिए एक यूनीक आईडी तय करना ज़रूरी है. साथ ही, विज्ञापन देने वाले के सभी कन्वर्ज़न में आईडी और टाइमस्टैंप का कॉम्बिनेशन अलग-अलग होना चाहिए. ऑनलाइन कन्वर्ज़न के लिए Search Ads 360, विज्ञापन देने वाले के Floodlight निर्देशों के आधार पर dsConversionId या floodlightOrderId को इस प्रॉपर्टी में कॉपी करता है.
  • conversionTimestamp: कन्वर्ज़न की तारीख और समय दिखाता है. उदाहरण के लिए, अगर कन्वर्ज़न शुक्रवार, 5 अगस्त, 2016 को सुबह 11:53:22 बजे ईस्टर्न डेलाइट सेविंग टाइम (जीएमटी -4:00) को होता है, तो टाइमस्टैंप को Epoch मिलीसेकंड में बताएं: 1470412402000.
  • segmentationType: इससे उस कन्वर्ज़न सिस्टम का पता चलता है जिसमें कन्वर्ज़न अपलोड किया जा रहा है. फ़िलहाल, सिर्फ़ Floodlight कन्वर्ज़न डेटा काम करता है. इसलिए, FLOODLIGHT की जानकारी देना हमेशा ज़रूरी होता है.
  • segmentationName: उस Floodlight गतिविधि का नाम जिसका इस्तेमाल विज्ञापन देने वाला कन्वर्ज़न रिपोर्ट करने के लिए कर रहा है.

    अगर विज्ञापन देने वाले व्यक्ति या कंपनी में एक ही नाम वाली गतिविधियां हैं, तो ऐसा तब हो सकता है, जब वे गतिविधियां अलग-अलग Floodlight ग्रुप से जुड़ी हों. ऐसे में, आपको किसी एक ऐक्टिविटी का नाम बदलकर कार्रवाई करने का सुझाव दिया जाता है.

    इसके अलावा, अगर आपको पता है कि Search Ads 360 ने किसी Floodlight गतिविधि के लिए असाइन किया है, तो segmentationName फ़ील्ड में नाम डालने के बजाय, segmentationId में आईडी की जानकारी दी जा सकती है. (Campaign Manager, Floodlight गतिविधि के लिए भी एक आईडी असाइन करता है, लेकिन Campaign Manager आईडी, Search Ads 360 आईडी से अलग होता है. इसका इस्तेमाल कन्वर्ज़न को एट्रिब्यूट करने के लिए नहीं किया जा सकता.) किसी Floodlight गतिविधि के लिए Search Ads 360 आईडी देखने के लिए, कन्वर्ज़न रिपोर्ट डाउनलोड करें. (Search Ads 360 यूज़र इंटरफ़ेस (यूआई) से या Reporting API से). अगर रिपोर्ट की समयसीमा के दौरान, Floodlight गतिविधि के लिए कम से कम एक कन्वर्ज़न को एट्रिब्यूट किया गया है, तो आपको रिपोर्ट में Search Ads 360 आईडी दिखेगा.

  • type: कन्वर्ज़न का टाइप, यानी कि ACTION या TRANSACTION. ACTION कन्वर्ज़न में कोई मॉनेटरी वैल्यू नहीं होती, जबकि पेमेंट वाले कन्वर्ज़न में कोई मॉनेटरी वैल्यू नहीं होती. ईमेल सूची में साइन अप (कार्रवाई) बनाम ई-कॉमर्स खरीदारी (लेन-देन) के उदाहरण.

    अगर TRANSACTION का इस्तेमाल किया जाता है, तो आपको नीचे दिए गए फ़ील्ड के बारे में भी बताना होगा:

    • revenueMicros: कन्वर्ज़न की मॉनेटरी वैल्यू.

अगर कन्वर्ज़न से मिलने वाला रेवेन्यू ट्रैक किया जाता है, तो पक्का करें कि आपका मॉडल, कन्वर्ज़न पाथ के हर टच पॉइंट के बीच रेवेन्यू बांटें.उदाहरण के लिए, अगर आपका मॉडल लीनियर तरीके का इस्तेमाल करता है (हर टच पॉइंट पर रेवेन्यू के बंटवारे के बराबर), तो किसी ऐसे कन्वर्ज़न पाथ में जिसमें तीन विज्ञापन क्लिक शामिल हैं, हर क्लिक को कन्वर्ज़न का 33% क्रेडिट दिया जाएगा. अगर कन्वर्ज़न से 100 डॉलर की आय हुई है, तो पक्का करें कि आपका मॉडल हर क्लिक के लिए 33 डॉलर का रेवेन्यू बांटता हो. साथ ही, पक्का करें कि revenueMicros में हर क्लिक के लिए सिर्फ़ 33 डॉलर की आय बताई गई हो.

वैकल्पिक फ़ील्ड

  • quantityMillis: इस कन्वर्ज़न में आइटम की संख्या. उदाहरण के लिए, ईमेल न्यूज़लेटर के लिए साइन अप करने वाले लोगों की संख्या या बेचे गए आइटम की कुल संख्या. अगर ACTION कन्वर्ज़न के लिए इस फ़ील्ड की जानकारी नहीं दी जाती है, तो Search Ads 360 अपने-आप 1000 की वैल्यू डाल देता है.
  • currencyCode: लेन-देन से मिलने वाले रेवेन्यू की मुद्रा. डिफ़ॉल्ट रूप से, रेवेन्यू को विज्ञापन देने वाले की मुद्रा में माना जाता है. अगर किसी दूसरी मुद्रा की जानकारी दी जाती है, तो Search Ads 360, तय की गई आय की रकम को विज्ञापन देने वाले की मुद्रा में बदल देता है. ज़्यादा जानें
    मुद्रा की जानकारी देने के लिए, ISO 4217 अक्षर (3-वर्ण) फ़ॉर्मैट का इस्तेमाल करें.
    सिर्फ़ 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 का पूरा अंदरूनी प्रतिनिधित्व शामिल होता है. जैसे, कैंपेन आईडी, विज्ञापन ग्रुप आईडी, और कीवर्ड (शर्त) आईडी.

{
 "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, requestValidation, requestValidation या requestValidation शामिल हो सकते हैं.

अनुरोध की पुष्टि से जुड़ी गड़बड़ियां

requestValidation गड़बड़ियों से यह पता चलता है कि कन्वर्ज़न अपलोड करने के अनुरोध में डेटा से जुड़ी समस्याएं मौजूद हैं. उदाहरण के लिए, कन्वर्ज़न पहले ही अपलोड किया जा चुका है या clickId नहीं मिला. इस तरह की गड़बड़ी में, मैसेज की जानकारी में दो आइटम होते हैं:

  • यह एक हेक्साडेसिमल कोड होता है, जो गड़बड़ी के टाइप का पता लगाता है. अपनी स्क्रिप्ट में मौजूद कोड का इस्तेमाल करके, गड़बड़ियों की पहचान की जा सकती है.
  • पुष्टि करने में हुई गड़बड़ी के बारे में जानकारी.

ज़्यादा जानकारी के लिए, उन कोड और ब्यौरे की सूची देखें जिन्हें Search Ads 360, कन्वर्ज़न अपलोड करने में हुई गड़बड़ियों के लिए दिखा सकता है.

दूसरी तरह की गड़बड़ियां

अन्य सभी तरह की गड़बड़ियों (internalError, transactionFailed, या lateStageRequestError) से पता चलता है कि Search Ads 360 में कोई अंदरूनी समस्या है.

किसी गड़बड़ी का जवाब देना

अगर अनुरोध पूरा नहीं होता है, तो पूरे अनुरोध कॉल को बाद में फिर से सबमिट करने की कोशिश करें. Search Ads 360 पहले से अपलोड किए गए किसी भी कन्वर्ज़न के लिए, requestValidation गड़बड़ियों को रिपोर्ट करेगा. हालांकि, यह बाकी कन्वर्ज़न अपलोड करने की कोशिश करेगा.

अगर फिर से अनुरोध सबमिट करने के बाद भी आपको गड़बड़ियां दिखती हैं, तो आगे की कार्रवाई के बारे में जानने के लिए, समस्या का हल सेक्शन देखें.