All Products
Search

This Product

    Intelligent Media Services:AddAdInsertion

    Document Center

    Intelligent Media Services:AddAdInsertion

    Last Updated:Oct 12, 2026

    Menambahkan konfigurasi penyisipan iklan.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Sintaks permintaan

    POST  HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Name

    string

    Yes

    Nama konfigurasi. Nama harus unik dalam satu akun. Panjangnya dapat mencapai 128 karakter dan harus sesuai dengan ekspresi reguler [A-Za-z0-9_-]+.

    my_ad
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi. Token harus unik untuk setiap permintaan guna mencegah pengiriman duplikat. Panjangnya dapat mencapai 200 karakter.

    ****0311a423d11a5f7dee713535****
    ContentUrlPrefix

    string

    Yes

    Awalan URL konten. URL mendukung protokol HTTP dan HTTPS. Panjangnya dapat mencapai 512 karakter.

    https://source.com/
    SlateAdUrl

    string

    No

    URL iklan slate. URL mendukung protokol HTTP dan HTTPS serta hanya mendukung file MP4 (.mp4). Panjangnya dapat mencapai 2.048 karakter.

    http://storage.com/slate1.mp4
    ConfigAliases

    string

    No

    Alias konfigurasi dinamis. Nilai berupa string JSON. Anda dapat menambahkan hingga 20 entri player_params.{name}. Bagian name dapat memiliki panjang hingga 150 karakter. Di bawah setiap player_params.xxx, Anda dapat menambahkan hingga 50 pasangan kunci-nilai. Kunci dapat memiliki panjang hingga 150 karakter, dan nilai dapat memiliki panjang hingga 500 karakter. Contoh: { "player_params.{name}": { "{key}": "{value}" } }

    { "player_params.p1": { "1": "abc" } }
    CdnContentSegmentUrlPrefix

    string

    No

    Awalan CDN untuk segmen konten video. URL mendukung protokol HTTP dan HTTPS. Panjangnya dapat mencapai 512 karakter.

    http://cdn.com/
    CdnAdSegmentUrlPrefix

    string

    No

    Awalan CDN untuk segmen iklan. URL mendukung protokol HTTP dan HTTPS. Panjangnya dapat mencapai 512 karakter.

    http://cdn.com/
    AdMarkerPassthrough

    string

    No

    Apakah akan meneruskan penanda iklan. Nilai default: OFF.

    Valid values:

    • OFF :

      OFF: Dinonaktifkan.

    • ON :

      ON: Diaktifkan.

    ON
    PersonalizationThreshold

    integer

    No

    Ambang batas personalisasi. Unit: seconds. Nilai default: 8.

    5
    AdsUrl

    string

    Yes

    URL server keputusan iklan. URL mendukung protokol HTTP dan HTTPS. Panjangnya dapat mencapai 2.048 karakter.

    http://ads.com/ad1?param1=[palyer_params.p1]

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    Config

    object

    Konfigurasi penyisipan iklan.

    CreateTime

    string

    Waktu saat konfigurasi dibuat. Waktu mengikuti standar ISO 8601 dan dalam UTC (berakhiran Z).

    2024-06-13T08:26:09Z
    LastModified

    string

    Waktu saat konfigurasi terakhir kali dimodifikasi.

    2024-06-13T08:26:09Z

    Name

    string

    Nama konfigurasi penyisipan iklan.

    my_ad
    ContentUrlPrefix

    string

    Awalan URL konten.

    https://source.com/

    AdsUrl

    string

    URL server keputusan iklan.

    http://ads.com/ad1?param1=[palyer_params.p1]

    ConfigAliases

    string

    Alias konfigurasi dinamis.

    { "player_params.p1": { "1": "abc" } }

    PersonalizationThreshold

    integer

    Ambang batas personalisasi.

    5
    SlateAdUrl

    string

    URL iklan slate.

    http://storage.com/slate1.mp4

    CdnConfig

    object

    Konfigurasi CDN.

    ContentSegmentUrlPrefix

    string

    Awalan CDN untuk segmen konten video.

    http://cdn.com/

    AdSegmentUrlPrefix

    string

    Awalan CDN untuk segmen iklan.

    http://cdn.com/

    AdMarkerPassthrough

    string

    Apakah penanda iklan diteruskan.

    ON
    ManifestEndpointConfig

    object

    Konfigurasi titik akhir manifes.

    HlsPrefix

    string

    Awalan titik akhir manifes HLS.

    https://****0311a423d11a5f7dee713535****.weaverpull-ssai.ap-southeast-1.ice.alibabacloudcs.com/v1/master/****4fda5b1a8e0d46c9bf6262a7****/my_ad/

    DashPrefix

    string

    Awalan titik akhir manifes DASH.

    https://****0311a423d11a5f7dee713535****.weaverpull-ssai.ap-southeast-1.ice.alibabacloudcs.com/v1/dash/****4fda5b1a8e0d46c9bf6262a7****/my_ad/
    RequestId

    string

    ID permintaan.

    ******3B-0E1A-586A-AC29-742247******

    Contoh

    Respons sukses

    JSONformat

    {
  "Config": {
    "CreateTime": "2024-06-13T08:26:09Z",
    "LastModified": "2024-06-13T08:26:09Z\n",
    "Name": "my_ad",
    "ContentUrlPrefix": "https://source.com/\n",
    "AdsUrl": "http://ads.com/ad1?param1=[palyer_params.p1]\n",
    "ConfigAliases": "{ \"player_params.p1\": { \"1\": \"abc\" } }\n",
    "PersonalizationThreshold": 5,
    "SlateAdUrl": "http://storage.com/slate1.mp4\n",
    "CdnConfig": {
      "ContentSegmentUrlPrefix": "http://cdn.com/\n",
      "AdSegmentUrlPrefix": "http://cdn.com/\n"
    },
    "AdMarkerPassthrough": "ON",
    "ManifestEndpointConfig": {
      "HlsPrefix": "https://****0311a423d11a5f7dee713535****.weaverpull-ssai.ap-southeast-1.ice.alibabacloudcs.com/v1/master/****4fda5b1a8e0d46c9bf6262a7****/my_ad/\n",
      "DashPrefix": "https://****0311a423d11a5f7dee713535****.weaverpull-ssai.ap-southeast-1.ice.alibabacloudcs.com/v1/dash/****4fda5b1a8e0d46c9bf6262a7****/my_ad/"
    }
  },
  "RequestId": "******3B-0E1A-586A-AC29-742247******"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.