REST Resource: advertisers

리소스: Advertiser

Display & Video 360 (DV360)의 단일 광고주입니다.

JSON 표현 
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "defaultBusinessName": string,
  "defaultLogoAssetId": string
}
필드
name

string

출력 전용입니다. 광고주의 리소스 이름입니다.
advertiserId

string (int64 format)

출력 전용입니다. 광고주의 고유 ID입니다. 시스템에서 할당합니다.
partnerId

string (int64 format)

필수 항목입니다. 변경할 수 없습니다. 광고주가 속한 파트너의 고유 ID입니다.
displayName

string

필수 항목입니다. 광고주의 표시 이름입니다.

최대 크기가 240바이트인 UTF-8로 인코딩되어야 합니다.
entityStatus

enum (EntityStatus)

필수 항목입니다. 광고주의 게재 신청서 및 광고 항목이 예산을 지출하고 인벤토리에 입찰할 수 있는지 여부를 제어합니다.

  • 허용되는 값은 ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED, ENTITY_STATUS_SCHEDULED_FOR_DELETION입니다.
  • ENTITY_STATUS_SCHEDULED_FOR_DELETION로 설정하면 광고주가 삭제되도록 처음 예약된 날짜로부터 30일 후에 삭제됩니다.
updateTime

string (Timestamp format)

출력 전용입니다. 광고주가 마지막으로 업데이트된 타임스탬프입니다. 시스템에서 할당합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
generalConfig

object (AdvertiserGeneralConfig)

필수 항목입니다. 광고주의 일반 설정입니다.
adServerConfig

object (AdvertiserAdServerConfig)

필수 항목입니다. 변경할 수 없습니다. 광고주의 광고 서버 관련 설정입니다.
creativeConfig

object (AdvertiserCreativeConfig)

필수 항목입니다. 광고주의 광고 소재 관련 설정입니다.
dataAccessConfig

object (AdvertiserDataAccessConfig)

광고주 데이터에 액세스하는 방법을 제어하는 설정입니다.
integrationDetails

object (IntegrationDetails)

광고주의 통합 세부정보입니다. 현재 광고주에게는 integrationCode만 적용됩니다. IntegrationDetails의 다른 필드는 지원되지 않으며 제공된 경우 무시됩니다.
servingConfig

object (AdvertiserTargetingConfig)

광고주의 광고 게재와 관련된 타겟팅 설정입니다.
prismaEnabled

boolean

Mediaocean (Prisma)과의 통합이 사용 설정되어 있는지 여부입니다. 이 기능을 사용 설정하면 다음에 동의하는 것으로 간주됩니다.

본인은 본인의 회사를 대신하여 Mediaocean (Prisma)이 Google에 예산 세그먼트 계획을 전송하도록 승인하고, Google이 이 광고주의 예산 계획, 청구, 조정 목적으로 DV360에서 Mediaocean으로 관련 보고서와 인보이스를 전송하도록 승인합니다.
billingConfig

object (AdvertiserBillingConfig)

필수 항목입니다. 광고주의 결제 관련 설정입니다.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

선택사항입니다. 이 광고주에 유럽 연합 정치 광고를 게재하는 광고 항목이 포함되어 있는지 여부입니다.

이 필드가 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING로 설정되면 다음이 발생합니다.

  • 이 광고주 아래에 생성된 새 광고 항목에는 별도로 지정하지 않는 한 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING가 할당됩니다.
  • 이 광고주에 속한 기존 광고 항목 중 값이 설정되지 않은 항목은 하루 이내에 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING로 업데이트됩니다.
defaultBusinessName

string

선택사항입니다. 광고주의 기본 비즈니스 이름입니다.

비즈니스 이름이 제공되지 않은 경우 이 광고주 아래의 YouTube 및 디맨드젠 캠페인 광고에서 사용되는 값입니다.
defaultLogoAssetId

string (int64 format)

선택사항입니다. 광고주의 기본 로고 이미지의 확장 소재 ID입니다.

로고 애셋이 제공되지 않은 경우 YouTube 및 디맨드 광고에서 이 광고주에 대해 사용할 저작물 ID입니다.

API를 사용하여 이 애셋을 업로드하려면 advertisers.adAssets.upload를 사용해야 합니다.

AdvertiserGeneralConfig

광고주의 일반 설정입니다.

JSON 표현 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
필드
domainUrl

string

필수 항목입니다. 광고주의 기본 웹사이트 도메인 URL입니다. 이 정보는 캠페인을 광고주와 연결하는 데 웹사이트 URL이 필요한 게시자에게 전송됩니다.

