הצגת רשימה של המרות

אפשר להתקשר אל Conversion.get() כדי להחזיר רשימה של אובייקטי המרה שעובדו ב-Search Ads 360. ניתן לבקש את כל ההמרות בחשבון מנוע החיפוש של המפרסם, או לצמצם את היקף הקמפיין, קבוצת המודעות, המודעה או מילת המפתח הספציפיים.

המזהים של 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

כשיוצרים כתובת URL כדי לאחזר רשימה של המרות, צריך להזין את שלושת הפרמטרים הראשונים – AgencyId, advertiserId ו-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