เริ่มต้นใช้งานฟีเจอร์ Generative AI สำหรับ API การตลาด

การสนับสนุน API สำหรับฟีเจอร์ Generative AI

การดูตัวอย่างชิ้นงานโฆษณาที่ประกอบด้วยชิ้นงานโฆษณาที่สร้างโดย AI ก่อนที่จะเผยแพร่โฆษณานั้นเป็นหน้าที่รับผิดชอบของผู้ลงโฆษณา ดูคำแนะนำในการกำหนดค่าตัวอย่าง

Meta ไม่รับประกันความสมบูรณ์ ความน่าเชื่อถือ และความถูกต้องของการสร้างข้อความที่แนะนำ พื้นหลังที่สร้างขึ้น หรือภาพที่ขยาย หากคุณใช้ API การตลาดเพื่อเข้าถึงฟีเจอร์ Generative AI ของเราตามที่ระบุไว้ด้านล่าง ข้อกำหนดเกี่ยวกับ Generative AI ของชิ้นงานโฆษณาจะมีผลบังคับใช้เพิ่มเติมจากข้อกำหนดของแพลตฟอร์ม Meta

เอกสารนี้จะแสดงให้คุณเห็นถึงวิธีการใช้ฟีเจอร์ Generative AI ในการสร้างข้อความ การขยายรูปภาพ และการสร้างพื้นหลังสำหรับโฆษณา

ก่อนที่คุณจะเริ่ม

คุณต้องทำตามขั้นตอนเหล่านี้เพื่อตั้งค่าแคมเปญโฆษณาของคุณด้วยฟีเจอร์ Generative AI ของ Meta

การสร้างข้อความ

AI จะสร้างข้อความรูปแบบต่างๆ โดยอิงจากข้อความหลักจากต้นฉบับ โฆษณาของคุณก่อนหน้านี้ หรือเนื้อหาจากเพจธุรกิจของคุณ เพื่อช่วยให้รายการแนะนำที่มีความเกี่ยวข้องกันมากขึ้น การเพิ่มตัวเลือกข้อความให้กับโฆษณาสามารถช่วยปรับแต่งชิ้นงานโฆษณาและลดความเบื่อหน่ายโฆษณา ซึ่งจะช่วยเพิ่มประสิทธิภาพได้ เรียนรู้เพิ่มเติมเกี่ยวกับฟีเจอร์นี้ได้ที่นี่

ขั้นตอนที่ 1: เลือกใช้การสร้างข้อความเมื่อสร้างโฆษณา

คุณสามารถสร้างโฆษณาผ่านตำแหน่งข้อมูล /ads หรือสร้างโฆษณาแบบสแตนด์อโลนผ่านตำแหน่งข้อมูล /adcreatives ได้ การเลือกใช้ฟีเจอร์นี้จะมีผลกับโฆษณาหรือชิ้นงานโฆษณาที่สร้างขึ้นในคำขอปัจจุบันเท่านั้น ไม่ว่าจะดำเนินการด้วยวิธีใดก็ตาม ให้เลือกใช้ฟีเจอร์การสร้างข้อความตามขั้นตอนต่อไปนี้

ระบุข้อความหลักในช่อง message ใน object_story_spec
เลือกใช้ 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/v21.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/v21.0/act_<AD_ACCOUNT_ID>/ads

ขั้นตอนที่ 2: ตัวอย่างการสร้างข้อความ

เมื่อโฆษณาถูกสร้างขึ้นด้วยการเลือกใช้ text_generation ฟีเจอร์นี้จะมีผลกับโฆษณาปัจจุบันเท่านั้น และข้อความหลักที่สร้างขึ้นจะถูกเพิ่มลงในข้อกำหนดเฉพาะของชิ้นงานโฆษณา หากเลือกใช้ฟีเจอร์ผ่านตำแหน่งข้อมูล /ads ช่อง status ในกลุ่มโฆษณาจะถูกตั้งค่าเป็น PAUSED ตามค่าเริ่มต้น (ดูเอกสารประกอบ) คุณสามารถดูรายการแนะนำที่สร้างขึ้นก่อนที่จะตั้งค่าสถานะของโฆษณาเป็น ACTIVE ด้วยตนเอง เพื่อให้สามารถเผยแพร่ได้

คุณสามารถดูตัวอย่างข้อมูลจำเพาะของชิ้นงานโฆษณาที่มีรายการแนะนำที่สร้างขึ้นได้โดยการอ่าน asset_feed_spec ผ่าน ID ชิ้นงานโฆษณาหรือ ID โฆษณา ดูตัวอย่างคำขอและการตอบกลับได้ที่ด้านล่างนี้

เริ่มต้นด้วยการสืบค้น asset_feed_spec ของชิ้นงานโฆษณาแบบสแตนด์อโลนที่สร้างในขั้นตอนที่ 1

คำขอ

// 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>

การตอบกลับ

