- 리소스: insertOrder
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- 메서드
리소스: insertOrder
게재 신청서 1개.
JSON 표현 |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
입력란 | |
---|---|
name |
출력 전용. 게재 신청서의 리소스 이름입니다. |
advertiserId |
출력 전용. 게재 신청서가 속한 광고주의 고유 ID입니다. |
campaignId |
필수 항목입니다. 변경할 수 없습니다. 게재 신청서가 속한 캠페인의 고유 ID입니다. |
insertionOrderId |
출력 전용. 게재 신청서의 고유 ID입니다. 시스템에서 할당합니다. |
displayName |
필수 항목입니다. 게재 신청서의 표시 이름입니다. UTF-8 형식으로 인코딩되어야 하며 최대 크기는 240바이트여야 합니다. |
insertionOrderType |
게재 신청서 유형입니다. 생성 시 이 필드를 지정하지 않으면 기본값은 |
entityStatus |
필수 항목입니다. 게재 신청서가 인벤토리에 예산을 지출하고 입찰할 수 있는지 여부를 제어합니다.
|
updateTime |
출력 전용. 게재 신청서가 마지막으로 업데이트된 시점의 타임스탬프입니다. 시스템에서 할당합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
partnerCosts[] |
게재 신청서와 연결된 파트너 비용입니다.
|
pacing |
필수 항목입니다. 게재 신청서의 예산 지출 속도 설정입니다. |
frequencyCap |
필수 항목입니다. 게재 신청서의 최대 게재빈도 설정입니다. |
integrationDetails |
게재 신청서의 추가 통합 세부정보입니다. |
performanceGoal |
필수 항목입니다. 게재 신청서의 실적 목표입니다. |
budget |
필수 항목입니다. 게재 신청서의 예산 할당 설정입니다. |
bidStrategy |
게재 신청서의 입찰 전략입니다. 기본적으로 |
reservationType |
출력 전용. 게재 신청서의 예약 유형입니다. |
billableOutcome |
변경할 수 없습니다. 게재 신청서의 청구 가능 결과입니다. 결과 기반 구매는 지원 중단되었습니다. |
InsertionOrderType
게재 신청서의 가능한 유형입니다.
게재 신청서 유형에 따라 적용 가능한 설정과 옵션(예: 광고 형식, 타겟팅 옵션)이 결정됩니다.
열거형 | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
게재 신청서 유형이 지정되지 않았거나 알 수 없습니다. |
RTB |
실시간 입찰. |
OVER_THE_TOP |
오버더톱 |
InsertionOrderBudget
게재 신청서 예산이 할당되는 방식을 관리하는 설정입니다.
JSON 표현 |
---|
{ "budgetUnit": enum ( |
입력란 | |
---|---|
budgetUnit |
필수 항목입니다. 변경할 수 없습니다. 예산 단위는 예산이 통화 기반인지 노출 기반인지 지정합니다. |
automationType |
게재 신청서의 입찰 및 예산을 관리하는 데 사용되는 자동화 유형입니다. 생성 시 이 필드를 지정하지 않으면 기본값은 |
budgetSegments[] |
필수 항목입니다. 예산 세그먼트의 목록입니다. 예산 세그먼트를 사용하여 게재 신청서가 실행되는 특정 기간에 특정 예산을 지정할 수 있습니다. |
InsertionOrderAutomationType
게재 신청서 입찰 및 예산을 자동화하는 데 사용할 수 있는 옵션입니다.
열거형 | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
이 버전에서 게재 신청서 자동화 옵션이 지정되지 않았거나 알 수 없습니다. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
자동 예산 할당 시스템이 소유한 광고 항목으로 예산을 자동으로 전환하여 performanceGoal 에 의해 정의된 실적을 최적화하도록 허용합니다. 입찰 설정에 자동화가 적용되지 않습니다. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
게재 신청서 수준에서 입찰 또는 예산이 자동화되지 않음 입찰 및 예산은 광고 항목 수준에서 수동으로 구성해야 합니다. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
시스템이 자동으로 입찰가를 조정하고 예산을 소유한 광고 항목으로 전환하도록 허용하여 performanceGoal 에 의해 정의된 실적을 최적화합니다. |
InsertionOrderBudgetSegment
단일 예산 세그먼트의 예산을 관리하는 설정입니다.
JSON 표현 |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
입력란 | |
---|---|
budgetAmountMicros |
필수 항목입니다. 주어진 |
description |
예산 분류 기준 설명입니다. 이 도구는 각 예산 세그먼트에 대한 구매주문서 정보를 입력하고 인보이스에 해당 정보를 인쇄하는 데 사용할 수 있습니다. UTF-8로 인코딩되어야 합니다. |
dateRange |
필수 항목입니다. 예산 세그먼트의 시작일 및 종료일 설정입니다. 상위 광고주의 시간대를 기준으로 결정됩니다.
|
campaignBudgetId |
이 게재 신청서 예산 세그먼트가 속한 캠페인 예산의 |
BillableOutcome
게재 신청서의 청구 가능한 결과입니다.
열거형 | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
지정되지 않은 청구 가능 결과입니다. |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
노출당 지불입니다. |
BILLABLE_OUTCOME_PAY_PER_CLICK |
클릭당 지불입니다. |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
Active View당 지불입니다. |
방법 |
|
---|---|
|
새 게재 신청서를 만듭니다. |
|
게재 신청서를 삭제합니다. |
|
게재 신청서를 가져옵니다. |
|
광고주의 게재 신청서를 나열합니다. |
|
타겟팅 유형 전반에 걸쳐 게재 신청서에 할당된 타겟팅 옵션을 나열합니다. |
|
기존 게재 신청서를 업데이트합니다. |