A request model for creating a sponsored game

Targeting age bracket(s) of the ad set ['Undefined' = 1, 'AgeUnder13' = 2, 'Age13OrOver' = 4, 'Age13To16' = 8, 'Age17OrOver' = 16]

Targeting device type(s) of the ad set ['Undefined' = 1, 'Computer' = 2, 'Phone' = 4, 'Tablet' = 8, 'Console' = 16, 'VR' = 32]

Targeting gender(s) of the ad set ['Undefined' = 1, 'Male' = 2, 'Female' = 4]

A model representing an Ad Creative (for example, an ad thumbnail).

The ID of the creative. Typically, a thumbnail's imageId.

The type of the ad creative. Typically, CreativeType.Image. ['Undefined' = 0, 'Image' = 1, 'Video' = 2]

A response model for retrieving a page of Roblox.AdConfiguration.Api.SponsoredCampaignModel.

The cursor for retrieving the next page, if present.

The cursor for retrieving the previous page, if present.

A collection of Roblox.AdConfiguration.Api.SponsoredCampaignModel.

A response model for retrieving a page of Roblox.AdConfiguration.Api.SponsoredGameV2Model.

A collection of Roblox.AdConfiguration.Api.SponsoredGameV2Model.

Represents a sponsored ad campaign target

The campaign target type ['Undefined' = 0, 'Universe' = 1, 'Asset' = 2, 'ImmersiveAd' = 3]

The name of the campaign target (i.e. the asset name, universe name, group name, etc.)

The type of the campaign target ['Undefined' = 0, 'Universe' = 1, 'Asset' = 2, 'ImmersiveAd' = 3]

The daily bid amount for the campaign / ad, in Robux

The location to place the campaign ['Undefined' = 1, 'GameSort' = 2, 'AvatarShop' = 4, 'ItemDetails' = 8, 'HomePage' = 16, 'Billboard300x250' = 32, 'Billboard600x300' = 64, 'Billboard300x600' = 128]

The response model which returns a collection of Roblox.AdConfiguration.Api.Models.CampaignTargetModel

Gets or sets a collection of Roblox.AdConfiguration.Api.Models.CampaignTargetModel

A model represents a request to stop a sponsored campaign / ad.

The list of campaign types we want to include in the results

 ['Undefined' = 0, 'Universe' = 1, 'Asset' = 2, 'ImmersiveAd' = 3]

The response model for getting a list of recent-ads-ranked universes.

Gets or sets a list of Roblox.AdConfiguration.Api.Models.UniverseModel.

A model represents a request to stop a sponsored game ad.

Represents a universe in API endpoint results.

A response model represents an Ad with complete information, including infos from its associated campaign and ad set

The status of the ad set ['Undefined' = 0, 'Draft' = 1, 'Scheduled' = 2, 'Running' = 3, 'Paused' = 4, 'Stopped' = 5, 'Completed' = 6]

The status of the ad ['Undefined' = 0, 'Draft' = 1, 'PendingApproval' = 2, 'Approved' = 3, 'Moderated' = 4]

The target type of the campaign ['Undefined' = 0, 'Universe' = 1, 'Asset' = 2, 'ImmersiveAd' = 3]

The number of conversions by ad click generated by the ad

The target id of the creative associated with the Ad

The type of the creative associated with the Ad ['Undefined' = 0, 'Image' = 1, 'Video' = 2]

The number of conversions by ad impression generated by the ad

The target age bracket of the ad set ['Undefined' = 1, 'AgeUnder13' = 2, 'Age13OrOver' = 4, 'Age13To16' = 8, 'Age17OrOver' = 16]

The target device type of the ad set ['Undefined' = 1, 'Computer' = 2, 'Phone' = 4, 'Tablet' = 8, 'Console' = 16, 'VR' = 32]

The target gender of the ad set ['Undefined' = 1, 'Male' = 2, 'Female' = 4]

The total number of clicks generated by the ad

The total number of conversions generated by the ad

The total number of impressions generated by the ad

AdConfiguration Api v2

campaignTargetType

campaignTargetId

Indicates whether to include reporting stats in the response

includeReportingStats

Indicates whether to retrieve archived ads

isArchived

The cursor of the page to retrieve. If empty, fetches the first page

