プレイアブル広告はインタラクティブな広告です。モバイルアプリ広告主はこれを使って、利用者がアプリのダウンロードを実行する前に、アプリの短いプレビューを提供できます。プレイアブル広告には、タップして試すメッセージが表示されるリードイン動画、つまり紹介動画があります。利用者がこの動画をタップすると、ゲームのフルスクリーンデモが表示され、ゲームを操作できます。広告には、デモの最中またはデモが完了したときにコールトゥアクションを表示できます。
プレイアブル広告は次のもので利用できます。
APIではなく広告マネージャを使ってプレイアブル広告をアップロードします。
広告ヘルプセンターにあるプレイアブル広告に関する記事をご覧になって、リードイン動画およびHTMLファイルとzipファイルの仕様についてご確認ください。
次のものが必要です。
POST
リクエストを/act_AD_ACCOUNT_ID/adsets
エンドポイントに送信して、広告セットを作成します。
複数の配置がある場合、広告用の複数の動画をアップロードして、特定の配置でどの動画を使用するか指定できます。次の例は、複数の配置をpublisher_platforms
、facebook_positions
、audience_network_positions
を使用して指定しています。
curl -X POST "https://graph.facebook.com/act_AD_ACCOUNT_ID/adsets ?name=AD_SET_NAME &access_token=ACCESS_TOKEN &bid_amount=2 &billing_event=IMPRESSIONS &campaign_id=AD_CAMPAIGN_ID &daily_budget=1000 &optimization_goal=APP_INSTALLS &promoted_object={ 'application_id':'APP_ID', 'object_store_url':'APP_STORE_URL' } &targeting={ 'device_platforms': ['mobile'], 'geo_locations': {countries:['US']}, 'publisher_platforms': ['facebook','audience_network'], 'facebook_positions': ['feed'], 'audience_network_positions': ['rewarded_video','classic'], 'user_os': ['ANDROID'] }"
成功すると、プレイアブル広告セットIDが返されます。
POST
リクエストを/act_AD_ACCOUNT_ID/adplayables
エンドポイントに送信して、プレイアブル広告ファイルをアップロードします。HTMLファイルではsource
パラメーターを使用し、zipファイルではsource_zip
パラメーターを使用します。
curl -X POST "https://graph.facebook.com/act_{your-ad-account}/adplayables ?name={your-playable-ad-name} &source=@{your-source-location} &access_token={your-system-access-token}"
成功すると、プレイアブルアセットIDが返されます。
POST
リクエストを/act_AD_ACCOUNT_ID/advideos
エンドポイントに送信して、リードイン動画をアップロードします。HTMLファイルではsource
パラメーターを使用し、zipファイルではsource_zip
パラメーターを使用します。
curl -X POST "https://graph-video.facebook.com/act_AD_ACCOUNT_ID/advideos ?source=@SOURCE_LOCATION &access_token=AD_ACCOUNT_ID"
成功すると、リードイン動画IDが返されます。
POST
リクエストを/act_AD_ACCOUNT_ID/adcreatives
エンドポイントに送信して、広告クリエイティブを作成します。
curl -X POST "https://graph.facebook.com/act_AD_ACCOUNT_ID/adcreatives ?name=PLAYABLE_AD_CREATIVE_NAME &access_token=ACCESS_TOKEN &playable_asset_id=PLAYABLE_ASSET_ID &object_story_spec={ 'page_id': 'PAGE_ID', 'video_data': { 'call_to_action': { 'type':'INSTALL_MOBILE_APP', 'value':{ 'application':'APP_ID', 'link':'LINK_URL' } }, 'image_url': 'THUMBNAIL_URL', 'link_description': 'CTA_MESSAGE', 'video_id': 'LEAD_IN_VIDEO_ID' } }"
成功すると、広告クリエイティブIDが返されます。
POST
リクエストを/act_AD_ACCOUNT_ID/ads
エンドポイントに送信します。
curl -X POST "https://graph.facebook.com/act_AD_ACCOUNT_ID/ads ?name=PLAYABLE_AD_NAME &access_token=ACCESS_TOKEN &adset_id=PLAYABLE_AD_SET_ID &creative={'creative_id':'PLAYABLE_AD_CREATIVE_ID'} &status=PAUSED"
広告のテストが完了すると、status
がACTIVE
に変わります。
プレイアブル広告のテストでは、iPadはサポートされていません。iOSデバイスをテストする際は、モバイルデバイスを使用してください。
プレイアブル広告の作成中にプレイアブルアセットをアップロードする際、プレイアブルアセットが無効であることを示すエラーメッセージが表示されることがあります。
表示される可能性がある一般的なエラーと、修正方法のヒントを次に示します。
エラー | 考えられる修正方法 |
---|---|
無効なアプリID | [アプリ]セクションが選択されていないか、このアプリ用の広告を作成する権限がない場合にこのエラーが表示されます。[アプリ]セクションを選択し、このアプリの広告を作成する正しい権限があるかどうかを確認してください。 |
CTAクリックの関数呼び出しがありません | このプレイアブルコードが、コールトゥアクション用のJavaScript関数 |
アップロードされたバンドルのSubAssetが多すぎます | zipファイルに含まれているファイルが100を超えています。使用するファイルは100未満にしてください。 |
アップロードするものが大きすぎます | zipファイルのサイズが5MBを超えています。zipファイルのサイズは5MB未満にしてください。 |
アップロードされたファイルが大きすぎます | 1つのHTMLファイルのサイズが2MBを超えているか、 |
アップロードされたファイルに外部リンクへのリダイレクトが含まれています | 1つ以上のアセットにJavaScriptリダイレクトコードが含まれています。該当するコードを削除してください。 |
プレイアブル広告ではサポートされていないHTML | ウイルス対策ソフトの実行に失敗した場合にこのエラーが表示されます。 |
プレイアブル広告ではサポートされていない目的 | サポートされていない目的を選択しています。プレイアブル広告でサポートされている目的はアプリのインストールだけです。広告を作成する前に、アプリのインストール目的を広告マネージャで選択してください。 |
プレイアブル広告ではサポートされていない配置 | プレイアブル広告ではサポートされていない配置を選択しました。 |