Dönüşümleri Listele

Search Ads 360'ta işlenmiş dönüşüm nesnelerinin listesini döndürmek için Conversion.get() yöntemini çağırın. Bir reklamverenin motor hesabındaki tüm dönüşümleri isteyebilir veya kapsamı belirli bir kampanya, reklam grubu, reklam ya da anahtar kelimeyle sınırlandırabilirsiniz.

İstekte belirttiğiniz Search Ads 360 kimlikleri, yanıtın kapsamını belirler. Örneğin:

  • Bir arama motoru 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 bu kimlikleri belirtin:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (anahtar kelime reklam grubu düzeyinde varsa)
    • adId
    • criterionId

Reklamvereniniz için Search Ads 360 kimliklerini alma hakkında bilgi edinmek için Search Ads 360 kimlikleri ve dönüşümleri bölümüne bakın.

İsteği göndermenizin ardından, Search Ads 360 isteği doğrular, nesne listesini oluşturur ve listeyi, yanıt gövdesinde bir ConversionList kaynağı olarak döndürür.

Örnek Alma İsteği

Aşağıdaki örnekte, 15 Kasım'dan 31 Aralık 2012'ye kadar belirli bir kampanyada gerçekleşen dönüşümlerin listesi gösterilmektedir.

JSON

Dönüşüm listesini almak için bir URL oluştururken, dönüşüm kaynağına giden yolun bir parçası olarak ilk üç parametreyi (ajans kimliği, reklamveren kimliği ve arama motoru kimliği) biçimlendirin. 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 alın

İstek doğrulama işlemi başarılı olursa Search Ads 360, yanıt gövdesinde bir ConversionList kaynağı döndürür. 

{
 "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ı" hatası döndürür. Örneğin, yukarıdaki örnek istek gerçek bir ajans belirtmediyse: 

Not Found