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

חיוג למספר 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 — כחלק מהנתיב אל משאב ההמרה. יש לציין את שאר הפרמטרים כפרמטרים של שאילתה בכתובת URL.

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