REST Resource: advertisers.campaigns

{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "campaignGoal": {
    object (CampaignGoal)
  },
  "campaignFlight": {
    object (CampaignFlight)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "campaignBudgets": [
    {
      object (CampaignBudget)
    }
  ]
}

string

Chỉ có đầu ra. Tên tài nguyên của chiến dịch.

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng duy nhất của nhà quảng cáo chứa chiến dịch.

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng duy nhất của chiến dịch. Do hệ thống chỉ định.

string

Bắt buộc. Tên hiển thị của chiến dịch.

Phải được mã hoá UTF-8 với kích thước tối đa là 240 byte.

enum (EntityStatus)

Bắt buộc. Kiểm soát việc đơn đặt hàng quảng cáo trong chiến dịch này có thể chi tiêu ngân sách và đặt giá thầu trên khoảng không quảng cáo hay không.

• Các giá trị được chấp nhận là ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED và ENTITY_STATUS_PAUSED.
• Đối với phương thức campaigns.create, ENTITY_STATUS_ARCHIVED không được phép.

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian khi chiến dịch được cập nhật lần gần đây nhất. Do hệ thống chỉ định.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

object (CampaignGoal)

Bắt buộc. Mục tiêu của chiến dịch.

object (CampaignFlight)

Bắt buộc. Mức chi tiêu theo kế hoạch và thời lượng của chiến dịch.

object (FrequencyCap)

Bắt buộc. Chế độ cài đặt giới hạn tần suất của chiến dịch.

object (CampaignBudget)

Danh sách ngân sách có thể sử dụng cho chiến dịch này.

Nếu bạn không đặt trường này, chiến dịch sẽ sử dụng ngân sách không giới hạn.

{
  "campaignGoalType": enum (CampaignGoalType),
  "performanceGoal": {
    object (PerformanceGoal)
  }
}

enum (CampaignGoalType)

Bắt buộc. Loại mục tiêu của chiến dịch.

object (PerformanceGoal)

Bắt buộc. Mục tiêu hiệu suất của chiến dịch.

Các giá trị được chấp nhận cho performanceGoalType là:

• PERFORMANCE_GOAL_TYPE_CPM
• PERFORMANCE_GOAL_TYPE_CPC
• PERFORMANCE_GOAL_TYPE_CPA
• PERFORMANCE_GOAL_TYPE_CPIAVC
• PERFORMANCE_GOAL_TYPE_CTR
• PERFORMANCE_GOAL_TYPE_VIEWABILITY
• PERFORMANCE_GOAL_TYPE_OTHER

{
  "performanceGoalType": enum (PerformanceGoalType),

  // Union field performance_goal_value can be only one of the following:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of list of possible types for union field performance_goal_value.
}

enum (PerformanceGoalType)

Bắt buộc. Loại mục tiêu hiệu suất.

string (int64 format)

Số tiền mục tiêu, tính bằng phần triệu đơn vị tiền tệ của nhà quảng cáo.

Áp dụng khi performanceGoalType là một trong:

• PERFORMANCE_GOAL_TYPE_CPM
• PERFORMANCE_GOAL_TYPE_CPC
• PERFORMANCE_GOAL_TYPE_CPA
• PERFORMANCE_GOAL_TYPE_CPIAVC
• PERFORMANCE_GOAL_TYPE_VCPM

Ví dụ: 1500000 đại diện cho 1,5 đơn vị tiền tệ chuẩn.

string (int64 format)

Giá trị thập phân của tỷ lệ phần trăm mục tiêu tính bằng micrô giây.

Áp dụng khi performanceGoalType là một trong:

• PERFORMANCE_GOAL_TYPE_CTR
• PERFORMANCE_GOAL_TYPE_VIEWABILITY
• PERFORMANCE_GOAL_TYPE_CLICK_CVR
• PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
• PERFORMANCE_GOAL_TYPE_VTR
• PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
• PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE

Ví dụ: 70000 biểu thị 7% (thập phân 0, 07).

string

Chuỗi chỉ báo hiệu suất chính (KPI) có thể để trống. Phải dùng phương thức mã hoá UTF-8 với độ dài không quá 100 ký tự.

Có thể áp dụng khi bạn đặt performanceGoalType thành PERFORMANCE_GOAL_TYPE_OTHER.

{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}

string (int64 format)

Số tiền mà chiến dịch dự kiến sẽ chi tiêu cho plannedDates cụ thể. Việc này sẽ không giới hạn việc phân phát, nhưng sẽ được dùng để theo dõi mức chi tiêu trong giao diện người dùng DV360.

Số lượng được tính bằng phần triệu. Phải lớn hơn hoặc bằng 0. Ví dụ: 500000000 đại diện cho 500 đơn vị tiền tệ tiêu chuẩn.

object (DateRange)

Bắt buộc. Ngày mà chiến dịch dự kiến sẽ chạy. Các khoảng thời gian này được phân giải theo múi giờ của nhà quảng cáo mẹ.

• Ngày được chỉ định ở đây sẽ không ảnh hưởng đến việc phân phát. Chúng được dùng để tạo cảnh báo và cảnh báo. Ví dụ: nếu thời gian hiển thị của đơn đặt hàng quảng cáo con bất kỳ nằm ngoài phạm vi các ngày này, thì giao diện người dùng sẽ hiển thị cảnh báo.
• startDate là bắt buộc và phải là ngày hiện tại hoặc sau đó.
• endDate là không bắt buộc. Nếu được chỉ định thì mã đó phải là startDate trở lên.
• Mọi ngày được chỉ định đều phải trước năm 2037.

{
  "budgetId": string,
  "displayName": string,
  "budgetUnit": enum (BudgetUnit),
  "budgetAmountMicros": string,
  "dateRange": {
    object (DateRange)
  },
  "externalBudgetSource": enum (ExternalBudgetSource),
  "externalBudgetId": string,
  "invoiceGroupingId": string,
  "prismaConfig": {
    object (PrismaConfig)
  }
}

string (int64 format)

Mã nhận dạng duy nhất của ngân sách chiến dịch. Do hệ thống chỉ định. Đừng đặt cho ngân sách mới.

Bạn phải cung cấp thông tin này khi cập nhật hoặc thêm ngân sách vào campaignBudgets. Nếu không, một mã nhận dạng mới sẽ được tạo và chỉ định.

string

Bắt buộc. Tên hiển thị của ngân sách.

Phải được mã hoá UTF-8 với kích thước tối đa là 240 byte.

enum (BudgetUnit)

Bắt buộc. Bất biến. Chỉ định xem ngân sách được tính bằng đơn vị tiền tệ hay số lượt hiển thị.

string (int64 format)

Bắt buộc. Tổng số tiền chi tiêu cho phân khúc đơn đặt hàng quảng cáo được liên kết.

Số lượng được tính bằng phần triệu. Phải lớn hơn 0. Ví dụ: 500000000 đại diện cho 500 đơn vị tiền tệ tiêu chuẩn.

object (DateRange)

Bắt buộc. Phạm vi ngày cho ngân sách chiến dịch. Các phân đoạn ngân sách được liên kết có thể có phạm vi ngày khác. Các khoảng thời gian này được phân giải theo múi giờ của nhà quảng cáo mẹ.

Cả startDate và endDate đều phải trước năm 2037.

enum (ExternalBudgetSource)

Bắt buộc. Nguồn bên ngoài của ngân sách.

string

Bất biến. Mã nhận dạng giúp xác định ngân sách này cho nguồn bên ngoài.

Nếu bạn đặt trường này và cấp thông tin hoá đơn của hồ sơ thanh toán tương ứng được đặt thành "Đơn đặt hàng cấp ngân sách", thì tất cả lượt hiển thị được phân phát dựa trên ngân sách này sẽ bao gồm mã này trên hoá đơn.

Phải là duy nhất trong chiến dịch.

string

Bất biến. Mã này dùng để nhóm các ngân sách cần đưa vào cùng một hoá đơn.

Nếu bạn đặt trường này và cấp hoá đơn của hồ sơ thanh toán tương ứng được đặt thành "Mã nhóm hoá đơn theo ngân sách", thì tất cả externalBudgetId có cùng invoiceGroupingId sẽ được gộp nhóm vào cùng một hoá đơn.

object (PrismaConfig)

Siêu dữ liệu bổ sung để công cụ Mediaocean Prisma sử dụng.

Bắt buộc đối với ngân sách Mediaocean.

Chỉ áp dụng cho prismaEnabled nhà quảng cáo.

{
  "prismaType": enum (PrismaType),
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "supplier": string
}

enum (PrismaType)

Bắt buộc. Loại Prisma.

object (PrismaCpeCode)

Bắt buộc. Khách hàng, sản phẩm và mã ước tính có liên quan từ công cụ Mediaocean Prisma.

string

Bắt buộc. Mục đã phân bổ ngân sách này (DSP, trang web, v.v.).

{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}

string

Mã khách hàng Prisma.

string

Mã sản phẩm Prisma.

string

Mã ước tính Prisma.