- Tài nguyên: Chiến dịch
- CampaignGoal
- CampaignGoalType
- PerformanceGoal
- PerformanceGoalType
- CampaignFlight
- CampaignBudget
- ExternalBudgetSource
- PrismaConfig
- PrismaType
- PrismaCpeCode
- Phương thức
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 ( |
Các trường | |
---|---|
name |
Chỉ có đầu ra. Tên tài nguyên của chiến dịch. |
advertiserId |
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 |
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 |
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 |
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.
|
updateTime |
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ụ: |
campaignGoal |
Bắt buộc. Mục tiêu của chiến dịch. |
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 |
Bắt buộc. Chế độ cài đặt giới hạn tần suất của chiến dịch. |
campaignBudgets[] |
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 ( |
Các trường | |
---|---|
campaignGoalType |
Bắt buộc. Loại mục tiêu chiến dịch. |
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
|
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. |
PerformanceGoal
Các chế độ cài đặt kiểm soát mục tiêu hiệu suất của chiến dịch.
Biểu diễn dưới dạng JSON |
---|
{ "performanceGoalType": enum ( |
Các trường | |
---|---|
performanceGoalType |
Bắt buộc. Loại mục tiêu hiệu suất. |
Trường nhóm performance_goal_value . Bắt buộc. Giá trị mục tiêu hiệu suất tương ứng với một performance_goal_type nhất định. performance_goal_value chỉ có thể là một trong những trạng thái sau đây: |
|
performanceGoalAmountMicros |
Số tiền mục tiêu, theo đơn vị tiền tệ của nhà quảng cáo. Áp dụng khi
Ví dụ: 1500000 đại diện cho 1,5 đơn vị tiêu chuẩn của tiền tệ. |
performanceGoalPercentageMicros |
Giá trị thập phân biểu diễn của tỷ lệ phần trăm mục tiêu tính bằng micrô giây. Áp dụng khi
Ví dụ: 70000 đại diện cho 7% (thập phân 0, 07). |
performanceGoalString |
Chuỗi chỉ báo hiệu suất chính (KPI) có thể để trống. Phải là mã UTF-8 với độ dài không quá 100 ký tự. Áp dụng khi bạn đặt |
PerformanceGoalType
Các loại mục tiêu hiệu suất có thể có.
Enum | |
---|---|
PERFORMANCE_GOAL_TYPE_UNSPECIFIED |
Loại mục tiêu hiệu suất chưa được chỉ định hoặc chưa xác định trong phiên bản này. |
PERFORMANCE_GOAL_TYPE_CPM |
Mục tiêu về hiệu suất được đặt theo CPM (chi phí mỗi nghìn lượt hiển thị quảng cáo). |
PERFORMANCE_GOAL_TYPE_CPC |
Mục tiêu hiệu suất được đặt theo CPC (chi phí mỗi lượt nhấp). |
PERFORMANCE_GOAL_TYPE_CPA |
Mục tiêu về hiệu suất được đặt theo CPA (chi phí mỗi hành động). |
PERFORMANCE_GOAL_TYPE_CTR |
Mục tiêu hiệu suất được đặt theo tỷ lệ phần trăm CTR (tỷ lệ nhấp). |
PERFORMANCE_GOAL_TYPE_VIEWABILITY |
Mục tiêu về hiệu suất được đặt trong Phần trăm khả năng xem. |
PERFORMANCE_GOAL_TYPE_CPIAVC |
Mục tiêu hiệu suất được đặt thành CPIAVC (chi phí mỗi lượt hiển thị có thể nghe và có thể xem khi hoàn tất). |
PERFORMANCE_GOAL_TYPE_CPE |
Mục tiêu hiệu suất được đặt trong CPE (chi phí mỗi lượt tương tác). |
PERFORMANCE_GOAL_TYPE_CLICK_CVR |
Mục tiêu về hiệu suất được đặt theo tỷ lệ phần trăm tỷ lệ chuyển đổi từ lượt nhấp (số lượt chuyển đổi trên mỗi lượt nhấp). |
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR |
Mục tiêu về hiệu suất được đặt theo tỷ lệ phần trăm tỷ lệ chuyển đổi lượt hiển thị (số lượt chuyển đổi trên mỗi lượt hiển thị). |
PERFORMANCE_GOAL_TYPE_VCPM |
Mục tiêu về hiệu suất được đặt theo VCPM (chi phí mỗi nghìn lượt hiển thị có thể xem). |
PERFORMANCE_GOAL_TYPE_VTR |
Mục tiêu về hiệu suất được đặt theo tỷ lệ phần trăm tỷ lệ xem trên YouTube (số lượt xem trên YouTube trên mỗi lượt hiển thị). |
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE |
Mục tiêu hiệu suất được đặt theo tỷ lệ phần trăm nghe hết âm thanh (số lượt nghe hết âm thanh trên mỗi lượt hiển thị). |
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE |
Mục tiêu hiệu suất được đặt theo tỷ lệ phần trăm xem hết video (số lượt xem video hoàn chỉnh trên mỗi lượt hiển thị). |
PERFORMANCE_GOAL_TYPE_OTHER |
Mục tiêu hiệu suất được đặt thành Khác. |
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 ( |
Các trường | |
---|---|
plannedSpendAmountMicros |
Số tiền mà chiến dịch dự kiến sẽ chi tiêu trong 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 |
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.
|
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 ( |
Các trường | |
---|---|
budgetId |
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 |
displayName |
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 |
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 |
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 |
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ả |
externalBudgetSource |
Bắt buộc. Nguồn ngân sách bên ngoài. |
externalBudgetId |
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 |
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ả |
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 |
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 ( |
Các trường | |
---|---|
prismaType |
Bắt buộc. Loại Prisma. |
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 |
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_SEARCH |
Loại tìm kiếm. |
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 |
Mã máy khách Prisma. |
prismaProductCode |
Mã sản phẩm Prisma. |
prismaEstimateCode |
Mã ước tính Prisma. |
Phương thức |
|
---|---|
|
Tạo chiến dịch mới. |
|
Xoá vĩnh viễn chiến dịch. |
|
Nhận được một chiến dịch. |
|
Liệt kê chiến dịch trong một nhà quảng cáo. |
|
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. |
|
Cập nhật chiến dịch hiện tại. |