Search Ads 360 Reporting API 구조

Search Ads 360 Reporting API의 기본 구성요소는 리소스와 서비스입니다. 리소스는 Search Ads 360 항목을 나타내고 서비스를 사용하여 Search Ads 360 항목을 검색합니다.

객체 계층 구조

Search Ads 360 계정은 객체의 계층 구조입니다.

  • 계정의 최상위 리소스는 고객입니다.

  • 각 계정에는 하나 이상의 운영 중인 캠페인이 포함됩니다.

  • 각 Campaign에는 광고를 논리적 모음으로 그룹화하는 하나 이상의 광고그룹이 포함됩니다.

  • 각 AdGroup에는 하나 이상의 광고그룹 광고가 포함됩니다.

  • 광고그룹 또는 캠페인에 하나 이상의 AdGroupCriterion 또는 CampaignCriterion를 연결할 수 있습니다. 기준은 광고가 트리거되는 방식을 정의합니다.

    • 키워드, 연령대, 위치 등 다양한 기준 유형이 있습니다. 캠페인 수준에서 정의된 기준은 캠페인 내의 다른 모든 리소스에 영향을 미칩니다. 캠페인 전체 예산 및 날짜를 지정할 수도 있습니다.

자료

리소스는 Search Ads 360 계정의 항목을 나타냅니다. 리소스의 예시로는 Customer, Campaign, AdGroup가 있습니다.

객체 ID

Search Ads 360의 모든 객체는 고유 ID로 식별됩니다. 일부 ID는 전역적으로 고유합니다. 즉, 모든 Search Ads 360 계정에서 고유한 ID도 있고 제한된 범위 내에서만 고유한 ID도 있습니다.

객체 ID 고유성 범위
예산 ID 전 세계
캠페인 ID 전 세계
광고그룹 ID 전 세계
광고 ID 광고그룹

각 AdGroupId / AdId 쌍은 전역적으로 고유합니다.
AdGroup기준 ID 광고그룹

각 AdGroupId / CriterionId 쌍은 전역적으로 고유합니다.
캠페인 기준 ID 실행

각 CampaignId / CriterionId 쌍은 전역적으로 고유합니다.
광고 확장 실행

각 CampaignId / AdExtensionId 쌍은 전역적으로 고유합니다.
피드 ID 전 세계
Feed Item ID 전 세계
Feed Attribute ID 피드
Feed Mapping ID 전 세계
라벨 ID 전 세계
사용자 목록 ID 전 세계

이러한 ID 규칙은 Search Ads 360 객체의 로컬 저장소를 설계할 때 유용할 수 있습니다.

객체 유형

일부 객체는 여러 항목 유형에 사용할 수 있습니다. 이 경우 객체에 콘텐츠를 설명하는 type 필드가 포함됩니다. 예를 들어 AdGroupAd는 텍스트 광고, 호텔 광고 또는 지역 광고를 나타낼 수 있습니다. AdGroupAd.ad.type 필드를 통해 유형 값에 액세스할 수 있습니다. 이 값은 AdType enum에 반환됩니다.

리소스 이름

각 리소스는 리소스와 상위 요소를 경로에 연결하는 resource_name 문자열로 고유하게 식별됩니다.

예를 들어 캠페인 리소스 이름의 형식은 다음과 같습니다.

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

고객 ID가 1234567인 Search Ads 360 계정에서 ID가 987654인 캠페인에는 resource_name이 있습니다.

customers/1234567/campaigns/987654

서비스

서비스를 사용하면 Search Ads 360 항목 및 메타데이터를 검색할 수 있습니다. 세 가지 서비스 유형이 있습니다.

검색 서비스
SearchAds360Service는 모든 리소스 객체 및 성능 통계를 검색하는 단일 통합 서비스입니다. Search 및 SearchStream라는 두 가지 메서드를 제공합니다. 두 메서드 모두 쿼리할 리소스, 검색할 리소스 속성과 성능 측정항목, 요청을 필터링하는 데 사용할 조건자, 성능 통계를 추가로 분석하는 데 사용할 세그먼트를 지정하는 쿼리가 필요합니다. 자세한 내용은 검색 보고서 만들기 및 Search Ads 360 쿼리 언어를 참고하세요.
현장 서비스
SearchAds360FieldService는 리소스에 사용 가능한 속성 및 데이터 유형과 같은 리소스에 대한 메타데이터를 검색합니다. SearchAds360Service 검색 메서드에서 사용할 수 있는 리소스, 리소스 필드, 세분화 키, 측정항목의 카탈로그를 요청할 수 있습니다. 자세한 내용은 리소스 메타데이터 검색을 참조하세요.
항목별 서비스

이러한 서비스는 단일 리소스 인스턴스를 검색하는 GET 요청 메서드를 제공합니다. 이는 리소스의 구조를 조사할 때 유용합니다.

법인별 서비스의 예는 다음과 같습니다.