Liệt kê lượt chuyển đổi

Gọi cho Conversion.get() để trả về danh sách các đối tượng chuyển đổi đã được xử lý trong Search Ads 360. Bạn có thể yêu cầu tất cả lượt chuyển đổi trong tài khoản công cụ của nhà quảng cáo hoặc thu hẹp phạm vi xuống chiến dịch, nhóm quảng cáo, quảng cáo hoặc từ khoá cụ thể.

Các mã nhận dạng Search Ads 360 mà bạn chỉ định trong yêu cầu sẽ xác định phạm vi của nội dung phản hồi. Ví dụ:

  • Để xem tất cả lượt chuyển đổi trong một tài khoản công cụ, hãy chỉ định các mã sau:
    • agencyId
    • advertiserId
    • engineAccountId
  • Để xem lượt chuyển đổi trong một chiến dịch cụ thể, hãy chỉ định các mã sau:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
  • Để xem các lượt chuyển đổi được phân bổ cho một quảng cáo và từ khoá cụ thể, hãy chỉ định các mã nhận dạng sau:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (nếu từ khoá tồn tại ở cấp nhóm quảng cáo)
    • adId
    • criterionId

Để biết thông tin về cách lấy mã nhận dạng Search Ads 360 cho nhà quảng cáo của bạn, hãy xem Mã nhận dạng Search Ads 360 và Lượt chuyển đổi.

Sau khi bạn gửi yêu cầu, Search Ads 360 sẽ xác thực yêu cầu, tạo danh sách đối tượng và trả về danh sách dưới dạng tài nguyên ConversionList trong nội dung phản hồi.

Ví dụ về yêu cầu Get

Ví dụ sau đây yêu cầu danh sách lượt chuyển đổi đã diễn ra từ tháng 11 từ ngày 15 đến ngày 31 tháng 12 năm 2012 trong một chiến dịch cụ thể.

JSON

Khi bạn tạo URL để truy xuất danh sách lượt chuyển đổi, hãy định dạng 3 lượt chuyển đổi đầu tiên các tham số –agencyId, advertiserId và EngineId – như một phần của đường dẫn đến nguồn chuyển đổi. Hãy chỉ định các tham số còn lại làm tham số truy vấn 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())

Ví dụ về nhận phản hồi

Nếu yêu cầu xác thực thành công, Search Ads 360 sẽ trả về một tài nguyên ConversionList trong nội dung phản hồi.

{
 "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"
  },
  ...
 ]
}

Nếu không xác thực được

Nếu báo cáo không vượt qua quy trình xác thực, Search Ads 360 sẽ trả về thông báo "Không tìm thấy" . Ví dụ: nếu yêu cầu ví dụ ở trên không chỉ định một thực đại lý:

Not Found