API Marketing

Bắt đầu sử dụng các tính năng AI tạo sinh trên API Marketing

Hỗ trợ API cho các tính năng AI tạo sinh

Nhà quảng cáo có trách nhiệm xem trước nội dung quảng cáo có nội dung do AI tạo trước khi đăng quảng cáo. Hãy xem hướng dẫn đặt cấu hình xem trước.

Meta không đưa ra bất kỳ bảo đảm nào liên quan đến tính đầy đủ, độ tin cậy cũng như độ chính xác của kết quả tạo văn bản gợi ý, phông nền được tạo hoặc hình ảnh được mở rộng. Nếu bạn sử dụng API Marketing để truy cập các tính năng AI tạo sinh nêu bên dưới, Điều khoản về AI tạo sinh trong nội dung quảng cáo sẽ được áp dụng cùng với Điều khoản của nền tảng Meta.

Tài liệu này sẽ chỉ cho bạn cách sử dụng tính năng tạo văn bản, mở rộng hình ảnh và tạo phông nền của AI tạo sinh cho quảng cáo.

Trước khi bắt đầu

Bạn cần làm theo những bước dưới đây để thiết lập chiến dịch quảng cáo bằng các tính năng AI tạo sinh của Meta.

  1. Tạo chiến dịch
  2. Tạo nhóm quảng cáo
  3. Tạo quảng cáo hoặc nội dung độc lập
  4. Xem trước nội dung
  5. Bật quảng cáo

Tạo văn bản

AI sẽ tạo ra các biến thể văn bản dựa trên văn bản chính gốc, quảng cáo trước đó hoặc nội dung từ Trang kinh doanh của bạn để giúp đưa ra gợi ý phù hợp hơn. Việc thêm nhiều tùy chọn văn bản hơn vào quảng cáo có thể giúp tùy chỉnh nội dung của bạn và giảm bớt tình trạng bão hoà nội dung, từ đó tăng hiệu quả. Tìm hiểu thêm về tính năng này tại đây.

Bước 1: Chọn sử dụng tính năng Tạo văn bản khi tạo quảng cáo

Bạn có thể tạo quảng cáo thông qua điểm cuối /ads hoặc tạo nội dung độc lập thông qua điểm cuối /adcreatives. Bạn chỉ có thể chọn sử dụng tính năng này cho quảng cáo hoặc nội dung được tạo trong yêu cầu hiện tại. Trong cả hai trường hợp đó, hãy chọn sử dụng tính năng Tạo văn bản bằng cách:

  1. Cung cấp văn bản chính trong trường message thuộc object_story_spec
  2. Chọn sử dụng text_generation

Hãy xem yêu cầu mẫu bên dưới:

Chọn sử dụng thông qua điểm cuối /adcreatives

curl -X POST \
  -F 'name=Text Gen Creative' \
  -F 'object_story_spec={
      "link_data": {
         "image_hash": "<IMAGE_HASH>", 
         "link": "<URL>", 
         "message": "<PRIMARY_TEXT_HERE>",  <--- Primary Text Here
      },
      "page_id": "<PAGE_ID>"
  }' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "text_generation": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Hoặc bạn có thể tạo đối tượng quảng cáo bằng điểm cuối act_<AD_ACCOUNT_ID>/ads:

Chọn sử dụng thông qua điểm cuối /ads

curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Text Gen Adgroup",
    "object_story_spec": {
      "link_data": {
         "image_hash": "<IMAGE_HASH>", 
         "link": "<URL>", 
         "message": "<PRIMARY_TEXT_HERE>",  <--- Primary Text Here
      },
      "page_id": "<PAGE_ID>"
    },
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "text_generation": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Bước 2: Xem trước để tạo văn bản

Khi bạn tạo quảng cáo bằng cách chọn sử dụng text_generation, hệ thống sẽ chỉ áp dụng tính năng này cho quảng cáo hiện tại và sẽ chèn văn bản chính được tạo vào quy cách nội dung. Nếu bạn chọn sử dụng tính năng này thông qua điểm cuối /ads, hệ thống sẽ mặc định đặt trường status trên nhóm quảng cáo thành PAUSED (xem tài liệu). Bạn có thể xem xét gợi ý được tạo trước khi đặt trạng thái của quảng cáo thành ACTIVE theo cách thủ công để hệ thống có thể phân phối quảng cáo đó.

Bạn có thể xem trước quy cách nội dung chứa gợi ý được tạo bằng cách đọc asset_feed_spec thông qua ID nội dung hoặc ID quảng cáo. Hãy xem yêu cầu và phản hồi mẫu bên dưới:

Bắt đầu bằng cách truy vấn asset_feed_spec của nội dung quảng cáo độc lập mà bạn đã tạo ở bước 1.

Yêu cầu

// request from creative
curl -X GET -G \
  -d 'fields=asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CREATIVE_ID>
  
// request from ad
curl -X GET -G \
  -d 'fields=creative{asset_feed_spec,status}' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_ID>

Phản hồi

