빠른 시작 예

다음은 지난 30일 동안의 계정 실적을 marketing_method 및 offer_id로 분류하여 반환하는 product_performance_view 샘플 쿼리입니다. 이 빠른 예시를 통해 Merchant Reports API를 익힐 수 있습니다.

이 보고서를 가져오려면 실적 및 통계 역할이 필요합니다. 자세한 내용은 요구사항을 참고하세요.

참고: 이 가이드에서는 기본 HTTP 요청을 교육 도구로 보여줍니다. 하지만 클라이언트 라이브러리 중 하나를 사용하여 요청을 제출하는 것이 좋습니다.

요청하려면 다음 판매자 센터 쿼리 언어 문을 accounts.reports.search 메서드에 전달합니다.

SELECT
  marketing_method,
  offer_id,
  impressions,
  clicks,
  click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

HTTP 요청 URL

이 요청은 다음 URL의 Merchant Reports API 서버에 대한 HTTP POST로 구성됩니다.

https://merchantapi.googleapis.com/reports/v1beta/accounts/PARENT/reports:search

전체 HTTP 요청 샘플

다음은 HTTP POST 요청 내에 포함된 보고서 정의를 보여주는 전체 예입니다.

POST /reports/v1beta/accounts/PARENT/reports:search HTTP/1.1
Host: merchantapi.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer

Parameters:
{
  "query" : "SELECT
              marketing_method,
              offer_id,
              impressions,
              clicks,
              click_through_rate
            FROM product_performance_view
            WHERE date BETWEEN '2023-11-01' AND '2023-11-30'"
}

다음은 샘플 응답입니다.

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38",
        "impressions": "1038",
        "clickThroughRate": "0.3661"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "126",
        "impressions": "1126",
        "clickThroughRate": "0.1119"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "26",
        "impressions": "526",
        "clickThroughRate": "0.0494"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "227",
        "impressions": "1227",
        "clickThroughRate": "0.1850"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "12",
        "impressions": "512",
        "clickThroughRate": "0.0234"
      }
    }
  ]
}