Trong v25 trở lên, bạn có thể sử dụng
SmartCampaignSettingService.GeneratePMaxDraftCampaign
phương thức để chuyển đổi chiến dịch Thông minh thành chiến dịch Tối đa hoá hiệu suất. Phương thức này không có trong v24 trở xuống.
Cách hoạt động của quy trình chuyển đổi
Khi bạn gọi
SmartCampaignSettingService.GeneratePMaxDraftCampaign,
API sẽ tạo chiến dịch Tối đa hoá hiệu suất nháp, ngân sách, nhóm thành phần và thành phần,
dựa trên cấu hình của chiến dịch Thông minh được cung cấp trong yêu cầu. Sau khi tạo, bạn nên kiểm tra, sửa đổi và cải thiện các tài nguyên mới trước khi bật chiến dịch để phân phát quảng cáo.
Chiến dịch Tối đa hoá hiệu suất nháp được tạo sẽ được khởi chạy với các giá trị trạng thái sau:
statusđược đặt thànhPAUSED.- Điều kiện phân phát của chiến dịch được phản ánh trong
primary_status. contains_eu_political_advertisingđược đặt thànhDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGtheo mặc định (nếu chưa được chỉ định trên chiến dịch Thông minh). Hãy xác minh và cập nhật trường này nếu chiến dịch của bạn có quảng cáo chính trị ở Liên minh Châu Âu.
Nhờ đó, bạn có thể kiểm tra, sửa đổi và cải thiện chiến dịch Tối đa hoá hiệu suất, ngân sách, nhóm thành phần và thành phần được tạo trước khi bật chiến dịch để phân phát quảng cáo.
Thành phần nháp
Chiến dịch mới đi kèm với một nhóm hình ảnh giữ chỗ cần được thay thế trước khi chiến dịch mới được bật. Khi trường image_enabled được hỗ trợ và đặt thành true trong yêu cầu, API sẽ tự động tạo hình ảnh thay vì sử dụng hình ảnh giữ chỗ. Bạn có thể kiểm tra các thành phần mới trong trường assets của phản hồi và thay thế các thành phần đó bằng cách làm theo các bước sau:
- Xem hướng dẫn về các yêu cầu đối với thành phần .
- Tải hình ảnh mới lên bằng cách làm theo ví dụ về thành phần hình ảnh tải lên.
- Liên kết các thành phần mới với nhóm thành phần của chiến dịch nháp, sau đó xoá các
AssetGroupAssetđường liên kết cho hình ảnh giữ chỗ (trong cùng một yêu cầu thay đổi tài nguyên nguyên tử hoặc sau khi liên kết các thành phần mới để vẫn đáp ứng các yêu cầu tối thiểu đối với thành phần) bằng cách làm theo hướng dẫn về cách liên kết nhóm thành phần với thành phần.
Các tham số trong yêu cầu
Thông báo GeneratePMaxDraftCampaignRequest chấp nhận
các trường sau:
resource_name(Bắt buộc): Tên tài nguyên củaSmartCampaignSettingđể tạo lại cho chiến dịch Thông minh mà bạn muốn chuyển đổi, theo định dạng sau:customers/customer_id/smartCampaignSettings/campaign_idvalidate_only(Không bắt buộc): Nếutrue, yêu cầu sẽ được xác thực nhưng không được thực thi. Chỉ các lỗi xác thực, cảnh báo hoặc vấn đề có thể xảy ra về lượt chuyển đổi mới được trả về trong trườngvalidated_infocủa phản hồi mà không tạo thực thể nháp.gbp_enabled(Không được hỗ trợ): Không bắt buộc. Có chuyển đổi vị trí của Trang doanh nghiệp trên Google (GBP) được liên kết với chiến dịch Tối đa hoá hiệu suất hay không. Hãy để trường này ở trạng thái chưa đặt hoặcfalse; việc đặt trường này thànhtruekhông được hỗ trợ và trả về lỗiSmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.image_enabled(Không được hỗ trợ): Không bắt buộc. Có tạo hình ảnh bắt buộc cho chiến dịch Tối đa hoá hiệu suất (chẳng hạn như các loại hình ảnh ngang, hình vuông và hình ảnh logo) hay không. Hãy để trường này ở trạng thái chưa đặt hoặcfalse; việc đặt trường này thànhtruekhông được hỗ trợ và trả về lỗiSmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.
Chi tiết về câu trả lời
Thông báo GeneratePMaxDraftCampaignResponse
trả về tên tài nguyên của chiến dịch Tối đa hoá hiệu suất nháp được tạo và
các thực thể được liên kết với chiến dịch đó:
pmax_campaign: Tên tài nguyênCampaigncủa chiến dịch Tối đa hoá hiệu suất nháp được tạo.campaign_budget: Tên tài nguyênCampaignBudgetđược liên kết với chiến dịch Tối đa hoá hiệu suất được tạo.asset_group: Tên tài nguyênAssetGroupđược liên kết với chiến dịch Tối đa hoá hiệu suất được tạo.assets: Danh sách tên tài nguyênAssetđược liên kết với chiến dịch Tối đa hoá hiệu suất được tạo.validated_info: Thông tin xác thực hoặc các vấn đề có thể xảy ra về lượt chuyển đổi do quá trình kiểm tra lượt chuyển đổi trả về (được điền sẵn cả khivalidate_onlyđược đặt thànhtruevà cùng với tên tài nguyên của thực thể được tạo khivalidate_onlylàfalse).
Quy trình công việc được đề xuất
Để chuyển đổi chiến dịch Thông minh, hãy sử dụng quy trình công việc sau:
- Tạo chiến dịch nháp: Gọi
SmartCampaignSettingService.GeneratePMaxDraftCampaignchỉ vớiresource_namebắt buộc được đặt (đểgbp_enabledvàimage_enabledở trạng thái chưa đặt hoặc đặt thànhfalse). Lưu tên tài nguyênpmax_campaign,campaign_budget,asset_groupvàassetsđược trả về. - Xem xét và tuỳ chỉnh chiến dịch: Vì chiến dịch Tối đa hoá hiệu suất nháp
được tạo với
status = PAUSEDvàcreation_status = INCOMPLETE, hãy kiểm tra và định cấu hình ngân sách, nhóm thành phần và thành phần của chiến dịch đó. - Bật chiến dịch và tạm dừng chiến dịch gốc: Khi bạn đã sẵn sàng phân phát
quảng cáo, hãy cập nhật
statuscủa chiến dịch Tối đa hoá hiệu suất thànhENABLED, sau đó cập nhậtstatuscủa chiến dịch Thông minh gốc thànhPAUSEDđể tránh phân phát trùng lặp.