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

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

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

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

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

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

कन्वर्ज़न के सभी टाइमस्टैंप को Epoch टाइम (इसे 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, विज़िट के clickID को पहचान न पाए. कुछ मामलों में, Search Ads 360 को clickId पहचानने में 24 घंटे लग सकते हैं.

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

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

इनमें से कोई भी काम करने के लिए, 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: इससे कन्वर्ज़न होने की तारीख और समय का पता चलता है. उदाहरण के लिए, अगर कन्वर्ज़न शुक्रवार, 5 अगस्त, 2016 को सुबह 11:53:22 बजे ईस्टर्न डेलाइट सेविंग टाइम (जीएमटी -4:00) पर होता है, तो टाइमस्टैंप को Epoch मिलीसेकंड में डालें: 1470412402000.
  • segmentationType: इससे यह पता चलता है कि कन्वर्ज़न को किस तरह के कन्वर्ज़न सिस्टम में अपलोड किया जा रहा है. फ़िलहाल, सिर्फ़ Floodlight कन्वर्ज़न इस्तेमाल किए जा सकते हैं. इसलिए, इस फ़ील्ड के लिए FLOODLIGHT की जानकारी देना हमेशा ज़रूरी होता है.
  • segmentationName: यह उस Floodlight गतिविधि का नाम है जिसका इस्तेमाल विज्ञापन देने वाला व्यक्ति या कंपनी, कन्वर्ज़न की रिपोर्ट करने के लिए कर रही है.

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

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

  • type: कन्वर्ज़न का टाइप. यह 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 के ज़्यादातर आइडेंटिफ़ायर हटाए जा सकते हैं. साथ ही, सिर्फ़ कीवर्ड के आइडेंटिफ़ायर के साथ-साथ कुछ अन्य फ़ील्ड भी तय किए जा सकते हैं:

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

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

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

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

  • type: कन्वर्ज़न का टाइप. यह 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" : [{
    "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 में इंपोर्ट करें. पक्का करें कि आपने मॉडल का नाम External Attribution Model रखा हो. इससे Search Ads 360 की सुविधाओं को यह पता चलता है कि अपलोड किए गए कन्वर्ज़न डेटा पर एट्रिब्यूशन मॉडल लागू किया गया है. ज़्यादा जानें

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

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

  • clickId: विज़िट का केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) क्लिक आईडी. विज्ञापन देने वाले व्यक्ति या कंपनी के वेब लॉग में क्लिक आईडी या कन्वर्ज़न की सूची देखें. इसके बाद, किसी दूसरे कन्वर्ज़न से क्लिक आईडी का इस्तेमाल करें. 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: इससे कन्वर्ज़न होने की तारीख और समय का पता चलता है. उदाहरण के लिए, अगर कन्वर्ज़न शुक्रवार, 5 अगस्त, 2016 को सुबह 11:53:22 बजे ईस्टर्न डेलाइट सेविंग टाइम (जीएमटी -4:00) पर होता है, तो टाइमस्टैंप को Epoch मिलीसेकंड में डालें: 1470412402000.
  • segmentationType: इससे यह पता चलता है कि कन्वर्ज़न को किस तरह के कन्वर्ज़न सिस्टम में अपलोड किया जा रहा है. फ़िलहाल, सिर्फ़ Floodlight कन्वर्ज़न इस्तेमाल किए जा सकते हैं. इसलिए, इस फ़ील्ड के लिए FLOODLIGHT की जानकारी देना हमेशा ज़रूरी होता है.
  • segmentationName: यह उस Floodlight गतिविधि का नाम है जिसका इस्तेमाल विज्ञापन देने वाला व्यक्ति या कंपनी, कन्वर्ज़न की रिपोर्ट करने के लिए कर रही है.

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

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

  • type: कन्वर्ज़न का टाइप. यह 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 का पूरा इंटरनल रेप्रज़ेंटेशन शामिल होता है. जैसे, कैंपेन आईडी, विज्ञापन ग्रुप आईडी, और कीवर्ड (मानदंड) आईडी.

{
 "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 नहीं मिला है. इस तरह की गड़बड़ी में, मैसेज details में दो आइटम होते हैं:

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

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

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

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

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

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

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