{
  "asset_feed_spec": {
    "bodies": [
      {
        "text": "Buy some cool LED TV at cheap price"
      },
      {
        "text": "Get your dream LED TV at an unbeatable price! Buy now and save big!"
      },
      {
        "text": "Get the best LED TV deals! 📺 Save money and upgrade your entertainment."
      },
      {
        "text": "Get an LED TV at a low cost! Cheap, high-quality options are available."
      },
      {
        "text": "Get LED TVs at affordable prices  ✨  !"
      }
    ],
    "optimization_type": "DEGREES_OF_FREEDOM"
  },
  "id": "<CREATIVE_ID>"
}

Sau khi bạn xem xét gợi ý và thấy có thể chấp nhận để đăng, hãy chuyển sang Bước 3 để đặt quảng cáo thành ACTIVE. Nếu bạn thấy không thể chấp nhận bất kỳ gợi ý được tạo nào, vui lòng tạo quảng cáo hoặc nội dung mới mà không chọn sử dụng tính năng Tạo văn bản.

Tạo nội dung mà không chọn sử dụng tính năng Tạo văn bản

curl -X POST \
  -F 'name=Text Gen Creative' \
  -F 'object_story_spec={
      "link_data": {
         "image_hash": "<IMAGE_HASH>", 
         "link": "<URL>", 
         "message": "<PRIMARY_TEXT_HERE>",
      },
      "page_id": "<PAGE_ID>"
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Bước 3: Đặt trạng thái của nhóm quảng cáo thành ACTIVE

Sau khi xác minh gợi ý văn bản được tạo, bạn có thể đặt status của quảng cáo thành ACTIVE. Bạn cần thực hiện bước này trong cả hai trường hợp:

  1. Khi một quảng cáo chọn sử dụng tính năng này thông qua điểm cuối /ads
  2. Nếu quảng cáo là quảng cáo đầu tiên dùng nội dung hiện có bằng cách chọn sử dụng tính năng tạo văn bản.

Yêu cầu

curl \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_ID>

Mở rộng hình ảnh

Tự động mở rộng hình ảnh của bạn để phù hợp với nhiều vị trí quảng cáo hơn.

Kể từ ngày 16/09/2024, chúng tôi sẽ thêm tính năng Mở rộng hình ảnh vào Điểm cải thiện tiêu chuẩn. Vì vậy, nếu bạn tạo quảng cáo hoặc nội dung quảng cáo đã chọn sử dụng tính năng Mở rộng hình ảnh, vui lòng tham khảo bài viết Điểm cải thiện tiêu chuẩn cho nội dung Advantage+ để biết thông tin về cách đặt standard_enhancements làm trường trong creative_features_spec.

Bước 1: Tạo quảng cáo hoặc nội dung đã chọn sử dụng tính năng mở rộng hình ảnh

Bạn có thể tạo quảng cáo thông qua điểm cuối /ads hoặc tạo nội dung độc lập thông qua điểm cuối /adcreatives. Trong cả hai trường hợp đó, hãy chọn sử dụng tính năng Mở rộng hình ảnh trong quy cách nội dung (xem ví dụ bên dưới).

Yêu cầu

// creative example
curl -X POST \
  -F 'name=Image Expansion Creative' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "image_uncrop": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
// ad example
curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Image Expansion Adgroup",
    "object_story_spec": {
      "link_data": {
         "image_hash": "<IMAGE_HASH>", 
         "link": "<URL>", 
         "message": "You got this.",
      },
      "page_id": "<PAGE_ID>"
    },
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "image_uncrop": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Bước 2: Xem trước để mở rộng hình ảnh

Tính năng này được hỗ trợ cho vị trí quảng cáo INSTAGRAM_STANDARD, FACEBOOK_REELS_MOBILE, INSTAGRAM_REELS, MOBILE_FEED_STANDARD, INSTGRAM_STORY. Để xem trước nội dung cho những vị trí quảng cáo này, hãy gửi yêu cầu GET đến điểm cuối /<AD_ID>/previews.

Nếu bạn không thể chấp nhận bất kỳ hình ảnh được tạo nào, vui lòng tạo lại quảng cáo hoặc nội dung mà không chọn sử dụng tính năng Mở rộng hình ảnh:

  • Đặt creative_feature thành image_uncrop.
  • Yêu cầu xem trước lại nếu status hiển thị là pending.

Lưu ý: Nếu nút transformation_spec không hiển thị, tức là nội dung không đủ điều kiện sử dụng tính năng mở rộng hình ảnh.

Yêu cầu

INSTAGRAM_STANDARD

curl -X GET -G \
  -d 'ad_format=INSTAGRAM_STANDARD' \
  -d 'creative_feature=image_uncrop' \
  -d 'access_token=/<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>/previews

FACEBOOK_REELS_MOBILE

curl -X GET -G \
  -d 'ad_format=FACEBOOK_REELS_MOBILE' \
  -d 'creative_feature=image_uncrop' \
  -d 'access_token=/<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>/previews

Phản hồi

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "image_uncrop": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible"
          }
        ]
      }
    }
  ]
}

(Không bắt buộc) Xem trước trực tiếp mà không cần tạo quảng cáo

Bạn cũng có thể yêu cầu xem trước bằng điểm cuối act_<AD_ACCOUNT_ID>/generatepreviews mà không thực sự cần tạo quảng cáo.

