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.

Omówienie

Projekty

Awatar

Zasoby

Open Cloud

Create

Odkrywanie

Lokalizacja

Analityka

Projektowanie

Scale

Affiliates

Monetize

Jest to metoda asynchroniczna, która zwraca deskryptor „Operation”, odpowiadający bieżącemu stanowi operacji. Zawiera punkt końcowy, który można wybrać przy użyciu funkcji poll, aby otrzymać rzeczywistą odpowiedź i nadające się do użycia metadane. Więcej informacji na temat operacji długotrwałych zawiera [dokumentacja]({longRunningOperationsLink}).
            
W poniższych sekcjach opisano odpowiedzi i obiekty w postaci metadanych, które zostają podane po ukończeniu operacji.

Punkty końcowe beta są gotowe do użytku publicznego. Zmiany wywołujące przerwy są możliwe, ale rzadkie.

To pole może być skonfigurowane podczas tworzenia zasobu, ale może nie być modyfikowane przez kolejne żądania.

Te pola mogą być skonfigurowane podczas tworzenia zasobu, ale nie mogą być modyfikowane przez kolejne żądania.

To pole może być podane w żądaniach, ale nigdy nie będzie uwzględniane w odpowiedziach.

Na klucz API: żądanie {maxInPeriod} co {periodInSeconds} s na adres IP

To pole może być skonfigurowane do użycia w odpowiedziach, ale będzie ignorowane w żądaniach.

Do wywołania tego punktu końcowego wymagane są następujące uprawnienia do kluczy API. Więcej
informacji na temat generowania odpowiednich kluczy można znaleźć w obszarze [Zarządzanie kluczami API]({apiKeyReferenceDocLink}).

Następujące punkty końcowe są dostępne za pośrednictwem ścieżek odnoszących się do podstawowego adresu URL.

