このガイドでは、Advantage+ クリエイティブ機能にオプトインした広告および広告クリエイティブの作成方法を説明します。
以前、Advantage+ クリエイティブは、Advantage+ クリエイティブのさまざまな機能をまとめた標準エンハンスでしか利用できませんでした。マーケティングAPI v22.0以降のすべてのバージョンにおいて、標準エンハンスのオプトインとプレビュー機能は廃止される予定です。今後は、このドキュメントに記載されているガイドラインに従い、個々のAdvantage+ クリエイティブ機能ごとにオプトインやプレビューを行えるようになります。
/adsエンドポイントを使用して広告を作成するか、/adcreativesエンドポイントを使用してスタンドアローンの広告クリエイティブを作成します。どちらの方法でも、creative_features_specパラメーターで、オプトインする個々の機能を指定してください。
image_touchups、inline_comment、image_templatesのオプトイン機能を実装するには:
// creative example curl -X POST \ -F 'name=Advantage+ Creative Creative' \ -F 'degrees_of_freedom_spec={ "creative_features_spec": { "image_touchups": { "enroll_status": "OPT_IN" }, "inline_comment": { "enroll_status": "OPT_IN" }, "image_template": { "enroll_status": "OPT_IN" } } }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives // ad example curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Advantage+ Creative 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_touchups": { "enroll_status": "OPT_IN" }, "inline_comment": { "enroll_status": "OPT_IN" }, "image_template": { "enroll_status": "OPT_IN" } } } }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads
以下は、creative_features_specパラメーターで実装できるAdvantage+ クリエイティブのオプトイン機能です。
| 名前 | 説明 |
|---|---|
| 任意。デフォルトはオプトインです。 デフォルトでは、4:5と9:16の配置が有効です。画像の調整方法をコントロールしたい場合は、
注: この機能は、広告マネージャでは**[画像のタッチアップ]*というラベルが付けられています。 |
| 任意。
注: この機能は、広告マネージャでは[ダイナミックオーバーレイを追加]というラベルが付けられています。 オーバーレイのレンダリング方法を手動でコントロールしたい場合は、「広告クリエイティブリンクデータ画像レイヤー仕様」のリファレンスドキュメントをご覧ください。 |
| 任意。
注: この機能は、広告マネージャでは[スタンプのCTAを作成]というラベルが付けられています。 |
| 任意。
注: この機能は、広告マネージャでは[ダイナミック説明]というラベルが付けられています。 |
| 任意。
{ "text_extraction": { "enroll_status": "OPT_IN" }
注: この機能は、広告マネージャでは[CTAエンハンス]というラベルが付けられています。 |
| 任意。
注: この機能は、広告マネージャでは[背景を生成]というラベルが付けられています。 |
| 任意。
注: この機能は、広告マネージャでは[明るさとコントラストを調整]というラベルが付けられています。 |
| 任意。
注: この機能は、広告マネージャでは[オーバーレイを追加]というラベルが付けられています。 |
| 任意。
注: この機能は、広告マネージャでは[ビジュアルのタッチアップ]というラベルが付けられています。 |
| 任意。
注: この機能は、広告マネージャでは[画像を拡張]というラベルが付けられています。 |
| 任意。
注: この機能は、広告マネージャでは[関連度が高いコメント]というラベルが付けられています。 |
| 任意。
注: この機能は、広告マネージャでは[ダイナミックメディア]というラベルが付けられています。 詳しくは、「ダイナミックメディア」をご覧ください。 |
| 任意。
注: この機能は、広告マネージャでは[柔軟性のあるメディア]または[フレキシブルなメディア]というラベルが付けられています。 |
| 任意。
注: この機能は、広告マネージャのフォーマット表示オプション内にある[コレクション]ドロップダウンで[商品を表示]というラベルが付けられています。 詳しくは、「マーケティングAPIの製品拡張(カタログアイテムを追加する)機能」をご覧ください。 |
| 任意。
注: この機能は、広告マネージャでは[時系列で詳細を明らかにする]というラベルが付けられています。 |
| 任意。
{ "text_extraction": { "enroll_status": "OPT_IN" }
注: この機能は、広告マネージャでは[テキストの改善]というラベルが付けられています。 |
| 任意。
注: この機能は、広告マネージャでは[テキストを翻訳]というラベルが付けられています。 |
| 任意。
注: この機能は、広告マネージャでは[ビジュアルのタッチアップ]というラベルが付けられています。 |
OPT_INとして指定されているものの特定の広告設定では対象外である機能は、creative_features_specパラメーターから自動的に削除されます。例えば、image_templates (または[オーバーレイを追加])を動画フォーマットクリエイティブに適用することはできません。動画広告でこの機能にオプトインしても、対象外として自動的に削除されます。
最終設定を確認するには、GETリクエストを使用してcreative_features_specパラメーターを取得します。
creative_features_specを取得した際に、standard_enhancementsまたはそのサブ機能が付加されていても、問題はありません。それらは、OPT_INに設定されていない限り、適用されません。標準エンハンスは廃止予定であり、廃止が完了次第、この挙動も段階的に解消される予定です。
Advantage+ クリエイティブの機能の大半は、creative_features_specパラメーターを使用してオプトインできます。例外はmusic機能であり、これはasset_feed_specパラメーターを使用して実装します。music機能をオプトアウトするには、assest_feed_spec.audiosパラメーターを空として渡します。
asset_feed_specパラメーターを使ってmusic機能にオプトインするには:
curl -X POST \ -F 'name="Advantage+ Creative Music"' \ -F 'object_story_spec={ "page_id": "<PAGE_ID>" }' \ -F 'asset_feed_spec={ "audios": [ { "type": "random" } ] }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives
オプトインされている機能の中にAI生成の機能が含まれている場合、広告をPAUSEDステータスで作成した後、下記のステップ2とステップ3を実行して公開処理を完了する必要があります。AI生成の機能が含まれていない場合、ステップ2とステップ3は任意であり、ACTIVEのステータスで広告を作成できます。
注:/adsエンドポイントを通じて広告を作成する際、広告のstatusフィールドはデフォルトでPAUSEDに設定されます。
プレビューの既存機能について、詳しくは「広告プレビュー」のリファレンスをご覧ください。
Advantage+ クリエイティブの機能をプレビューするには、既存のプレビューリクエストにcreative_featureパラメーターを追加し、対象となる機能の名前を指定します。
プレビューに対応している機能の例としては、image_templates、image_touchups、video_auto_crop、enhance_cta、text_optimizations、image_background_gen、image_uncrop、description_automationがあります。
curl -X GET -G \ -d 'ad_format="DESKTOP_FEED_STANDARD"' \ -d 'creative_feature=<FEATURE_NAME> \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v25.0/<AD_ID>/previews
{ "data": [ { "body": "<iframe src='<PREVIEW_URL>'></iframe>", "transformation_spec": { "<FEATURE_NAME>": [ { "body": "<iframe src='<PREVIEW_URL>'></iframe>", "status": "eligible" } ] } } ] }
返されたURLをクリックすると、プレビューが表示されます。
注:transformation_specオブジェクトが返されない場合、指定された配置においてはそのクリエイティブがAdvantage+ クリエイティブ機能の対象外であるため、機能が適用されないということです。
プレビューを確認して公開に問題がないと判断した場合は、広告をACTIVEに設定します(まだACTIVEに設定していない場合)。プレビューで問題が見つかった場合は、その機能にオプトインせずに、新たに広告または広告クリエイティブを作り直します。
ACTIVEに設定する広告の準備ができたら、ステータスをACTIVEに設定します。
curl -X POST \ -F 'status=ACTIVE' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v25.0/<AD_ID>Advantage+ クリエイティブのその他の機能:
product_extensions広告クリエイティブに関するその他のリソース:
Advantage+ クリエイティブは、以前は標準エンハンスとして利用可能でした。