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

الاتصال بـ "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