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

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

पुराने कन्वर्ज़न अपलोड करने से जुड़ी पाबंदियों के बारे में जानकारी, Search Ads 360 के सहायता केंद्र पर मिल सकती है.

अगर आपके Conversion.insert() अनुरोध में एक से ज़्यादा कन्वर्ज़न शामिल हैं, तो Search Ads 360 पूरे बैच को 'सभी या कुछ भी नहीं' लेन-देन के तौर पर अपलोड करने के बजाय, हर कन्वर्ज़न को अपलोड करने की पूरी कोशिश करता है. अगर किसी बैच में कुछ कन्वर्ज़न अपलोड नहीं हो पाते, तो हो सकता है कि बाकी कन्वर्ज़न अपलोड हो जाएं. अमान्य अनुरोध या नेटवर्क या सिस्टम में कुछ समय के लिए हुई गड़बड़ी की वजह से, कन्वर्ज़न अपलोड नहीं हो सकते. इसलिए, हमारा सुझाव है कि आप डाले गए हर कन्वर्ज़न के लिए जवाब पढ़ें, ताकि यह पक्का किया जा सके कि कन्वर्ज़न अपलोड हो गया है.

अपलोड किए गए डेटा का इस्तेमाल कब किया जा सकेगा?

अगर किसी कन्वर्ज़न के लिए आज या बीते हुए कल का conversionTimestamp तय किया जाता है, तो कन्वर्ज़न की मेट्रिक, अपलोड करने के एक घंटे में Search Ads 360 यूज़र इंटरफ़ेस (यूआई) में दिखेंगी. अगर आपने ऐसा conversionTimestamp डाला है जो बीते हुए कल से पहले का है, तो मेट्रिक कुछ घंटों में अपडेट हो जाएंगी.

कन्वर्ज़न के सभी टाइमस्टैंप को एपॉच टाइम (इसे Unix टाइम भी कहा जाता है) में बदलें.

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

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

डेटा डालने का अनुरोध भेजना

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

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

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

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

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

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

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

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

    TRANSACTION तय करने पर, आपको यह फ़ील्ड भी तय करना होगा:

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

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

  • quantityMillis: इस कन्वर्ज़न में मौजूद आइटम की संख्या. उदाहरण के लिए, ईमेल न्यूज़लेटर के लिए साइन अप करने वाले लोगों की संख्या या बेचे गए आइटम की कुल संख्या. अगर आपने ऐक्शन कन्वर्ज़न के लिए इस फ़ील्ड की जानकारी नहीं दी है, तो Search Ads 360 अपने-आप 1000 की वैल्यू डाल देता है.
  • currencyCode: लेन-देन से मिले रेवेन्यू की मुद्रा. डिफ़ॉल्ट रूप से, आय को विज्ञापन देने वाले की मुद्रा में माना जाता है. अगर आपने कोई दूसरी मुद्रा चुनी है, तो Search Ads 360 रेवेन्यू की बताई गई रकम को विज्ञापन देने वाले की मुद्रा में बदल देता है. ज़्यादा जानें
    मुद्रा बताने के लिए, ISO 4217 के मुताबिक अक्षरों वाले (तीन वर्णों में) फ़ॉर्मैट का इस्तेमाल करें.
    सिर्फ़ ट्रांज़ैक्शन कन्वर्ज़न के लिए लागू होता है.
  • 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: यह कीवर्ड आइडेंटिफ़ायर है. criterionId पाने के लिए, अपने लैंडिंग पेज के यूआरएल में TrackerId मैक्रो जोड़ें. कीवर्ड आईडी पाने के बारे में जानने के लिए, Search Ads 360 आईडी और कन्वर्ज़न देखें.
  • conversionId: ऑफ़लाइन कन्वर्ज़न के लिए, विज्ञापन देने वाले लोग या कंपनियां यह आईडी उपलब्ध कराती हैं. विज्ञापन देने वाले, अपनी पसंद का कोई भी आईडी डाल सकते हैं. अनुरोध में मौजूद हर कन्वर्ज़न के लिए एक यूनीक आईडी होना चाहिए. साथ ही, विज्ञापन देने वाले के सभी कन्वर्ज़न में आईडी और टाइमस्टैंप का कॉम्बिनेशन यूनीक होना चाहिए. ऑनलाइन कन्वर्ज़न के लिए, Search Ads 360 इस प्रॉपर्टी में dsConversionId या floodlightOrderId को कॉपी करता है. यह विज्ञापन देने वाले के Floodlight निर्देशों पर निर्भर करता है.
  • conversionTimestamp: इससे उस तारीख और समय का पता चलता है जब कन्वर्ज़न हुआ था. उदाहरण के लिए, अगर कन्वर्ज़न, शुक्रवार, 05 अगस्त, 2016 को सुबह 11:53:22 ईस्टर्न डेलाइट सेविंग टाइम (जीएमटी -4:00) को हुआ है, तो टाइमस्टैंप को इकोसिस्टम के हिसाब से मिलीसेकंड में बताएं: 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 यूज़र इंटरफ़ेस या रिपोर्टिंग एपीआई से डाउनलोड की जा सकती है. अगर रिपोर्ट की समयसीमा के दौरान, Floodlight गतिविधि को कम से कम एक कन्वर्ज़न एट्रिब्यूट किया गया है, तो आपको रिपोर्ट में Search Ads 360 आईडी दिखेगा.

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

    TRANSACTION तय करने पर, आपको यह फ़ील्ड भी तय करना होगा:

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

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

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

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

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

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

    TRANSACTION तय करने पर, आपको यह फ़ील्ड भी तय करना होगा:

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

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

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

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

requestValidation errors

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

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

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

अन्य तरह की गड़बड़ियां

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

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

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

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