API direct quoi. Contrat d'utilisation pour l'utilisation de l'API du service Yandex.Direct

  • 06.07.2019

Dans ce cours, nous examinerons service de gestion des paris en Direct Courtier R- http://r-broker.ru/.

Il existe de nombreux services similaires. R-broker est l'un des leaders du marché.

Vous pouvez utiliser le service gratuitement si vous créez une campagne dans leur compte. Contactez-les simplement et ils créeront un nouveau compte propre pour vous (ce sera un sous-compte de leur compte d'agent principal).

Si vous souhaitez connecter le service à votre compte, il existe une grille tarifaire. Les prix d’utilisation des capacités du service dépendent du nombre de phrases et d’ajustements.

Comment fonctionne le courtier R ?

Le R-broker fonctionne via l'API Direct : http://direct.yandex.ru/help/?id=1113180

Il se connecte à la campagne et a accès aux champs d'enchères.

Le service effectue jusqu'à 96 corrections automatiques par jour (toutes les 15 minutes).

Selon Aide Direct, les nouveaux tarifs sont activés de 5 à 60 minutes. Mais le temps de traitement moyen pour cette action est de 10 minutes !

La signification de R-broker

1. Protection antidérapante

Le P-broker protège contre le support/support (peut être appelé différemment).

Regardons cela avec un exemple.

1 spécial = 5$
2 spéciaux = 2$
entrée au spécial = 0.5$

Vous vous présentez à la 1ère place.

Votre montant débité par clic est de 2,01 $.

Le concurrent en 2ème position vous prend et vous soutient, fixe une enchère à 4,99$.

Tous. Désormais, un clic vous coûte 5 $, et non 2,01 $.

Lorsque vous avez des centaines d’expressions dans votre campagne, vous ne pourrez jamais contrôler vous-même l’apparition de telles situations..

Certains robots ont déjà une fonction similaire.

Exemple - www.magazion.ru.

Sur la base de la stratégie choisie, "Magazion" attaque les offres des concurrents en fixant ses propres offres plus élevées. Le montant de la prime d'attaque dépend du paramètre d'agressivité (peut être défini pour l'ensemble de la campagne publicitaire ou pour des phrases individuelles).

Eh bien, tous les robots modernes adéquats ont une fonction de protection.

Des situations similaires se produisent constamment dans des domaines hautement compétitifs.

Par exemple - fenêtres en plastique, création de site internet, etc.

Sans l’automatisation des enchères via l’API, le Kazakhstan ne peut pas réellement réussir dans ces domaines.

2. Gestion des offres

R-broker est un robot. Il veille à la bonne mise en œuvre de la stratégie choisie.

Un courtier R est parfois tout simplement irremplaçable.

La principale caractéristique est d'occuper des postes sans relégation.

Les prix montent et descendent tout au long de la journée.

Si vous souhaitez être spécial à l'entrée, nous pouvons fixer manuellement les tarifs dans l'interface Direct d'entrée dans le bloc.

Toute fluctuation de 1 cent et nous serons hors de là.

Dans un premier temps, nous fournirons davantage (dans la limite de nos limites) - des subventions sont possibles.

Nous pouvons rester assis toute la journée et ajuster les tarifs nous-mêmes, mais nous finirons bientôt dans un hôpital psychiatrique.

Le P-broker lui-même peut ajuster les tarifs plusieurs fois par heure.

Alors que les tarifs des concurrents changent automatiquement via l'API plusieurs fois par jour, ces personnes les modifient manuellement une fois par jour le matin. Pas du tout une concurrence égale.

Nuances

Vous ne pouvez pas connecter le P-broker aux stratégies automatiques de Direct, car Les champs d'enchères ne sont pas disponibles.

Il est idéal d'utiliser un courtier P pour la position disponible la plus élevée (il fixe simplement le taux pour la position souhaitée) et de saisir des blocs de min. prix.

Autobroker Direct réduira toujours le taux au minimum possible dès maintenant et ici.

Le courtier automobile et la stratégie en Direct sont d'une importance décisive pour déterminer la position dans la recherche.

Voici ce qui ne va pas : le P-broker met parfois beaucoup de temps à se charger.

Mise en place d'un courtier R

Un P-broker peut paraître compliqué à première vue. Mais je vous assure qu’il n’y a rien de compliqué là-dedans.

Si vous ne comprenez pas encore très bien comment fonctionne Direct, alors jusqu'à ce que vous compreniez, il vaut mieux ne pas lire plus loin, sinon ce sera très difficile à comprendre. Il est préférable de réétudier les sujets passés.

Les instructions destinées au courtier R doivent être lues!

Il y a beaucoup de choses inutiles dans le P-broker. J'écrirai ce qui mérite qu'on y prête attention.

Journaux d'événements/Statistiques et analyses

Je ne regarde jamais les statistiques via un courtier P. Le magazine est parfois utile, parfois non.

Ce sont des sections médiocres. Vous pouvez simplement les ignorer maintenant.

Options de contrôle

Utilisez le curseur (à gauche) pour activer le contrôle et définir un calendrier d'ajustement des taux. Nous cochons les cases correspondant à l'heure à laquelle votre annonce est diffusée.

Contrôle qualité des campagnes

Il vaut mieux ne rien toucher.

Recréer une phrase pour un faible CTR est généralement un chemin vers la tombe.

Nous devons traiter le problème, pas le recréer. Yandex se souvient de tout.

Connexion automatique de nouvelles phrases à contrôler

Si la tactique est la même dans toute la République du Kazakhstan, alors c’est possible. Et sinon, vous devez inclure chaque phrase vous-même.

Paramètres des tactiques RK

R-max est le prix maximum que nous sommes prêts à payer par clic. Pas celui qui sera dans l’interface Direct. Ces informations sont spécifiquement destinées au courtier P.

Paramètres communs

Cochez la deuxième case : « Toujours définir une enchère non inférieure à l'enchère minimale pour l'affichage lors de la recherche. »

Je désactive généralement la première option.

En incluant le point 3, nous n'aurons pas de limitation r-max et le tarif pourra être fixé même à 50$ - l'essentiel est que le budget le permette. Pour être sûr, il vaut mieux ne pas l’allumer.

À propos, 50 $ est la mise maximale autorisée en Direct. Horreur. Je ne sais pas qui est prêt à payer autant pour 1 clic. Tu est prêt?

Modification des options pour toutes les expressions de la campagne

Ici, vous pouvez définir des tactiques générales.

En savoir plus sur les stratégies dans les instructions.

Tactiques de base :

1>2>3 (on occupe une certaine place, on tombe sur le plus proche par le bas)

1>G>D(on prend place à l'intérieur du bloc, on tombe dans le bloc adjacent)

Le reste n'est pas vraiment nécessaire. Ils répètent ces tactiques dans une certaine mesure.

Exemple

Imaginons que nous ayons une tactique dans l'interface Direct : entrez un bloc de minutes. prix (spécial + garantie).

Nous avons mis en place le P-broker pour 1>G>D CP (placement spécial) avec un peu de R-max.

De ce fait, tout ce qui peut être montré le sera chez le spécialiste (à l'entrée), s'il plante, alors il sera garanti à l'entrée.

Tout ce qui est garanti, dans les plus brefs délais, devient spécial.

Économiquement, avec colère.

N'oubliez pas : une campagne publicitaire bien réglée est très facile à gâcher lors d'une recherche, c'est pourquoi la tactique et un lancement approprié sont très importants.

Bonjour.

La vulgarisation des types dépendants pour la programmation est grandement facilitée par la bibliothèque Servant, qui sert à la fois à fournir une API typée (servant-serveur) et à écrire des requêtes sur une API existante (servant-client). Nous utiliserons cette bibliothèque (une explication de son fonctionnement dépasse le cadre de cet article ; les personnes intéressées peuvent lire le rapport). Cependant, le problème ne se limitera pas aux types dépendants intégrés à Servant, et nous en ajouterons d'autres.

Plan

Nous décrirons plusieurs entités de base de l'API Yandex.Direct : méthode (ajouter, obtenir), opération, résultat de l'opération, objet (noms de dictionnaires, publicités, campagnes) et définirons une fonction typée de manière dépendante qui permet d'appeler n'importe quelle méthode paramétré par un objet et accepter une réponse dont le type dépend de la méthode appelée et du type de l'objet.

Opérations

Objets

L'API Yandex.Direct est très étendue : elle peut être utilisée pour traiter des annonces, des groupes d'annonces, des campagnes, des extensions, mots clés et beaucoup plus. Nous allons écrire une fonction générique qui nous permettra de passer n'importe lequel de ces objets à la méthode appelée.

Tout d’abord quelques exemples. Les publicités:

Campagnes :

L'adresse de traitement des demandes liées aux publicités est « https://api.direct.yandex.com/json/v5/ads » et l'adresse de traitement des demandes liées aux campagnes est « https://api.direct.yandex. com/json/v5/campagnes. Tous les autres objets ont également leurs propres adresses pour traiter les demandes. Créons donc une classe de types

Autrement dit, chaque objet doit être sérialisable en JSON afin de pouvoir être envoyé sur le réseau et avoir un nom qui fait partie de l'adresse des requêtes.

API

Décrivons l'API Direct à l'aide des outils fournis par Servant :

a est le type du paramètre de la méthode appelée, r est le type du résultat renvoyé. L'opération est automatiquement sérialisée en JSON, le résultat est automatiquement désérialisé depuis JSON.

Nous avons également besoin d'une configuration spécifique à Direct :

Et on peut enfin tout mettre en place et définir la fonction principale de communication avec l'API Direct :

(Dans les versions plus récentes, Servant Manager fait partie de ClientM, mais au moment de la rédaction du dernier instantané LTS sur Stackage, il utilise ancienne version). perform accepte une configuration spécifique à Direct, un gestionnaire de connexions, une méthode à appeler sous forme singleton et un objet à transmettre à la méthode. De la signature de perform nous pouvons voir que le type de la valeur de retour (ResultOf m a) dépend vraiment de la méthode appelée (m dans SMthod m) et du type du paramètre (a) qui lui est passé. Sinon, nous utilisons simplement les fonctionnalités de base fournies par Servant.

Conclusion

À l’aide d’un Servant typé de manière dépendante, vous pouvez décrire l’API de manière déclarative et éliminer le besoin de sérialiser et de désérialiser manuellement les données. Cependant, les types de données qui répondent à une demande peuvent dépendre du contenu de la demande, mais les types dépendants vous permettent également d'exprimer ici tous les invariants nécessaires.

Le présent accord régit la relation entre vous (ci-après dénommé vous ou l'utilisateur) et YANDEX LLC (ci-après dénommé Yandex) concernant l'utilisation de l'API (ci-après dénommée l'API) du service Yandex.Direct (ci-après dénommé en tant que service).

Yandex vous offre la possibilité d'utiliser l'API du service pour gérer des campagnes publicitaires à l'aide d'applications qui interagissent avec le service, ainsi que d'utiliser l'API d'autres manières qui ne contredisent pas le présent accord. L'utilisation de l'API au sein du Service est régie par le présent Contrat, l'Offre de Service située à l'adresse , et le Contrat d'utilisation Yandex, disponible à l'adresse : .

En utilisant l'API, vous acceptez par la présente tous les termes du présent Contrat et les documents spécifiés ci-dessus et vous vous engagez à les respecter ou à cesser d'utiliser l'API.

Aux fins du présent Accord, les termes suivants sont utilisés :

    Service API "Yandex.Direct", API- interface logicielle pour l'interaction des applications (tel que ce terme est défini ci-dessous) avec le service Yandex.Direct.

    Clé API (jeton OAuth)- un identifiant unique délivré à l'Utilisateur, permettant l'accès aux fonctionnalités du Service.

Conditions d'utilisation de l'API :

1. Votre sécurité.

Vous êtes responsable de la sécurité de votre clé API, ainsi que de tout ce qui est fait sur le Service à l'aide de l'Application et de la clé API que vous utilisez. Toutes les actions dans le Service effectuées à l'aide de votre clé API sont considérées comme étant effectuées par vous. Vous acceptez que vous devez immédiatement informer Yandex de tout accès non autorisé (non autorisé par vous) à votre clé API et/ou de toute violation de la sécurité. Yandex n'est pas responsable d'une éventuelle perte ou modification de données pouvant survenir en raison de votre violation des dispositions de cette partie du PS. Yandex vous encourage à utiliser toutes les mesures pour assurer la sécurité de l'API, y compris des mesures pour maintenir la confidentialité de la clé API.

2. Accès automatisé.

Vous acceptez qu'à l'exception des Applications permettant d'interagir avec l'API, il vous est interdit d'utiliser d'autres moyens d'accès automatisés (robots, etc.) au Service.

3. Surveillance.

Vous comprenez et acceptez que Yandex surveille toutes les activités à l'aide de l'API et peut collecter et analyser des statistiques sur les actions des utilisateurs effectuées à l'aide de l'API.

4. Garantie d'accès.

Vous acceptez que les conditions de service (y compris l'API) puissent être modifiées par Yandex à tout moment sans préavis aux utilisateurs. Par conséquent, Yandex ne garantit pas la disponibilité constante du Service (y compris l'API) ou de l'un de ses composants. Les Services (y compris l'API) sont fournis « tels quels ». Yandex ne garantit pas que le Service ou ses composants (y compris l'API) répondent aux objectifs et aux attentes de l'Utilisateur, ni que son fonctionnement sera ininterrompu ou sans erreur. Yandex n'est pas responsable de vos actions ou de celles d'autres utilisateurs effectuées sur le Service à l'aide de l'API. Yandex n'indemnise aucun dommage, direct ou indirect, causé à l'utilisateur ou à des tiers à la suite de l'utilisation ou de l'impossibilité d'utiliser le service ou ses composants individuels (y compris l'API).

Vous acceptez que Yandex puisse suspendre ou fermer complètement l'accès à l'API, modifier les protocoles et les méthodes d'accès sans donner de raisons et sans aucune responsabilité de sa part. Vous êtes responsable de la sécurité de toutes vos données et devez être prêt à gérer des campagnes via l'interface client Web.

5. Limites.

Vous acceptez que Yandex puisse, à sa discrétion, fixer des restrictions (quota) sur l'utilisation de l'API ou de ses composants individuels, en fonction de nombreux indicateurs, y compris, entre autres, le volume de services fournis à l'utilisateur de l'application, des indicateurs techniques de la campagne publicitaire (CTR moyen, disponibilité des annonces rejetées pour modération, etc.).

Les règles d'application de ces restrictions sont décrites dans les « Questions et réponses » situées au niveau du lien « API » de votre compte.

Si vous utilisez une application qui ne répond pas aux exigences énoncées dans le contrat d'utilisation pour les développeurs, Yandex se réserve le droit de limiter et/ou de refuser votre accès à l'API.

Vous assumez également toute responsabilité et tout risque de conséquences néfastes associés à la restriction et/ou à l'interdiction de l'accès des applications à l'API pour les motifs établis dans le contrat d'utilisation pour les développeurs.

6. Tiers.

Dans le cas où vous utilisez l'API pour gérer des campagnes publicitaires de tiers sur la base d'un contrat ou d'un autre accord entre vous, vous devez comprendre que toutes les données relatives aux comptes de ces clients et autres informations relatives à campagnes publicitaires ces transactions client utilisant votre clé API sont considérées comme confidentielles ; Vous n'avez pas le droit de les utiliser vous-même ou de les céder à des tiers sans consentement écrit leurs propiétaires.

Si vous fournissez l'accès à l'API à des tiers (y compris en créant un compte associé à votre compte), vous êtes entièrement responsable de toutes les actions de ces tiers comme s'il s'agissait des vôtres.

7. Validité de cet accord.

Yandex se réserve le droit de suspendre cet accord à votre égard si vous ne respectez pas ses conditions. À partir du moment de cette suspension, vous devez cesser d’utiliser l’API.

8. Dispositions finales.

Le présent Contrat et toutes les relations liées à l'utilisation du Service et de l'API sont régis par les lois de la Fédération de Russie.

Toutes les réclamations liées à l'utilisation/l'impossibilité d'utiliser l'API au sein du Service doivent être envoyées à : [email protégé].

Yandex peut modifier le texte du présent Contrat et/ou toute autre condition d'utilisation du Service à tout moment sans en informer l'Utilisateur. Le texte actuel de cet accord est publié à l'adresse suivante : .

_____________________________

Date de publication 04/05/2019

Version précédente du document : .

Version précédente du document : .