Tilaa brändin ulkoinen arviointi

Käytä tilin omistamaa viestintäbrändiä

Käytä käytössä olevaa API-tiliä HTTPS-yhteyden kautta sallitusta lähde-IP-osoitteesta. Tuetut todennustavat ovat Basic ja Bearer. Bränditunnuksen on kuuluttava kyseiselle tilille. Pidä palveluntarjoajan tunnisteet, brändin identiteettitiedot ja palautetut raportit yksityisinä.

Tilaa uusi ulkoinen arviointi

Käytä POST-menetelmää, kun arviointipalveluntarjoajan on tehtävä tälle brändille uusi arviointi. Jos sinulla on jo palveluntarjoajan tulos, käytä tuontia sen sijaan. Tästä erillinen toiminto on brändin identiteetin uudelleenvarmennus.

Lue ensin nykyisen brändin tiedot ja vahvista sen identiteettitiedot. Valitse tuettu palveluntarjoajan ja luokan yhdistelmä luetteloista, jotka ovat ajan tasalla ja tarkista kyseisen palveluntarjoajan vaatimukset. Kaikki palveluntarjoajat eivät tue kaikkia luokkia. Poliittisen arvioinnin lisätietojen on kuvattava todellista organisaatiota tai kampanjaa, eivätkä ne saa olla esimerkkitietoja.

Valmistele palveluntarjoajalle lähetettävä pyyntö

Ulkoisen arviointitilauksen kentät
Kenttä	Arvo
evpId	Pakollinen palveluntarjoajan tunnus ajantasaisesta ulkoisten arviointipalveluntarjoajien luettelosta, 1–10 merkkiä.
vettingClass	Tuettu luokka, jonka aiot ostaa; valitse se nimenomaisesti ja vahvista sen hinta.
additionalRequestPayload	JSON-koodattu merkkijono, joka sisältää palveluntarjoajakohtaiset tiedot ja on pakollinen poliittisessa arvioinnissa. Se on ulomman JSON-olion sisällä oleva merkkijono, ei sisäkkäinen olio. Varmista kaikki vaaditut tiedot valitulta palveluntarjoajalta.

Vahvista onnistuneen ja epäonnistuneen tuloksen maksut

Nykyiset asiakashinnat Yhdysvaltain dollareina, tarkistettu 24. lokakuuta 2026. Vahvista ajantasainen summa ennen todellisen tilauksen tekemistä. Ennakkoon maksetun saldon riittävyys tarkistetaan onnistuneen tuloksen hinnan perusteella; ostojen on oltava sallittuja.

Ulkoisen arvioinnin määritetyt tuloskohtaiset maksut
Luokka	Aktiivinen tulos	Epäonnistunut tulos
STANDARD	$46.12	$5.56
ENHANCED	$112.78	$6.67
POLITICAL	$73.34	$24.45
POLITICAL ja Express-pyyntö	$106.67	$24.45
AUTHPLUS	$13.89	$13.89
RCS	$83.34	$83.34

Odottavissa tilauksissa säilyvät onnistuneen ja epäonnistuneen tuloksen maksusummat, ja lopullinen veloitus tehdään, kun tulos tilassa ACTIVE tai FAILED synkronoidaan. Kahdessa viimeisessä luokassa on sama määritetty maksu kummallekin lopulliselle tulokselle. Välittömästi saatu lopullinen tulos voidaan veloittaa tilausvastauksen yhteydessä. Myöhempi tilan synkronointi voi tehdä odottavan maksun lopullisen veloituksen.

Älä pidä asetusta mock:true lupauksena maksuttomasta ulkoisesta arvioinnista. Ulkoisen arvioinnin nykyinen veloitusprosessi voi silti kirjata ja veloittaa kyseisen tilauksen. Nämä ohjeet eivät edellytä todellista ostoa testausta varten; käytä paikallisia testiaineistoja ilman verkkoyhteyttä, kunnes aiot valtuuttaa maksullisen arvioinnin.

Lähetä yksi tarkastettu tilaus

Valmistele vetting-order.json-tiedosto, joka sisältää palveluntarjoajan tunnuksen, luokan ja mahdolliset vaaditut lisätiedot. Tiedosto sisältää todellisen pyynnön, jonka aiot lähettää. Pidä se yksityisenä.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request POST \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @vetting-order.json \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"

Seuraa todellista tulosta

Onnistunut HTTP-vastaus voi sisältää odottavan arviointitietueen. Säilytä sen vettingId ja tarkista vettingStatus, syyt, pisteet sekä voimassaolon alkamis- ja päättymispäivät siltä osin kuin ne ovat saatavilla. PENDING ja UNSCORE edellyttävät jatkoseurantaa; ACTIVE, FAILED ja EXPIRED kuvaavat eri tuloksia. Pelkkä HTTP-tason hyväksyntä ei osoita suotuisaa pistemäärää tai kampanjan kelpoisuutta.

Käytä ulkoisen arvioinnin tilatietoa tietueen seuraamiseen. Lopullisen tuloksen lukeminen tai tuonti voi tehdä aiemman maksullisen tilauksen lopullisen veloituksen; toimenpiteestä voi siis aiheutua olemassa olevan avoimen maksun veloitus.

Yritä samaa tarkoitettua pyyntöä uudelleen

Käytä yhtä Idempotency-Key-avainta kutakin tarkoitettua toimintoa kohden ja säilytä menetelmä, polku, kysely ja pyynnön rungon tavut täsmälleen samoina. Avaimissa voi olla 1–128 tulostettavaa ASCII-merkkiä ilman välilyöntejä. Keskeneräisen pyynnön kaksoiskappale voi palauttaa koodin 409 ja Retry-After-otsakkeen. Valmiista pyynnöistä palautetaan uudelleen niiden tallennettu vastaus virheineen. Noudata pyyntötiheyden rajoituksia.

Välimuistiin tallennettu 502-vastaus voi seurata tiedonsiirtovirhettä. Välimuistiin tallennettu 500-vastaus, jossa on requestId, voi tarkoittaa, että rekisteri hyväksyi toiminnon mutta paikallinen pysyvä tallennus tai laskutus epäonnistui. Säilytä pyynnön tunnus, tarkista nykyiset tietueet ja selvitä tilanne tuen kanssa ennen uuden avaimen käyttöä. Älä oleta virheen tarkoittavan, ettei tilausta ole olemassa.