कन्वर्ज़न की सूची बनाएं

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

आपके अनुरोध में दिए गए Search Ads 360 आईडी से, जवाब का दायरा तय होता है. उदाहरण के लिए:

  • किसी इंजन खाते में सभी कन्वर्ज़न देखने के लिए, ये आईडी बताएं:
    • agencyId
    • advertiserId
    • engineAccountId
  • किसी खास कैंपेन में कन्वर्ज़न देखने के लिए, ये आईडी बताएं:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
  • किसी खास विज्ञापन और कीवर्ड से मिले कन्वर्ज़न देखने के लिए, ये आईडी बताएं:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (अगर कीवर्ड, विज्ञापन ग्रुप लेवल पर मौजूद है)
    • adId
    • criterionId

विज्ञापन देने वाले के लिए Search Ads 360 के आईडी पाने के बारे में जानकारी पाने के लिए, Search Ads 360 आईडी और कन्वर्ज़न देखें.

अनुरोध भेजने के बाद, Search Ads 360 अनुरोध की पुष्टि करता है, ऑब्जेक्ट की सूची जनरेट करता है, और रिस्पॉन्स के मुख्य हिस्से में सूची को ConversionList संसाधन के तौर पर दिखाता है.

'अनुरोध पाएं' का उदाहरण

नीचे दिए गए उदाहरण में, किसी खास कैंपेन में 15 नवंबर से 31 दिसंबर, 2012 तक हुए कन्वर्ज़न की सूची का अनुरोध किया गया है.

JSON

जब आप कन्वर्ज़न की सूची फिर से पाने के लिए कोई यूआरएल बनाते हैं, तो कन्वर्ज़न संसाधन के पाथ के हिस्से के तौर पर, पहले तीन पैरामीटर—agencyId, विज्ञापन देने वाले के आईडी, और EngineId को फ़ॉर्मैट करें. बाकी पैरामीटर को यूआरएल क्वेरी पैरामीटर के तौर पर डालें.

GET https://www.googleapis.com/doubleclicksearch/v2/agency/12300000000000456/advertiser/45600000000010291/engine/700000000042441/conversion?campaign=71700000001899732&startDate=20121115&endDate=20121231&startRow=0&rowCount=10

Java

  /**
   * Instantiate the Doubleclicksearch service, request a list of conversions in a specific campaign,
   * and print the list to standard out.
   */
  public static void main(String[] args) throws Exception {

    Doubleclicksearch service = getService(); // See Set Up Your Application.
    ConversionList conversionList = listConversions(service);
    outputList(conversionList);
  }


  /**
   * Request a list of the first 10 conversions in a specific campaign.
   */
  private static ConversionList listConversions(Doubleclicksearch service) throws IOException {
    try {
      Get getRequest = service.conversion().get(
          new Long(12300000000000456L), // Replace with your agency ID
          new Long(45600000000010291L), // Replace with your advertiser ID
          new Long(700000000042441L), // Replace with your engine account ID
          new Integer(20121231), // End date
          new Integer(10), // Number of rows
          new Integer(20121115), // Start date
          new Long(0L)); // Starting row
      getRequest.setCampaignId(71700000002044839L); // Optional parameter

      return getRequest.execute();
    } 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());
      return null; // Unreachable code.
    }
  }

 /**
  * Print to standard out.
  */
  privte static void outputList(ConversionList conversionList) {
    for (Conversion conversion : conversionList.getConversion()) {
      if (null != conversion) {
        System.out.println(conversion.toString());
      }
    }
  }

Python

def get_conversion(service):
  """Request the first 10 conversions in a specific campaign
     and print the list.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().get(
      agencyId='12300000000000456', // Replace with your ID
      advertiserId='45600000000010291', // Replace with your ID
      engineAccountId='700000000042441', // Replace with your ID
      campaignId='71700000002044839', // Replace with your ID
      startDate=20131115,
      endDate=20131231,
      startRow=0,
      rowCount=10
  )

  pprint.pprint(request.execute())

जवाब पाने का उदाहरण

अगर पुष्टि हो जाती है, तो Search Ads 360 रिस्पॉन्स के मुख्य हिस्से में ConversionList रिसॉर्स दिखाता है. 

{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700003491981017",
   "adId": "0",
   "dsConversionId": "48752623802180029",
   "conversionId": "ag5zfmV2ZW50YXBpZGVtb3ITCxILVHJhbnNhY3Rpb24YgfQDDA",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
   "currencyCode": "USD",
   "quantityMillis": "0",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001081555",
   "segmentationName": "Customer Call",
   "conversionTimestamp": "1355776573000",
   "conversionModifiedTimestamp": "1355776580813"
  },
  {
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700003491981017",
   "adId": "44700000155906860",
   "dsConversionId": "48752623802180029",
   "conversionId": "ag5zfmV2ZW50YXBpZGVtb3ITCxILVHJhbnNhY3Rpb24YgfQDDA",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "20000000",
   "currencyCode": "USD",
   "quantityMillis": "0",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001081555",
   "segmentationName": "Customer Call",
   "conversionTimestamp": "1355776573000",
   "conversionModifiedTimestamp": "1355776580813"
  },
  ...
 ]
}

अगर पुष्टि नहीं हो पाती है

अगर रिपोर्ट में पुष्टि की प्रोसेस पूरी नहीं होती है, तो Search Ads 360 "नहीं मिला" गड़बड़ी दिखाता है. उदाहरण के लिए, अगर ऊपर दिए गए उदाहरण के अनुरोध से किसी असली एजेंसी की जानकारी नहीं मिलती है: 

Not Found