플레이어블 광고는 사용자가 앱을 다운로드할지를 결정하기 전에 모바일 앱 광고주가 앱에 대한 짧은 미리 보기를 제공할 수 있는 인터랙티브 광고입니다. 플레이어블 광고에는 눌러서 체험하기 메시지가 포함된 도입 또는 소개 동영상이 있습니다. 사용자가 동영상을 누르면 전체 화면 게임 데모가 열려 게임과 상호작용할 수 있습니다. 광고는 데모 전체 또는 데모가 완료된 시점에 행동 유도를 표시할 수 있습니다.
플레이어블 광고를 사용할 수 있는 위치:
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 함수 |
업로드된 번들에 너무 많은 하위 자산 포함 | zip 파일에 포함된 파일이 100개를 초과합니다. 파일을 100개 미만으로 줄이세요. |
업로드 용량 초과 | zip 파일이 5MB를 초과합니다. zip 파일 용량을 5MB 미만으로 줄이세요. |
업로드된 파일 용량 초과 | 단일 HTML 파일이 2MB를 초과하거나 |
업로드된 파일에 외부 링크로의 리디렉션 포함 | 하나 이상의 자산에 JavaScript 리디렉션 코드가 포함되어 있습니다. 코드를 삭제하세요. |
플레이어블 광고에 지원되지 않는 HTML | 이 오류는 바이러스 백신 검사에 실패한 경우 표시됩니다. |
플레이어블 광고에 지원되지 않는 목표 | 선택한 목표는 지원되지 않습니다. 플레이어블 광고에 지원되는 유일한 목표는 앱 설치 목표입니다. 광고를 만들기 전에 광고 관리자에서 앱 설치 목표를 선택하세요. |
플레이어블 광고에 지원되지 않는 노출 위치 | 플레이어블 광고에 지원되지 않는 노출 위치를 선택했습니다. |