REST Resource: advertisers.campaigns

Tài nguyên: Chiến dịch

Một chiến dịch duy nhất.

Biểu diễn dưới dạng JSON 
{
  "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)
    }
  ]
}
Các trường
name

string

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

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.
campaignId

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.
displayName

string

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

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

enum (EntityStatus)

Bắt buộc. Kiểm soát việc cá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.

  • 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.
updateTime

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 ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
campaignGoal

object (CampaignGoal)

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

object (CampaignFlight)

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

object (FrequencyCap)

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

object (CampaignBudget)

Danh sách ngân sách có thể 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.

CampaignGoal

Chế độ cài đặt kiểm soát mục tiêu của chiến dịch.

Biểu diễn dưới dạng JSON 
{
  "campaignGoalType": enum (CampaignGoalType),
  "performanceGoal": {
    object (PerformanceGoal)
  }
}
Các trường
campaignGoalType

enum (CampaignGoalType)

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

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

CampaignGoalType

Các loại mục tiêu chiến dịch có thể có.

Enum
CAMPAIGN_GOAL_TYPE_UNSPECIFIED Giá trị mục tiêu không được chỉ định hoặc không xác định trong phiên bản này.
CAMPAIGN_GOAL_TYPE_APP_INSTALL Tăng số lượt cài đặt ứng dụng hoặc lượt tương tác.
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS Tăng mức độ nhận biết về thương hiệu hoặc sản phẩm.
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION Tăng doanh số bán hàng tại cửa hàng hoặc ngoại tuyến.
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION Thúc đẩy lượt truy cập hoặc hành động trực tuyến.

CampaignFlight

Chế độ cài đặt theo dõi mức chi tiêu theo kế hoạch và thời lượng của chiến dịch.

Biểu diễn dưới dạng JSON 
{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}
Các trường
plannedSpendAmountMicros

string (int64 format)

Số tiền mà chiến dịch dự kiến sẽ chi tiêu trong plannedDates đã cho. Điều 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ố tiền được trình bày dưới dạ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ệ chuẩn.
plannedDates

object (DateRange)

Bắt buộc. Ngày mà chiến dịch dự kiến sẽ chạy. Các khung giờ này được phân giải tương ứng với múi giờ của nhà quảng cáo gốc.

  • Ngày được chỉ định ở đây sẽ không ảnh hưởng đến việc phân phát. Các thông báo này được dùng để tạo cảnh báo và cảnh báo. Ví dụ: nếu ngày hiển thị của đơn đặt hàng quảng cáo con nằm ngoài phạm vi những ngày này, thì giao diện người dùng sẽ hiển thị một 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, đó phải là startDate trở lên.
  • Mọi ngày được chỉ định đều phải trước năm 2037.

CampaignBudget

Chế độ cài đặt kiểm soát cách phân bổ ngân sách chiến dịch.

Biểu diễn dưới dạng JSON 
{
  "budgetId": string,
  "displayName": string,
  "budgetUnit": enum (BudgetUnit),
  "budgetAmountMicros": string,
  "dateRange": {
    object (DateRange)
  },
  "externalBudgetSource": enum (ExternalBudgetSource),
  "externalBudgetId": string,
  "invoiceGroupingId": string,
  "prismaConfig": {
    object (PrismaConfig)
  }
}
Các trường
budgetId

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 đưa thông tin này vào 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.
displayName

string

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

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

enum (BudgetUnit)

Bắt buộc. Không thể thay đổi. Chỉ định xem ngân sách được đo lường bằng đơn vị tiền tệ hay số lượt hiển thị.
budgetAmountMicros

string (int64 format)

Bắt buộc. Tổng số tiền mà các phân khúc đơn đặt hàng quảng cáo đã liên kết có thể đặt ngân sách.

Số tiền được trình bày dưới dạ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ệ chuẩn.
dateRange

object (DateRange)

Bắt buộc. Phạm vi ngày cho ngân sách chiến dịch. 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 khung giờ này được phân giải tương ứng với múi giờ của nhà quảng cáo gốc.

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

enum (ExternalBudgetSource)

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

string

Không thể thay đổi. Mã nhận dạng 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à đặt cấp chi tiết hoá đơn của hồ sơ thanh toán tương ứng thành "Cấp ngân sách PO", thì tất cả lượt hiển thị được phân phát bằng ngân sách này sẽ ghi nhận mã này trên hoá đơn.

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

string

Không thể thay đổi. Mã được sử dụng để nhóm các ngân sách để đưa vào cùng một hoá đơn.

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

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.

ExternalBudgetSource

Nguồn bên ngoài cho phân đoạn ngân sách của chiến dịch.

Enum
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED Giá trị nguồn ngân sách bên ngoài chưa được chỉ định hoặc không xác định trong phiên bản này.
EXTERNAL_BUDGET_SOURCE_NONE Ngân sách không có nguồn bên ngoài.
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN Nguồn ngân sách là Mediaocean.

PrismaConfig

Chế độ cài đặt dành riêng cho công cụ Mediaocean Prisma.

Biểu diễn dưới dạng JSON 
{
  "prismaType": enum (PrismaType),
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "supplier": string
}
Các trường
prismaType

enum (PrismaType)

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

object (PrismaCpeCode)

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

string

Bắt buộc. Pháp nhân phân bổ ngân sách này (DSP, trang web, v.v.).

PrismaType

Các loại có thể có cho ngân sách Prisma.

Enum
PRISMA_TYPE_UNSPECIFIED Loại chưa được chỉ định hoặc không xác định trong phiên bản này.
PRISMA_TYPE_DISPLAY Loại hiển thị.
PRISMA_TYPE_VIDEO Loại video.
PRISMA_TYPE_AUDIO Loại âm thanh.
PRISMA_TYPE_SOCIAL Loại xã hội.
PRISMA_TYPE_FEE Loại phí.

PrismaCpeCode

Trung tâm thanh toán của Google hỗ trợ tìm kiếm và lọc trên các trường thành phần của mã này.

Biểu diễn dưới dạng JSON 
{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}
Các trường
prismaClientCode

string

Mã máy khách Prisma.
prismaProductCode

string

Mã sản phẩm Prisma.
prismaEstimateCode

string

Mã ước tính Prisma.

Phương thức

bulkListCampaignAssignedTargetingOptions

 Liệt kê các lựa chọn nhắm mục tiêu được chỉ định của chiến dịch trên nhiều loại nhắm mục tiêu.

create

 Tạo chiến dịch mới.

delete

 Xoá vĩnh viễn chiến dịch.

get

 Nhận được một chiến dịch.

list

 Liệt kê chiến dịch trong một nhà quảng cáo.

patch

 Cập nhật chiến dịch hiện tại.