Preferensi privasi

Fitur wajib

Diperlukan untuk keamanan dan fungsi dasar situs.

Selalu aktif

Diagnostik Landing & pemutaran ulang yang disamarkan

Mengukur kunjungan publik, pengunjung yang berhenti melanjutkan, dan interaksi dengan tautan pendaftaran menggunakan ID anonim khusus tab ini, tanpa menautkan akun. Semua teks disamarkan dan formulir diblokir.

Analitik penggunaan opsional

Izinkan analitik penggunaan PostHog? Ubah pilihan Anda kapan saja di footer.

Izinkan juga pemutaran ulang sesi di situs web publik ini

Pemutaran ulang dalam mode lintas situs opsional menampilkan halaman publik dan interaksi, dengan input serta konten pribadi disamarkan. Pemutaran ulang di App merupakan pilihan terpisah.

Memerlukan analitik opsional; pemutaran ulang dalam mode lintas situs ini nonaktif secara default. Mode Landing di atas berjalan secara terpisah.

Cara kami menggunakan data

Mode Landing default menyimpan ID anonim hanya di sessionStorage tab ini, tanpa menautkannya ke App, akun, atau ID lintas situs opsional. Mengizinkan analitik opsional beralih ke ID terpisah tanpa menggabungkan catatan Landing sebelumnya.

Dengan mengizinkan analitik opsional, Anda memungkinkan PostHog berbagi cookie anonim antara situs web ini dan App kami, dengan penyimpanan lokal browser di masing-masing situs. Dengan persetujuan Anda, kunjungan terverifikasi di tab yang sama dapat ditautkan ke akun baru Anda setelah pendaftaran dikonfirmasi.

Pemutaran ulang dalam mode lintas situs opsional nonaktif secara default. Hapus centang opsi pemutaran ulang mode tersebut dan simpan untuk menghentikan rekaman baru dalam mode itu; nonaktifkan diagnostik Landing dan pemutaran ulang yang disamarkan secara terpisah di atas. Pilihan ini tidak mengubah pengaturan akun.

Pemberitahuan privasi & pengukuran agregat Cloudflare terpisah.

Analitik browser tidak mengaktifkan analitik akun.

SosoAPI
Mulai gratis
ID
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
Mulai gratis

Pencarian hanya dimuat saat digunakan. Jelajahi semua kategori di bawah.

Periklanan

Kueri wawasan iklan

Ambil kinerja iklan berbayar resmi dalam batas tertentu dengan tanggal, zona waktu, mata uang, jendela atribusi, dan tindakan konversi yang eksplisit. Metrik yang tidak tersedia tetap tidak tersedia.

POST /advertising-api/insights/query

Kontrak ditinjau: · sha256:9aedef8d43dd4514

Baca sebagai MarkdownUnduh kontrak publikUnduh OpenAPI

Ringkasan

Ambil kinerja iklan berbayar resmi dalam batas tertentu dengan tanggal, zona waktu, mata uang, jendela atribusi, dan tindakan konversi yang eksplisit. Metrik yang tidak tersedia tetap tidak tersedia.

Respons HTTP berhasil dapat berarti permintaan diterima, bukan selesai. Untuk pekerjaan latar belakang, simpan ID yang dikembalikan dan periksa operasi yang sama sampai selesai. Postingan terjadwal atau diterima baru dipublikasikan setelah platform mengonfirmasi; timeout klien tidak membuktikan hasilnya.

Autentikasi dan izin

Jenis kredensial yang diterima
user_session, delegated_oauth, personal_access_token
Kemampuan yang didelegasikan
agent:advertising_read
Peran ruang kerja minimum
viewer
Cakupan akses
Sumber daya yang boleh diakses pengguna ini
Persetujuan seluruh ruang kerja diperlukan
Tidak
Mengubah status
Tidak
Saat operasi selesai
synchronous_http_response

Token hanya dapat menggunakan hak pemiliknya. Setiap permintaan memeriksa keanggotaan ruang kerja, kepemilikan sumber daya, ruang kerja terpilih, dan kemampuan yang diberikan. Profil core dan full mengubah alat yang ditampilkan; tidak memberikan akses.

Kolom permintaan

Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.

Kolom permintaan
Kolom / cabangJenis / wajibBatasan
$objectWajib dalam induk
  • additionalProperties: false
