모바일 앱용 플레이어블 광고

플레이어블 광고는 사용자가 앱을 다운로드할지를 결정하기 전에 모바일 앱 광고주가 앱에 대한 짧은 미리 보기를 제공할 수 있는 인터랙티브 광고입니다. 플레이어블 광고에는 눌러서 체험하기 메시지가 포함된 도입 또는 소개 동영상이 있습니다. 사용자가 동영상을 누르면 전체 화면 게임 데모가 열려 게임과 상호작용할 수 있습니다. 광고는 데모 전체 또는 데모가 완료된 시점에 행동 유도를 표시할 수 있습니다.

플레이어블 광고를 사용할 수 있는 위치:

제한 사항

  • Audience Network 노출 위치에는 도입 동영상이 표시되지 않습니다.
  • Instagram 노출 위치에는 도입 동영상만 표시됩니다.
  • 플레이어블 광고는 앱 설치 목표를 설정했을 경우에만 사용할 수 있습니다.

API 대신 광고 관리자를 사용하여 플레이어블 광고를 업로드하세요.

사양

도입 동영상, HTML 및 zip 파일의 사양에 대한 자세한 내용은 광고 고객 센터의 플레이어블 광고 문서를 참조하세요.

API를 사용한 플레이어블 광고 생성

요구 사항

다음 항목을 준비해야 합니다.

1단계. 광고 세트 만들기

POST 요청을 /act_AD_ACCOUNT_ID/adsets 엔드포인트로 보내서 광고 세트를 만드세요.

광고에 두 개 이상의 동영상을 업로드하고, 여러 노출 위치가 있을 시 특정 노출 위치에 어떤 동영상을 사용할지 지정할 수 있습니다. 다음 예시에서는 publisher_platforms, facebook_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 코드에 이 함수를 사용하세요.

업로드된 번들에 너무 많은 하위 자산 포함

zip 파일에 포함된 파일이 100개를 초과합니다. 파일을 100개 미만으로 줄이세요.

업로드 용량 초과

zip 파일이 5MB를 초과합니다. zip 파일 용량을 5MB 미만으로 줄이세요.

업로드된 파일 용량 초과

단일 HTML 파일이 2MB를 초과하거나 index.html 파일이 2MB를 초과합니다. 파일 용량을 줄이세요.

업로드된 파일에 외부 링크로의 리디렉션 포함

하나 이상의 자산에 JavaScript 리디렉션 코드가 포함되어 있습니다. 코드를 삭제하세요.

플레이어블 광고에 지원되지 않는 HTML

이 오류는 바이러스 백신 검사에 실패한 경우 표시됩니다.

플레이어블 광고에 지원되지 않는 목표

선택한 목표는 지원되지 않습니다. 플레이어블 광고에 지원되는 유일한 목표는 앱 설치 목표입니다. 광고를 만들기 전에 광고 관리자에서 앱 설치 목표를 선택하세요.

플레이어블 광고에 지원되지 않는 노출 위치

플레이어블 광고에 지원되지 않는 노출 위치를 선택했습니다.