Marketing API

Memulai Penggunaan Fitur AI Generatif di Marketing API

Dukungan API untuk fitur AI Generatif

Pengiklan bertanggung jawab untuk melihat pratinjau materi iklan yang menampilkan materi iklan yang dihasilkan oleh AI sebelum menerbitkan iklannya. Lihat petunjuk konfigurasi pratinjau.

Meta tidak memberikan jaminan apa pun mengenai kelengkapan, keandalan, dan akurasi pembuatan teks yang disarankan, latar belakang yang dihasilkan, atau gambar yang diperluas. Jika Anda menggunakan Marketing API untuk mengakses fitur AI Generatif kami yang dijelaskan di bawah ini, Ketentuan AI Generatif Materi Iklan berlaku sebagai tambahan untuk Ketentuan Platform Meta.

Dokumen ini menunjukkan cara menggunakan fitur AI generatif pembuatan teks, perluasan gambar, dan pembuatan latar belakang untuk iklan.

Sebelum Memulai

Anda perlu mengikuti langkah-langkah ini untuk menyiapkan kampanye iklan dengan fitur AI generatif Meta.

  1. Buat Kampanye
  2. Buat Set Iklan
  3. Buat Iklan atau Materi Iklan Mandiri
  4. Pratinjau Materi Iklan
  5. Aktifkan Iklan

Pembuatan Teks

Variasi teks dihasilkan dengan AI yang terinspirasi dari teks utama asli Anda, iklan Anda sebelumnya, atau konten dari Halaman bisnis Anda untuk membantu membuat saran menjadi lebih relevan. Menambahkan lebih banyak opsi teks ke iklan dapat membantu menyesuaikan materi iklan Anda dan mengurangi kejenuhan melihat iklan yang dapat membantu meningkatkan kinerja. Pelajari fitur ini selengkapnya di sini.

Langkah 1: Setujui penggunaan Pembuatan Teks saat membuat iklan

Anda dapat membuat iklan melalui endpoint /ads atau membuat materi iklan mandiri melalui endpoint /adcreatives. Persetujuan fitur hanya berlaku untuk iklan atau materi iklan yang dibuat dalam permintaan saat ini. Dalam kedua pendekatan tersebut, setujui penggunaan fitur Pembuatan Teks dengan:

  1. Memberikan teks utama di kolom message dalam object_story_spec
  2. Menyetujui penggunaan text_generation

Lihat contoh permintaan di bawah ini:

Setujui melalui endpoint /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

Atau, Anda dapat membuat objek iklan dengan endpoint act_<AD_ACCOUNT_ID>/ads:

Setujui melalui endpoint /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

Langkah 2: Pratinjau untuk Pembuatan Teks

Ketika iklan dibuat dengan menyetujui penggunaan text_generation, fitur hanya akan diterapkan pada iklan saat ini, dan teks utama yang dihasilkan akan dimasukkan ke spesifikasi materi iklan. Jika fitur telah disetujui melalui endpoint /ads, kolom status pada grup iklan akan diatur ke PAUSED secara default (lihat dokumentasi). Anda dapat meninjau saran yang dihasilkan sebelum mengatur status iklan secara manual ke ACTIVE agar dapat dikirimkan.

Spesifikasi materi iklan yang berisi saran yang dihasilkan dapat dipratinjau dengan membaca asset_feed_spec melalui ID materi iklan atau ID iklan. Lihat contoh permintaan dan tanggapan di bawah ini:

Mulai dengan melakukan kueri asset_feed_spec materi iklan mandiri Anda yang dibuat di langkah 1.

Permintaan

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

Tanggapan

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

Setelah saran ditinjau dan terlihat dapat diterima untuk dipublikasikan, lanjutkan ke Langkah 3 untuk mengatur iklan ke ACTIVE. Jika saran yang dihasilkan tidak dapat diterima, buat iklan atau materi iklan baru tanpa menyetujui Pembuatan Teks.

Membuat materi iklan tanpa menyetujui Pembuatan Teks

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

Langkah 3: Atur status grup iklan ke ACTIVE

Setelah memverifikasi saran teks yang dihasilkan, Anda dapat mengatur status iklan ke ACTIVE. Langkah ini perlu dilakukan pada kedua kasus berikut:

  1. Ketika sebuah iklan menyetujui fitur melalui endpoint /ads
  2. Jika iklan tersebut merupakan iklan pertama yang menggunakan materi iklan yang ada dengan persetujuan pembuatan teks.

Permintaan

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

Perluasan Gambar

Perluas gambar Anda secara otomatis agar sesuai dengan lebih banyak penempatan.

