แสดงรายการ Conversion

โทรหา Conversion.get() เพื่อแสดงรายการออบเจ็กต์ Conversion ที่ได้รับการประมวลผลใน Search Ads 360 แล้ว คุณสามารถขอ Conversion ทั้งหมดในบัญชีเครื่องมือค้นหาของผู้ลงโฆษณา หรือจํากัดขอบเขตให้แคบลงเหลือเพียงแคมเปญ กลุ่มโฆษณา โฆษณา หรือคีย์เวิร์ดได้

รหัส Search Ads 360 ที่คุณระบุในคําขอจะเป็นตัวกําหนดขอบเขตของการตอบกลับ เช่น

  • หากต้องการดู Conversion ทั้งหมดในบัญชีเครื่องมือค้นหา ให้ระบุรหัสเหล่านี้
    • agencyId
    • advertiserId
    • engineAccountId
  • หากต้องการดู Conversion ในแคมเปญหนึ่งๆ ให้ระบุรหัสเหล่านี้
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
  • หากต้องการดู Conversion ที่เกิดจากโฆษณาและคีย์เวิร์ดที่เฉพาะเจาะจง ให้ระบุรหัสเหล่านี้
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (หากมีคีย์เวิร์ดอยู่ที่ระดับกลุ่มโฆษณา)
    • adId
    • criterionId

ดูข้อมูลเกี่ยวกับการรับรหัส Search Ads 360 สําหรับผู้ลงโฆษณาได้ที่รหัสและ Conversion ของ Search Ads 360

หลังจากที่คุณส่งคําขอ Search Ads 360 จะตรวจสอบคําขอ สร้างรายการออบเจ็กต์ และแสดงผลรายการเป็นทรัพยากร ConversionList ในเนื้อหาการตอบกลับ

ตัวอย่างการขอ

ตัวอย่างต่อไปนี้ขอรายการ Conversion ที่เกิดขึ้นตั้งแต่วันที่ 15 พฤศจิกายนถึงวันที่ 31 ธันวาคม 2012 ในแคมเปญหนึ่งๆ

JSON

เมื่อสร้าง URL เพื่อเรียกข้อมูลรายการ Conversion ให้จัดรูปแบบพารามิเตอร์ 3 รายการแรกคือ AgencyId, AdvertisersId และ EngineId เป็นส่วนหนึ่งของเส้นทางไปยังทรัพยากร Conversion ระบุพารามิเตอร์ที่เหลือเป็นพารามิเตอร์การค้นหาของ 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