전환 나열

Conversion.get()를 호출하여 Search Ads 360에서 처리된 전환 객체 목록을 반환합니다. 광고주의 엔진 계정에서 모든 전환을 요청하거나 범위를 특정 캠페인, 광고그룹, 광고 또는 키워드로 좁힐 수 있습니다.

요청에 지정한 Search Ads 360 ID에 따라 응답 범위가 결정됩니다. 예를 들면 다음과 같습니다.

  • 엔진 계정의 모든 전환을 보려면 다음 ID를 지정하세요.
    • agencyId
    • advertiserId
    • engineAccountId
  • 특정 캠페인의 전환을 보려면 다음 ID를 지정하세요.
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
  • 특정 광고 및 키워드에 기여한 전환을 보려면 다음 ID를 지정하세요.
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (키워드가 광고그룹 수준에 있는 경우)
    • adId
    • criterionId

광고주의 Search Ads 360 ID를 가져오는 방법은 Search Ads 360 ID 및 전환을 참고하세요.

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

Get 요청 예시

다음 예에서는 특정 캠페인에서 2012년 11월 15일부터 12월 31일까지 발생한 전환 목록을 요청합니다.

JSON

전환 목록을 가져올 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