Notifier la demande

Les soumissionnaires reçoivent des notifications concernant les résultats de l’enchère, le temps de réponse aux enchères et toutes les erreurs générées par la réponse d’un soumissionnaire particulier (c’est-à-dire , « erreur d’analyse JSON »). Ces notifications seront envoyées par le biais d’un appel côté serveur à un soumissionnaire spécifié notify_URI lorsque l’enchère sera terminée et que l’impression sera servie. Vous pouvez gérer la quantité d’informations que vous recevez dans vos notifications à l’aide du notify_full_auction champ du service soumissionnaire. Les notifications incluent des détails sur chaque offre soumise.

Enchère interne

Pour toutes les enchères que nous menons, les soumissionnaires recevront des notifications lorsqu’une enchère est gagnée et lorsqu’une erreur se produit. Les enchérisseurs peuvent également choisir de recevoir des notifications en cas de perte d’enchères en soumettant une demande de support.

Enchère externe

Pour toutes les enchères effectuées par un tiers, les soumissionnaires recevront une notification en attente lorsque leur offre sera transmise au tiers, et une notification lorsqu’une enchère sera gagnée.

Spécifications

Tags

Réponses

Notifications perdues

Nous pouvons vous envoyer des demandes de notification lorsque vous envoyez une réponse d’offre différente de zéro pour une enchère, et ne gagnez pas la vente aux enchères. Cela peut se produire soit parce que vous avez fait une surenchère, soit parce que votre offre a été rejetée. Les offres peuvent être rejetées pour des raisons techniques telles qu’un message JSON mal formé ou pour des raisons professionnelles telles que l’utilisation d’un élément créatif bloqué par le vendeur ou l’envoi d’un prix d’offre inférieur au plancher d’une transaction. Si vous avez des difficultés à obtenir la livraison sur un créatif donné, les messages de notification perdus sont un excellent moyen de voir pourquoi votre créatif ne gagne pas plus d’impressions. Pour activer les messages de notification perdus, envoyez une demande de support et un représentant peut l’activer pour votre soumissionnaire.

Liste d’erreurs

Pour obtenir la liste de toutes les erreurs possibles qui peuvent être envoyées dans une demande de notification, consultez Codes d’erreur d’enchère.

Notifier l’enchère complète

Si le paramètre notify_full_auctionService de soumissionnaire est défini sur true, full_tag_infoet bid_info sera inclus dans la réponse. Le paramètre full_tag_info contient toutes les informations décrites dans la section Étiquettes de la page Demande d’offre , à l’exception du exclusive_default champ , tandis que bid_info contient toutes les informations des sections Bid_info et Segments de la page Demande d’enchère .

Exemples

Demande d’étiquette unique - Enchère gagnée

{   "notify_request":{
      "timestamp":"2011-02-09 00:11:44",
      "response_time_ms":4,
      "tags":[
         {
            "id":474074,
            "auction_id_64":7606327141949238687,
            "payment_rule_id":65930,
            "price_paid":0.90000,
            "member_id":670,
            "notify_type":"won",
            "creative_id":12345,
            "user_id_64":4628364836293826
         }
      ],
      "responses":[
         {
            "result":"ok",
            "price_bid":1.00000
         }
      ]
   }
}

Demande d’étiquette unique - Enchère perdue

{
    "notify_request": {
        "user_id_64": 2843838668060323000,
        "responses": [
            {
                "price_bid": 0.06207,
                "result": "ok"
            }
        ],
        "tags": [
            {
                "notify_type": "lost",
                "id": 9373851,
                "payment_rule_id": 874041,
                "auction_id_64": 1177991420539445500
            }
        ],
        "timestamp": "2016-09-27 21:49:06",
        "auction_timestamp": "2016-09-27 21:49:06",
        "response_time_ms": 67
    }
}

Demande d’étiquette unique - Erreur dans la réponse

{
    "notify_request": {
        "user_id_64": 9191106446964517565,
        "responses": [
            {
                "error_id": 408,
                "result": "error",
                "error": "Creative 536754694 brand 75445 banned on member's ad profile 542799"
            }
        ],
        "tags": [
            {
                "notify_type": "lost",
                "id": 5632681,
                "payment_rule_id": 821648,
                "auction_id_64": 442903072350998711
            }
        ],
        "timestamp": "2016-09-27 21:48:46",
        "auction_timestamp": "2016-09-27 21:48:46",
        "response_time_ms": 87
    }
}

Rubrique connexe

Demande de notification - FAQ