http: 또는 https:로 시작하고 경로 또는 쿼리 문자열이 없는 URL을 제공하세요. 예: http://www.example.com
timeZone

string

출력 전용입니다. 광고주 시간대의 표준 TZ 데이터베이스 이름입니다. 예를 들면 America/New_York입니다.

자세한 내용은 https://en.wikipedia.org/wiki/List_of_tz_database_time_zones를 참고하세요.

CM360 하이브리드 광고주의 경우 시간대는 연결된 CM360 계정의 시간대와 동일하며, 서드 파티 전용 광고주의 경우 시간대는 상위 파트너의 시간대와 동일합니다.
currencyCode

string

필수 항목입니다. 변경할 수 없습니다. 광고주의 통화(ISO 4217 형식)입니다.

허용되는 코드와 해당 코드가 나타내는 통화는 다음과 같습니다.

통화 코드 : 통화 이름

  • ARS : 아르헨티나 페소
  • AUD : 오스트레일리아 달러
  • BRL : 브라질 헤알
  • CAD : 캐나다 달러
  • CHF : 스위스 프랑
  • CLP : 칠레 페소
  • CNY : 중국 위안
  • COP : 콜롬비아 페소
  • CZK : 체코 코루나
  • DKK : 덴마크 크로네
  • EGP : 이집트 파운드
  • EUR : 유로
  • GBP : 영국 파운드
  • HKD : 홍콩 달러
  • HUF : 헝가리 포린트
  • IDR : 인도네시아 루피아
  • ILS : 이스라엘 셰켈
  • INR : 인도 루피
  • JPY : 일본 엔
  • KRW : 대한민국 원
  • MXN : 멕시코 페소
  • MYR : 말레이시아 링깃
  • NGN : 나이지리아 나이라
  • NOK : 노르웨이 크로네
  • NZD : 뉴질랜드 달러
  • PEN : 페루 누에보 솔
  • PLN : 폴란드 즈워티
  • RON : 뉴 루마니아 레우
  • RUB : 러시아 루블
  • SEK : 스웨덴 크로나
  • TRY : 튀르키예 리라
  • TWD : 신 타이완 달러
  • USD : 미국 달러
  • ZAR : 남아프리카 공화국 랜드

AdvertiserAdServerConfig

광고주의 광고 서버 관련 설정입니다.

JSON 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of mutually exclusive fields.
}
필드
필수 항목입니다. 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

서드 파티 광고 서버만 사용하는 광고주의 구성입니다.
cmHybridConfig

object (CmHybridConfig)

Campaign Manager 360 (CM360)과 서드 파티 광고 서버를 모두 사용하는 광고주의 구성입니다.
상호 배타적 필드의 끝입니다.

ThirdPartyOnlyConfig

서드 파티 광고 서버만 사용하는 광고주를 위한 설정입니다.

JSON 표현 
{
  "pixelOrderIdReportingEnabled": boolean
}
필드
pixelOrderIdReportingEnabled

boolean

픽셀의 주문 ID 보고가 사용 설정되어 있는지 여부입니다. 이 값은 true로 설정되면 변경할 수 없습니다.

CmHybridConfig

Campaign Manager 360 (CM360)과 서드 파티 광고 서버를 모두 사용하는 광고주의 설정입니다.

JSON 표현 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
필드
cmAccountId

string (int64 format)

필수 항목. 변경할 수 없습니다. DV360 광고주와 연결된 CM360 플러드라이트 구성의 계정 ID입니다.
cmFloodlightConfigId

string (int64 format)

필수 항목입니다. 변경할 수 없습니다. DV360 광고주와 연결된 CM360 플러드라이트 구성의 ID입니다.
cmAdvertiserIds[]

string (int64 format)

출력 전용입니다. CM360 플러드라이트 구성을 공유하는 CM360 광고주 ID의 집합입니다.
cmSyncableSiteIds[]

string (int64 format)

게재위치가 DV360에 광고 소재로 동기화될 CM360 사이트 목록입니다.

advertisers.create 메서드에 없거나 비어 있으면 시스템에서 CM360 사이트를 자동으로 만듭니다.

이 목록에서 사이트를 삭제하면 CM360에서 동기화된 DV360 광고 소재가 삭제될 수 있습니다. 사이트를 하나 이상 지정해야 합니다.
dv360ToCmDataSharingEnabled

boolean

CM360 데이터 전송 보고서에 DV360 데이터를 포함할지 여부입니다.
dv360ToCmCostReportingEnabled

boolean

DV360 비용을 CM360에 보고할지 여부입니다.
cmFloodlightLinkingAuthorized

boolean