workspace_idstringWajib dalam induk
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
advertising_account_idstringWajib dalam induk
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
levelstringWajib dalam induk
  • enum: ["campaign","adset","ad"]
start_datestringWajib dalam induk
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
end_datestringWajib dalam induk
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
action_attribution_windowsarrayWajib dalam induk
  • minItems: 1
  • maxItems: 1
action_attribution_windows[]stringOpsional / item
  • enum: ["1d_click","7d_click","1d_view"]
action_report_timestringWajib dalam induk
  • enum: ["impression","conversion"]
conversion_action_typestringWajib dalam induk
  • pattern: "^[a-z][a-z0-9_.]{0,99}$"
revenue_action_typestringWajib dalam induk
  • pattern: "^[a-z][a-z0-9_.]{0,99}$"
afterstringOpsional / item
  • maxLength: 2048
limitintegerOpsional / item
  • minimum: 1
  • maximum: 50
  • default: 25
JSON Schema lengkap
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "advertising_account_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "level": {
      "type": "string",
      "enum": [
        "campaign",
        "adset",
        "ad"
      ]
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "action_attribution_windows": {
      "minItems": 1,
      "maxItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "1d_click",
          "7d_click",
          "1d_view"
        ]
      }
    },
    "action_report_time": {
      "type": "string",
      "enum": [
        "impression",
        "conversion"
      ]
    },
    "conversion_action_type": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9_.]{0,99}$"
    },
    "revenue_action_type": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9_.]{0,99}$"
    },
    "after": {
      "type": "string",
      "maxLength": 2048
    },
    "limit": {
      "default": 25,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "workspace_id",
    "advertising_account_id",
    "level",
    "start_date",
    "end_date",
    "action_attribution_windows",
    "action_report_time",
    "conversion_action_type",
    "revenue_action_type"
  ],
  "additionalProperties": false
}

Respons dan penyelesaian

Status HTTP berhasil: 200. Saat operasi selesai: synchronous_http_response.

Respons HTTP berhasil dapat berarti permintaan diterima, bukan selesai. Untuk pekerjaan latar belakang, simpan ID yang dikembalikan dan periksa operasi yang sama sampai selesai. Postingan terjadwal atau diterima baru dipublikasikan setelah platform mengonfirmasi; timeout klien tidak membuktikan hasilnya.

Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.

Respons dan penyelesaian
Kolom / cabangJenis / wajibBatasan
$objectWajib dalam induk—
contract_versionstringWajib dalam induk
  • const: "ad-performance/v1"
source_idstringWajib dalam induk
  • maxLength: 100
source_sha256stringWajib dalam induk
  • pattern: "^[a-f0-9]{64}$"
identity_verificationstringWajib dalam induk
  • enum: ["customer_supplied","accepted_provider_grant"]
currencystringWajib dalam induk
  • pattern: "^[A-Z]{3}$"
timezonestringWajib dalam induk
  • maxLength: 100
selectionobjectWajib dalam induk—
selection.provider_api_versionstringWajib dalam induk
  • const: "v26.0"
selection.provider_account_idstringWajib dalam induk
  • pattern: "^[1-9]\\d{1,24}$"
selection.currencystringWajib dalam induk
  • pattern: "^[A-Z]{3}$"
selection.timezonestringWajib dalam induk
  • maxLength: 100
selection.levelstringWajib dalam induk
  • enum: ["campaign","adset","ad"]
selection.start_datestringWajib dalam induk
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
selection.end_datestringWajib dalam induk
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
selection.action_attribution_windowsarrayWajib dalam induk
  • minItems: 1
  • maxItems: 1
selection.action_attribution_windows[]stringOpsional / item
  • enum: ["1d_click","7d_click","1d_view"]
selection.action_report_timestringWajib dalam induk
  • enum: ["impression","conversion"]
selection.conversion_action_typestringWajib dalam induk
  • maxLength: 100
selection.revenue_action_typestringWajib dalam induk
  • maxLength: 100
completebooleanWajib dalam induk—
rowsarrayWajib dalam induk
  • maxItems: 500
rows[]objectOpsional / item—
rows[].row_idstringWajib dalam induk
  • maxLength: 100
