- 리소스: InsertOrder
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- InsertionOrderType
- KPI
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- KpiType
- InsertionOrderBudget
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- OptimizationObjective
- 메서드
리소스: InsertOrder
단일 게재 신청서
JSON 표현 |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
필드 | |
---|---|
name |
출력 전용입니다. 게재 신청서의 리소스 이름입니다. |
advertiserId |
출력 전용입니다. 게재 신청서가 속한 광고주의 고유 ID입니다. |
campaignId |
필수 항목입니다. 변경할 수 없습니다. 게재 신청서가 속한 캠페인의 고유 ID입니다. |
insertionOrderId |
출력 전용입니다. 게재 신청서의 고유 ID입니다. 시스템에서 할당합니다. |
displayName |
필수 항목입니다. 게재 신청서의 표시 이름입니다. 최대 240바이트의 UTF-8로 인코딩되어야 합니다. |
insertionOrderType |
게재 신청서 유형입니다. 생성 시 이 필드를 지정하지 않으면 기본값은 |
entityStatus |
필수 항목입니다. 게재 신청서가 인벤토리에 예산을 지출하고 입찰할 수 있는지 여부를 제어합니다.
|
updateTime |
출력 전용입니다. 게재 신청서가 마지막으로 업데이트된 시점의 타임스탬프입니다. 시스템에서 할당합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
partnerCosts[] |
게재 신청서와 연결된 파트너 비용입니다.
|
pacing |
필수 항목입니다. 게재 신청서의 예산 지출 속도 설정입니다. |
frequencyCap |
필수 항목입니다. 게재 신청서의 최대 게재빈도 설정입니다. |
integrationDetails |
게재 신청서의 추가 통합 세부정보입니다. |
kpi |
필수 항목입니다. 게재 신청서의 핵심성과지표 (KPI)입니다. 이를 '목표'라고 합니다. 디스플레이 및 Video 360 인터페이스 |
budget |
필수 항목입니다. 게재 신청서의 예산 할당 설정입니다. |
bidStrategy |
게재 신청서의 입찰 전략입니다. 기본적으로 |
reservationType |
출력 전용입니다. 게재 신청서의 예약 유형입니다. |
optimizationObjective |
선택사항입니다. 게재 신청서의 최적화 목표입니다. 이 필드는 허용 목록에 포함된 고객만 사용할 수 있습니다. 고객이 허용 목록에 없는 경우 이 필드는 null이며, 이 필드를 설정하려고 하면 오류가 반환됩니다. |
InsertionOrderType
가능한 게재 신청서 유형입니다.
게재 신청서 유형에 따라 광고 형식이나 타겟팅 옵션 등 적용 가능한 설정과 옵션이 결정됩니다.
열거형 | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
게재 신청서 유형이 지정되지 않았거나 알 수 없습니다. |
RTB |
실시간 입찰. |
OVER_THE_TOP |
오버더톱 |
KPI
게재 신청서의 핵심성과지표(KPI)를 관리하는 설정입니다.
JSON 표현 |
---|
{ "kpiType": enum ( |
필드 | |
---|---|
kpiType |
필수 항목입니다. KPI의 유형입니다. |
kpiAlgorithmId |
선택사항입니다. KPI_CUSTOM_IMPRESSION_VALUE_OVER_COST와(과) 연결된 맞춤 입찰 알고리즘 ID입니다. 적절한 KPI를 선택하지 않으면 이 필드는 무시됩니다. |
통합 필드 kpi_value . 필수 항목입니다. KPI의 값입니다. 관련 필드는 kpi_type 에 해당합니다. kpi_value 은 다음 중 하나일 수 있습니다. |
|
kpiAmountMicros |
목표 금액(광고주 통화의 마이크로 단위)
예: 1500000은 1.5 통화의 표준 단위를 나타냅니다. |
kpiPercentageMicros |
목표 비율을 마이크로 단위로 나타낸 십진수입니다.
예: 70000은 7% (십진수 0.07)를 나타냅니다. |
kpiString |
KPI 문자열이며 비워 둘 수 있습니다. 100자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다.
|
KpiType
가능한 핵심성과지표 (KPI) 유형입니다.
열거형 | |
---|---|
KPI_TYPE_UNSPECIFIED |
이 버전에서 KPI 유형이 지정되지 않았거나 알 수 없습니다. |
KPI_TYPE_CPM |
KPI는 CPM (1,000회 노출당비용)입니다. |
KPI_TYPE_CPC |
KPI는 CPC (클릭당비용)입니다. |
KPI_TYPE_CPA |
KPI는 CPA (액션당비용)입니다. |
KPI_TYPE_CTR |
KPI는 CTR (클릭률)입니다. |
KPI_TYPE_VIEWABILITY |
KPI는 조회가능성 비율입니다. |
KPI_TYPE_CPIAVC |
KPI는 CPIAVC (완료 시 청취 및 조회 가능한 노출당 비용)입니다. |
KPI_TYPE_CPE |
KPI는 CPE (참여당비용)입니다. |
KPI_TYPE_CPV |
KPI는 CPV (조회당비용)로 설정됩니다. |
KPI_TYPE_CLICK_CVR |
KPI는 클릭 전환율 (클릭당 전환수) 비율입니다. |
KPI_TYPE_IMPRESSION_CVR |
KPI는 노출 전환율 (노출당 전환수) 비율입니다. |
KPI_TYPE_VCPM |
KPI는 VCPM (조회 가능 노출 1,000회당 비용)입니다. |
KPI_TYPE_VTR |
KPI는 YouTube 조회율 (노출당 YouTube 조회수) 비율입니다. |
KPI_TYPE_AUDIO_COMPLETION_RATE |
KPI는 오디오 완료율 (노출당 완료된 오디오 청취 횟수) 비율입니다. |
KPI_TYPE_VIDEO_COMPLETION_RATE |
KPI는 동영상 완료율 (노출당 완료된 동영상 조회수) 비율입니다. |
KPI_TYPE_CPCL |
KPI는 CPCL (완전한 오디오 청취당 비용)으로 설정됩니다. |
KPI_TYPE_CPCV |
KPI는 CPCV (완료된 동영상 조회당 비용)로 설정됩니다. |
KPI_TYPE_TOS10 |
KPI는 화면에 10초 이상 표시된 시간의 비율 (화면에 10초 이상 표시된 측정 가능, 건너뛸 수 없는 노출수의 비율)로 설정됩니다. |
KPI_TYPE_MAXIMIZE_PACING |
전체 예산 지출을 우선하면서 브랜드 영향을 극대화하도록 KPI가 설정됩니다. |
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST |
KPI는 맞춤 노출 값을 비용으로 나눈 값으로 설정됩니다. |
KPI_TYPE_OTHER |
KPI에는 다른 가치도 있습니다. |
InsertionOrderBudget
게재 신청서 예산이 할당되는 방식을 제어하는 설정입니다.
JSON 표현 |
---|
{ "budgetUnit": enum ( |
필드 | |
---|---|
budgetUnit |
필수 항목입니다. 변경할 수 없습니다. 예산 단위는 예산이 통화 기반인지 또는 노출수 기반인지 지정합니다. |
automationType |
게재 신청서의 입찰가 및 예산을 관리하는 데 사용되는 자동화 유형입니다. 생성 시 이 필드를 지정하지 않으면 기본값은 |
budgetSegments[] |
필수 항목입니다. 예산 세그먼트의 목록입니다. 예산 세그먼트를 사용하여 게재 신청서가 실행되는 특정 기간 동안 특정 예산을 지정할 수 있습니다. |
InsertionOrderAutomationType
게재 신청서 입찰가 및 예산을 자동화하는 데 가능한 옵션입니다.
열거형 | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
게재 신청서 자동화 옵션이 지정되지 않았거나 이 버전에서 알 수 없습니다. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
자동 예산 할당. 시스템이 소유한 광고 항목으로 예산을 자동으로 전환하여 kpi 에서 정의한 실적을 최적화하도록 허용합니다. 입찰가 설정에 자동화 기능이 없습니다. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
게재 신청서 수준에서는 입찰 또는 예산을 자동화하지 않습니다. 입찰가 및 예산은 광고 항목 수준에서 수동으로 구성해야 합니다. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
시스템이 자동으로 입찰가를 조정하고, 소유한 광고 항목으로 예산을 전환하여 kpi 에서 정의한 실적을 최적화하도록 허용합니다. |
InsertionOrderBudgetSegment
단일 예산 세그먼트의 예산을 관리하는 설정입니다.
JSON 표현 |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
필드 | |
---|---|
budgetAmountMicros |
필수 항목입니다. 주어진 |
description |
예산 세그먼트 설명입니다. 이 버튼을 사용하여 각 예산 세그먼트의 구매주문서 정보를 입력하고 인보이스에 해당 정보를 인쇄할 수 있습니다. UTF-8로 인코딩되어야 합니다. |
dateRange |
필수 항목입니다. 예산 세그먼트의 시작일 및 종료일 설정입니다. 상위 광고주의 시간대를 기준으로 해결됩니다.
|
campaignBudgetId |
이 게재 신청서 예산 세그먼트가 속한 캠페인 예산의 |
OptimizationObjective
가능한 최적화 목표 유형
열거형 | |
---|---|
OPTIMIZATION_OBJECTIVE_UNSPECIFIED |
유형 값이 지정되지 않았거나 이 버전에서 알 수 없습니다. |
CONVERSION |
매출과 전환을 늘리는 노출에 우선순위를 둡니다. |
CLICK |
웹사이트 트래픽, 앱, 앱 스토어를 늘리는 노출에 우선순위를 둡니다. |
BRAND_AWARENESS |
특정 품질의 노출에 우선순위를 둡니다. |
CUSTOM |
목표는 할당된 맞춤 입찰 알고리즘에 의해 정의됩니다. |
NO_OBJECTIVE |
목표가 정의되지 않음. 모든 KPI 또는 입찰 전략을 사용할 수 있습니다. |
메서드 |
|
---|---|
|
새 게재 신청서를 만듭니다. |
|
게재 신청서를 삭제합니다. |
|
게재 신청서를 가져옵니다. |
|
광고주의 게재 신청서를 나열합니다. |
|
타겟팅 유형 전반에 걸쳐 게재 신청서에 할당된 타겟팅 옵션을 나열합니다. |
|
기존 게재 신청서를 업데이트합니다. |