Ten ciąg jest sformatowany jako [FieldMask](/cloud/reference/types#fieldmask).

Wartość JSON może być typu „null”, „boolean”, „string”, „number”, „array” lub „object”.

Do umożliwienia aplikacji OAuth 2.0 użycia tego punktu końcowego wymagane są następujące zakresy. Więcej informacji na temat rejestrowania aplikacji OAuth 2.0 można znaleźć w obszarze [Rejestracja i omówienie aplikacji]({oauth2ReferenceDocLink}).

Następujące obiekty opisują ładunki, które są przyjmowane lub zwracane. Więcej informacji na temat tego, kiedy te obiekty są w użyciu, można znaleźć w poszczególnych punktach końcowych.

Ten ciąg jest sformatowany jako [Timestamp](/cloud/reference/types#timestamp).

This allows viewing information about your assets.

This allows uploading and updating assets to Roblox.

Grants the ability to update badges owned by the user.

This allows viewing information about your commerce items.

This allows editing of your commerce merchant connections.

This allows you to view information about your Creator Store products.

This allows you to modify information about your Creator Store products.

This allows viewing information about your communities.

This allows you to manage community join requests and role updates of lower-ranked community members for your account.

This allows viewing information about your inventory.

Grants access to mange your badges and spend robux.

Grants access to manage your developer products.

Grants access to read information about the experiences you follow.

Grants access to follow and unfollow experiences on your behalf.

Grants access to manage your communities.

Grants permission to read community information.

Grants access to read and write your localization tables

Grants access to manage team collaboration for all experiences you own.

Grants access to manage your experiences and certain information associated with your experiences (e.g. localization information).

Grants access to read your experiences' localization information.

Grants access to modify your experiences' localization preferences.

Grants access to manage your user account.

Grants access to modify user localization preferences.

This grants the ability to publish messages on behalf of users.

This allows sending notifications from your experience to users.

This allows listing secrets associated with your experience.

This allows creating and updating secrets associated with your experience.

Grants access to read about your subscription products.

Grants the ability to read place information.

Grants the ability to edit place information.

This operation grants access to publish new versions of experiences to Roblox.

Grants the ability to read experience information.

Grants the ability to edit experience information.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

Grants the ability to read user's premium and verified status.

This allows you to view a user's social accounts.

This enables Single Sign-On functionality.

This grants access to read your profile information.

Wartość domyślna: {defaultValueStart}{defaultValueEnd}

Tablica to uporządkowana lista wartości. Tablice są używane do przechowywania zbiorów danych.

Zestaw par klucz-wartość, w których klucz może być dowolną liczbą, ciągiem lub obiektem.

Jeśli to możliwe ta funkcja zwraca wartość natychmiast, ale jako wynik może podawać wątek, który ją wywołał, do momentu zwrócenia wartości.

{nameStart}nazwa{nameEnd} nie jest już obsługiwana ani utrzymywana na platformie Roblox.

To działanie matematyczne nie jest już obsługiwane ani utrzymywane na platformie Roblox.

Ten członek nie jest widoczny w wyszukiwarce obiektów i nie jest przeznaczony do powszechnego użycia.

Ten członek jest dostępny tylko za pośrednictwem paska poleceń. Próba uzyskania dostępu do tego członka poprzez skrypty powoduje wystąpienie błędu.

Ta funkcja nie może wstrzymać wątku Lua, który ją wywołał.

Próba uzyskania dostępu do tego członka poprzez skrypty powoduje wystąpienie błędu. Możesz spróbować uzyskać dostęp do tego członka poprzez okno właściwości aplikacji Roblox Studio.

Ten członek nie jest widoczny w przeglądarce obiektów w aplikacji Roblox Studio.

Nie możesz utworzyć instancji tej klasy, używając polecenia Instance.new constructor.

Platforma Roblox nie replikuje tego członka poza jego granicę serwer-klient.

Kod Lua nie może uzyskać dostępu do tego członka. Możliwe, że uda ci się zmienić jego wartość w oknie właściwości w aplikacji Roblox Studio.

Ten członek jest dostępny z poziomu zadań środowiska wykonawczego OpenCloud Luau.

Zachowanie replikacyjne tego obiektu jest zależne od gracza, który jest jego właścicielem.

Ten członek jest dostępny za pośrednictwem paska poleceń i dodatków plug-in. Próba uzyskania dostępu do tego członka poprzez skrypty powoduje wystąpienie błędu.

Członek tylko do odczyty. Próba zapisu związana z tym członkiem powoduje wystąpienie błędu.

Ta właściwość jest tylko do odczytu i można ją bezpiecznie odczytywać w niezsynchronizowanych wątkach. Próba jej zapisania powoduje wystąpienie błędu.

Ten członek jest dostępny tylko w ramach skryptów CoreScript.

Tylko skrypty Roblox CoreScript mogą mieć dostęp do tego członka i nie może być używany przez graczy.

Tę właściwość można bezpiecznie odczytywać i zapisywać w ramach wielu wątków.

Ta klasa to przypadek wyjątkowy najwyższego poziomu. Pobierz instancję tej klasy przy użyciu funkcji GetService.

Większa liczba wątków może spowodować zapisanie w tej właściwości, a zatem odczytywanie niezsynchronizowanych wątków może być niebezpieczne.

Ta funkcja wstrzymuje wątek Lua, który ją wywołał, do momentu zwrócenia wyniku. Nie powoduje to przerwania działania innych skryptów.

Zarządzaj wszystkimi swoimi projektami i analizuj je w jednym wygodnym miejscu.

Ucz się, korzystając z dokumentacji i zasobów przeznaczonych dla wszystkich twórców.

Naucz się tworzyć projekty na platformie Roblox, korzystając z przewodników, samouczków i przykładów kodu.

Twórz projekty w aplikacji Studio – naszym kompleksowym środowisku IDE – i wdrażaj je na szerokiej gamie urządzeń.

Dependable ways to offer value over time to your audience

Learn how to create successful ads that drive traffic to your creations

Chart your experience's growth and discover opportunities to improve

Learn how to apply movement to your characters and environments

Learn how to upload or use assets from Store in your creations

Create Avatar items and publish it to Marketplace

Sorted by highest revenue over the last 7 days

Learn about what you can make and sell on the marketplace

The avatar represents every Roblox user as a customizable character

See this thread of cool creations being built by the community

Learn basic modeling techniques in blender

Find models, scripts, and plugins made by other creators

Learn how to cage your avatar items from Roblox's own 3D artist

Learn how to configure characters to ensure all avatar features work properly

Learn how to create objects that interact with the world or other users

Make and sell your first basic clothing item on Roblox

Use Studio's collaboration tools to work with your team at the same time

Check out what’s trending on the Creator Marketplace

Check out what's trending on the Creator Store

Participate in community events held by other Creators

Find tutorials written by the Creator community

Keep players engaged and monetized with content updates

Captivate your audience with an enjoyable gameplay cycle

Drive engagement and progress with fun, repetitive gameplay

Learn how to create a sliding door without writing any code

Alex shares first-hand experience behind creating the hit experience, JailBreak

Blake found a passion in making realistic, quirky carnival games

The Clemens are the family-owned studio behind hits like The Survival Game

Jasmine is the artist behind some of the most popular avatar items on Marketplace

Jessica is the designer behind imaginative environments like in Alo Yoga

Jenni is the UGC creator and artist behind many popular collaborations

Morphist’s unique style combines cutesy and emo aesthetics

The Riotfall creators travel to find inspiration for their immersive environments

Stephen shares their love of programming tools

Sam shares how they got started designing fashion items that they wish existed

All objects that make up a 3D world, such as parts and lighting

Learn about the range of debugging tools available in Studio

See your progress towards your next cash out!

Use the developer console to debug your experience when testing

Adding subscriptions to your experience helps build long term relationships with your user base. Enable subscriptions before December 15, 2023, and enjoy 3 months of lower rates.

Look at the top Experiences out to get inspiration

Get started with Studio, Roblox’s creation engine

Add a few lines of code to unlock new dashboards to understand your onboarding and other funnels and track your in-game economy.

Minty teaches Enyu about constructive solid geometry.

Build live, cross-server events and cutscenes on a structured sequence

Learn how to create timed events for your experiences

Create time-based events for increased discoverability across Roblox. Announce your latest update, highlight an activity, or celebrate a milestone with your players!

Learn about how to target the age group right for your Creation through Experienced Guidelines

Gain knowledge and expertise directly from Roblox

Learn how to implement a friend invite reward system

Understand the basics of how to create a game

Learn how you can control how your data is used to train AI. {linkStart}Read More{linkEnd}

Easily create custom textures using our AI tools

Use our all-in-one creation engine to build anything you can imagine

PolarCub shares all the tips tricks to make UGC items

Leverage Guilded to build a community for your Creation

Join our incredible cast of creators for a Halloween game jam

Use the head part to create facial animations or trigger emotes

Using metrics to understand where you can improve your gameplay

Figure out how to keep them coming back to your game

User input allow users to interact with your experience environment

Guide players through their first time playing your experience

Create clothing that stretchs and fit over any avatar body

At Roblox, we believe you learn best by doing. Choose one of our guides to explore more of what the platform offers.

Get help writing code and answers to your creation questions

The Lighting and SoundService let you control environmental effects

Learn how to adapt your content to different languages and cultural norms

This walkthrough covers attachments, beams, and some basic scripting concepts that shows you how to set player health to 0 if they touch something

Cultivating an active player base is an instrumental part of developing a successful and enduring game.

Get started with the performance optimization and troubleshooting tool

Microprofiler provides timing information for the task scheduler

Dive deep into frame colors, flame graphs, and more

Understand how to use metrics to be more successful

Improve the performance of computationally intensive Luau scripts

View your daily benchmarks, insights, and real-time metrics to take {boldStart}{experienceName}{boldEnd} to the next level.

Learn how to use NPCs (non-player characters) in your experiences

@minty creates an obby live from scratch using suggestions from chat

Our platform provides you with unparalleled opportunities to create. Get started by exploring the Creator Hub, Roblox Studio, and our vibrant Creator community.

Our platform provides you with unparalleled opportunities to create.

Our community of award-winning studios and self-taught creators all started here, just like you. 

A principal environment artist at Roblox covers how and why to use packages

Learn how to deal with the most common performance problems.

Staff stream about gravity, material properties, and constraints

Learn about what happens when a user joins an experience

Plugins add additional features or functionality to your creations

Let's tour PolarCub's UGC Homestore! Also, Temprist shows up.

Learn how to drive traffic and awareness to your creations

Catch up on all the highlights from this year's RDC

Learn how to sell and promote avatar items with insights from the experts.

Learn efficient workflows for making avatar items in Blender.

Madison_Hatter2 shows how to texture and publish a simple avatar item.

Learn about what’s possible with our creation engine

Learn hwo to rig an R15 humanoid character model

Make and sell your first basic rigid accessory on Roblox

Get a preview of some of the new features and capabilities coming soon to Roblox

Studio is the tool that lets you create experiences on Roblox

Learn how to use the script editor in Studio to create custom scripts

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

Scripting lets you add immersive interactions for your users

Learn Studio shortcuts and key commands that make building quicker

Learn how to integrate features that allow players to play with friends

Create a Sponsored Ad to get your Creation in front of more Creators

Studio is an all-in-one tool for building on Roblox. Try making something today!

Learn how to offer players recurring benefits for a monthly fee

Grow your experience with the help of other Creators

Use the terrain editor to generate and alter terrain in Studio

Experiences like {boldStart}{experienceName}{boldEnd} saw an average +8.5% lift in qualified play through rate with personalization.

Translations can help your Creation reach tons of different audiences

Tour the new UGC Homestore template with Minty and SCHLEEMPH

Learn about how to build for Roblox's unique audience

What are they and how you can use them to build

Watch a quick introduction to creating on Roblox, then jump into Studio

Read the latest announcements from Roblox Staff

Manage and grow your creations all in one convenient place

Workspace holds objects that you want the engine to render in your project

Staff stream covering parts, meshes, terrain, and lighting

Intro to texturing for UGC ft. Madison_Hatter2

Ad configuration v2