rows[].metricsobjectWajib dalam induk—
rows[].metrics.spendobjectWajib dalam induk—
rows[].metrics.spend.valuestring | nullWajib dalam induk—
rows[].metrics.spend.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.spend.valueanyOf 2nullWajib dalam induk—
rows[].metrics.spend.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.spend.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.spend.reasonstring | nullWajib dalam induk—
rows[].metrics.spend.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
rows[].metrics.spend.reasonanyOf 2nullWajib dalam induk—
rows[].metrics.spend.input_refsarrayWajib dalam induk
  • maxItems: 2000
rows[].metrics.spend.input_refs[]stringOpsional / item
  • maxLength: 300
rows[].metrics.clicksobjectWajib dalam induk—
rows[].metrics.clicks.valuestring | nullWajib dalam induk—
rows[].metrics.clicks.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.clicks.valueanyOf 2nullWajib dalam induk—
rows[].metrics.clicks.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.clicks.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.clicks.reasonstring | nullWajib dalam induk—
rows[].metrics.clicks.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
rows[].metrics.clicks.reasonanyOf 2nullWajib dalam induk—
rows[].metrics.clicks.input_refsarrayWajib dalam induk
  • maxItems: 2000
rows[].metrics.clicks.input_refs[]stringOpsional / item
  • maxLength: 300
rows[].metrics.conversionsobjectWajib dalam induk—
rows[].metrics.conversions.valuestring | nullWajib dalam induk—
rows[].metrics.conversions.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.conversions.valueanyOf 2nullWajib dalam induk—
rows[].metrics.conversions.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.conversions.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.conversions.reasonstring | nullWajib dalam induk—
rows[].metrics.conversions.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
rows[].metrics.conversions.reasonanyOf 2nullWajib dalam induk—
rows[].metrics.conversions.input_refsarrayWajib dalam induk
  • maxItems: 2000
rows[].metrics.conversions.input_refs[]stringOpsional / item
  • maxLength: 300
rows[].metrics.attributed_revenueobjectWajib dalam induk—
rows[].metrics.attributed_revenue.valuestring | nullWajib dalam induk—
rows[].metrics.attributed_revenue.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.attributed_revenue.valueanyOf 2nullWajib dalam induk—
rows[].metrics.attributed_revenue.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.attributed_revenue.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.attributed_revenue.reasonstring | nullWajib dalam induk—
rows[].metrics.attributed_revenue.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
rows[].metrics.attributed_revenue.reasonanyOf 2nullWajib dalam induk—
rows[].metrics.attributed_revenue.input_refsarrayWajib dalam induk
  • maxItems: 2000
rows[].metrics.attributed_revenue.input_refs[]stringOpsional / item
  • maxLength: 300
rows[].metrics.cpcobjectWajib dalam induk—
rows[].metrics.cpc.valuestring | nullWajib dalam induk—
rows[].metrics.cpc.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.cpc.valueanyOf 2nullWajib dalam induk—
rows[].metrics.cpc.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.cpc.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.cpc.reasonstring | nullWajib dalam induk—
rows[].metrics.cpc.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
rows[].metrics.cpc.reasonanyOf 2nullWajib dalam induk—
rows[].metrics.cpc.input_refsarrayWajib dalam induk
  • maxItems: 2000
rows[].metrics.cpc.input_refs[]stringOpsional / item
  • maxLength: 300
rows[].metrics.cpaobjectWajib dalam induk—
rows[].metrics.cpa.valuestring | nullWajib dalam induk—
rows[].metrics.cpa.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.cpa.valueanyOf 2nullWajib dalam induk—
rows[].metrics.cpa.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.cpa.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.cpa.reasonstring | nullWajib dalam induk—
rows[].metrics.cpa.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
rows[].metrics.cpa.reasonanyOf 2nullWajib dalam induk—
rows[].metrics.cpa.input_refsarrayWajib dalam induk
  • maxItems: 2000
rows[].metrics.cpa.input_refs[]stringOpsional / item
  • maxLength: 300
rows[].metrics.attributed_roasobjectWajib dalam induk—
rows[].metrics.attributed_roas.valuestring | nullWajib dalam induk—
rows[].metrics.attributed_roas.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.attributed_roas.valueanyOf 2nullWajib dalam induk—
rows[].metrics.attributed_roas.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.attributed_roas.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.attributed_roas.reasonstring | nullWajib dalam induk—
rows[].metrics.attributed_roas.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
rows[].metrics.attributed_roas.reasonanyOf 2nullWajib dalam induk—
rows[].metrics.attributed_roas.input_refsarrayWajib dalam induk
  • maxItems: 2000
