إدراج الإحالات الناجحة

اتصل بـ Conversion.get() لعرض قائمة بكائنات التحويل التي تمت معالجتها في "إعلانات شبكة البحث 360". يمكنك طلب جميع الإحالات الناجحة في حساب محرك المعلن أو تضييق النطاق إلى حملة أو مجموعة إعلانية أو إعلان أو كلمة رئيسية معينة.

تحدّد أرقام تعريف "إعلانات شبكة البحث 360" التي تحدّدها في الطلب نطاق الاستجابة. مثلاً:

  • للاطّلاع على كل الإحالات الناجحة في حساب محرك بحث، حدِّد أرقام التعريف التالية:
    • agencyId
    • advertiserId
    • engineAccountId
  • للاطّلاع على الإحالات الناجحة في حملة معيّنة، حدِّد أرقام التعريف التالية:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
  • للاطّلاع على الإحالات الناجحة المنسوبة إلى إعلان وكلمة رئيسية محدّدين، حدِّد أرقام التعريف التالية:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (إذا كانت الكلمة الرئيسية على مستوى المجموعة الإعلانية)
    • adId
    • criterionId

للحصول على معلومات حول الحصول على أرقام تعريف "إعلانات شبكة البحث 360" للمعلن، اطّلِع على الإحالات الناجحة وأرقام التعريف في "إعلانات شبكة البحث 360".

بعد إرسال الطلب، تتحقّق "إعلانات شبكة البحث 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

لغة 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())

مثال على الحصول على رد

في حال نجاح التحقق من صحة الطلب، تعرض "إعلانات شبكة البحث 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"
  },
  ...
 ]
}

في حالة فشل التحقق من الصحة

وفي حال عدم اجتياز التقرير لعملية التحقّق، تعرض "إعلانات شبكة البحث 360" رسالة الخطأ "لم يتم العثور عليه". على سبيل المثال، إذا لم يحدّد نموذج الطلب أعلاه وكالة فعلية: 

Not Found