Telefon et: Conversion.get()
değerini döndürür. Siz
bir reklamverenin motor hesabındaki tüm dönüşümleri isteyebilir veya kapsamı bir
reklam grubu, reklam veya anahtar kelime olabilir.
İstekte belirttiğiniz Search Ads 360 kimlikleri yanıt verelim. Örneğin:
- Bir motor hesabındaki tüm dönüşümleri görmek için şu kimlikleri belirtin:
agencyId
advertiserId
engineAccountId
- Belirli bir kampanyadaki dönüşümleri görmek için şu kimlikleri belirtin:
agencyId
advertiserId
engineAccountId
campaignId
- Belirli bir reklam ve anahtar kelimeyle ilişkilendirilen dönüşümleri görmek için
şu kimlikler:
agencyId
advertiserId
engineAccountId
campaignId
adGroupId
(anahtar kelime, reklam grubu düzeyinde mevcutsa)adId
criterionId
Reklamvereninize Search Ads 360 kimliklerini alma hakkında bilgi için Search Ads 360 kimlikleri konusuna bakın ve Dönüşümler.
İstek gönderildikten sonra, Search Ads 360 isteği doğrular,
nesneler ve listeyi ConversionList
kaynağı olarak
yanıt gövdesi.
Örnek Alma isteği
Aşağıdaki örnekte, Kasım ayında gerçekleşen dönüşümlerin listesi istenmiştir. 15 ile 31 Aralık 2012 arasında, belirli bir kampanyada kullanılabilir.
JSON
Dönüşümlerin listesini almak üzere bir URL oluşturduğunuzda, ilk üçünü parametrelerini (agencyId, advertiserId veengineId) dönüşüm kaynağıdır. Kalan parametreleri URL sorgu parametreleri olarak belirtin.
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())
Örnek yanıt alma
İstek doğrulama başarılı olursa Search Ads 360, ConversionList
yanıt gövdesi.
{ "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" }, ... ] }
Doğrulama başarısız olursa
Rapor doğrulamayı geçemezse Search Ads 360 "Bulunamadı" değerini döndürür hatası. Örneğin, yukarıdaki örnek istekte gerçek bir ajans:
Not Found