pageCursor

22: Invalid campaign target ID.
23: Invalid campaign target type.

0: Authorization has been denied for this request.

Gets a page of Roblox.AdConfiguration.Api.SponsoredCampaignModel with specified input parameters.

Roblox.AdConfiguration.Api.Models.CreateSponsoredCampaignRequest

request

2: Daily budget is lower than minimum allowed.
3: Total budget must be greater than 0.
4: Ad name cannot be empty.
5: Start date must not be a future date.
6: End date must be a future date.
7: Start date must be earlier than end date.
8: Total budget does not match daily spend and number of days being scheduled
9: Cannot load the universe for the specified universe id.
11: Invalid target age bracket.
12: Invalid target gender.
13: Invalid target device type.
14: Invalid ad set id.
15: Ad name cannot exceed 255 characters.
16: Insufficient Robux balance.
17: Name has already been taken.
18: Daily budget is higher than maximum allowed.
19: Invalid group id.
20: Number of days scheduled exceeded maximum days allowed.
21: Your experience is currently not eligible for advertising.
22: Invalid campaign target ID.
23: Invalid campaign target type.
24: Invalid creative ID.
25: Invalid creative type.
28: Total budget must be campaign duration * daily bid
29: The target is not eligible for new campaigns
30: Invalid user ID

0: Authorization has been denied for this request.
10: Insufficient permissions.

0: An unknown error occurred.
31: Internal server error

Creates a complete ad. Including ad campaign, ad set, escrow, and the ad.
Currently intended for creation of sponsorships only.

Get all asset type IDs that are eligible to be sponsored.

Roblox.AdConfiguration.Api.Models.GetEligibleCampaignTargetsRequest

0: Token Validation Failed
10: Insufficient permissions.

Returns a collection of Roblox.AdConfiguration.Api.Models.CampaignTargetModel that the user is authorized to sponsor, ordered by most recently advertised

Ads.Management.Service.CampaignTargetType.

campaignTargetIds

Checks whether the targets are eligible for sponsorship, and
if the user is authorized to sponsor the targets.

Roblox.AdConfiguration.Api.Models.StopSponsoredCampaignRequest

10: Insufficient permissions.
14: Invalid ad set id.
31: Internal server error

Stops a sponsored campaign / ad (ad set) from running. Initiated by a user.

universeId

Indicates whether to include reporting stats in the response.

Indicates whether to retrieve archived ads.

9: Cannot load the universe for the specified universe id.
9: Cannot load the universe for the specified universe id.

Gets a page of Roblox.AdConfiguration.Api.SponsoredGameV2Model with specified input parameters.

Roblox.AdConfiguration.Api.CreateSponsoredGameV2Request

Creates a new sponsored game ad with specified input parameters.

Roblox.AdConfiguration.Api.Models.StopSponsoredGameV2Request

To stop a sponsored-game ad (ad set) from running, initiated by a user.

groupId

Gets a list of universes for the authenticated user, or the given group, ordered by most recently created sponsored game ads.

Panoramica

Esperienze

Avatar

Risorse

Open Cloud

Create

Scoperta

Localizzazione

Analisi

Design

Scale

Affiliates

Monetize

Questo metodo è asincrono e restituisce un'"operazione", che rappresenta lo stato corrente della stessa. Contiene un percorso endpoint che è possibile sondare per ottenere la risposta reale e i metadati applicabili. Per ulteriori informazioni, consulta la [documentazione]({longRunningOperationsLink}) sulle operazioni di lunga durata.
            
Le sezioni seguenti descrivono gli oggetti di risposta e metadati forniti al completamento di un'operazione.

Gli endpoint beta sono pronti per l'uso del pubblico. Modifiche incompatibili sono possibili ma rare.

Questo campo può essere impostato durante la creazione di una risorsa, ma non può essere modificato da richieste successive.

È possibile impostare questi campi durante la creazione di una risorsa, ma non modificarli in base a richieste successive.

Questo campo può essere fornito per le richieste, ma non verrà mai incluso nelle risposte.

Per chiave API: {maxInPeriod} richieste ogni {periodInSeconds} secondi per indirizzo IP

Questo campo può essere impostato per le risposte, ma verrà ignorato nelle richieste.