rows[].metrics.attributed_roas.input_refs[]stringOpsional / item
  • maxLength: 300
totalsobjectWajib dalam induk—
totals.spendobjectWajib dalam induk—
totals.spend.valuestring | nullWajib dalam induk—
totals.spend.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.spend.valueanyOf 2nullWajib dalam induk—
totals.spend.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.spend.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.spend.reasonstring | nullWajib dalam induk—
totals.spend.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
totals.spend.reasonanyOf 2nullWajib dalam induk—
totals.spend.input_refsarrayWajib dalam induk
  • maxItems: 2000
totals.spend.input_refs[]stringOpsional / item
  • maxLength: 300
totals.clicksobjectWajib dalam induk—
totals.clicks.valuestring | nullWajib dalam induk—
totals.clicks.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.clicks.valueanyOf 2nullWajib dalam induk—
totals.clicks.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.clicks.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.clicks.reasonstring | nullWajib dalam induk—
totals.clicks.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
totals.clicks.reasonanyOf 2nullWajib dalam induk—
totals.clicks.input_refsarrayWajib dalam induk
  • maxItems: 2000
totals.clicks.input_refs[]stringOpsional / item
  • maxLength: 300
totals.conversionsobjectWajib dalam induk—
totals.conversions.valuestring | nullWajib dalam induk—
totals.conversions.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.conversions.valueanyOf 2nullWajib dalam induk—
totals.conversions.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.conversions.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.conversions.reasonstring | nullWajib dalam induk—
totals.conversions.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
totals.conversions.reasonanyOf 2nullWajib dalam induk—
totals.conversions.input_refsarrayWajib dalam induk
  • maxItems: 2000
totals.conversions.input_refs[]stringOpsional / item
  • maxLength: 300
totals.attributed_revenueobjectWajib dalam induk—
totals.attributed_revenue.valuestring | nullWajib dalam induk—
totals.attributed_revenue.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.attributed_revenue.valueanyOf 2nullWajib dalam induk—
totals.attributed_revenue.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.attributed_revenue.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.attributed_revenue.reasonstring | nullWajib dalam induk—
totals.attributed_revenue.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
totals.attributed_revenue.reasonanyOf 2nullWajib dalam induk—
totals.attributed_revenue.input_refsarrayWajib dalam induk
  • maxItems: 2000
totals.attributed_revenue.input_refs[]stringOpsional / item
  • maxLength: 300
totals.cpcobjectWajib dalam induk—
totals.cpc.valuestring | nullWajib dalam induk—
totals.cpc.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.cpc.valueanyOf 2nullWajib dalam induk—
totals.cpc.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.cpc.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.cpc.reasonstring | nullWajib dalam induk—
totals.cpc.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
totals.cpc.reasonanyOf 2nullWajib dalam induk—
totals.cpc.input_refsarrayWajib dalam induk
  • maxItems: 2000
totals.cpc.input_refs[]stringOpsional / item
  • maxLength: 300
totals.cpaobjectWajib dalam induk—
totals.cpa.valuestring | nullWajib dalam induk—
totals.cpa.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.cpa.valueanyOf 2nullWajib dalam induk—
totals.cpa.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.cpa.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.cpa.reasonstring | nullWajib dalam induk—
totals.cpa.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
totals.cpa.reasonanyOf 2nullWajib dalam induk—
totals.cpa.input_refsarrayWajib dalam induk
  • maxItems: 2000
totals.cpa.input_refs[]stringOpsional / item
  • maxLength: 300
totals.attributed_roasobjectWajib dalam induk—
totals.attributed_roas.valuestring | nullWajib dalam induk—
totals.attributed_roas.valueanyOf 1stringWajib dalam induk
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.attributed_roas.valueanyOf 2nullWajib dalam induk—
totals.attributed_roas.unitstringWajib dalam induk
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.attributed_roas.availabilitystringWajib dalam induk
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.attributed_roas.reasonstring | nullWajib dalam induk—
totals.attributed_roas.reasonanyOf 1stringWajib dalam induk
  • maxLength: 300
