โทรติดต่อ 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 สำหรับผู้ลงโฆษณาได้ที่รหัส Search Ads 360 และ Conversion
หลังจากที่คุณส่งคำขอ Search Ads 360 จะตรวจสอบคำขอ และสร้างรายการ
และแสดงรายการเป็นทรัพยากร ConversionList
ใน
เนื้อหาการตอบกลับ
ตัวอย่างคำขอรับ
ตัวอย่างต่อไปนี้ส่งคำขอรายการ Conversion ที่เกิดขึ้นตั้งแต่เดือนพฤศจิกายน 15 ถึง 31 ธันวาคม 2012 ในแคมเปญใดแคมเปญหนึ่ง
JSON
เมื่อสร้าง URL เพื่อดึงรายการ Conversion ให้จัดรูปแบบ 3 รายการแรก พารามิเตอร์ เช่นagencyId,ผู้ลงโฆษณาId และ 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