Partager via


API de plateforme numérique - Service membre de la plateforme

Il s’agit d’un service en lecture seule qui affiche des informations publiques sur les autres membres de la plateforme Xandr que vous pouvez acheter et à qui vous pouvez vendre. Il affiche également des informations sur les fournisseurs de données.

API REST

HTTP, méthode Endpoint Description
GET https://api.appnexus.com/platform-member Affichez tous les membres qui ont exposé leurs informations.
GET https://api.appnexus.com/platform-member?active=1 Afficher uniquement les membres actifs qui ont exposé leurs informations.
GET https://api.appnexus.com/platform-member?id=MEMBER_ID Afficher un membre spécifique.

Champs JSON

Champ Type Description
active Boolean Si truela valeur est , le membre est active.
bidder objet ID et nom du soumissionnaire que ce membre utilise pour acheter des impressions.
contact_info objet Contact et informations supplémentaires pour le membre.
daily_imps_any_audit_status int Nombre d’impressions quotidiennes via l’inventaire qui a n’importe quel status d’audit, à inclure : unaudited, Xandr-reviewed, seller-reviewedet les deux Xandr-and-seller-reviewed.
daily_imps_appnexus_reviewed int Nombre d’impressions quotidiennes par le biais de l’inventaire qui a été audité par Xandr.
daily_imps_appnexus_seller_reviewed int Nombre d’impressions quotidiennes via l’inventaire qui a l’un des trois états d’audit suivants : seller-reviewed, Xandr-reviewedet .Xandr-and-seller-reviewed
daily_imps_self_audited int Déconseillé.
daily_imps_unaudited int Déconseillé.
daily_imps_verified int Déconseillé.
default_discrepancy_pct double Pourcentage que Xandr déduit de chaque offre pour certains partenaires d’approvisionnement externes en fonction des écarts passés entre ce que Xandr et le partenaire fournisseur ont enregistré comme impressions gagnées.
description string Description du membre.
email string Adresse e-mail à utiliser pour contacter le membre.
has_resold Valeur booléenne Si truela valeur est , le membre a exposé l’inventaire pour la revente à d’autres membres. Vous pouvez utiliser le service de revente d’inventaire pour afficher des informations sur l’inventaire exposé.
id int ID du membre.
is_iash_compliant Valeur booléenne Si truela valeur est , le membre est conforme à IASH.
last_modified Timestamp Date et heure de la dernière modification de l’entrée de membre.
name string Le nom du membre.
primary_type enum Type de membre, qui indique le type principal des transactions que ce membre effectue avec Xandr. Valeurs possibles :
- "network"
- "buyer"
- "seller"
- "data_provider"
platform_exposure enum Visibilité du membre sur la plateforme. Valeurs possibles :
- "public" - Le nom du membre est affiché.
- "private" - Seul l’ID de membre est affiché.
- "hidden" - Le membre n’est pas affiché par ce service.
seller_member_groups objet L’ID, le nom, l’ordre d’affichage des groupes de membres vendeurs, ainsi que la date et l’heure de création et de dernière modification des entrées.
seller_type enum Relation de vente entre le membre et Xandr. Valeurs possibles :
- "platform" - Xandr facture le membre pour la vente des stocks en fonction du contrat du membre.
- "partner" - Xandr ne facture pas le membre pour la vente, mais facture plutôt les acheteurs, en fonction de leurs contrats lorsqu’ils achètent l’inventaire de ce membre.
visibility_rules objet Niveau de détail inclus dans les demandes d’enchères du membre si primary_type a la valeur "seller". Pour plus d’informations, consultez Règles de visibilité ci-dessous.

Règles de visibilité

Champ Type Description
expose_publishers Boolean Non utilisé. Le vendeur envoie toujours des ID d’éditeur dans les demandes d’enchères.

Pour certains clients uniquement : si false, le vendeur n’envoie pas d’ID d’éditeur dans les demandes d’enchères.
expose_tags Valeur booléenne Non utilisé. Ce champ n’est pas disponible pour la plupart des clients. Les ID de placement sont toujours transmis dans vos demandes d’enchères.

Pour certains clients uniquement : si true, le vendeur envoie des ID de placement dans les demandes d’enchères.
expose_age Valeur booléenne Si la valeur est true, le vendeur envoie l’âge des utilisateurs dans les demandes d’enchères.
expose_gender Valeur booléenne Si la valeur est true, le vendeur envoie le sexe des utilisateurs dans les demandes d’enchères.
expose_universal_categories Valeur booléenne Non utilisé.
expose_custom_categories enum Visibilité des catégories de contenu personnalisées dans les demandes d’enchères du vendeur. Valeurs possibles :
- "none" - Aucune catégorie personnalisée n’est passée dans les demandes d’enchères.
- "all" - Toutes les catégories personnalisées sont passées dans les demandes d’enchères.
- "list" - Les catégories personnalisées répertoriées dans le custom_categories tableau sont passées dans les demandes d’enchères.
custom_categories tableau d’objets Catégories de contenu personnalisées que le vendeur passe dans les demandes d’enchères, si expose_custom_categories est "list".
url_exposure enum Visibilité des URL d’impression dans les demandes d’enchères du vendeur. Valeurs possibles :
- "full» - Les URL complètes sont passées dans les demandes d’enchères.
- "domain" - Seuls les domaines d’URL sont passés dans les demandes d’enchères.
- "hidden" - Les URL ne sont pas passées dans les demandes d’enchères. Notez que vous pouvez toujours recevoir l’URL par défaut du vendeur, si le vendeur en a une configurée.