필수 항목입니다. 변경할 수 없습니다. 이 필드를 true로 설정하면 회사에서 지정된 플러드라이트 구성의 정보를 이 Display & Video 360 광고주와 공유하도록 승인합니다.

AdvertiserCreativeConfig

광고주의 광고 소재 관련 설정입니다.

JSON 표현 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
필드
iasClientId

string (int64 format)

Integral Ad Service (IAS)에서 제공하는 캠페인 모니터링 구성 ID입니다. DV360 시스템은 이 ID가 포함된 IAS '캠페인 모니터' 태그를 광고 소재 태그에 추가합니다.
obaComplianceDisabled

boolean

온라인 행동 기반 광고 (OBA) 및 규제 요건에 따라 광고에 배지 (콘텐츠를 광고로 식별) 및 투명성 정보 (광고 수신 정보와의 상호작용 관련)를 추가하는 Google의 광고 수신 정보 기능을 사용 중지할지 여부입니다. 광고 수신 정보는 사용자가 표시되는 광고를 더욱 세부적으로 관리하고 광고주가 사용자에게 광고가 표시되는 이유를 설명할 수 있도록 도와줍니다. 자세히 알아보기

이 필드를 true로 설정하는 경우 Display & Video 360을 통해 게재되는 광고는 다음을 준수해야 합니다.

  • Google Marketing Platform과의 계약에 따라 온라인 행동 기반 광고 (OBA)를 준수해야 합니다.
  • 유럽 경제 지역 (EEA)에서는 광고에 투명성 정보와 사용자가 불법 콘텐츠를 신고할 수 있는 메커니즘을 포함해야 합니다. 대체 광고 배지, 투명성 및 신고 솔루션을 사용하는 경우 필수 투명성 정보와 불법 콘텐츠 신고 메커니즘이 포함되어 있는지 확인하고 적절한 양식을 사용하여 불법 콘텐츠 신고가 있을 경우 Google에 알려야 합니다.
dynamicCreativeEnabled

boolean

광고주가 동적 광고 소재를 사용 설정했는지 여부입니다.
videoCreativeDataSharingAuthorized

boolean

이 필드를 true로 설정하면 회사에서 Display & Video 360 광고주와 연결된 동영상 광고 소재를 사용하여 광고주의 텔레비전 캠페인과 관련된 보고서 및 기능을 제공하도록 Google에 승인하는 것입니다.

광고주가 CM360 hybrid 광고 서버 구성을 사용하는 경우에만 적용됩니다.

AdvertiserDataAccessConfig

광고주 관련 데이터에 액세스하는 방법을 제어하는 설정입니다.

JSON 표현 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
필드
sdfConfig

object (AdvertiserSdfConfig)

광고주의 구조화된 데이터 파일 (SDF) 설정입니다.

지정하지 않으면 상위 파트너의 SDF 설정이 사용됩니다.

AdvertiserSdfConfig

광고주의 구조화된 데이터 파일 (SDF) 설정입니다.

JSON 표현 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
필드
overridePartnerSdfConfig

boolean

이 광고주가 상위 파트너의 SDF 구성을 재정의하는지 여부입니다.

기본적으로 광고주는 상위 파트너의 SDF 구성을 상속합니다. 파트너 구성을 재정의하려면 이 필드를 true로 설정하고 sdfConfig에 새 구성을 제공합니다.
sdfConfig

object (SdfConfig)

광고주의 SDF 구성입니다.

AdvertiserTargetingConfig

광고주의 광고 게재와 관련된 타겟팅 설정입니다.

JSON 표현 
{
  "exemptTvFromViewabilityTargeting": boolean
}
필드
exemptTvFromViewabilityTargeting

boolean

커넥티드 TV 기기가 광고주 아래의 모든 동영상 광고 항목에 대해 조회 가능성 타겟팅에서 제외되는지 여부입니다.

AdvertiserBillingConfig

광고주의 결제 관련 설정입니다.

JSON 표현 
{
  "billingProfileId": string
}
필드
billingProfileId

string (int64 format)

필수 항목입니다. 광고주에게 할당된 결제 프로필의 ID입니다.

메서드

audit

 광고주를 감사합니다.

create

 새 광고주를 만듭니다.

delete

 광고주를 삭제합니다.

editAssignedTargetingOptions

 단일 광고주의 타겟팅 옵션을 수정합니다.

get

 광고주를 가져옵니다.

list

 현재 사용자가 액세스할 수 있는 광고주를 나열합니다.

listAssignedTargetingOptions

 타겟팅 유형 전반에서 광고주에게 할당된 타겟팅 옵션을 나열합니다.

patch

 기존 광고주를 업데이트합니다.