[section=TableOfContents]Daftar Isi[/section] [b]Sedikit perkenalan:[/b] [olist] [*] [doclink=features/steam_controller/getting_started_for_players]Memulai sebagai [b]Pemain[/b][/doclink] [*] [doclink=features/steam_controller/getting_started_for_devs]Memulai sebagai [b]Pengembang[/b][/doclink] [/olist] [b]Untuk si paling ahli:[/b] [olist] [*] [doclink=features/steam_controller/concepts][/doclink] [*] [doclink=features/steam_controller/device][/doclink] [*] [doclink=features/steam_controller/iga_file][/doclink] [*] [doclink=features/steam_controller/action_manifest_file][/doclink] [*] [doclink=features/steam_controller/input_source][/doclink] [*] [doclink=features/steam_controller/input_source_modes][/doclink] [*] [doclink=features/steam_controller/mode_shifting][/doclink] [*] [doclink=features/steam_controller/browse_configs][/doclink] [*] [doclink=features/steam_controller/activators][/doclink] [*] [doclink=features/steam_controller/mouse_regions][/doclink] [*] [doclink=features/steam_controller/radial_menus][/doclink] [*] [doclink=features/steam_controller/touch_menus][/doclink] [*] [doclink=features/steam_controller/action_set_layers][/doclink] [*] [doclink=features/steam_controller/legacy_mode][/doclink] [/olist]…
This can be useful if your game has custom UI for showing a specific promo item to the user otherwise if you want to grant multiple promotional items then use [api]ISteamInventory::AddPromoItems[/api] or [api]ISteamInventory::GrantPromoItems[/api]. …
If you want to grant a single promotional item then use [api]ISteamInventory::AddPromoItem[/api]. If you want to grant all possible promo items then use [api]ISteamInventory::GrantPromoItems[/api]. Any items that can be granted MUST have a "promo" attribute in their itemdef. …
[section]Bergabung dalam Event Diskon Pihak Ketiga sebagai Partisipan[/section] Jika game-mu diundang untuk bergabung ke salah satu event seperti ini, silakan lihat halaman [b]Berpartisipasi dalam Event Pihak Ketiga[/b] di sini: https://partner.steamgames.com/doc/store/promo/thirdpartyevents [section]Menyelenggarakan Event Diskon Pihak Ketiga[/section] Jika kamu ingin menyelenggarakan event pihak ketiga di Steam, atau memperpanjang event gaming yang sudah ada dengan Steam, silakan baca lebih lanjut di sini: https://partner.steamgames.com/doc/store/promo/organizers [section]Tutorial & Tip[/section] Alat Editor Halaman Diskon: https://partner.steamgames.com/doc/resources/Sales_Feature_Beta Aset Grafis: https://partner.steamgames.com/doc/store/assets Contoh Lini Masa: https://partner.steamgames.com/doc/store/promo/planning …
('item' | 'bundle' | 'generator' | 'playtimegenerator' | 'tag_generator')[/td][/tr] [tr][td]bundle[/td][td](lihat [doclink=features/inventory/schema#SpecifyBundles]item bundel atau generator[/doclink] di bawah)[/td][/tr] [tr][td]promo[/td][td](lihat [doclink=features/inventory/schema#PromoItems]format promo[/doclink] di bawah)[/td][/tr] [tr][td]drop_start_time[/td][td]Stempel waktu UTC - untuk mencegah mulainya promo sebelum waktu yang ditentukan, hanya berlaku jika promo = manual (lihat [doclink=features/inventory/schema#PromoItems]format promo[/doclink] di bawah)[/td][/tr] [tr][td]exchange[/td][td](lihat [doclink=features/inventory/schema#ExchangeFormat]format pertukaran[/doclink] di bawah)[/td][/tr] [tr][td]price[/td][td](lihat [doclink=features/inventory/schema#SpecifyPrices]format harga[/doclink] di bawah)[/td][/tr] [tr][td]price_category[/td][td]Harga yang sudah ditentukan adalah tempat di mana kami menangani nilai dari berbagai mata uang untukmu. …
(lihat [doclink=features/inventory/schema#PlaytimeDrops]Drop Item Waktu Bermain[/doclink] di bawah)[/td][/tr] [tr][td]granted_manually[/td][td]false/true. Jika true, maka hanya akan diberikan ketika AddPromoItem() atau AddPromoItems() dipanggil dengan id definisi item eksplisit. Jika tidak, ini bisa diberikan melalui panggilan GrantPromoItems(). …
Jika demikian, Steam dapat membekalimu dengan alat-alat untuk membuat [doclink=store/promo/thirdpartyevents]Event Diskon Pihak Ketiga[/doclink] sendiri. Alat-alat tersebut memungkinkanmu untuk membuat dan mengelola laman landas event kustom milikmu sendiri di Steam. …
Perlu diingat bahwa setelah dipublikasikan, visibilitas event-mu akan secara otomatis terpicu, seperti yang diuraikan di bagian [doclink=/store/promo/organizers#16]Visibilitas Event[/doclink]. Selain itu, halaman diskonmu akan tetap terlihat sampai kamu memilih untuk menyembunyikannya. …
[/list] [/list] [/list] [b]Contoh Respons:[/b] [code=json] { "response": { "result": "OK", "params": { "count": 4, "orders": [ { "orderid": "1233", "transid": "1234567890123456788", "steamid": "76561197972751825", "status": "PartialRefund", "currency": "USD", "time": "2024-01-23T18:30:00Z", "country": "US", "usstate": "WA", "timecreated": "2024-01-23T18:15:00Z", "items": [ { "itemid": 100, "qty": 1, "amount": 99, "vat": 9, "itemstatus": "Refunded" }, { "itemid": 101, "qty": 1, "amount": 1299, "vat": 116, "itemstatus": "Succeeded" } ] }, { "orderid": "1234", "transid": "1234567890123456789", "steamid": "76561197972751825", "status": "Failed", "currency": "USD", "time": "2024-01-23T18:40:30Z", "country": "US", "usstate": "WA", "timecreated": "2024-01-23T18:39:00Z", "items": [ { "itemid": 100, "qty": 1, "amount": 99, "vat": 9, "itemstatus": "Failed" } ] }, { "orderid": "1235", "transid": "1234567890123456790", "steamid": "76561197972751825", "status": "Succeeded", "currency": "USD", "time": "2024-01-23T18:40:40Z", "country": "US", "usstate": "WA", "timecreated": "2024-01-23T18:39:30Z", "items": [ { "itemid": 101, "qty": 1, "amount": 1299, "vat": 116, "itemstatus": "Succeeded" } ] }, { "orderid": "1236", "transid": "1234567890123456791", "steamid": "76561197972751825", "status": "Chargedback", "currency": "USD", "time": "2024-01-23T19:55:00Z", "country": "US", "usstate": "WA", "timecreated": "2024-01-23T18:40:00Z", "items": [ { "itemid": 102, "qty": 1, "amount": 999, "vat": 89, "itemstatus": "Chargedback" } ] } ] } } } [/code] [section=GetUserAgreementInfo]GetUserAgreementInfo[/section] [code=http]GET https://partner.steam-api.com/ISteamMicroTxn/GetUserAgreementInfo/v2/[/code] [table] [tr][th]Nama[/th][th]Jenis[/th][th]Diperlukan[/th][th]Deskripsi[/th][/tr] [tr] [td][b]key[/b][/td][td]string[/td] [td]✔[/td] [td]Web API Steamworks [url=https://partner.steamgames.com/doc/webapi_overview/auth#publisher-keys]key penerbit[/url] dengan perizinan [b]Transaksi Mikro[/b].…
[/list] [/list] [/list] [b]Contoh Respons:[/b] [code=xml] <response> <result>OK</result> <params> <state>WA</state> <country>US</country> <currency>USD</currency> </params> </response> [/code] [section=InitTxn]InitTxn[/section] [code=http]POST https://partner.steam-api.com/ISteamMicroTxn/InitTxn/v3/[/code] [table] [tr][th]Nama[/th][th]Jenis[/th][th]Diperlukan[/th][th]Deskripsi[/th][/tr] [tr] [td][b]key[/b][/td][td]string[/td] [td]✔[/td] [td]Web API Steamworks [url=https://partner.steamgames.com/doc/webapi_overview/auth#publisher-keys]key penerbit[/url] dengan perizinan [b]Transaksi Mikro[/b].…
Namun, jika kamu tertarik untuk membuat event diskon pihak ketiga di Steam, kami ingin mendengarnya darimu. Silakan baca [doclink=store/promo/organizers]Menyelenggarakan Event Diskon Pihak Ketiga[/doclink] untuk memulainya.[/callout] [section]Visibilitas Event untuk Partisipan[/section] [subsection]Visibilitas di Luar Steam[/subsection] Penyelenggara event-mu seharusnya memiliki rincian lebih lanjut tentang bagaimana mereka akan menampilkan atau memasarkan event mereka di luar Steam. …
Beberapa event mungkin memenuhi syarat untuk pemfituran yang dikurasi di Toko di penempatan promosi seperti Takeunder atau Penawaran Harian, Tengah Minggu, dan Akhir Minggu. Ini dibahas secara lebih rinci di [doclink=store/promo/organizers#15]Visibiltas Event Steam[/doclink]. Jika event dipilih untuk pemfituran yang dikurasi di Toko, Tim Event Steam akan memberi tahu penyelenggara event yang kemudian akan membagikan informasi ini ke partisipan event. …
[section]Sebelum memulai[/section] Untuk dapat menggunakan fitur ini, kamu perlu: [list] [*]Baca [doclink=store/promo]pedoman dan aturan[/doclink] untuk jenis event yang akan kamu jalankan. [*]Di bagian bawah setiap halaman aturan, temukan tautan di bagian "Permulaan" dan kirim tiket bantuan dengan menyertakan informasi tentang event-mu. [*]Setelah diaktifkan, kamu dapat menambahkan game, mengonfigurasi bagian, dan menyelesaikan sebagian besar pekerjaan pemasaran untuk mengatur game dalam event-mu. [*]Buka "pratinjau" halaman diskonmu untuk melihat kontrol yang mengaktifkan pengelompokan latar. …
Teks akan diletakkan di bagian bawah secara otomatis [doclink=store/assets/promos#spotlight]Lihat rinciannya[/doclink][/td] [td]Beberapa event dapat ditampilkan di halaman beranda toko. Jika sudah didiskusikan dengan kontak Valve-mu, maka kami dapat menggunakan gambar ini. …
Teks akan diletakkan di bagian bawah secara otomatis [doclink=store/assets/promos#spotlight]Lihat rinciannya[/doclink][/td] [td]Beberapa event dapat ditampilkan di halaman beranda toko. Jika sudah didiskusikan dengan kontak Valve-mu, maka kami dapat menggunakan gambar ini. …
[h4]Memberikan item dalam game karena mengaktifkan key pihak ketiga[/h4] Jika kamu menggunakan [doclink=features/inventory]Layanan Inventaris Steam[/doclink], pastikan ItemDef item dikonfigurasikan dengan benar sebagai item promo dan panggil [api]ISteamInventory::AddPromoItem[/api] dari client. Jika kamu memiliki item backend sendiri, panggil [api]ISteamUser::GetAuthSessionTicket[/api] dari client game, lalu gunakan [webapi]ISteamUserAuth/AuthenticateUserTicket[/webapi] dengan [webapi]ISteamUser/CheckAppOwnership[/webapi] untuk memverifikasi kepemilikan. …
issueid=938]kirimkan tiket[/url] untuk memulai prosesnya. Setelah kamu mengonfirmasikan bahwa kamu telah [doclink=/store/promo/organizers#10]membaca aturannya[/doclink], Steam akan mengaktifkan halaman diskon sehingga kamu dapat memulai membuat event-mu. Pada saat ini, event-mu akan ditinjau untuk setiap kemungkinan pemfituran di halaman beranda yang dikurasi. …
[/list] [/list] [b]Contoh Respons:[/b] [code=xml] { "response": { "item_json": "[{ \"accountid\":\"148618792083651397\",\"itemid\":\"17209346500926339\",\"Timestamp\":\"\",\"originalitemid\":\"17209346500926339\",\"itemdefid\":\"120\",\"appid\":480,\"position\":0,\"quantity\":1,\"transid\":\"\",\"state\":\"\",\"origin\":\"external\",\"price\":\"\",\"acquired\":\"20140912T195537Z\"}]" } } [/code] [b]Contoh panggilan:[/b] [code] curl -X POST -H "Content-Type: application/x-www-form-urlencoded" \ -d appid=480 \ -d steamid=292733980074050545 \ -d itemdefid[0]=4111 \ -d itemdefid[1]=4112 \ "http://api.steampowered.com/IInventoryService/AddItem/v1?key=xxxxxx" [/code] [section=AddPromoItem]AddPromoItem[/section] [code=http]POST https://partner.steam-api.com/IInventoryService/AddPromoItem/v1/[/code] [table] [tr][th]Nama[/th][th]Jenis[/th][th]Diperlukan[/th][th]Deskripsi[/th][/tr] [tr][td][b]key[/b][/td][td]string[/td][td]✔[/td] [td][url=https://partner.steamgames.com/doc/webapi_overview/auth#publisher-keys]Key penerbit[/url] Web API Steamworks dengan perizinan [b]Ekonomi[/b].…
Ilustrasi yang digunakan untuk Penawaran Tengah Minggu adalah aset kustom dengan rincian ukuran [doclink=store/assets/promos]di sini[/doclink], yang akan dilokalkan oleh Valve. Secara default, diskon Penawaran Tengah Minggu berjalan selama seminggu, tapi kami dapat menjalankannya antara tiga hingga 14 hari sesuai dengan permintaan penerbit. …
Sama dengan Penawaran Tengah Minggu, Penawaran Akhir Minggu memerlukan aset kustom dengan rincian ukuran [doclink=store/assets/promos]di sini[/doclink], yang akan dilokalkan oleh Valve. Secara default, diskon Penawaran Akhir Minggu berjalan selama seminggu, tapi kami dapat menjalankannya antara empat hingga 14 hari sesuai dengan permintaan penerbit. …
[subsection]Hosting events on Steam[/subsection] If you are looking for information on hosting a sale event on Steam, please see [doclink=store/promo/organizers][/doclink] [subsection]Getting Started With Sale Editor Tools[/subsection] The best place to start with familiarizing yourself with the sale page editing tools is this overview page here: [doclink=marketing/event_tools/sales/tools][/doclink] For more details on various topics within the sale page editors, please see the following documentation: [list] [*][doclink=marketing/event_tools/sales/groups][/doclink] [*][doclink=marketing/event_tools/sales/livestream][/doclink] [*][doclink=marketing/event_tools/sales/minimum][/doclink] [*][doclink=marketing/event_tools/sales/sections][/doclink] [/list] …
[/td][/tr] [/table] [b]Contoh respons:[/b] [code] "response": { "results": [ { "partnerid": "10500", "date": "2025/05/01", "line_item_type": "Package", "packageid": 123, "bundleid":777 "package_sale_type": "Steam", "platform": "Windows", "country_code": "AU", "base_price": "3995", "sale_price": "1995", "currency": "AUD", "gross_units_sold": 10, "gross_units_returned": -2, "gross_sales_usd": "311.7201", "gross_returns_usd": "-25.5322", "net_tax_usd": "26.0431", "primary_appid": 999, "additional_revenue_share_tier": 0, "net_units_sold": 8, "net_sales_usd": "260.1448", "combined_discount_id": 8888, "total_discount_percentage": 50 }, { "partnerid": "10500", "date": "2025/05/01", "line_item_type": "Package", "packageid": 456, "package_sale_type": "Steam", "platform": "Windows", "country_code": "CA", "base_price": "5999", "sale_price": "5999", "currency": "CAD", "gross_units_sold": 100, "gross_units_returned": 0, "gross_sales_usd": "4309.0101", "gross_returns_usd": "0.0000", "net_tax_usd": "517.0812", "primary_appid": 1099, "additional_revenue_share_tier": 1, "viw_grant_partnerid": "5200", "net_units_sold": 100, "net_sales_usd": "3791.9288", }, { "partnerid": "10500", "date": "2025/05/01", "line_item_type": "MicroTxn", "appid": 1099, "game_item_id": 1, "country_code": "US", "currency": "USD", "gross_units_sold": 2, "gross_units_returned": 0, "gross_sales_usd": "9.9800", "gross_returns_usd": "0.0000", "net_tax_usd": "0.9980", "primary_appid": 1099, "additional_revenue_share_tier": 1, "net_units_sold": 2, "net_sales_usd": "8.9820", "avg_sale_price_usd": "4.9900" }, { "partnerid": "10500", "date": "2025/05/01", "line_item_type": "Package", "packageid": 123, "package_sale_type": "Retail", "platform": "Unknown", "country_code": "AE", "primary_appid": 999, "key_request_id": 7100, "gross_units_activated": 10 }, ], "key_request_info": [ { "key_request_id": 7100, "key_request_notes": "Keys for Key Markets", "game_code_id": 842, "game_code_description": "Retail Distribution - Middle East & North Africa", "territory_code_id": 0, "territory_code_description": "UNUSED" } ], "package_info": [ { "packageid": 123, "package_name": "Grate Expectations: Cheese Preparation Simulator - Deluxe Edition" }, { "packageid": 456, "package_name": "Grate Expectations 2: Curd Your Loins - Launch Edition" } ] "app_info": [ { "appid": 999, "app_name": "Grate Expectations: Cheese Preparation Simulator }, { "appid": 1099, "app_name": "Grate Expectations 2: Curd Your Loins" } ], "bundle_info": [ { "bundleid": 777, "bundle_name": "Grate Expectations Deluxe Bundle" }, ], "combined_discount_info": [ { "combined_discount_id": 8888, "combined_discount_name": "Bundle Discount", "total_discount_percentage": 50, "discount_ids": [11111] }, ], "game_item_info": [ { "appid": 1099, "game_item_id": 1, "game_item_description": "500 Grams of Whey", "game_item_category": "Essential Cheese Product" } ], "country_info": [ { "country_code": "AE", "country_name": "United Arab Emirates", "region": "Middle East & North Africa" }, { "country_code": "AU", "country_name": "Australia", "region": "Oceania" }, { "country_code": "CA", "country_name": "Canada", "region": "North America" }, { "country_code": "US", "country_name": "United States", "region": "North America" }, ], "max_id": "29481179373" [/code] [section=GetAppWishlistReporting]GetAppWishlistReporting[/section] [code=http]GET https://partner.steam-api.com/IPartnerFinancialsService/GetAppWishlistReporting/v001/[/code] [b]Nilai permintaan[/b][table] [tr][th]Nama[/th][th]Jenis[/th][th]Diperlukan[/th][th]Description[/th][/tr] [tr] [td][b]key[/b][/td][td]string[/td] [td]✔[/td] [td]Web API Steamworks [url=https://partner.steamgames.com/doc/webapi_overview/auth#publisher-keys]key penerbit[/url] dengan perizinan [b]Finansial[/b].…