totals.attributed_roas.reasonanyOf 2nullWajib dalam induk—
totals.attributed_roas.input_refsarrayWajib dalam induk
  • maxItems: 2000
totals.attributed_roas.input_refs[]stringOpsional / item
  • maxLength: 300
gapsarrayWajib dalam induk
  • maxItems: 1000
gaps[]stringOpsional / item
  • maxLength: 300
suggestionsarrayWajib dalam induk
  • maxItems: 3
suggestions[]objectOpsional / item—
suggestions[].rule_idstringWajib dalam induk
  • enum: ["supply_revenue","review_comparable_creative_test","complete_coverage"]
suggestions[].rule_versionnumberWajib dalam induk
  • const: 1
suggestions[].proposalstringWajib dalam induk
  • maxLength: 600
suggestions[].input_refsarrayWajib dalam induk
  • maxItems: 2000
suggestions[].input_refs[]stringOpsional / item
  • maxLength: 300
suggestions[].limitationsstringWajib dalam induk
  • const: "Observational comparison only; no causal uplift or profitability claim. Human review required."
advertising_account_idstringWajib dalam induk
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
next_cursorstring | nullWajib dalam induk—
next_cursoranyOf 1stringWajib dalam induk
  • maxLength: 2048
next_cursoranyOf 2nullWajib dalam induk—
JSON Schema lengkap
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "ad-performance/v1"
    },
    "source_id": {
      "type": "string",
      "maxLength": 100
    },
    "source_sha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "identity_verification": {
      "type": "string",
      "enum": [
        "customer_supplied",
        "accepted_provider_grant"
      ]
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "timezone": {
      "type": "string",
      "maxLength": 100
    },
    "selection": {
      "type": "object",
      "properties": {
        "provider_api_version": {
          "type": "string",
          "const": "v26.0"
        },
        "provider_account_id": {
          "type": "string",
          "pattern": "^[1-9]\\d{1,24}$"
        },
        "currency": {
          "type": "string",
          "pattern": "^[A-Z]{3}$"
        },
        "timezone": {
          "type": "string",
          "maxLength": 100
        },
        "level": {
          "type": "string",
          "enum": [
            "campaign",
            "adset",
            "ad"
          ]
        },
        "start_date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "end_date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "action_attribution_windows": {
          "minItems": 1,
          "maxItems": 1,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "1d_click",
              "7d_click",
              "1d_view"
            ]
          }
        },
        "action_report_time": {
          "type": "string",
          "enum": [
            "impression",
            "conversion"
          ]
        },
        "conversion_action_type": {
          "type": "string",
          "maxLength": 100
        },
        "revenue_action_type": {
          "type": "string",
          "maxLength": 100
        }
      },
      "required": [
        "provider_api_version",
        "provider_account_id",
        "currency",
        "timezone",
        "level",
        "start_date",
        "end_date",
        "action_attribution_windows",
        "action_report_time",
        "conversion_action_type",
        "revenue_action_type"
      ]
    },
    "complete": {
      "type": "boolean"
    },
    "rows": {
      "maxItems": 500,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "row_id": {
            "type": "string",
            "maxLength": 100
          },
          "metrics": {
            "type": "object",
            "properties": {
              "spend": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              },
              "clicks": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              },
              "conversions": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              },
              "attributed_revenue": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              },
              "cpc": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              },
              "cpa": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              },
              "attributed_roas": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              }
            },
            "required": [
              "spend",
              "clicks",
              "conversions",
              "attributed_revenue",
              "cpc",
              "cpa",
              "attributed_roas"
            ]
          }
        },
        "required": [
          "row_id",
          "metrics"
        ]
      }
    },
    "totals": {
      "type": "object",
      "properties": {
        "spend": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        },
        "clicks": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        },
        "conversions": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        },
        "attributed_revenue": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        },
        "cpc": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        },
        "cpa": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        },
        "attributed_roas": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        }
      },
      "required": [
        "spend",
        "clicks",
        "conversions",
        "attributed_revenue",
        "cpc",
        "cpa",
        "attributed_roas"
      ]
    },
    "gaps": {
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 300
      }
    },
    "suggestions": {
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rule_id": {
            "type": "string",
            "enum": [
              "supply_revenue",
              "review_comparable_creative_test",
              "complete_coverage"
            ]
          },
          "rule_version": {
            "type": "number",
            "const": 1
          },
          "proposal": {
            "type": "string",
            "maxLength": 600
          },
          "input_refs": {
            "maxItems": 2000,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 300
            }
          },
          "limitations": {
            "type": "string",
            "const": "Observational comparison only; no causal uplift or profitability claim. Human review required."
          }
        },
        "required": [
          "rule_id",
          "rule_version",
          "proposal",
          "input_refs",
          "limitations"
        ]
      }
    },
    "advertising_account_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2048
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "contract_version",
    "source_id",
    "source_sha256",
    "identity_verification",
    "currency",
    "timezone",
    "selection",
    "complete",
    "rows",
    "totals",
    "gaps",
    "suggestions",
    "advertising_account_id",
    "next_cursor"
  ]
}

