モバイルアプリのプレイアブル広告

プレイアブル広告はインタラクティブな広告です。モバイルアプリ広告主はこれを使って、利用者がアプリのダウンロードを実行する前に、アプリの短いプレビューを提供できます。プレイアブル広告には、タップして試すメッセージが表示されるリードイン動画、つまり紹介動画があります。利用者がこの動画をタップすると、ゲームのフルスクリーンデモが表示され、ゲームを操作できます。広告には、デモの最中またはデモが完了したときにコールトゥアクションを表示できます。

プレイアブル広告は次のもので利用できます。

  • Facebookストーリーズ
  • Facebookニュースフィード
  • Audience Networkインタースティシャル
  • Audience Networkリワード
  • 配置アセットのカスタマイズ機能によるInstagramフィードとInstagramストーリーズ

制限

  • リードイン動画は、Audience Network配置では表示されません。
  • Instagram配置では、リードイン動画のみが表示されます。
  • プレイアブル広告はアプリインストール目的でのみ利用できます。

APIではなく広告マネージャを使ってプレイアブル広告をアップロードします

仕様

広告ヘルプセンターにあるプレイアブル広告に関する記事をご覧になって、リードイン動画およびHTMLファイルとzipファイルの仕様についてご確認ください。

APIを使用してプレイアブル広告を作成する

要件

次のものが必要です。

ステップ1.広告セットを作成する

POSTリクエストを/act_AD_ACCOUNT_ID/adsets エンドポイントに送信して、広告セットを作成します。

複数の配置がある場合、広告用の複数の動画をアップロードして、特定の配置でどの動画を使用するか指定できます。次の例は、複数の配置をpublisher_platformsfacebook_positionsaudience_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が返されます。

ステップ2.使用する広告アカウントにHTMLファイルまたはZipファイルをアップロードする

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が返されます。

ステップ3.広告アカウントにリードイン動画ファイルをアップロードする

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が返されます。

ステップ4.広告クリエイティブを作成する

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が返されます。

ステップ5.広告を作成する

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"
  

広告のテストが完了すると、statusACTIVEに変わります

プレイアブル広告のテストでは、iPadはサポートされていません。iOSデバイスをテストする際は、モバイルデバイスを使用してください。

トラブルシューティング

プレイアブル広告の作成中にプレイアブルアセットをアップロードする際、プレイアブルアセットが無効であることを示すエラーメッセージが表示されることがあります。

表示される可能性がある一般的なエラーと、修正方法のヒントを次に示します。

エラー考えられる修正方法

無効なアプリID

[アプリ]セクションが選択されていないか、このアプリ用の広告を作成する権限がない場合にこのエラーが表示されます。[アプリ]セクションを選択し、このアプリの広告を作成する正しい権限があるかどうかを確認してください。

CTAクリックの関数呼び出しがありません

このプレイアブルコードが、コールトゥアクション用のJavaScript関数FbPlayableAd.onCTAClick()を使用していません。CTAコードでこの関数を使用してください。

アップロードされたバンドルのSubAssetが多すぎます

zipファイルに含まれているファイルが100を超えています。使用するファイルは100未満にしてください。

アップロードするものが大きすぎます

zipファイルのサイズが5MBを超えています。zipファイルのサイズは5MB未満にしてください。

アップロードされたファイルが大きすぎます

1つのHTMLファイルのサイズが2MBを超えているか、index.htmlファイルのサイズが2MBを超えています。ファイルのサイズを小さくしてください。

アップロードされたファイルに外部リンクへのリダイレクトが含まれています

1つ以上のアセットにJavaScriptリダイレクトコードが含まれています。該当するコードを削除してください。

プレイアブル広告ではサポートされていないHTML

ウイルス対策ソフトの実行に失敗した場合にこのエラーが表示されます。

プレイアブル広告ではサポートされていない目的

サポートされていない目的を選択しています。プレイアブル広告でサポートされている目的はアプリのインストールだけです。広告を作成する前に、アプリのインストール目的を広告マネージャで選択してください。

プレイアブル広告ではサポートされていない配置

プレイアブル広告ではサポートされていない配置を選択しました。