Chuyển đổi chiến dịch Thông minh thành chiến dịch Tối đa hoá hiệu suất

Trong phiên bản v25 trở lên, bạn có thể sử dụng phương thức SmartCampaignSettingService.GeneratePMaxDraftCampaign để 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 lượt chuyển đổi

Khi bạn gọi SmartCampaignSettingService.GeneratePMaxDraftCampaign, API sẽ tạo một 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 nháp, 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 nháp Tối đa hoá hiệu suất được tạo sẽ được khởi chạy với các giá trị trạng thái sau:

  • status được đặt thành PAUSED.
  • Trạng thái đủ điều kiện phân phát của quảng cáo được thể hiện trong primary_status.
  • contains_eu_political_advertising được đặt thành DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING theo 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ó chứa 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 đã 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:

  1. Xem hướng dẫn về yêu cầu đối với thành phần.
  2. Tải hình ảnh mới lên bằng cách làm theo ví dụ về tải thành phần hình ảnh lên.
  3. 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 đường liên kết AssetGroupAsset cho hình ảnh giữ chỗ (trong cùng một yêu cầu thay đổi tài nguyên 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 về thành phần) bằng cách làm theo hướng dẫn liên kết nhóm thành phần với thành phần.

Tham số 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ủa SmartCampaignSetting cần 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_id
    
  • validate_only (Không bắt buộc): Nếu true, yêu cầu sẽ được xác thực nhưng không được thực thi. Chỉ có lỗi xác thực, cảnh báo hoặc các vấn đề có thể xảy ra khi chuyển đổi được trả về trong trường validated_info củ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 địa điểm trên 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. Để trống trường này hoặc đặt thành false; việc đặt thành true không được hỗ trợ và sẽ trả về lỗi SmartCampaignError.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 hay không (chẳng hạn như các loại hình ảnh ngang, vuông và biểu trưng). Hãy để trống trường này hoặc đặt thành false; việc đặt thành true không được hỗ trợ và sẽ trả về lỗi SmartCampaignError.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 nháp Tối đa hoá hiệu suất đã tạo và các thực thể liên quan:

  • pmax_campaign: Tên tài nguyên Campaign củ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ên CampaignBudget được liên kết với chiến dịch Tối đa hoá hiệu suất đã tạo.
  • asset_group: Tên tài nguyên AssetGroup được liên kết với chiến dịch Tối đa hoá hiệu suất đã tạo.
  • assets: Danh sách tên tài nguyên Asset được liên kết với chiến dịch Tối đa hoá hiệu suất đã 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 quy trình kiểm tra lượt chuyển đổi trả về (được điền sẵn cả khi validate_only được đặt thành true và cùng với tên tài nguyên thực thể được tạo khi validate_only là false).

Để chuyển đổi một chiến dịch Thông minh, hãy làm theo quy trình sau:

  1. Tạo chiến dịch nháp: Gọi SmartCampaignSettingService.GeneratePMaxDraftCampaign chỉ với resource_name bắt buộc được đặt (để trống gbp_enabled và image_enabled hoặc đặt thành false). Lưu tên tài nguyên pmax_campaign, campaign_budget, asset_group và assets được trả về.
  2. 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 bằng status = PAUSED và creation_status = INCOMPLETE, nên 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 đó.
  3. 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 status của chiến dịch Tối đa hoá hiệu suất thành ENABLED, sau đó cập nhật status của chiến dịch Thông minh gốc thành PAUSED để tránh phân phát trùng lặp.