Mulai 16 September 2024, fitur Perluasan Gambar akan disertakan sebagai bagian dari Penyempurnaan Standar. Oleh karena itu, jika membuat iklan atau materi iklan yang menggunakan fitur Perluasan Gambar, silakan lihat informasi Penyempurnaan Standar untuk Materi Iklan Advantage+ tentang cara mengatur standard_enhancements sebagai kolom di dalam creative_features_spec.

Langkah 1: Buat iklan atau materi iklan yang menggunakan fitur perluasan gambar

Anda dapat membuat iklan melalui endpoint /ads atau membuat materi iklan mandiri melalui endpoint /adcreatives. Dalam kedua pendekatan tersebut, setujui penggunaan fitur Perluasan Gambar dalam spesifikasi materi iklan (lihat contoh di bawah).

Permintaan

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

Langkah 2: Pratinjau untuk Perluasan Gambar

Fitur ini didukung untuk penempatan INSTAGRAM_STANDARD, FACEBOOK_REELS_MOBILE, INSTAGRAM_REELS, MOBILE_FEED_STANDARD, INSTGRAM_STORY. Untuk melihat pratinjau untuk penempatan ini, buat permintaan GET ke endpoint /<AD_ID>/previews.

Jika gambar yang dihasilkan tidak dapat diterima, buat iklan atau materi iklan baru tanpa menyetujui Perluasan Gambar:

  • Atur creative_feature sebagai image_uncrop.
  • Minta kembali pratinjau jika status ditampilkan sebagai pending.

Catatan: Jika node transformation_spec tidak ditampilkan, hal tersebut menandakan bahwa materi iklan tidak memenuhi syarat untuk perluasan gambar.

Permintaan

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

Tanggapan

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

(Opsional) Pratinjau langsung tanpa pembuatan iklan

Anda juga dapat meminta pratinjau menggunakan endpoint act_<AD_ACCOUNT_ID>/generatepreviews tanpa benar-benar membuat iklan.

Permintaan

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

Pembuatan Latar Belakang

Kami akan membuat latar belakang yang berbeda untuk gambar produk yang memenuhi syarat dan memberikan versi yang paling mungkin ditanggapi oleh pemirsa Anda. Latar belakang ini dibuat berdasarkan aset asli Anda.

Langkah 1: Buat iklan atau materi iklan yang menyetujui pembuatan latar belakang

Pembuatan latar belakang saat ini hanya berfungsi dengan iklan produk dinamis atau iklan katalog Advantage+ di Kabar Seluler.

Anda dapat membuat iklan melalui endpoint /ads atau membuat materi iklan mandiri melalui endpoint /adcreatives. Dalam kedua pendekatan tersebut, setujui penggunaan fitur Pembuatan Latar Belakang dalam spesifikasi materi iklan (lihat contoh di bawah).

Permintaan

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

Langkah 2: Pratinjau untuk Pembuatan Latar Belakang

Dengan memilih fitur ini, kami akan membuat latar belakang yang berbeda untuk gambar produk yang memenuhi syarat dan memberikan versi yang paling mungkin ditanggapi oleh pemirsa Anda. Persetujuan fitur hanya berlaku untuk iklan yang dibuat dalam permintaan saat ini. Latar belakang ini dibuat berdasarkan aset asli Anda, yang menampilkan warna atau pola yang berbeda untuk gambar produk yang memenuhi syarat. Anda akan melihat pratinjau statis atau langsung dari latar belakang yang Anda hasilkan tergantung kelayakan katalog.

Jika latar belakang yang dihasilkan tidak dapat diterima, buat iklan atau materi iklan baru tanpa menyetujui Pembuatan Latar Belakang.

  • Pratinjau saat ini hanya mendukung penempatan MOBILE_FEED_STANDARD
  • Atur creative_feature sebagai image_background_gen
  • Jika pratinjau langsung untuk produk katalog Anda tidak siap, pratinjau stok ditampilkan dengan status diatur ke PENDING

Permintaan

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

Tanggapan

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

(Opsional) Pratinjau langsung tanpa pembuatan iklan

Anda juga dapat meminta pratinjau materi iklan menggunakan endpoint /<AD_CREATIVE_ID>/previews tanpa benar-benar membuat iklan.

Permintaan

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

Tanggapan

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

Tentang transparansi AI

Gambar iklan yang dibuat atau diedit secara material dengan fitur materi iklan AI generatif Meta tertentu yang tersedia di fitur marketing kami dapat menyertakan info AI di dalam menu tiga titik sebuah iklan atau mempunyai label info AI di samping label Bersponsor. Pelajari tentang transparansi AI generatif untuk iklan.

Pelajari Selengkapnya