광고 소재

Creatives 리소스는 Google의 인증을 받기 위해 새 광고 소재를 Google에 제출하는 경로를 제공합니다.

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

광고 소재 및 광고 소재 분류 데이터

{
  "kind": "adexchangebuyer#creative",
  "accountId": integer,
  "buyerCreativeId": string,
  "agencyId": long,
  "HTMLSnippet": string,
  "videoURL": string,
  "clickThroughUrl": [
    string
  ],
  "vendorType": [
    integer
  ],
  "attribute": [
    integer
  ],
  "width": integer,
  "height": integer,
  "advertiserName": string,
  "status": string,
  "disapprovalReasons": [
    {
      "reason": string,
      "details": [
        string
      ]
    }
  ],
  "advertiserId": [
    long
  ],
  "sensitiveCategories": [
    integer
  ],
  "restrictedCategories": [
    integer
  ],
  "productCategories": [
    integer
  ],
  "corrections": [
    {
      "reason": string,
      "details": [
        string
      ]
    }
  ],
  "filteringReasons": {
    "date": string,
    "reasons": [
      {
        "filteringStatus": integer,
        "filteringCount": long
      }
    ]
  }
}
속성 이름 설명 참고
kind string 리소스 유형입니다. 항상 'adexchangebuyer#creative입니다.
accountId integer 계정 ID입니다.
buyerCreativeId string 이 광고의 광고 소재를 식별하는 구매자별 ID입니다.
HTMLSnippet string 웹페이지에 삽입하면 광고를 게재하는 HTML 코드입니다. 이 코드가 설정되면 videoURL은 설정해서는 안 됩니다.쓰기 가능
videoURL string 동영상 광고를 로드할 URL, 즉 해당 동영상 광고를 가져오는 데 사용할 URL입니다. 이 URL의 리소스는 일반적으로 동영상을 로드하는 표준 형식과 추적 정보를 포함하는 XML 문서입니다. 이 XML 문서는 비동영상 광고에만 사용되는 HTML 코드와는 다릅니다. 이 코드가 설정되면 HTMLSnippet은 설정해서는 안 됩니다.쓰기 가능
clickThroughUrl[] list 코드의 도착 URL 집합입니다.
vendorType[] list 이 코드에서 게재할 수 있는 광고의 제휴업체 유형 목록입니다. vendors.txt 파일에서 정의된 바에 따라 각 업체 유형을 정수로 나타냅니다.쓰기 가능
attribute[] list 이 코드에서 게재할 수 있는 광고에 대한 구매자 선택 속성의 목록입니다. buyer-declarable-creative-attributes.txt 파일에서 정의된 바에 따라 각 속성을 정수로 나타냅니다.쓰기 가능
width integer 광고의 폭(픽셀 단위)입니다.
height integer 광고의 높이(픽셀 단위)입니다.
advertiserName string 광고 소재를 통해 홍보하려는 회사의 이름입니다.
status string 광고 소재 게재 상태입니다. 읽기 전용입니다. 요청에서 이 필드를 설정하지 말아야 합니다.
advertiserId[] list 광고주 ID가 감지된 경우 해당 ID입니다. 읽기 전용입니다. 요청에서 이 필드를 설정하지 말아야 합니다.
sensitiveCategories[] list 민감한 카테고리가 감지된 경우 해당 카테고리입니다. 읽기 전용입니다. ad-sensitive-categories.txt 파일에서 정의된 바에 따라 각 카테고리를 정수로 나타냅니다. 요청에서 이 필드를 설정하지 말아야 합니다.
restrictedCategories[] list 이 코드에서 게재할 수 있는 광고의 모든 제한된 카테고리입니다. ad-restricted-categories.txt 파일에서 정의된 바에 따라 각 카테고리를 정수로 나타냅니다.쓰기 가능
productCategories[] list 제품 카테고리가 감지된 경우 해당 카테고리입니다. 읽기 전용입니다. ad-product-categories.txt 파일에서 정의된 바에 따라 각 카테고리를 정수로 나타냅니다. 요청에서 이 필드를 설정하지 말아야 합니다.
agencyId long 이 광고 소재의 대행사 ID입니다.쓰기 가능
disapprovalReasons[] list 비승인된 경우 비승인 사유입니다. 비승인 사유 중 일부는 카테고리로 분류되지 않을 수 있으므로 광고 소재의 상태가 DISAPPROVED이지만 disapprovalReasons 목록이 비어 있을 수 있습니다. 이러한 경우에는 기술 계정 관리자에게 문의하여 문제 해결 방법을 알아보세요. 읽기 전용입니다. 요청에서 이 필드를 설정하지 말아야 합니다.
disapprovalReasons[].reason string 카테고리로 분류된 비승인 사유입니다.
disapprovalReasons[].details[] list 비승인 사유에 대한 추가 정보입니다.
corrections[] list 이 광고 소재에 적용된 수정사항을 모두 보여줍니다. 읽기 전용입니다. 요청에서 이 필드를 설정하지 말아야 합니다.
corrections[].reason string 광고 소재에 적용된 수정의 유형입니다.
corrections[].details[] list 수정에 대한 추가적인 세부정보입니다.
filteringReasons object 광고 소재에 대한 필터링 이유입니다. 읽기 전용입니다. 요청에서 이 필드를 설정하지 말아야 합니다.
filteringReasons.date string 데이터에 대한 ISO 8601 형식의 날짜입니다. 데이터는 태평양 표준시로 00:00:00에서 23:59:59까지 수집됩니다.
filteringReasons.reasons[] list 필터링 이유입니다.
filteringReasons.reasons[].filteringStatus integer 필터링 상태 코드입니다. 상태 코드를 보려면 다운로드 섹션의 'creative-status-codes.txt'를 참조하세요.
filteringReasons.reasons[].filteringCount long 광고 소재가 상태로 필터링된 횟수입니다. 이 개수에는 Exchange의 모든 게시자가 포함됩니다.

메소드

insert
Google의 광고 소재 인증 과정에 새 광고 소재를 제출합니다.
list
인증된 사용자의 활성화된 광고 소재 목록을 검색합니다. LIST를 통해 광고 소재를 찾을 수 있으려면 새 광고 소재를 제출한 뒤 최대 20분이 소요될 수 있습니다.
get
광고 소재 하나의 상태를 가져옵니다. GET을 통해 광고 소재를 가져올 수 있으려면 새 광고 소재를 제출한 뒤 최대 20분이 소요될 수 있습니다.

다음에 대한 의견 보내기...

DoubleClick Ad Exchange Buyer REST API