Exemples

Afficher des informations sur le membre 74

$ curl -b cookies -c cookies 'https://api.appnexus.com/platform-member?id=74'
{
    "response": {
        "status": "OK",
        "platform-member": {
            "id": 74,
            "name": "PubMatic",
            "description": null,
            "primary_type": "seller",
            "platform_exposure": "public",
            "email": null,
            "daily_imps_verified": 200168000,
            "daily_imps_self_audited": 200168000,
            "daily_imps_unaudited": 168582133,
            "daily_imps_any_audit_status": 885677200,
            "daily_imps_appnexus_reviewed": 557187900,
            "daily_imps_appnexus_seller_reviewed": 557187900,
            "is_iash_compliant": false,
            "has_resold": false,
            "visibility_rules": {
                "expose_publishers": true,
                "expose_tags": true,
                "expose_age": true,
                "expose_gender": true,
                "expose_universal_categories": true,
                "url_exposure": "full",
                "expose_custom_categories": "none"
            },
            "bidder": {
                "id": "0",
                "name": "internal bidder"
            },
            "seller_type": "partner",
            "contact_info": [
                {
                    "name": "PubMatic RTB Team",
                    "title": null,
                    "email": "RTB@pubmatic.com",
                    "phone": null,
                    "address": null,
                    "address_2": null,
                    "city": "New York",
                    "country": "USA",
                    "region": "NY",
                    "postal_code": null,
                    "additional_info": "PubMatic can significantly increase the reach of your media buy, increase the efficiency of acquiring new publishers, and strengthen your publisher relationships. Contact us to learn how we can work together.",
                    "website_url": null,
                    "types": [
                        "supply"
                    ]
                }
            ],
            "active": true,
            "last_modified": "2013-06-21 17:48:49",
            "default_discrepancy_pct": 1
        },
        "count": 1,
        "start_element": 0,
        "num_elements": 100
    }
}

Afficher des informations sur tous les membres qui ont exposé leurs informations

$ curl -b cookies -c cookies 'https://api.appnexus.com/platform-member'
{
    "response": {
        "status": "OK",
        "platform-members": [
            {
                "id": 3,
                "name": "MikeOnAds",
                "description": null,
                "primary_type": "seller",
                "platform_exposure": "public",
                "email": null,
                "daily_imps_verified": 100,
                "daily_imps_self_audited": 100,
                "daily_imps_unaudited": 0,
                "daily_imps_any_audit_status": 2800,
                "daily_imps_appnexus_reviewed": 2600,
                "daily_imps_appnexus_seller_reviewed": 2600,
                "is_iash_compliant": false,
                "has_resold": true,
                "visibility_rules": {
                    "expose_publishers": true,
                    "expose_tags": true,
                    "expose_age": true,
                    "expose_gender": true,
                    "expose_universal_categories": true,
                    "url_exposure": "full",
                    "expose_custom_categories": "none"
                },
                "bidder": {
                    "id": "2",
                    "name": "DisplayWords"
                },
                "seller_type": "partner",
                "active": true,
                "last_modified": "2013-06-18 10:10:51",
                "default_discrepancy_pct": null
            },
            {
                "id": 7,
                "name": "Adify",
                "description": null,
                "primary_type": "network",
                "platform_exposure": "public",
                "email": null,
                "daily_imps_verified": null,
                "daily_imps_self_audited": null,
                "daily_imps_unaudited": null,
                "daily_imps_any_audit_status": null,
                "daily_imps_appnexus_reviewed": null,
                "daily_imps_appnexus_seller_reviewed": null,
                "is_iash_compliant": true,
                "has_resold": true,
                "visibility_rules": {
                    "expose_publishers": true,
                    "expose_tags": true,
                    "expose_age": true,
                    "expose_gender": true,
                    "expose_universal_categories": true,
                    "url_exposure": "full",
                    "expose_custom_categories": "none"
                },
                "bidder": {
                    "id": "0",
                    "name": "internal bidder"
                },
                "seller_type": "partner",
                "active": false,
                "last_modified": "2012-09-13 13:13:39",
                "default_discrepancy_pct": null
            },
            {
                "id": 8,
                "name": "Ning",
                "description": null,
                "primary_type": "network",
                "platform_exposure": "public",
                "email": null,
                "daily_imps_verified": null,
                "daily_imps_self_audited": null,
                "daily_imps_unaudited": null,
                "daily_imps_any_audit_status": null,
                "daily_imps_appnexus_reviewed": null,
                "daily_imps_appnexus_seller_reviewed": null,
                "is_iash_compliant": false,
                "has_resold": true,
                "visibility_rules": {
                    "expose_publishers": true,
                    "expose_tags": true,
                    "expose_age": true,
                    "expose_gender": true,
                    "expose_universal_categories": true,
                    "url_exposure": "full",
                    "expose_custom_categories": "none"
                },
                "bidder": {
                    "id": "0",
                    "name": "internal bidder"
                },
                "seller_type": "platform",
                "active": false,
                "last_modified": "2012-09-13 13:13:39",
                "default_discrepancy_pct": null
            },
            ...
        ],
        "count": 335,
        "start_element": 0,
        "num_elements": 100
    }
}