Yêu cầu

FACEBOOK_REELS_MOBILE

curl -X GET -G \
  -d 'ad_format=FACEBOOK_REELS_MOBILE' \
  -d 'creative_feature=image_uncrop' \
  -d 'creative={
       "object_story_spec": {
         "page_id": "<PAGE_ID>",
          "link_data": {
            "image_hash": "<IMAGE_HASH>",
            "link": "<WEBSITE_LINK>"
          }
        }
     }'
  -d 'access_token=<ACCESS_TOKEN>'
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/generatepreviews

Tạo phông nền

Chúng tôi sẽ tạo các phông nền khác nhau cho hình ảnh sản phẩm đủ điều kiện và phân phối phiên bản mà đối tượng của bạn có nhiều khả năng sẽ phản hồi nhất. Những phông nền này được tạo dựa trên tài sản gốc của bạn.

Bước 1: Tạo quảng cáo hoặc nội dung đã chọn sử dụng tính năng tạo phông nền

Tính năng tạo phông nền hiện chỉ hoạt động với quảng cáo sản phẩm động hoặc quảng cáo danh mục Advantage+ ở Bảng feed trên di động.

Bạn có thể tạo quảng cáo thông qua điểm cuối /ads hoặc tạo nội dung độc lập thông qua điểm cuối /adcreatives. Trong cả hai trường hợp đó, hãy chọn sử dụng tính năng Tạo phông nền trong quy cách nội dung (xem ví dụ bên dưới).

Yêu cầu

// creative example
  curl -X POST \
  -F 'name=Background Gen Creative' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "image_background_gen": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

// ad example
curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Background Gen Adgroup",
    "object_story_spec": {
      "page_id": "<PAGE_ID>",
      "template_data": {
        "description": "Description {{product.description}} ",
        "link": "https://www.example.com/",
        "message": "Test {{product.name | titleize}} ",
        "name": "Headline {{product.price}}"
      }
    },
    "product_set_id": "<PRODUCT_SET_ID>",
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "image_background_gen": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Bước 2: Xem trước để tạo phông nền

Khi bạn chọn sử dụng tính năng này, chúng tôi sẽ tạo các phông nền khác nhau cho hình ảnh sản phẩm đủ điều kiện và phân phối phiên bản mà đối tượng của bạn có nhiều khả năng sẽ phản hồi nhất. Bạn chỉ có thể chọn sử dụng tính năng này cho quảng cáo được tạo trong yêu cầu hiện tại. Những phông nền này được tạo dựa trên tài sản gốc của bạn, có các màu sắc hoặc hoa văn khác nhau cho hình ảnh sản phẩm đủ điều kiện. Bạn sẽ thấy bản xem trước tĩnh hoặc trực tiếp cho phông nền được tạo, tùy theo điều kiện của danh mục.

Nếu bạn không thể chấp nhận bất kỳ phông nền được tạo nào, vui lòng tạo lại quảng cáo hoặc nội dung mà không chọn sử dụng tính năng Tạo phông nền.

  • Bản xem trước hiện chỉ được hỗ trợ cho vị trí quảng cáo MOBILE_FEED_STANDARD
  • Đặt creative_feature thành image_background_gen
  • Nếu bản xem trước trực tiếp cho sản phẩm trong danh mục của bạn chưa sẵn sàng, bản xem trước có sẵn sẽ hiển thị với status được đặt thành PENDING

Yêu cầu

MOBILE_FEED_STANDARD

curl -X GET -G \
  -d 'ad_format=MOBILE_FEED_STANDARD' \
  -d 'creative_feature=image_background_gen' \
  -d 'access_token=/<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>/previews

Phản hồi

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "image_background_gen": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible" // or one of "pending", "ineligible"
          }
        ]
      }
    }
  ]
}

(Không bắt buộc) Xem trước trực tiếp mà không cần tạo quảng cáo

Bạn cũng có thể yêu cầu xem trước nội dung bằng điểm cuối /<AD_CREATIVE_ID>/previews mà không thực sự cần tạo quảng cáo.

Yêu cầu

MOBILE_FEED_STANDARD

curl -X GET -G \
  -d 'ad_format=MOBILE_FEED_STANDARD' \
  -d 'creative_feature=image_background_gen' \
  -d 'access_token=<ACCESS_TOKEN>'
  https://graph.facebook.com/v19.0/<AD_CREATIVE_ID>/generatepreviews

Phản hồi

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "image_background_gen": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible" // or one of "pending", "ineligible"
          }
        ]
      }
    }
  ]
}

Giới thiệu về tính minh bạch của AI

Những hình ảnh quảng cáo được tạo hoặc được chỉnh sửa đáng kể bằng một số tính năng AI tạo sinh của Meta cho nội dung có trên các công cụ marketing của chúng tôi có thể chứa thông tin về AI trong menu hình ba dấu chấm của quảng cáo hoặc có nhãn thông tin về AI bên cạnh nhãn Được tài trợ. Tìm hiểu về tính minh bạch của AI tạo sinh đối với quảng cáo.

Tìm hiểu thêm