Kesalahan dan percobaan ulang aman

Periksa status HTTP dan isi respons. Kesalahan validasi 400 mungkin berisi ZodError; kesalahan handler menggunakan kolom error, message, dan code. Simpan request_id atau x-request-id untuk diagnosis, tanpa kredensial. Atasi kesalahan akses 401/403 sebelum mencoba lagi, dan ikuti Retry-After untuk 429. Jika penulisan belum pasti atau mengembalikan 5xx, baca hasil yang sudah ada terlebih dahulu. Gunakan kembali kunci idempotensi hanya jika didukung; perilaku percobaan ulang berbeda menurut operasi dan tidak menjamin pengiriman tepat satu kali.

Panduan pemecahan masalah

Contoh

Contoh ini menggunakan nilai fiktif yang diperiksa terhadap skema. Ganti ID dengan yang diizinkan bagi Anda, media dengan aset siap, dan tanggal dengan waktu publikasi yang dikonfirmasi. Periksa kelayakan akun sebelum mengirim penulisan. Halaman ini tidak mengirim permintaan API.

Atur SOSOAPI_ACCESS_TOKEN di server Anda ke kredensial yang diterima operasi ini, dan jauhkan dari kode browser. Untuk agen AI, gunakan sosoapi auth login untuk masuk melalui browser dan biarkan CLI memperbarui kredensialnya.

request.json

{
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "advertising_account_id": "11111111-1111-4111-8111-111111111111",
  "level": "campaign",
  "start_date": "2099-01-15",
  "end_date": "2099-01-15",
  "action_attribution_windows": [
    "1d_click"
  ],
  "action_report_time": "impression",
  "conversion_action_type": "example",
  "revenue_action_type": "example"
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/advertising-api/insights/query" \
  -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

JavaScript

// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/advertising-api/insights/query", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "advertising_account_id": "11111111-1111-4111-8111-111111111111",
  "level": "campaign",
  "start_date": "2099-01-15",
  "end_date": "2099-01-15",
  "action_attribution_windows": [
    "1d_click"
  ],
  "action_report_time": "impression",
  "conversion_action_type": "example",
  "revenue_action_type": "example"
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

npx sosoapi api post /advertising-api/insights/query < request.json

Contoh respons sintetis

{
  "contract_version": "ad-performance/v1",
  "source_id": "example",
  "source_sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "identity_verification": "customer_supplied",
  "currency": "USD",
  "timezone": "UTC",
  "selection": {
    "provider_api_version": "v26.0",
    "provider_account_id": "12345",
    "currency": "USD",
    "timezone": "UTC",
    "level": "campaign",
    "start_date": "2099-01-15",
    "end_date": "2099-01-15",
    "action_attribution_windows": [
      "1d_click"
    ],
    "action_report_time": "impression",
    "conversion_action_type": "example",
    "revenue_action_type": "example"
  },
  "complete": false,
  "rows": [],
  "totals": {
    "spend": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    },
    "clicks": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    },
    "conversions": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    },
    "attributed_revenue": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    },
    "cpc": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    },
    "cpa": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    },
    "attributed_roas": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    }
  },
  "gaps": [],
  "suggestions": [],
  "advertising_account_id": "11111111-1111-4111-8111-111111111111",
  "next_cursor": null
}

MCP: sosoapi_ads_insights_query

Semua operasi APIAutentikasi dan izin