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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    अगर आप 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 की बिडिंग की रणनीतियों में किया जा सकता है.

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

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

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

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

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

    अगर आप 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, internalError हो सकती है, transactionFailed या lateStageRequestError.

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

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

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

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

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

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

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

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

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