推廣 API
返回中文(香港)
這份文件已更新。
中文(香港) 的翻譯尚未完成。
英文更新時間：8月27日

開始在行銷 API 上使用生成式 AI 功能

生成式 AI 功能的 API 支援

廣告商在發佈廣告之前，應負責預覽採用 AI 生成廣告創意的廣告創意。請參閱預覽配置說明。

對於建議的文字生成、生成背景或擴展圖像的完整性、可靠性和準確性，Meta 不提供任何保證。如果您使用行銷 API 來存取我們以下所述的生成式 AI 功能，除了《Meta 開放平台使用條款》外，也適用《廣告創意生成式 AI 使用條款》。

本文件說明如何將文字生成、圖像擴展和背景生成等生成式 AI 功能用於廣告。

準備工作

您需要按照以下步驟，使用 Meta 生成式 AI 功能來設定廣告行銷活動。

  1. 建立行銷活動
  2. 建立廣告組合
  3. 建立廣告或獨立式廣告創意
  4. 預覽廣告創意
  5. 啟用廣告

文字生成

使用 AI 生成的文字版本會採集原始主要文字、先前的廣告或商家粉絲專頁的內容做為靈感，以幫助提升建議內容的相關性。在廣告中加入更多文字選項，有助於自訂您的廣告創意並減少廣告創意疲乏，進而提升成效。深入瞭解此功能。

步驟 1：建立廣告時選擇使用文字生成

您可以透過 /ads 端點建立廣告，或透過 /adcreatives 端點建立獨立式廣告創意。選擇使用此功能僅適用於在目前要求中建立的廣告或廣告創意。無論採用哪一種方法，都可以按照以下方式選擇使用文字生成功能：

  1. 在 object_story_spec 的 message 欄位中提供主要文字
  2. 選擇使用 text_generation

請參閱下面的範例要求：

透過 /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/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

或者您可以使用 act_<AD_ACCOUNT_ID>/ads 端點建立廣告物件：

透過 /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/v20.0/act_<AD_ACCOUNT_ID>/ads

步驟 2：預覽文字生成

選擇使用 text_generation 建立廣告時，此功能只會套用於目前廣告，而生成的主要文字會插入廣告創意規格中。若是透過 /ads 端點選擇使用此功能，則廣告群組上的 status 欄位會預設為 PAUSED（請參閱文件）。您可以先查看生成的建議後，再手動將廣告的狀態設定為 ACTIVE，使其可供投遞。

若要預覽包含生成建議的廣告創意規格，可以透過廣告創意編號或廣告編號來讀取 asset_feed_spec。請參閱下面的範例要求和回應：

首先請查詢您在步驟 1 中建立之獨立式廣告創意的 asset_feed_spec。

要求

// request from creative
curl -X GET -G \
  -d 'fields=asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.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/v20.0/<AD_ID>

回應

{
  "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>"
}

查看過建議內容且看起來可以發佈後，請繼續進行步驟 3，將廣告設為 ACTIVE。若有任何無法接受的生成建議內容，請建立新的廣告或廣告創意，而不要選擇使用文字生成。

建立廣告創意時不選擇使用文字生成

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/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

步驟 3：將廣告群組狀態設定為 ACTIVE

驗證過生成的文字建議後，您可以將廣告的 status 設定為 ACTIVE。以下兩種情況都需要執行此步驟：

  1. 廣告透過 /ads 端點選擇使用此功能時
  2. 如果廣告是第一個使用選擇文字生成之現有廣告創意的廣告。

要求

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

圖像擴展

自動擴展圖像，以配合更多廣告版位。

步驟 1：建立選擇使用圖像擴展的廣告或廣告創意

您可以透過 /ads 端點建立廣告，或透過 /adcreatives 端點建立獨立式廣告創意。無論採用哪一種方法，都可以在廣告創意規格中選擇使用圖像擴展功能（請參閱下面的範例）。

要求

// 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/v20.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/v20.0/act_<AD_ACCOUNT_ID>/ads

步驟 2：預覽圖像擴展

INSTAGRAM_STANDARD、FACEBOOK_REELS_MOBILE、INSTAGRAM_REELS、MOBILE_FEED_STANDARD、INSTGRAM_STORY 廣告版位皆支援此功能。若要查看這些廣告版位的預覽，請發出 GET 要求至 /<AD_ID>/previews 端點。

若有任何無法接受的生成圖像，請重新建立廣告或廣告創意，而不要選擇使用圖像擴展：

  • 將 creative_feature 設定為 image_uncrop。
  • 如果 status 顯示為 pending，請重新要求預覽。

注意：如果未顯示 transformation_spec 節點，表示該廣告創意不符合圖像擴展資格。

要求

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

回應

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

（選用）直接預覽而不建立廣告

您也可以使用 act_<AD_ACCOUNT_ID>/generatepreviews 端點來要求預覽，而不實際建立廣告。

要求

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

背景生成

我們會為符合資格的商品圖像建立不同的背景，並投遞您的廣告受眾最有可能做出反應的版本。這些背景是根據您的原始素材所建立。

步驟 1：建立選擇使用背景生成的廣告或廣告創意

背景生成目前僅適用於行動版動態消息上的動態商品廣告或高效速成+ 目錄廣告。

您可以透過 /ads 端點建立廣告，或透過 /adcreatives 端點建立獨立式廣告創意。無論採用哪一種方法，都可以在廣告創意規格中選擇使用背景生成功能（請參閱下面的範例）。

要求

// 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/v20.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/v20.0/act_<AD_ACCOUNT_ID>/ads

步驟 2：預覽背景生成

若選擇使用此功能，我們會為符合資格的商品圖像建立不同的背景，並投遞您的廣告受眾最有可能做出反應的版本。選擇使用功能僅適用於在目前要求中建立的廣告。這些背景是根據您的原始素材而建立，針對符合資格的商品圖像，搭配不同顏色或圖案。依據目錄的資格，您會看到生成背景的靜態或即時預覽。

若有任何無法接受的生成背景，請重新建立廣告或廣告創意，而不要選擇使用背景生成。

  • 目前只有 MOBILE_FEED_STANDARD 廣告版位支援預覽
  • 將 creative_feature 設定為 image_background_gen
  • 如果目錄商品的即時預覽尚未準備好，則會顯示 status 設定為 PENDING 的庫存預覽

要求

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

回應

{
  "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"
          }
        ]
      }
    }
  ]
}

（選用）直接預覽而不建立廣告

您也可以使用 /<AD_CREATIVE_ID>/previews 端點來要求預覽廣告創意，而不實際建立廣告。

要求

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

回應

{
  "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"
          }
        ]
      }
    }
  ]
}

瞭解詳情