Táto zmluva upravuje vzťah medzi vami (ďalej len vy alebo používateľ) a spoločnosťou YANDEX LLC (ďalej len Yandex) týkajúci sa používania rozhrania API (ďalej len API) služby Yandex.Direct (ďalej len ako Služba).
Yandex vám poskytuje možnosť používať rozhranie API služby na správu reklamných kampaní pomocou aplikácií, ktoré interagujú so službou, ako aj používať rozhranie API inými spôsobmi, ktoré nie sú v rozpore s touto dohodou. Používanie API v rámci Služby sa riadi touto Zmluvou, Ponukou služby umiestnenou na adrese a Zmluvou s používateľom Yandex, ktorá je dostupná na: .
Používaním API týmto súhlasíte so všetkými podmienkami tejto zmluvy a dokumentmi uvedenými vyššie a zaväzujete sa ich dodržiavať alebo prestať používať API.
Na účely tejto zmluvy sa používajú nasledujúce podmienky:
Služba API "Yandex.Direct", API- softvérové rozhranie na interakciu aplikácií (ako je tento pojem definovaný nižšie) so službou Yandex.Direct.
Kľúč API (token OAuth)- jedinečný identifikátor pridelený Používateľovi, ktorý umožňuje prístup k funkciám Služby.
Podmienky používania API:
1. Vaša bezpečnosť.
Zodpovedáte za bezpečnosť vášho API kľúča, ako aj za všetko, čo sa robí v Službe pomocou Aplikácie a API kľúča, ktoré používate. Všetky akcie v Službe vykonané pomocou vášho kľúča API sa považujú za vykonané vami. Súhlasíte s tým, že musíte okamžite informovať Yandex o akomkoľvek neoprávnenom (vami neautorizovanom) prístupe k vášmu API kľúču a/alebo akomkoľvek porušení bezpečnosti. Yandex nezodpovedá za možnú stratu alebo zmenu údajov, ku ktorým môže dôjsť v dôsledku vášho porušenia ustanovení tejto časti PS. Yandex vám odporúča použiť všetky opatrenia na zaistenie bezpečnosti rozhrania API vrátane opatrení na zachovanie dôvernosti kľúča API.
2. Automatizovaný prístup.
Súhlasíte s tým, že s výnimkou Aplikácií na interakciu s API máte zakázané používať iné prostriedky automatizovaného prístupu (roboty atď.) k Službe.
3. Monitorovanie.
Rozumiete a súhlasíte s tým, že spoločnosť Yandex monitoruje všetku aktivitu pomocou rozhrania API a môže zhromažďovať a analyzovať štatistiky o akciách používateľov vykonaných pomocou rozhrania API.
4. Záruka prístupu.
Súhlasíte s tým, že podmienky služby (vrátane rozhrania API) môže spoločnosť Yandex kedykoľvek zmeniť bez predchádzajúceho upozornenia používateľov. Yandex preto nezaručuje stálu dostupnosť Služby (vrátane API) ani žiadnej z jej súčastí. Služby (vrátane API) sa poskytujú „tak ako sú“. Yandex nezaručuje, že Služba alebo jej komponenty (vrátane API) spĺňajú ciele a očakávania používateľa, ani že jej prevádzka bude neprerušovaná alebo bezchybná. Yandex nezodpovedá za vaše akcie alebo akcie iných používateľov vykonané v rámci Služby pomocou rozhrania API. Yandex nekompenzuje žiadne škody, priame alebo nepriame, spôsobené Používateľovi alebo tretím stranám v dôsledku používania alebo neschopnosti používať Službu alebo jej jednotlivé komponenty (vrátane API).
Súhlasíte s tým, že spoločnosť Yandex môže pozastaviť alebo úplne zatvoriť prístup k API, zmeniť protokoly a metódy prístupu bez udania dôvodov a bez zodpovednosti zo svojej strany. Zodpovedáte za bezpečnosť všetkých svojich údajov a musíte byť pripravení spravovať kampane cez webové klientske rozhranie.
5. Obmedzenia.
Súhlasíte s tým, že spoločnosť Yandex môže podľa vlastného uváženia stanoviť obmedzenia (kvóty) na používanie rozhrania API alebo jeho jednotlivých komponentov v závislosti od mnohých ukazovateľov, medzi ktoré patrí okrem iného objem služieb poskytovaných používateľovi aplikácie, technické ukazovatele reklamnú kampaň (priemerné CTR, inzeráty o dostupnosti zamietnuté kvôli moderovaniu atď.).
Pravidlá uplatňovania takýchto obmedzení sú popísané v časti „Otázky a odpovede“ nachádzajúce sa na odkaze „API“ vo vašom účte.
Ak používate aplikáciu, ktorá nespĺňa požiadavky stanovené v používateľskej zmluve pre vývojárov, spoločnosť Yandex si vyhradzuje právo obmedziť a/alebo zamietnuť váš prístup k API.
Tiež nesiete všetku zodpovednosť a riziko nepriaznivých dôsledkov spojených s obmedzením a/alebo zakázaním prístupu Aplikácií k API z dôvodov stanovených v Užívateľskej zmluve pre vývojárov.
6. Tretie strany.
V prípade, že používate API na správu reklamných kampaní tretích strán na základe zmluvy alebo inej dohody medzi vami, musíte pochopiť, že všetky údaje týkajúce sa účtov takýchto klientov a ďalšie informácie týkajúce sa reklamných kampaní takýchto klientov, vykonávané pomocou vášho kľúča API sa považujú za dôverné; Nemáte právo ich sami používať alebo prenášať na tretie strany bez písomného súhlasu ich vlastníkov.
Ak poskytnete prístup k API akýmkoľvek tretím stranám (vrátane vytvorenia účtu pre ne spojeného s vaším účtom), nesiete plnú zodpovednosť za všetky činnosti takýchto tretích strán, ako keby boli vaše vlastné.
7. Platnosť tejto zmluvy.
Yandex si vyhradzuje právo pozastaviť túto zmluvu vo vzťahu k vám, ak nebudete dodržiavať jej podmienky. Od momentu takéhoto pozastavenia musíte prestať ďalej používať API.
8. Záverečné ustanovenia.
Táto zmluva a všetky vzťahy súvisiace s používaním Služby a API sa riadia zákonmi Ruskej federácie.
Všetky nároky súvisiace s používaním/neschopnosťou používať API v rámci Služby by mali byť zaslané na adresu: [e-mail chránený].
Spoločnosť Yandex môže kedykoľvek zmeniť text tejto zmluvy a/alebo akékoľvek iné podmienky používania služby bez toho, aby o tom informovala používateľa. Aktuálny text tejto zmluvy je zverejnený na adrese: .
_____________________________
Dátum zverejnenia 04.05.2019
Predchádzajúca verzia dokumentu: .
Predchádzajúca verzia dokumentu: .
Ahoj.
Popularizáciu závislých typov pre programovanie výrazne uľahčuje knižnica Servant, ktorá sa používa ako na poskytovanie typovaného API (servant-server), tak aj na písanie dotazov na existujúce (servant-client). Túto knižnicu využijeme (vysvetlenie jej fungovania je nad rámec tohto príspevku; záujemcovia si môžu prečítať správu). Záležitosť však nebude obmedzená na závislé typy zabudované do Servanta a pridáme ďalšie vlastné.
Plán
Popíšeme niekoľko základných entít Yandex.Direct API: metóda (pridať, získať), operácia, výsledok operácie, objekt (názvy slovníkov, reklám, kampaní) a zadefinujeme závisle typovanú funkciu, ktorá umožňuje volať ľubovoľnú metódu parametrizované nejakým objektom a prijať odpoveď, ktorej typ závisí od volanej metódy a typu objektu.
Operácie
Objekty
Rozhranie API Yandex.Direct je veľmi rozsiahle: možno ho použiť na spracovanie reklám, reklamných skupín, kampaní, rozšírení, kľúčových slov a oveľa viac. Napíšeme generickú funkciu, ktorá nám umožní odovzdať ktorýkoľvek z týchto objektov volanej metóde.
Najprv pár príkladov. Reklamy:
Kampane:
Adresa na spracovanie žiadostí súvisiacich s reklamami je „https://api.direct.yandex.com/json/v5/ads“ a adresa na spracovanie žiadostí súvisiacich s kampaňami je „https://api. direct.yandex. com/json/v5/campaigns.“ Všetky ostatné objekty majú tiež svoje adresy na spracovanie požiadaviek. Vytvorme si teda typovú triedu
To znamená, že každý objekt musí byť serializovateľný do JSON, aby mohol byť odoslaný cez sieť, a musí mať názov, ktorý tvorí časť adresy pre požiadavky.
API
Poďme popísať Direct API pomocou nástrojov poskytovaných spoločnosťou Servant:
a je typ parametra volanej metódy, r je typ vráteného výsledku. Operácia je automaticky serializovaná do JSON, výsledok je automaticky deserializovaný z JSON.
Potrebujeme tiež konfiguráciu špecifickú pre Direct:
A konečne môžeme dať všetko dohromady a definovať hlavnú funkciu pre komunikáciu s Direct API:
(V novších verziách je Servant Manager súčasťou ClientM, ale v čase písania najnovšej snímky LTS na Stackage používa staršiu verziu). perform akceptuje konfiguráciu špecifickú pre Direct, správcu pripojenia, metódu, ktorá sa má volať v singleton forme, a objekt, ktorý sa má odovzdať metóde. Z podpisu perform môžeme vidieť, že typ návratovej hodnoty (ResultOf m a) skutočne závisí od volanej metódy (m v SMthod m) a od typu parametra (a), ktorý sa jej odovzdáva. V opačnom prípade používame iba základné funkcie poskytované službou Servant.
Záver
Pomocou závislého typu Servant môžete deklaratívne opísať API a eliminovať potrebu ručnej serializácie a deserializácie údajov. Typy údajov, ktoré prichádzajú ako odpoveď na požiadavku, však môžu závisieť od obsahu požiadavky, ale závislé typy tu tiež umožňujú vyjadriť všetky potrebné invarianty.
V tomto kurze sa pozrieme na služba pre správu stávok v Direct R-sprostredkovateľ- http://r-broker.ru/.
Podobných služieb je veľa. R-broker je jedným z lídrov na trhu.
Službu môžete využívať bezplatne, ak si v ich účte vytvoríte kampaň. Stačí ich kontaktovať a oni vám vytvoria nový čistý účet (toto bude podúčet ich účtu hlavného agenta).
Ak chcete službu pripojiť k svojmu účtu, existuje tarifa. Ceny za využívanie možností služby závisia od počtu fráz a úprav.
Ako R-broker funguje?
R-broker funguje cez Direct API: http://direct.yandex.ru/help/?id=1113180
Pripája sa ku kampani a má prístup k poliam cenových ponúk.
Služba vykoná denne až 96 automatických opráv (každých 15 minút).
Podľa pomoci Direct sa nové sadzby aktivujú od 5 do 60 minút. Priemerný čas spracovania tejto akcie je však 10 minút!
Význam R-brokera
1. Protišmyková ochrana
P-broker chráni pred podporou/podporou (môže sa nazývať inak).
Pozrime sa na to na príklade.
1 špeciál = 5 USD
2 špeciálne ponuky = 2 doláre
vstup do špeciálneho = 0,5 $
Ukazujete sa na 1. mieste.
Vaša suma odpísaná za kliknutie je 2,01 USD.
Konkurent na 2. pozícii vás vezme a podporí, nastaví ponuku 4,99 USD.
Všetky. Teraz vás kliknutie stojí 5 USD, nie 2,01 USD.
Keď budete mať v kampani stovky fráz, nikdy nebudete môcť sami kontrolovať výskyt takýchto situácií..
Teraz už majú niektoré roboty podobnú funkciu.
Príklad - www.magazion.ru.
Na základe zvolenej stratégie „Magazion“ útočí na ponuky konkurentov a nastavuje svoje vlastné vyššie ponuky. Výška útočnej prémie závisí od nastavenia agresivity (dá sa nastaviť pre celú reklamnú kampaň alebo pre jednotlivé frázy).
No, všetky adekvátne moderné roboty majú ochrannú funkciu.
Podobné situácie vznikajú vo vysoko konkurenčných oblastiach neustále.
Napríklad - plastové okná, tvorba webových stránok a pod.
Bez automatizácie ponúk prostredníctvom API nemôže byť Kazachstan v týchto oblastiach skutočne úspešný.
2. Správa ponúk
P-broker je robot. Sleduje správnu implementáciu zvolenej stratégie.
R-broker je niekedy jednoducho nenahraditeľný.
Hlavnou črtou je držanie pozícií bez zostupu.
Ceny stúpajú a klesajú počas dňa.
Ak chcete byť pri vstupe výnimoční, sadzby pre vstup do bloku vieme manuálne nastaviť v priamom rozhraní.
Akákoľvek fluktuácia o 1 cent a budeme preč.
Na začiatok dodáme viac (v rámci našich možností) - dotácie sú možné.
Môžeme sedieť celý deň a sami si upravovať sadzby, ale čoskoro skončíme v psychiatrickej liečebni.
Samotný P-broker môže upravovať sadzby niekoľkokrát za hodinu.
Kým ceny konkurentov sa menia automaticky cez API mnohokrát denne, títo ľudia ich menia manuálne raz denne ráno. Vôbec nie rovná konkurencia.
Nuansy
Nemôžete pripojiť P-broker k automatickým stratégiám Direct, pretože Polia ponuky nie sú k dispozícii.
Ideálne je použiť P-brokera na najvyššiu dostupnú pozíciu (jednoducho nastaví sadzbu pre požadovanú pozíciu) a zadá bloky min. cena.
Autobroker Direct vždy zníži sadzbu na minimum možné práve teraz a práve tu.
Rozhodujúci význam pri určovaní pozície vo vyhľadávaní má autobroker a stratégia v Direct.
Tu je to zlé - P-broker sa niekedy načítava dlho.
Založenie R brokera
P-broker sa na prvý pohľad môže zdať komplikovaný. Uisťujem vás však, že na tom nie je nič zložité.
Ak ešte veľmi dobre nerozumiete, ako Direct funguje, potom je lepšie nečítať ďalej, kým nepochopíte, inak to bude veľmi ťažké pochopiť. Je lepšie znovu študovať minulé témy.
Je potrebné prečítať si pokyny pre R-brokera!
V P-broker je veľa nepotrebných vecí. Napíšem, čo stojí za pozornosť.
Denníky udalostí / Štatistiky a Analytics
Nikdy sa nepozerám na štatistiky cez P-brokera. Časopis je niekedy užitočný, niekedy nie.
Sú to priemerné úseky. Teraz ich môžete jednoducho ignorovať.
Možnosti ovládania
Pomocou posúvača (vľavo) povoľte ovládanie a nastavte plán úpravy sadzieb. Zaškrtávame políčka pre čas, v ktorom sa zobrazuje váš inzerát.
Kontrola kvality kampane
Je lepšie sa ničoho nedotýkať.
Obnovenie frázy pre nízku mieru prekliknutia je vo všeobecnosti cestou do hrobu.
Problém musíme liečiť, nie ho znovu vytvárať. Yandex si pamätá všetko.
Automatické pripojenie nových fráz na ovládanie
Ak je taktika rovnaká pre celú Kazašskú republiku, potom je to možné. A ak nie, potom musíte každú frázu zahrnúť sami.
Nastavenie taktiky RK
R-max je maximálna cena, ktorú sme ochotní zaplatiť za kliknutie. Nie ten, ktorý bude v priamom rozhraní. Tieto informácie sú špeciálne pre P-brokera.
Spoločné parametre
Začiarknite druhú položku „Vždy nastavte cenovú ponuku, ktorá nie je nižšia ako minimálna pre zobrazenie vo vyhľadávaní“.
Väčšinou vypínam prvú možnosť.
Zaradením bodu 3 nebudeme mať obmedzenie r-max a sadzbu je možné nastaviť aj na 50 dolárov – hlavné je, že to rozpočet umožňuje. Pre istotu je lepšie ho nezapínať.
Mimochodom, 50 $ je maximálna povolená stávka v Direct. Hrôza. Neviem, kto je ochotný zaplatiť toľko za 1 kliknutie. Si pripravený?
Zmena možností pre všetky frázy v kampani
Tu môžete nastaviť všeobecnú taktiku.
Prečítajte si viac o stratégiách v pokynoch.
Základná taktika:
1>2>3 (obsadíme určité miesto, padneme zdola na najbližšie)
1>G>D(zaujmeme miesto v bloku, spadneme do susedného bloku)
Ostatné naozaj netreba. Túto taktiku do istej miery opakujú.
Príklad
Predstavme si, že v Direct rozhraní máme taktiku – zadajte blok minút. cena (špeciálna + záruka).
P-brokera sme nastavili na 1>G>D CP (špeciálne umiestnenie) s nejakým R-max.
Výsledkom je, že všetko, čo sa dá ukázať, sa zobrazí v špecialistovi (pri vchode), ak sa zrúti, bude to zaručené pri vchode.
Všetko, čo je zaručené, čo najskôr prerazí do špeciálneho.
Ekonomicky, nahnevane.
Pamätajte: dobre vyladená reklamná kampaň sa pri vyhľadávaní veľmi ľahko pokazí, preto je veľmi dôležitá taktika a správne spustenie.
