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 광고그룹

각 AdGroupId / AdId 쌍은 전 세계적으로 고유합니다.
AdGroupCriterion ID 광고그룹

각 AdGroupId / CriterionId 쌍은 전 세계적으로 고유합니다.
CampaignCriterion ID 캠페인

각 CampaignId / CriterionId 쌍은 전 세계적으로 고유합니다.
광고 확장 캠페인

각 CampaignId / AdExtensionId 쌍은 전 세계적으로 고유합니다.
피드 ID 전역
Feed Item ID 전역
Feed Attribute ID 피드
Feed Mapping ID 전역
라벨 ID 전역
UserList 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 요청 메서드를 제공합니다. 이는 리소스의 구조를 검사하는 데 유용합니다.

항목별 서비스의 예는 다음과 같습니다.