- 리소스: Campaign
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- CampaignGoal
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- CampaignGoalType
- CampaignFlight
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- CampaignBudget
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ExternalBudgetSource
- PrismaConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- PrismaType
- PrismaCpeCode
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 메서드
리소스: 캠페인
단일 캠페인
JSON 표현 |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "displayName": string, "entityStatus": enum ( |
필드 | |
---|---|
name |
출력 전용입니다. 캠페인의 리소스 이름입니다. |
advertiserId |
출력 전용입니다. 캠페인이 속한 광고주의 고유 ID입니다. |
campaignId |
출력 전용입니다. 캠페인의 고유 ID입니다. 시스템에서 할당합니다. |
displayName |
필수 항목입니다. 캠페인의 표시 이름입니다. 최대 240바이트의 UTF-8로 인코딩되어야 합니다. |
entityStatus |
필수 항목입니다. 이 캠페인의 게재 신청서가 인벤토리에 예산을 지출하고 입찰할 수 있는지 여부를 제어합니다.
|
updateTime |
출력 전용입니다. 캠페인이 마지막으로 업데이트된 시점의 타임스탬프입니다. 시스템에서 할당합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
campaignGoal |
필수 항목입니다. 캠페인의 목표입니다. |
campaignFlight |
필수 항목입니다. 계획된 캠페인 지출 및 기간 |
frequencyCap |
필수 항목입니다. 캠페인의 최대 게재빈도 설정입니다. |
campaignBudgets[] |
이 캠페인에서 사용할 수 있는 예산 목록입니다. 이 필드를 설정하지 않으면 캠페인에서 무제한 예산이 사용됩니다. |
CampaignGoal
캠페인의 목표를 제어하는 설정입니다.
JSON 표현 |
---|
{ "campaignGoalType": enum ( |
필드 | |
---|---|
campaignGoalType |
필수 항목입니다. 캠페인 목표의 유형입니다. |
performanceGoal |
필수 항목입니다. 캠페인의 실적 목표입니다. 사용 가능한
|
CampaignGoalType
가능한 캠페인 목표 유형입니다.
열거형 | |
---|---|
CAMPAIGN_GOAL_TYPE_UNSPECIFIED |
이 버전에서 목표값이 지정되지 않았거나 알 수 없습니다. |
CAMPAIGN_GOAL_TYPE_APP_INSTALL |
앱 설치 또는 참여를 유도합니다. |
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS |
브랜드 또는 제품의 인지도를 높입니다. |
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION |
오프라인 또는 매장 판매를 유도합니다. |
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION |
온라인 액션 또는 방문을 유도합니다. |
CampaignFlight
계획된 지출 및 캠페인 기간을 추적하는 설정입니다.
JSON 표현 |
---|
{
"plannedSpendAmountMicros": string,
"plannedDates": {
object ( |
필드 | |
---|---|
plannedSpendAmountMicros |
주어진 금액은 마이크로 단위입니다. 0보다 크거나 같아야 합니다. 예를 들어 500000000은 500개의 통화 표준 단위를 나타냅니다. |
plannedDates |
필수 항목입니다. 캠페인이 실행될 것으로 예상되는 날짜입니다. 상위 광고주의 시간대를 기준으로 해결됩니다.
|
CampaignBudget
캠페인 예산 할당 방법을 제어하는 설정입니다.
JSON 표현 |
---|
{ "budgetId": string, "displayName": string, "budgetUnit": enum ( |
필드 | |
---|---|
budgetId |
캠페인 예산의 고유 ID입니다. 시스템에서 할당합니다. 새 예산을 설정하지 마세요. 예산을 업데이트하거나 |
displayName |
필수 항목입니다. 예산의 표시 이름입니다. 최대 240바이트의 UTF-8로 인코딩되어야 합니다. |
budgetUnit |
필수 항목입니다. 변경할 수 없습니다. 예산을 통화로 측정할지 노출수로 측정할지 지정합니다. |
budgetAmountMicros |
필수 항목입니다. 연결된 게재 신청서 세그먼트에서 예산을 할당할 수 있는 총 금액입니다. 금액은 마이크로 단위입니다. 0보다 커야 합니다. 예를 들어 500000000은 500개의 통화 표준 단위를 나타냅니다. |
dateRange |
필수 항목입니다. 캠페인 예산의 기간입니다. 연결된 예산 세그먼트의 기간은 다를 수 있습니다. 상위 광고주의 시간대를 기준으로 해결됩니다.
|
externalBudgetSource |
필수 항목입니다. 예산의 외부 소스입니다. |
externalBudgetId |
변경할 수 없습니다. 외부 소스에 이 예산을 식별하는 ID입니다. 이 필드가 설정되고 해당 결제 프로필의 인보이스 세부정보 수준이 '예산 수준 PO'로 설정된 경우 이 예산에 대해 게재되는 모든 노출에 이 ID가 인보이스에 포함됩니다. 캠페인 내에서 고유해야 합니다. |
invoiceGroupingId |
변경할 수 없습니다. 동일한 인보이스에 포함될 예산을 그룹화하는 데 사용되는 ID입니다. 이 필드가 설정되고 해당 결제 프로필의 인보이스 수준이 '예산 인보이스 그룹 ID'로 설정된 경우 동일한 |
prismaConfig |
Mediaocean Prisma 도구에서 사용하기 위한 추가 메타데이터입니다. Mediaocean 예산에 필요합니다.
|
ExternalBudgetSource
캠페인 예산 세그먼트의 외부 소스입니다.
열거형 | |
---|---|
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED |
이 버전에서는 외부 예산 소스 값이 지정되지 않았거나 알 수 없습니다. |
EXTERNAL_BUDGET_SOURCE_NONE |
예산에 외부 소스가 없습니다. |
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN |
예산 소스는 Mediaocean입니다. |
PrismaConfig
Mediaocean Prisma 도구 전용 설정입니다.
JSON 표현 |
---|
{ "prismaType": enum ( |
필드 | |
---|---|
prismaType |
필수 항목입니다. Prisma 유형입니다. |
prismaCpeCode |
필수 항목입니다. Mediaocean Prisma 도구의 관련 고객, 제품 및 추정 코드 |
supplier |
필수 항목입니다. 이 예산을 할당한 개체 (DSP, 사이트 등)입니다. |
PrismaType
Prisma 예산에 가능한 유형입니다.
열거형 | |
---|---|
PRISMA_TYPE_UNSPECIFIED |
이 버전에서 유형이 지정되지 않았거나 알 수 없습니다. |
PRISMA_TYPE_DISPLAY |
디스플레이 유형입니다. |
PRISMA_TYPE_SEARCH |
검색 유형 |
PRISMA_TYPE_VIDEO |
동영상 유형입니다. |
PRISMA_TYPE_AUDIO |
오디오 유형입니다. |
PRISMA_TYPE_SOCIAL |
소셜 유형 |
PRISMA_TYPE_FEE |
수수료 유형입니다. |
PrismaCpeCode
Google 결제 센터는 이 코드의 구성요소 필드에서 검색과 필터링을 지원합니다.
JSON 표현 |
---|
{ "prismaClientCode": string, "prismaProductCode": string, "prismaEstimateCode": string } |
필드 | |
---|---|
prismaClientCode |
Prisma 클라이언트 코드입니다. |
prismaProductCode |
Prisma 제품 코드입니다. |
prismaEstimateCode |
Prisma 견적 코드입니다. |
메서드 |
|
---|---|
|
새 캠페인을 만듭니다. |
|
캠페인을 영구적으로 삭제합니다. |
|
캠페인을 가져옵니다. |
|
광고주의 캠페인을 나열합니다. |
|
타겟팅 유형 전반에서 캠페인에 할당된 타겟팅 옵션을 나열합니다. |
|
기존 캠페인을 업데이트합니다. |