Mencantumkan Konversi

Panggil Conversion.get() untuk menampilkan daftar objek konversi yang telah diproses di Search Ads 360. Anda dapat meminta semua konversi di akun mesin pengiklan atau mempersempit cakupan ke kampanye, grup iklan, iklan, atau kata kunci tertentu.

ID Search Ads 360 yang Anda tentukan dalam permintaan menentukan cakupan respons. Contoh:

  • Untuk melihat semua konversi di akun mesin, tentukan ID ini:
    • agencyId
    • advertiserId
    • engineAccountId
  • Untuk melihat konversi di kampanye tertentu, tentukan ID ini:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
  • Untuk melihat konversi yang diatribusikan ke iklan dan kata kunci tertentu, tentukan ID berikut:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (jika kata kunci ada di tingkat grup iklan)
    • adId
    • criterionId

Untuk informasi tentang cara mendapatkan ID Search Ads 360 bagi pengiklan, lihat ID dan Konversi Search Ads 360.

Setelah Anda mengirim permintaan, Search Ads 360 akan memvalidasi permintaan tersebut, membuat daftar objek, dan menampilkan daftar sebagai resource ConversionList dalam isi respons.

Contoh Dapatkan permintaan

Contoh berikut meminta daftar konversi yang terjadi dari 15 November hingga 31 Desember 2012 di kampanye tertentu.

JSON

Ketika Anda membuat URL untuk mengambil daftar konversi, format tiga parameter pertama—agencyId, pengiklanId, dan engineId—sebagai bagian dari jalur ke resource konversi tersebut. Tentukan parameter yang tersisa sebagai parameter kueri 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())

Contoh Dapatkan respons

Jika validasi permintaan berhasil, Search Ads 360 akan menampilkan resource ConversionList di isi respons.

{
 "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"
  },
  ...
 ]
}

Jika validasi gagal

Jika laporan tidak lulus validasi, Search Ads 360 akan menampilkan error "Tidak ditemukan". Misalnya, jika contoh permintaan di atas tidak menentukan agensi sungguhan:

Not Found