Le seguenti autorizzazioni chiave API sono necessarie per chiamare questo endpoint. Per ulteriori informazioni sulla generazione di chiavi appropriate, vedi [Gestisci chiavi API]({apiKeyReferenceDocLink}).

I seguenti endpoint sono disponibili nei percorsi relativi all'URL di base.

Questa stringa è formattata come [Timestamp](/cloud/reference/types#timestamp).

Un valore JSON può essere `null`, `boolean`, `string`, `number`, `array`, or `object`.

I seguenti ambiti sono necessari per l'applicazione OAuth 2.0 per utilizzare questo endpoint. Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, vedi [Registrazione e revisione dell'app]({oauth2ReferenceDocLink}).

Gli oggetti seguenti descrivono i payloads accettati o restituiti. Per maggiori informazioni su quando vengono utilizzati questi oggetti, consultare ogni singolo endpoint.

Per utilizzare questo endpoint sono necessari i seguenti ambiti per la tua applicazione OAuth 2.0. Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, vedere [Registrazione e revisione dell'app]({oauth2ReferenceDocLink}).

Questo permette di visualizzare informazioni sui tuoi beni.

Questo permette di caricare e aggiornare gli asset su Roblox.

Fornisce la possibilità di aggiornare i badge di proprietà dell'utente.

Consente di visualizzare informazioni sui tuoi articoli commerciali.

Consente la modifica delle tue connessioni commerciali.

Consente di visualizzare le informazioni sui tuoi prodotti del Creator Store.

Consente di modificare le informazioni sui tuoi prodotti del Creator Store.

Consente di vedere le informazioni sulle tue comunità.

Consente di gestire le richieste di adesione alla comunità e gli aggiornamenti dei ruoli dei membri della comunità di rango inferiore per il tuo account.

Offre l'accesso per gestire i tuoi badge.

Consente l'accesso per gestire i tuoi badge e spendere Robux.

Consente l'accesso per gestire i tuoi prodotti per sviluppatori.

Consente l'accesso per leggere le informazioni sulle esperienze che segui.

Consente l'accesso per seguire e non seguire le esperienze per tuo conto.

Consente l'accesso per gestire le tue comunità.

Fornisce il permesso di leggere le informazioni sulla comunità.

Concede le autorizzazioni di gestione della comunità.

Consente l'accesso per leggere e scrivere le tue tabelle di localizzazione

Consente l'accesso per gestire la collaborazione in team per tutte le tue esperienze.

Consente l'accesso per gestire le tue esperienze e determinate informazioni associate alle tue esperienze (ad esempio, informazioni sulla localizzazione).

Offre l'accesso per leggere le informazioni sulla localizzazione delle tue esperienze.

Consente l'accesso per modificare le preferenze di localizzazione delle tue esperienze.

Consente l'accesso per gestire il tuo account utente.

Consente l'accesso per modificare le preferenze di localizzazione dell'utente.

Ciò garantisce la possibilità di pubblicare messaggi per conto degli utenti.

Consente di inviare notifiche dalla tua esperienza agli utenti.

Questo permette di elencare i segreti associati alla tua esperienza.

Ciò consente di creare e aggiornare i segreti associati alla tua esperienza.

Consente l'accesso per leggere i tuoi prodotti in abbonamento.

Offre la possibilità di leggere le informazioni sul posto.

Offre la possibilità di modificare le informazioni sul posto.

Questa operazione consente di pubblicare nuove versioni di esperienze a Roblox.

Offre la possibilità di leggere le informazioni sull'esperienza.

Offre la possibilità di modificare le informazioni sull'esperienza.

Consente di visualizzare le restrizioni degli utenti nell'esperienza.

Offre la possibilità di leggere lo stato premium e verificato dell'utente.

Consente di visualizzare gli account social di un utente.

Questa operazione abilita la funzionalità Single Sign-On.

Consente l'accesso alla lettura delle informazioni del tuo profilo.

Valore predefinito: {defaultValueStart}{defaultValueEnd}

Un vettore è un elenco ordinato di valori. I vettori sono utili per memorizzare le raccolte di dati.

Un insieme di coppie chiave-valore, in cui le chiavi possono essere qualsiasi numero, stringa o oggetto.

Questa funzione restituisce immediatamente, se possibile, ma può restituire il thread che lo ha chiamato fino a quando non può restituire un valore.

{nameStart}nome{nameEnd} non è più supportato o mantenuto da Roblox.

Questa operazione matematica non è più supportata o mantenuta da Roblox.

Questo membro non appare nel browser degli oggetti e non è destinato ad un uso diffuso.

Questo membro è accessibile solo tramite la barra dei comandi. Il tentativo di accedere a questo membro dagli script provoca un errore.

Questa funzione non può mettere in pausa il thread di Lua che l'ha chiamato.

Il tentativo di accedere a questo membro negli script causa un errore. Potresti essere in grado di accedere a questo membro dalla finestra delle proprietà di Roblox Studio.

Questo membro non appare nel browser degli oggetti di Roblox Studio.

Non è possibile creare un'istanza di questa classe con il Instance.new constructor.

Roblox non replica questo membro attraverso il suo confine server-client.

Il codice Lua non può accedere a questo membro. Potresti cambiare il suo valore dalla finestra di proprietà in Roblox Studio.

Questo membro è accessibile dalle attività di esecuzione di OpenCloud Luau.

Il comportamento di replica di questo oggetto dipende dal giocatore che lo possiede.

Questo membro è accessibile tramite la barra dei comandi e i plugin. Ogni tentativo di accesso a questo membro dagli script genererà un errore.

Questo membro è in sola lettura. Ogni tentativo di sovrascrittura genererà un errore.

Questa proprietà è in sola lettura ed è sicura da leggere in thread non sincronizzati. Ogni tentativo di sovrascrittura genererà un errore.

Questa proprietà è in sola lettura ed è sicura da leggere in thread non sincronizzati. Tentando di scriverci causa un errore.

Questo membro è accessibile solo in CoreScripts.

Solo Roblox CoreScripts può accedere a questo membro e non è utilizzabile dai giocatori.

È possibile leggere e scrivere a questa proprietà in modo sicuro da più thread.

Questa classe è un singleton di primo livello. Recupera un'istanza di questa classe con la funzione GetService.

Più thread possono potenzialmente scrivere su questa proprietà, quindi non è sicuro leggere da thread non sincronizzati.

È possibile leggere e sovrascrivere questa proprietà in modo sicuro da più thread.

Questa funzione interrompe il thread di Lua che lo chiamava fino a quando non restituisce un risultato. Questo non interrompe altri script.

Gestisci e analizza tutte le tue esperienze in un unico posto.

Impara con la documentazione e le risorse rivolte a tutti i creatori.

Scopri come creare esperienze Roblox grazie a guide, tutorial e campioni di codice.

Crea le tue esperienze in Studio, il nostro IDE all-in-one, e scaricalo su un'ampia varietà di dispositivi.

Dei modi affidabili per offrire valore nel tempo al tuo pubblico

Scopri come creare degli annunci efficaci che indirizzino il traffico verso le tue creazioni

Monitora la crescita della tua esperienza e scopri delle opportunità per migliorare

Scopri come applicare il movimento ai tuoi personaggi e ai tuoi ambienti

Scopri come caricare o utilizzare le risorse del Negozio nelle tue creazioni

Crea articoli Avatar e pubblicali sul Marketplace

Ordinato in base alle entrate più alte negli ultimi 7 giorni

Scopri cosa puoi realizzare e vendere sul marketplace

L'avatar rappresenta ciascun utente Roblox come un personaggio personalizzabile

Vedi questo flusso di creazioni fresche costruite dalla comunità

Impara le tecniche di modellazione di base in Blender

Troverai modelli, script e plugin sviluppati da altri creatori

Scopri come mettere in gabbia i tuoi articoli dell'avatar con l'artista 3D di Roblox

Scopri come configurare i personaggi per assicurarti che tutte le caratteristiche dell'avatar funzionino correttamente

Scopri come creare degli oggetti che interagiscono con il mondo o con altri utenti

Realizza e vendi il tuo primo capo di abbigliamento di base su Roblox

Usa gli strumenti di collaborazione di Studio per lavorare in contemporanea con il tuo team

Scopri qual è la tendenza sul Creatore Marketplace

Scopri i trend del momento sul Negozio Creatore

Partecipa agli eventi della comunità tenuti da altri Creatori

Trova tutorial scritti dalla Comunità Creatori

Mantieni i giocatori coinvolti e monetizza i contenuti con gli aggiornamenti

Affascina il pubblico con un divertente ciclo di gioco

Promuovi il coinvolgimento e i progressi con un gameplay divertente e ripetitivo

Scopri come creare una porta scorrevole senza scrivere alcun codice

Alex racconta la sua esperienza diretta con la creazione del gioco di successo, Jailbreak

Blake ha scoperto una passione nel creare giochi di carnevale realistici e stravaganti

I Clemens sono lo studio a conduzione familiare che ha realizzato successi come The Survival Game

Jasmine è l'artista che ha creato alcuni degli articoli per avatar più popolari sul Marketplace

Jessica è la designer di ambienti fantasiosi come in Alo Yoga

Jenni è la creatrice e artista di UGC che ha dato vita a molte collaborazioni popolari

Lo stile unico di Morphist combina estetica adorabile ed emo

I creatori di Riotfall viaggiano per trovare ispirazione per i loro ambienti coinvolgenti

Stephen condivide il suo amore per gli strumenti di programmazione

Sam racconta come ha iniziato a progettare degli articoli di moda che aveva sempre desiderato

Tutti gli oggetti che compongono un mondo 3D, come parti e illuminazione

Scopri la gamma di strumenti di debug disponibili in Studio

Guarda i tuoi progressi verso il tuo prossimo incasso!

Usa la console di sviluppo per eseguire il debug della tua esperienza durante i test

Aggiungere degli abbonamenti alla tua esperienza ti aiuterà a costruire relazioni a lungo termine con la tua base di utenti. Abilita gli abbonamenti entro il 15 dicembre 2023 e approfitta di 3 mesi di tariffe agevolate.

Guarda le migliori Esperienze per ottenere ispirazione

Inizia con Studio, il motore di creazione di Roblox

Aggiungi alcune righe di codice per sbloccare nuove dashboard che ti aiuteranno a comprendere il tuo onboarding e altri contenuti funnel, nonché a monitorare la tua economia di gioco.

Minty insegna a Enyu la geometria solida costruttiva.

Costruisci eventi live, cross-server e taglia scene su una sequenza strutturata

Scopri come creare eventi a tempo per le tue esperienze

Crea eventi basati sul tempo per una maggiore scoperta su Roblox. annuncia il tuo ultimo aggiornamento, evidenzia un'attività o festeggia un traguardo con i tuoi giocatori!

Scopri come indirizzare la fascia di età giusta per la tua creazione attraverso linee guida esperienza

Acquisisci conoscenze e competenze direttamente da Roblox

Scopri come implementare un sistema di ricompense per gli inviti agli amici

Impara le nozioni fondamentali su come creare un gioco

Scopri come puoi controllare il modo in cui i tuoi dati vengono utilizzati per addestrare l'IA. {linkStart}Leggi di più{linkEnd}

Crea facilmente delle strutture personalizzate utilizzando i nostri strumenti di intelligenza artificiale

Usa il nostro motore di creazione completo per costruire tutto ciò che puoi immaginare

PolarCub condivide tutti i trucchi per creare degli articoli UGC

Approfitta di Guilded per costruire una comunità attorno alla tua creazione

Unisciti al nostro incredibile cast di creatori per una maratona di sviluppo giochi di Halloween

Usa la parte della testa per creare delle animazioni facciali o attivare degli emote

Utilizza le metriche per capire dove puoi migliorare il tuo gameplay

Scopri come invogliare gli utenti a giocare di nuovo col tuo gioco

L'input dell'utente consente agli utenti di interagire con l'ambiente della tua esperienza

Guidano i giocatori attraverso la loro prima esperienza di gioco

Crea dei capi di abbigliamento che si adattano al corpo di qualsiasi avatar

A Roblox, crediamo che impari meglio facendo. Scegli una delle nostre guide per esplorare più di ciò che offre la piattaforma.

Ricevi aiuto per scrivere il codice e ottieni le risposte alle tue domande sul processo di creazione

Lighting e SoundService ti consentono di controllare gli effetti ambientali

Scopri come adattare i tuoi contenuti a diverse lingue e norme culturali

Questa guida passo-passo illustra allegati, fasci di luce e alcuni concetti di scripting di base che ti mostreranno come impostare la salute del giocatore su 0 se tocca qualcosa

Scopri come sperimentare rapidamente nuove idee

Coltivare una base di giocatori attivi è una parte fondamentale dello sviluppo di un gioco di successo e duraturo.

Inizia con lo strumento di ottimizzazione delle prestazioni e risoluzione dei problemi

MicroProfiler fornisce informazioni sui tempi per i processi dell'Agenda

Scopri nel dettaglio come funzionano i colori delle cornici, i grafici delle fiamme e altro ancora

Impara a utilizzare le metriche per avere più successo

Migliora le prestazioni degli script Luau ad alta intensità computazionale

Visualizza i tuoi benchmark giornalieri, i dati analitici e le metriche in tempo reale per portare {boldStart}{experienceName}{boldEnd} al livello successivo.

Scopri come utilizzare gli NPC (personaggi non giocanti) nelle tue esperienze

@minty crea dal vivo un percorso a ostacoli partendo da zero con i suggerimenti della chat

La nostra piattaforma ti offre opportunità ineguagliabili per creare. Inizia esplorando il Creator Hub, Roblox Studio e la nostra vibrante comunità di creatori.

La nostra piattaforma ti offre opportunità senza precedenti per creare.

La nostra comunità di sviluppatori pluripremiati e creatori autodidatti è nata qui, proprio come te. 

Un importante artista di ambienti su Roblox spiega come e perché utilizzare i pacchetti

Un contenuto elaborato dallo staff su gravità, proprietà dei materiali e vincoli

Scopri cosa succede quando un utente si unisce a un'esperienza

I plugin aggiungono funzionalità aggiuntive alle tue creazioni

Visitiamo l'UGC Homestore di PolarCub! Incontreremo anche Temprist.

Scopri come indirizzare il traffico e far conoscere le tue creazioni

Scopri tutti i punti salienti dell'RDC di quest'anno

Scopri cosa è possibile fare con il nostro motore di creazione

Impara a eseguire il rigging di un modello di personaggio umanoide R15

Crea e vendi il tuo primo accessorio rigido di base su Roblox

Ottieni un'anteprima di alcune delle nuove funzionalità e funzionalità che arriveranno presto a Roblox

Studio è lo strumento che ti consente di creare delle esperienze su Roblox

Scopri come utilizzare l'editor di script in Studio per creare degli script personalizzati

Andrew shows you where to place your scripts, so they run properly.

Lo scripting ti consente di aggiungere interazioni coinvolgenti per i tuoi utenti

Impara le scorciatoie di Studio e i comandi chiave per accelerare il processo di costruzione

Scopri come integrare le funzioni che consentono agli utenti di giocare con gli amici

Crea un annuncio sponsorizzato per ottenere la tua creazione di fronte a più creatori

Studio è uno strumento completo per costruire contenuti su Roblox. Prova a realizzare qualcosa oggi!

Scopri come offrire ai giocatori dei vantaggi ricorrenti a fronte di una quota mensile

Fai crescere la tua esperienza con l'aiuto di altri Creatori

Usa l'editor di terreno per generare e modificare il terreno in Studio

Esperienze come {boldStart}{experienceName}{boldEnd} hanno registrato un incremento medio dell'8,5% nel tasso di partecipazione qualificata con la personalizzazione.

Le traduzioni possono aiutare la tua creazione a raggiungere tonnellate di pubblico diverso

Scopri il nuovo modello UGC Homestore con Minty e SCHLEEMPH

Scopri come costruire dei contenuti per il pubblico specifico di Roblox

Cosa sono e come puoi usarli per costruire

Guarda una rapida introduzione al processo di creazione su Roblox, quindi passa a Studio

Leggi gli ultimi annunci dello Staff di Roblox

Gestisci e fai crescere le tue creazioni tutto in un unico posto conveniente

L'area di lavoro contiene gli oggetti che vuoi che il motore renderizzi all'interno del tuo progetto

Un contenuto elaborato dallo staff su parti, mesh, terreno e illuminazione

Aggiungi contenuti della community alla tua esperienza

Ad configuration v2

Models