Telepon Conversion.get()
untuk menampilkan daftar objek konversi yang telah diproses di Search Ads 360. Anda
dapat meminta semua konversi di akun mesin pengiklan atau mempersempit cakupan ke
kampanye, grup iklan, iklan, atau kata kunci tertentu.
ID Search Ads 360 yang Anda tentukan dalam permintaan menentukan cakupan responsnya. Contoh:
- Untuk melihat semua konversi di akun mesin, tentukan ID ini:
agencyId
advertiserId
engineAccountId
- Untuk melihat konversi di kampanye tertentu, tentukan ID ini:
agencyId
advertiserId
engineAccountId
campaignId
- Untuk melihat konversi yang diatribusikan ke iklan dan kata kunci tertentu, tentukan
ID ini:
agencyId
advertiserId
engineAccountId
campaignId
adGroupId
(jika kata kunci ada di tingkat grup iklan)adId
criterionId
Untuk informasi tentang cara mendapatkan ID Search Ads 360 untuk pengiklan, lihat ID Search Ads 360 dan Konversi.
Setelah Anda mengirim permintaan, Search Ads 360 akan memvalidasi permintaan tersebut, membuat daftar
objek, dan menampilkan daftar sebagai resource ConversionList
di
isi respons.
Contoh permintaan Get
Contoh berikut meminta daftar konversi yang terjadi dari bulan November 15 hingga 31 Desember 2012 dalam kampanye tertentu.
JSON
Saat Anda membuat URL untuk mengambil daftar konversi, format tiga konversi pertama parameter—agencyId, AdvertiserId, dan engineId—sebagai bagian dari jalur ke resource konversi. Tentukan parameter yang tersisa sebagai parameter kueri 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())
Contoh Mendapatkan respons
Jika validasi permintaan berhasil, Search Ads 360 akan menampilkan resource ConversionList
di bagian
isi respons.
{ "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" }, ... ] }
Jika validasi gagal
Jika laporan tidak lulus validasi, Search Ads 360 akan menampilkan pesan "Tidak ditemukan" {i>error<i}. Misalnya, jika contoh permintaan di atas tidak menentukan agensi:
Not Found