Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh 3: Metadata kontekstual

Bagian ini memberikan JSONata ekspresi untuk pola umum saat bekerja dengan respons Inferensi GetMetadata Elemental. Gunakan ini di Output blok AWS_SERVICE_REQUEST fungsi Anda.

Membangun jendela waktu kueri

Gunakan ekspresi berikut untuk Body bidang AWS_SERVICE_REQUEST fungsi Anda:

{%'{"outputName": "my-contextual-output", "timeSpecification": {"ptsBased": {"startPts": ' & $string(($exists(inference.previousBreakEndPts) and inference.previousBreakEndPts > inference.pts - 30 * inference.timescale ? inference.previousBreakEndPts : inference.pts - 30 * inference.timescale)) & ', "endPts": ' & $string(inference.pts + 1) & ', "timescale": ' & $string(inference.timescale) & '}}, "parameters": {"contextualMetadata": {}}}' %}

Ekspresi ini memilih tampilan yang lebih inference.previousBreakEndPts baru dan 30 detik, memastikan jendela kueri tidak pernah melebihi 30 detik. Jika inference.previousBreakEndPts tidak tersedia (misalnya, jeda iklan pertama), ekspresi default akan menggunakan tampilan balik 30 detik.

Ekstrak IAB ID kategori

{%response.statusCode = 200 ? $join($distinct(response.body.items.metadata.contextualMetadata.iabTaxonomy.categories.uniqueId), ',') : ''%}

Hasil: "641,645,324" — IAB ID unik Taksonomi Konten, cocok untuk diteruskan sebagai parameter kueri (misalnya,iab_cats=641,645,324).

Ekstrak IAB jalur kategori

{%response.statusCode = 200 ? $join($distinct(response.body.items.metadata.contextualMetadata.iabTaxonomy.categories.($join(path, ' > '))), '|') : ''%}

Hasil: "Genres > Animation & Anime|Genres > Family/Children|Entertainment > Movies" — jalur taksonomi yang dapat dibaca manusia.

Ekstrak ditandai GARM kategori

{%response.statusCode = 200 ? $join($distinct(response.body.items.metadata.contextualMetadata.garm.suitability.categories[flagged = true].category), ',') : ''%}

Hasil: "ILLEGAL_DRUGS_TOBACCO_ALCOHOL" — kategori untuk dikecualikan dari penargetan iklan atau untuk memberi sinyal masalah keamanan merek ke server keputusan iklan Anda.

Tentukan tertinggi GARM tingkat risiko

{%response.statusCode = 200 and $exists(response.body.items) ? ($names := ['NONE','LOW','MEDIUM','HIGH']; $flagged := response.body.items.metadata.contextualMetadata.garm.suitability.categories[flagged = true].risk; $scores := $map($flagged, function($r){ $r = 'HIGH' ? 3 : $r = 'MEDIUM' ? 2 : $r = 'LOW' ? 1 : 0 }); $count($scores) > 0 ? $names[$max($scores)] : 'NONE') : ''%}

Hasil: "MEDIUM" — tingkat risiko terburuk di semua tembakan dan GARM kategori yang dianalisis. Mengembalikan string kosong jika permintaan gagal atau badan respons hilang, sehingga data yang hilang tidak dilaporkan sebagaiNONE.

Periksa keamanan merek

{%response.statusCode = 200 and $exists(response.body.items) ? $string($not($exists(response.body.items.metadata.contextualMetadata.garm.suitability.categories[flagged = true]))) : ''%}

Hasil: "false" jika ada GARM kategori yang ditandai, "true" jika konten aman untuk merek. Mengembalikan string kosong jika permintaan gagal atau badan respons hilang.

Sinyal kontekstual gabungan

{%response.statusCode = 200 ? $string({'categories': $distinct(response.body.items.metadata.contextualMetadata.iabTaxonomy.categories.($join(path, ' > '))), 'category_ids': $distinct(response.body.items.metadata.contextualMetadata.iabTaxonomy.categories.uniqueId), 'garm_flagged': $distinct(response.body.items.metadata.contextualMetadata.garm.suitability.categories[flagged = true].category)}) : ''%}

Hasil: String JSON menggabungkan semua sinyal kontekstual menjadi satu muatan terstruktur.

Per-shot detail

{%response.statusCode = 200 ? $string(response.body.items.{'pts': pts, 'categories': metadata.contextualMetadata.iabTaxonomy.categories.($join(path, ' > ')), 'garm_flagged': metadata.contextualMetadata.garm.suitability.categories[flagged = true].category}) : ''%}

Hasil: Array objek per bidikan yang mempertahankan konten mana di mana PTS memicu klasifikasi mana. Gunakan ketika logika pengambilan keputusan iklan Anda membutuhkan perincian temporal.

Tips dan praktik terbaik

Gunakan tips berikut saat membangun ekspresi keluaran untuk respons Inferensi Elemental.

Untuk panduan penyiapan lengkap termasuk prasyarat dan kebijakan sumber daya, lihatIntegrasi Inferensi Elemental. Untuk referensi tipe fungsi, lihatAWS permintaan layanan.