{
  "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/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

ขั้นตอนที่ 3: ตั้งค่าสถานะกลุ่มโฆษณาเป็น `ACTIVE`

หลังจากที่คุณได้ตรวจสอบยืนยันคำข้อความแนะนำที่สร้างขึ้นแล้ว คุณสามารถตั้งค่า status ของโฆษณาเป็น ACTIVE ได้ คุณจะต้องทำขั้นตอนนี้ในทั้ง 2 กรณีดังต่อไปนี้

เมื่อโฆษณาเลือกใช้ฟีเจอร์นี้ผ่านตำแหน่งข้อมูล /ads
หากโฆษณาเป็นโฆษณาแรกที่ใช้ชิ้นงานโฆษณาที่มีอยู่โดยเลือกใช้การสร้างข้อความ

คำขอ

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

การขยายรูปภาพ

ขยายรูปภาพของคุณโดยอัตโนมัติเพื่อให้เหมาะกับตำแหน่งการจัดวางเพิ่มเติม

ตั้งแต่วันที่ 16 กันยายน 2024 ฟีเจอร์การขยายรูปภาพจะรวมอยู่ในการเพิ่มประสิทธิภาพมาตรฐาน ด้วยเหตุนี้ หากสร้างโฆษณาหรือชิ้นงานโฆษณาที่เลือกใช้การขยายรูปภาพ โปรดดูที่ข้อมูลการเพิ่มประสิทธิภาพมาตรฐานสำหรับชิ้นงานโฆษณา Advantage+ เกี่ยวกับการตั้งค่า standard_enhancements เป็นช่องใน creative_features_spec

ขั้นตอนที่ 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/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

ขั้นตอนที่ 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: สร้างโฆษณาหรือชิ้นงานโฆษณาที่เลือกใช้การสร้างพื้นหลัง

ขณะนี้การสร้างพื้นหลังสามารถใช้งานได้กับโฆษณาสินค้าแบบไดนามิกหรือโฆษณาแค็ตตาล็อก Advantage+ ในฟีดบนมือถือเท่านั้น

คุณสามารถสร้างโฆษณาผ่านตำแหน่งข้อมูล /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/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

ขั้นตอนที่ 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"
          }
        ]
      }
    }
  ]
}

เกี่ยวกับความโปร่งใสของ AI

รูปภาพโฆษณาที่สร้างขึ้นหรือได้รับการแก้ไขอย่างชัดเจนโดยใช้ฟีเจอร์สร้างสรรค์ด้วย Generative AI ของ Meta บางอย่างที่มีให้ใช้งานในเครื่องมือทางการตลาดของเราอาจมีข้อมูล AI อยู่ภายในเมนูสามจุดของโฆษณาหรือมีป้ายข้อมูล AI อยู่ถัดจากป้ายได้รับการสนับสนุน เรียนรู้เกี่ยวกับความโปร่งใสของ Generative AI สำหรับโฆษณา

เริ่มต้นใช้งานฟีเจอร์ Generative AI สำหรับ API การตลาด

ก่อนที่คุณจะเริ่ม

การสร้างข้อความ

ขั้นตอนที่ 1: เลือกใช้การสร้างข้อความเมื่อสร้างโฆษณา

เลือกใช้ผ่านตำแหน่งข้อมูล /adcreatives

เลือกใช้ผ่านตำแหน่งข้อมูล /ads

ขั้นตอนที่ 2: ตัวอย่างการสร้างข้อความ

คำขอ

การตอบกลับ

สร้างชิ้นงานโฆษณาโดยไม่เลือกใช้การสร้างข้อความ

ขั้นตอนที่ 3: ตั้งค่าสถานะกลุ่มโฆษณาเป็น ACTIVE

คำขอ

การขยายรูปภาพ

ขั้นตอนที่ 1: สร้างโฆษณาหรือชิ้นงานโฆษณาที่เลือกใช้การขยายรูปภาพ

คำขอ

ขั้นตอนที่ 2: ตัวอย่างการขยายรูปภาพ

คำขอ

การตอบกลับ

(ดำเนินการหรือไม่ก็ได้) ดูตัวอย่างโดยตรงโดยไม่ต้องสร้างโฆษณา

คำขอ

การสร้างพื้นหลัง

ขั้นตอนที่ 1: สร้างโฆษณาหรือชิ้นงานโฆษณาที่เลือกใช้การสร้างพื้นหลัง

คำขอ

ขั้นตอนที่ 2: ตัวอย่างการสร้างพื้นหลัง

คำขอ

การตอบกลับ

(ดำเนินการหรือไม่ก็ได้) ดูตัวอย่างโดยตรงโดยไม่ต้องสร้างโฆษณา

คำขอ

การตอบกลับ

เกี่ยวกับความโปร่งใสของ AI

เรียนรู้เพิ่มเติม

เลือกใช้ผ่านตำแหน่งข้อมูล `/adcreatives`

เลือกใช้ผ่านตำแหน่งข้อมูล `/ads`

ขั้นตอนที่ 3: ตั้งค่าสถานะกลุ่มโฆษณาเป็น `ACTIVE`