فهرست تبدیل ها

برای بازگرداندن فهرستی از اشیاء تبدیلی که در Search Ads 360 پردازش شده‌اند Conversion.get() فراخوانی کنید. می‌توانید همه تبدیل‌ها را در حساب موتور تبلیغ‌کننده درخواست کنید یا دامنه را به یک کمپین، گروه تبلیغات، آگهی یا کلمه کلیدی خاص محدود کنید.

شناسه‌های Search Ads 360 که در درخواست مشخص می‌کنید دامنه پاسخ را تعیین می‌کنند. مثلا:

  • برای مشاهده همه تبدیل‌ها در یک حساب موتور، این شناسه‌ها را مشخص کنید:
    • agencyId
    • advertiserId
    • engineAccountId
  • برای مشاهده تبدیل‌ها در یک کمپین خاص، این شناسه‌ها را مشخص کنید:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
  • برای مشاهده تبدیل هایی که به یک آگهی و کلمه کلیدی خاص نسبت داده می شوند، این شناسه ها را مشخص کنید:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (اگر کلمه کلیدی در سطح گروه تبلیغات وجود داشته باشد)
    • adId
    • criterionId

برای کسب اطلاعات در مورد دریافت شناسه های Search Ads 360 برای تبلیغ کننده خود، به Search Ads 360 IDs and Conversions مراجعه کنید.

پس از ارسال درخواست، Search Ads 360 درخواست را تأیید می کند، لیستی از اشیاء را ایجاد می کند و لیست را به عنوان منبع ConversionList در بدنه پاسخ برمی گرداند.

مثال دریافت درخواست

مثال زیر فهرستی از تبدیل‌هایی را که از 15 نوامبر تا 31 دسامبر 2012 در یک کمپین خاص رخ داده است را درخواست می‌کند.

JSON

هنگامی که یک URL برای بازیابی لیستی از تبدیل‌ها ایجاد می‌کنید، سه پارامتر اول – agencyId، advertiserId و engineId – را به عنوان بخشی از مسیر منبع تبدیل قالب‌بندی کنید. پارامترهای باقیمانده را به عنوان پارامترهای جستجوی 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

جاوا

  /**
   * 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());
      }
    }
  }

پایتون

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