전환 나열

Conversion.get()에 전화 걸기 Search Ads 360에서 처리된 전환 객체의 목록을 반환합니다. 나 광고주의 엔진 계정에서 모든 전환을 요청하거나 키워드를 설정할 수 있습니다.

요청에 지정하는 Search Ads 360 ID에 따라 확인할 수 있습니다. 예를 들면 다음과 같습니다.

  • 엔진 계정의 모든 전환을 보려면 다음 ID를 지정하세요. <ph type="x-smartling-placeholder">
      </ph>
    • agencyId
    • advertiserId
    • engineAccountId
  • 특정 캠페인에서 전환을 보려면 다음 ID를 지정합니다. <ph type="x-smartling-placeholder">
      </ph>
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
  • 특정 광고 및 키워드로 발생한 전환을 보려면 다음 ID를 포함합니다. <ph type="x-smartling-placeholder">
      </ph>
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (광고그룹 수준에 키워드가 있는 경우)
    • adId
    • criterionId

광고주의 Search Ads 360 ID를 얻는 방법에 대한 자세한 내용은 Search Ads 360 ID를 참조하세요. 전환을 참조하세요.

요청을 보내면 Search Ads 360에서 요청을 검증하고 객체를 사용하고 목록을 ConversionList 리소스로 반환합니다. 응답 본문입니다.

Get 요청 예

다음 예에서는 11월에 발생한 전환의 목록을 요청합니다. 2012년 12월 15일부터 12월 31일까지의 기간을 기준으로 했습니다.

JSON

전환 목록을 가져오기 위해 URL을 구성할 때 처음 3개의 URL 형식을 매개변수(agencyId, 광고주 ID 및 엔진 ID)를 알 수 있습니다. 나머지 매개변수를 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());
      }
    }
  }

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())

Get 응답 예

요청 유효성 검사에 성공하면 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