Inserzioni riproducibili su app mobili

Le inserzioni riproducibili sono inserzioni interattive che consentono agli inserzionisti su app mobili di offrire brevi anteprime delle loro app prima che le persone decidano di scaricarne una. Le inserzioni riproducibili presentano un video introduttivo con il messaggio Tocca per provare. Non appena la persona toccherà il video, sarà reindirizzata alla demo del gioco a schermo intero con la quale può interagire. L'inserzione può visualizzare una call to action durante la demo o al termine.

Le inserzioni riproducibili sono disponibili su:

Limitazioni

  • I video introduttivi non vengono mostrati per i posizionamenti di Audience Network.
  • I video introduttivi vengono mostrati solo per i posizionamenti di Instagram.
  • Le inserzioni riproducibili sono disponibili solo con l'obiettivo Installazioni dell'app.

Carica un'inserzione riproducibile utilizzando Gestione inserzioni anziché l'API.

Specifiche

Consulta l'articolo sulle inserzioni riproducibili nel Centro assistenza per le inserzioni per scoprire di più sulle specifiche per i video introduttivi e i file HTML e zip.

Creazione di un'inserzione riproducibile utilizzando l'API

Requisiti

Avrai bisogno dei seguenti elementi:

Passaggio 1. Creazione di un gruppo di inserzioni

Invia una richiesta POST all'endpoint /act_AD_ACCOUNT_ID/adsets per la creazione di un gruppo di inserzioni.

Puoi caricare più di un video per l'inserzione e specificare quale video utilizzare per un posizionamento specifico quando disponi di più posizionamenti. Il seguente esempio specifica più posizionamenti utilizzando publisher_platforms, facebook_positions e audience_network_positions.

Formattato per una maggiore leggibilità.
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']
    }"

In caso di azione eseguita correttamente, verrà restituito un ID del gruppo di inserzioni riproducibili.

Passaggio 2. Caricamento di un file HTML o zip sull'account pubblicitario

Invia una richiesta POST all'endpoint /act_AD_ACCOUNT_ID/adplayables per il caricamento del file delle inserzioni riproducibili. Utilizza il parametro source per un file HTML oppure il parametro source_zip per un file zip.

Formattato per una maggiore leggibilità.
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}"

In caso di azione eseguita correttamente, verrà restituito un ID delle risorse riproducibili.

Passaggio 3. Caricamento di un file del video introduttivo su un account pubblicitario

Invia una richiesta POST all'endpoint /act_AD_ACCOUNT_ID/advideos per il caricamento di un video introduttivo. Utilizza il parametro source per un file HTML oppure il parametro source_zip per un file zip.

Formattato per una maggiore leggibilità.
curl -X POST "https://graph-video.facebook.com/act_AD_ACCOUNT_ID/advideos
  ?source=@SOURCE_LOCATION
  &access_token=AD_ACCOUNT_ID"

In caso di azione eseguita correttamente, verrà restituito un ID del video introduttivo.

Passaggio 4. Creazione di una creatività dell'inserzione.

Invia una richiesta POST all'endpoint /act_AD_ACCOUNT_ID/adcreatives per la creazione di una creatività dell'inserzione.

Formattato per una maggiore leggibilità.
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'
    }
  }"

In caso di azione eseguita correttamente, verrà restituito un ID della creatività dell'inserzione.

Passaggio 5. Creazione di un'inserzione

Invia una richiesta POST all'endpoint /act_AD_ACCOUNT_ID/ads.

Formattato per una maggiore leggibilità.
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"
  

Dopo aver completato il test dell'inserzione, cambia lo status in ACTIVE.

Gli iPad non sono supportati per i test delle inserzioni riproducibili. Durante i test dei dispositivi iOS, utilizza un dispositivo mobile.

Risoluzione dei problemi

Quando carichi delle risorse riproducibili durante la creazione di un'inserzione riproducibile, potresti visualizzare un messaggio di errore che segnala che la risorsa non è valida.

Di seguito sono riportati gli errori comuni che potresti riscontrare e i suggerimenti su come correggerli.

ErrorePossibile soluzione

ID dell'app non valido

Questo errore viene visualizzato quando la sezione App non è selezionata o se non è presente l'autorizzazione per creare inserzioni per questa app. Seleziona la sezione App e controlla di disporre delle autorizzazioni corrette per creare l'inserzione per questa app.

Chiamata di funzione per clic sulla CTA mancante

Il codice riproducibile non utilizza la funzione JavaScript FbPlayableAd.onCTAClick() per la call to action. Utilizza questa funzione nel tuo codice CTA.

Bundle caricato con troppe risorse secondarie

Il tuo file zip contiene più di 100 file. Utilizza meno di 100 file.

Caricamento troppo grande

Il tuo file zip è più grande di 5 MB. Riduci le dimensioni del file zip a meno di 5 MB.

Il file caricato è troppo grande

Il singolo file HTML è più grande di 2 MB oppure il file index.html è più grande di 2 MB. Riduci le dimensioni del file.

Il file caricato contiene un reindirizzamento a un link esterno

Una o più risorse contengono codice di reindirizzamento di JavaScript. Rimuovi il codice.

HTML non supportato per l'inserzione riproducibile

Visualizzerai questo errore in caso di problemi nella scansione antivirus.

Obiettivo non supportato per le inserzioni riproducibili

Hai selezionato un obiettivo che non è supportato. L'obiettivo Installazioni dell'app è l'unico obiettivo supportato per le inserzioni riproducibili. Prima della creazione della tua inserzione, seleziona l'obiettivo Installazioni dell'app in Gestione inserzioni.

Posizionamento non supportato per le inserzioni riproducibili

Hai selezionato un posizionamento non supportato dalle inserzioni riproducibili.