Partager via

Service de profil de visibilité

Si vous revendez votre inventaire, le service de profil de visibilité vous permet de contrôler le niveau de détail que vous transmettez aux acheteurs dans vos demandes d’enchères. Plus précisément, vous pouvez exposer ou masquer les ID et noms des éditeurs, les ID et noms de placement, les données d’âge et de sexe fournies par l’éditeur, la catégorisation universelle et personnalisée de votre inventaire, les URL d’inventaire, les informations d’emplacement, etc.

Les paramètres par défaut dans votre profil (par exemple, expose_age_default, expose_gender_default, etc.) s’appliquent à tous les acheteurs de plateforme et soumissionnaires externes, mais vous pouvez remplacer les paramètres par défaut pour les acheteurs de plateforme et les soumissionnaires externes spécifiques à l’aide des buyer_members tableaux et bidders . Par exemple, vous pouvez masquer les données d’inventaire par défaut, puis exposer les données uniquement à des membres acheteurs spécifiques avec lesquels vous avez une relation commerciale spéciale. Vous pouvez également exposer les données d’inventaire à tout le monde, à l’exception des membres acheteurs spécifiques que vous jugez concurrents.

En plus d’affecter les données que les acheteurs voient dans vos demandes d’enchères, les paramètres de visibilité affectent les données que les acheteurs voient lorsqu’ils signalent des impressions achetées auprès de vous. Par exemple, si vous masquez des ID et des noms d’éditeur à un acheteur, cet acheteur ne verra pas vos ID et noms d’éditeur dans les rapports.

Remarque

Bien que vous puissiez créer plusieurs profils de visibilité, vous ne pouvez en attacher qu’un seul à votre membre (voir le visibility_profile_id champ dans le service membre). Si vous souhaitez joindre des profils de visibilité directement aux éditeurs, contactez votre représentant de compte.

API REST

HTTP, méthode Endpoint Description
POST https://api.appnexus.com/visibility-profile
(visibility_profile JSON)		 Ajoutez un profil de visibilité.
PUT https://api.appnexus.com/visibility-profile?id=VISIBILITY_PROFILE_ID
(visibility_profile JSON)		 Modifier un profil de visibilité.
DELETE https://api.appnexus.com/visibility-profile?id=VISIBILITY_PROFILE_ID Supprimer un profil de visibilité.
GET https://api.appnexus.com/visibility-profile Affichez tous vos profils de visibilité.
GET https://api.appnexus.com/visibility-profile?id=VISIBILITY_PROFILE_ID Afficher un profil de visibilité spécifique.
GET https://api.appnexus.com/visibility-profile?id=1,2,3 Affichez plusieurs profils de visibilité par ID à l’aide d’une liste séparée par des virgules.
GET https://api.appnexus.com/visibility-profile/meta Découvrez les champs que vous pouvez filtrer et trier.

Champs JSON

Champ Type Description
id int En lecture seule. ID du profil de visibilité.
Par défaut: Nombre généré automatiquement (par exemple, 123).
Obligatoire On :PUT, dans la chaîne de requête.
member_id int En lecture seule. ID du membre propriétaire du profil de visibilité.
name string Nom du profil de visibilité.
Obligatoire sur :POST
notes string Informations supplémentaires sur le profil de visibilité.
expose_publishers_default Valeur booléenne Ne pas utiliser.
Non disponible pour tous les clients. Si la valeur est true, les ID d’éditeur sont passés dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_tags_default Valeur booléenne Ne pas utiliser.
Non disponible pour tous les clients. Si truela valeur est , les ID de placement sont passés dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_age_default Valeur booléenne Si truela valeur est , les données d’âge fournies par l’éditeur sont transmises dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_gender_default Valeur booléenne Si truela valeur est , les données de genre fournies par l’éditeur sont transmises dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_universal_categories_default Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_custom_categories_default enum Visibilité de vos catégories de contenu personnalisées dans vos demandes d’enchères.
Valeurs possibles :
- none: aucune catégorie personnalisée n’est passée dans vos demandes d’enchères.
- all: toutes les catégories personnalisées sont passées dans vos demandes d’enchères.
- list: les catégories personnalisées répertoriées dans le custom_categories tableau sont passées dans vos demandes d’enchères.
Par défaut:none
url_exposure_default enum Visibilité des URL d’inventaire dans vos demandes d’enchères.
Valeurs possibles :
- full: les URL complètes sont passées dans vos demandes d’enchères.
- domain: seuls les domaines d’URL sont passés dans vos demandes d’enchères.
- hidden: les URL ne sont pas passées dans vos demandes d’enchères.
Par défaut:full
expose_bid_requests_default Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_auction_id_default Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_locale_default Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_ecp_default Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_reserve_price_default Valeur booléenne Si la valeur est true, les prix de réserve fournis par l’éditeur sont passés dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_user_id_default Valeur booléenne Si la valeur est true, les ID utilisateur fournis par l’éditeur sont passés dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_ip_default Valeur booléenne Si la valeur est true, les adresses IP fournies par l’éditeur sont passées dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_venue_id_default Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_user_agent_default Valeur booléenne Si la valeur est true, les agents utilisateur fournis par l’éditeur sont passés dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_city_default Valeur booléenne Si la valeur est true, les villes fournies par l’éditeur sont disponibles pour le ciblage et la création de rapports pour les acheteurs à l’aide de Microsoft Invest. Cela s’applique à tous les membres et soumissionnaires Microsoft Invest qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Si true et ce profil de visibilité est associé à une transaction utilisant le ciblage restreint du vendeur, les acheteurs Microsoft Invest ciblant la transaction ne pourront pas cibler les villes. Pour plus d’informations, consultez le service de transaction.
Les acheteurs sur des DSP externes peuvent cibler et créer des rapports sur les villes, quel que soit ce paramètre.
Par défaut:true
expose_state_default Valeur booléenne Si la valeur est true, les états fournis par l’éditeur sont disponibles pour le ciblage et la création de rapports pour les acheteurs à l’aide de Microsoft Invest. Cela s’applique à tous les membres et soumissionnaires Microsoft Invest qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Si true et ce profil de visibilité est associé à une transaction utilisant le ciblage restreint du vendeur, les acheteurs Microsoft Invest ciblant la transaction ne pourront pas cibler les états. Pour plus d’informations, consultez le service de transaction.
Les acheteurs sur les fournisseurs de services de sécurité réseau externes peuvent cibler et créer des rapports sur les états, quel que soit ce paramètre.
Par défaut:true
expose_dma_default Valeur booléenne Si la valeur est true, les DMV fournies par l’éditeur sont disponibles pour le ciblage et la création de rapports pour les acheteurs à l’aide de Microsoft Invest. Cela s’applique à tous les membres et soumissionnaires Microsoft Invest qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Si true et ce profil de visibilité est associé à une transaction utilisant le ciblage restreint du vendeur, les acheteurs Microsoft Invest ciblant la transaction ne pourront pas cibler les DMAs. Pour plus d’informations, consultez le service de transaction.
Les acheteurs sur des DSP externes peuvent cibler et générer des rapports sur les DMV, quel que soit ce paramètre.
Par défaut:true
expose_postal_code_default Valeur booléenne Si la valeur est true, les codes postaux fournis par l’éditeur sont transmis dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_geo_lat_lon_default Valeur booléenne Si truela valeur est , les informations de latitude et de longitude fournies par l’éditeur sont transmises dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_device_id_default Valeur booléenne Si la valeur est true, les ID d’appareil fournis par l’éditeur sont passés dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_device_model_id_default Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_querystring_default Valeur booléenne Si la valeur est true, les chaînes de requête fournies par l’éditeur sont passées dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_application_id_default Valeur booléenne Si la valeur est true, les ID d’application mobile Android ou iOS fournis par l’éditeur sont passés dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_site_id_default Valeur booléenne Si la valeur est true, les ID de groupe de placement (site) fournis par l’éditeur sont passés dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme et aux soumissionnaires qui ne sont pas définis séparément dans les buyer_members tableaux et bidders ci-dessous.
Par défaut:true
expose_datetime_default Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
buyer_members tableau d’objets Règles de visibilité pour les membres de la plateforme Xandr spécifiques. Pour plus d’informations, consultez Membres acheteurs ci-dessous.
Par défaut:true
bidders tableau d’objets Règles de visibilité pour des soumissionnaires externes spécifiques et/ou des fournisseurs de données contextuels. Pour plus d’informations, consultez Soumissionnaires ci-dessous.
custom_categories tableau d’objets Catégories de contenu personnalisées passées dans vos demandes d’enchères. Pour plus d’informations, consultez Catégories personnalisées ci-dessous.
Obligatoire Sur :POST, si expose_custom_categories_default a la valeur list.
last_modified Timestamp En lecture seule. Date et heure de la dernière modification du profil de visibilité.
expose_device_type_targets Valeur booléenne Si true et ce profil de visibilité est associé à une transaction utilisant le ciblage restreint du vendeur, les acheteurs Microsoft Invest ciblant la transaction ne pourront pas cibler les types d’appareils. Pour plus d’informations, consultez le service de transaction.
expose_segment_groups_default Valeur booléenne Si true et ce profil de visibilité est associé à une transaction utilisant le ciblage restreint du vendeur, les acheteurs Microsoft Invest ciblant l’offre ne pourront pas cibler les segments. Pour plus d’informations, consultez le service de transaction.
expose_video_context_default Valeur booléenne Si true et ce profil de visibilité est associé à une transaction utilisant le ciblage restreint vendeur, les acheteurs Microsoft Invest ciblant l’offre ne pourront pas cibler les contextes vidéo (par exemple, pré-roll). Pour plus d’informations, consultez le service de transaction.
expose_video_content_genres_default Valeur booléenne Si true et ce profil de visibilité est associé à une transaction utilisant le ciblage restreint vendeur, les acheteurs Microsoft Invest ciblant l’offre ne pourront pas cibler les genres de contenu vidéo (par exemple, comédie). Pour plus d’informations, consultez le service de transaction.
expose_video_program_types_default Valeur booléenne Si true et ce profil de visibilité est associé à une transaction utilisant le ciblage restreint vendeur, les acheteurs Microsoft Invest ciblant l’offre ne pourront pas cibler les types de programmes vidéo (par exemple, séries). Pour plus d’informations, consultez le service de transaction.
expose_video_content_ratings_default Valeur booléenne Si true et ce profil de visibilité est associé à une transaction utilisant le ciblage restreint du vendeur, les acheteurs Microsoft Invest ciblant l’offre ne pourront pas cibler les évaluations de contenu vidéo. Pour plus d’informations, consultez le service de transaction.
expose_video_content_duration_default Valeur booléenne Si true ce profil de visibilité est associé à une transaction utilisant le ciblage restreint du vendeur, les acheteurs Microsoft Invest ciblant l’offre ne pourront pas cibler les durées de contenu vidéo (par exemple, le format court). Pour plus d’informations, consultez le service de transaction.
expose_video_content_networks_default Valeur booléenne Si true et ce profil de visibilité est associé à une transaction utilisant le ciblage restreint du vendeur, les acheteurs Microsoft Invest ciblant l’offre ne pourront pas cibler les réseaux de contenu vidéo. Pour plus d’informations, consultez le service de transaction.
expose_video_delivery_types_default Valeur booléenne Si true et ce profil de visibilité est associé à une transaction utilisant le ciblage restreint du vendeur, les acheteurs Microsoft Invest ciblant la transaction ne pourront pas cibler les types de diffusion vidéo (par exemple, VOD). Pour plus d’informations, consultez le service de transaction.

Catégories personnalisées

Si expose_custom_categories_default est défini sur list, vous utilisez ce tableau pour spécifier les catégories personnalisées que vous souhaitez passer dans vos demandes d’enchères. Chaque objet du tableau représente une catégorie personnalisée unique et contient les champs suivants. Pour la mise en forme, consultez les exemples ci-dessous.

Conseil

Vous pouvez utiliser le service de catégorie de contenu pour obtenir les ID de vos catégories de contenu personnalisées.

Champ Type Description
id int ID de la catégorie de contenu personnalisé passée dans vos demandes d’enchères.
name chaîne En lecture seule. Nom de la catégorie de contenu personnalisée.

Membres acheteur

Vous utilisez ce tableau pour définir des règles de visibilité pour des membres de la plateforme Xandr spécifiques. Chaque objet du tableau représente un seul membre et contient les champs suivants. Pour la mise en forme, consultez les exemples ci-dessous.

Conseil

Vous pouvez utiliser le service membre de la plateforme pour obtenir les ID des membres de la plateforme Xandr.

Champ Type Description
id int ID du membre de la plateforme Xandr auquel vous souhaitez appliquer des règles de visibilité spécifiques.
Obligatoire sur :POST
name chaîne En lecture seule. Nom du membre de la plateforme Xandr.
expose_publishers Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Pour certains clients : si true, les ID d’éditeur sont passés dans vos demandes d’enchères au membre.
Par défaut:true
expose_tags Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Pour certains clients : si true, les ID de placement sont passés dans vos demandes d’enchères au membre.
Par défaut:true
expose_age Valeur booléenne Si truela valeur est , les données d’âge sont transmises dans vos demandes d’enchères au membre.
Par défaut:true
expose_gender Valeur booléenne Si truela valeur est , les données de sexe sont transmises dans vos demandes d’enchères au membre.
Par défaut:true
expose_universal_categories Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_custom_categories enum Visibilité de vos catégories de contenu personnalisées dans vos demandes d’enchères au membre. Valeurs possibles :
- none: aucune catégorie personnalisée n’est passée dans vos demandes d’enchères.
- all: toutes les catégories personnalisées sont passées dans vos demandes d’enchères.
- list: les catégories personnalisées répertoriées dans le custom_categories tableau sont passées dans vos demandes d’enchères.
Par défaut:none
custom_categories tableau d’objets Catégories de contenu personnalisées qui sont passées dans vos demandes d’enchères au membre. Pour les champs de ce tableau, consultez Catégories personnalisées ci-dessus.
Obligatoire Sur :POST, si expose_custom_categories_default a la valeur list.
url_exposure enum Visibilité des URL d’inventaire dans vos demandes d’enchères adressées au membre. Valeurs possibles :
- full: les URL complètes sont passées dans vos demandes d’enchères.
- domain: seuls les domaines d’URL sont passés dans vos demandes d’enchères.
- hidden: les URL ne sont pas passées dans vos demandes d’enchères.
Par défaut:full
expose_bid_requests Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_auction_id Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_locale Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_ecp Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_reserve_price Valeur booléenne Si la valeur est true, les prix de réserve sont exposés au membre propriétaire.
Par défaut:true
expose_user_id Valeur booléenne Si la valeur est true, les ID utilisateur sont exposés au membre propriétaire.
Par défaut:true
expose_ip Valeur booléenne Si la valeur est true, les adresses IP sont exposées au membre propriétaire.
Par défaut:true
expose_venue_id Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_user_agent Valeur booléenne Si la valeur est true, les agents utilisateur sont exposés au membre propriétaire.
Par défaut:true
expose_city Valeur booléenne Si truela valeur est , les villes sont disponibles pour le ciblage et la création de rapports pour l’acheteur Microsoft Invest.
Par défaut:true
expose_state Valeur booléenne Si truela valeur est , les états sont disponibles pour le ciblage et la création de rapports pour l’acheteur Microsoft Invest.
Par défaut:true
expose_dma Valeur booléenne Si la valeur est true, les DMV sont disponibles pour le ciblage et la création de rapports pour l’acheteur Microsoft Invest.
Par défaut:true
expose_postal_code Valeur booléenne Si la valeur est true, les codes postaux sont exposés au membre propriétaire.
Par défaut:true
expose_geo_lat_lon Valeur booléenne Si truela valeur est , les informations de latitude et de longitude sont exposées au membre propriétaire.
Par défaut:true
expose_device_id Valeur booléenne Si la valeur est true, les ID d’appareil sont exposés au membre propriétaire.
Par défaut:true
expose_device_model_id Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_querystring Valeur booléenne Si la valeur est true, les chaînes de requête sont exposées au membre propriétaire.
Par défaut:true
expose_application_id Valeur booléenne Si la valeur est true, les ID d’application mobile Android ou iOS sont exposés au membre propriétaire.
Par défaut:true
expose_site_id Valeur booléenne Si la valeur est true, les ID de groupe de placement (site) sont exposés au membre propriétaire.
Par défaut:true
expose_datetime Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true

Soumissionnaires

Vous utilisez ce tableau pour définir des règles de visibilité pour des soumissionnaires externes et/ou des fournisseurs de données contextuels spécifiques. Chaque objet du tableau représente un enchérisseur unique et contient les champs suivants. Pour la mise en forme, consultez les exemples ci-dessous.

Conseil

Il n’existe aucun service permettant d’obtenir directement les ID des soumissionnaires externes ; Toutefois, le service membre de la plateforme vous obtient des informations sur les membres de la plateforme, y compris les soumissionnaires qu’ils utilisent.

Champ Type Description
id int ID du soumissionnaire externe auquel vous souhaitez appliquer des règles de visibilité spécifiques.
Obligatoire sur :POST
name chaîne En lecture seule. Nom du soumissionnaire externe.
expose_publishers Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Pour certains clients : si true, les ID d’éditeur sont transmis dans vos demandes d’enchères au soumissionnaire.
Par défaut:true
expose_tags Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Pour certains clients : si true, les ID de placement sont transmis dans vos demandes d’offre au soumissionnaire.
Par défaut:true
expose_age Valeur booléenne Si truela valeur est , les données d’âge sont transmises dans vos demandes d’enchères au soumissionnaire.
Par défaut:true
expose_gender Valeur booléenne Si truela valeur est , les données de sexe sont transmises dans vos demandes d’offre au soumissionnaire.
Par défaut:true
expose_universal_categories Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_custom_categories enum La visibilité de vos catégories de contenu personnalisées dans vos demandes de soumission au soumissionnaire.
Valeurs possibles :
- none: aucune catégorie personnalisée n’est passée dans vos demandes d’enchères.
- all: toutes les catégories personnalisées sont passées dans vos demandes d’enchères.
- list: les catégories personnalisées répertoriées dans le custom_categories tableau sont passées dans vos demandes d’enchères.
Par défaut:none
custom_categories tableau d’objets Catégories de contenu personnalisées transmises dans vos demandes d’offre au soumissionnaire. Pour les champs de ce tableau, consultez Catégories personnalisées ci-dessus.
Obligatoire Sur :POST, si expose_custom_categories_default a la valeur list.
url_exposure enum Visibilité des URL d’inventaire dans vos demandes de soumission au soumissionnaire.
Valeurs possibles :
- full: les URL complètes sont passées dans vos demandes d’enchères.
- domain: seuls les domaines d’URL sont passés dans vos demandes d’enchères.
- hidden: les URL ne sont pas passées dans vos demandes d’enchères.
Par défaut:full
expose_bid_requests Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_auction_id Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_locale Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_ecp Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_reserve_price Valeur booléenne Si truela valeur est , les prix de réserve sont passés dans vos demandes de soumission au soumissionnaire.
Par défaut:true
expose_user_id Valeur booléenne Si truela valeur est , les ID utilisateur sont transmis dans vos demandes d’enchères au soumissionnaire.
Par défaut:true
expose_ip Valeur booléenne Si la valeur est true, les adresses IP sont passées dans vos demandes d’offre au soumissionnaire.
Par défaut:true
expose_venue_id Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_user_agent Valeur booléenne Si la valeur est true, les agents utilisateur ont transmis vos demandes d’enchères au soumissionnaire.
Par défaut:true
expose_city Valeur booléenne Si truela valeur est , les villes sont disponibles pour le ciblage et la création de rapports pour le soumissionnaire Microsoft Invest.
Par défaut:true
expose_state Valeur booléenne Si truela valeur est , les états sont disponibles pour le ciblage et la création de rapports pour le soumissionnaire Microsoft Invest.
Par défaut:true
expose_dma Valeur booléenne Si la valeur est true, les DMV sont disponibles pour le ciblage et la création de rapports pour le soumissionnaire Microsoft Invest.
Par défaut:true
expose_postal_code Valeur booléenne Si truela valeur est , les codes postaux sont transmis dans vos demandes de soumission au soumissionnaire.
Par défaut:true
expose_geo_lat_lon Valeur booléenne Si truela valeur est , les informations de latitude et de longitude sont transmises dans vos demandes d’offre au soumissionnaire.
Par défaut:true
expose_device_id Valeur booléenne Si la valeur est true, les ID d’appareil sont transmis dans vos demandes d’offre au soumissionnaire.
Par défaut:true
expose_device_model_id Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true
expose_querystring Valeur booléenne Si la valeur est true, les chaînes de requête sont passées dans vos demandes d’offre au soumissionnaire.
Par défaut:true
expose_application_id Valeur booléenne Si la valeur est true, les ID d’application mobile Android ou iOS sont transmis dans vos demandes d’offre au soumissionnaire.
Par défaut:true
expose_site_id Valeur booléenne Si la valeur est true, les ID de groupe de placement (site) sont transmis dans vos demandes de soumission au soumissionnaire.
Par défaut:true
expose_datetime Valeur booléenne Ne pas utiliser. Ce champ est ignoré.
Par défaut:true

Exemples

Ajouter un profil de visibilité - Afficher les données d’inventaire à tous les acheteurs, à l’exception du membre 9

Dans cet exemple, la POST demande crée un profil de visibilité qui permet à tous les membres de la plateforme Xandr et aux soumissionnaires externes, à l’exception du membre 9, d’afficher les informations d’éditeur, de placement, d’âge, de sexe, de catégorie et d’URL dans vos demandes d’enchères.

$ cat visibility_profile

{
    "visibility-profile": {
        "name": "Test Visibility Profile",
        "expose_age_default": true,
        "expose_gender_default": true,
        "expose_custom_categories_default": "all",
        "url_exposure_default": "full",
        "expose_reserve_price_default": true,
        "expose_user_id_default": true,
        "expose_ip_default": true,
        "expose_user_agent_default": true,
        "expose_postal_code_default": true,
        "expose_geo_lat_lon_default": true,
        "expose_device_id_default": true,
        "expose_querystring_default": true,
        "expose_application_id_default": true,
        "expose_site_id_default": true,
        "buyer_members": [
            {
                "id": 9,
                "expose_age": false,
                "expose_gender": false,
                "expose_custom_categories": "none",
                "url_exposure": "hidden"
            }
        ]
    }
}

$ curl -b cookies -X POST -d @visibility_profile 'https://api.appnexus.com/visibility-profile'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 1818,
        "start_element": 0,
        "num_elements": 100,
        "visibility-profile": {
            "id": 1818,
            "member_id": 1066,
            "name": "Test Visibility Profile",
            "notes": null,
            "expose_age_default": true,
            "expose_gender_default": true,
            "expose_custom_categories_default": "all",
            "url_exposure_default": "full",
            "expose_reserve_price_default": true,
            "expose_user_id_default": true,
            "expose_ip_default": true,
            "expose_user_agent_default": true,
            "expose_postal_code_default": true,
            "expose_geo_lat_lon_default": true,
            "expose_device_id_default": true,
            "expose_querystring_default": true,
            "expose_application_id_default": true,
            "expose_site_id_default": true,
            "last_modified": "2015-08-31 21:18:54",
            "buyer_members": [
                {
                    "id": 9,
                    "expose_age": false,
                    "expose_gender": false,
                    "expose_custom_categories": "none",
                    "url_exposure": "hidden",
                    "expose_bid_requests": true,
                    "expose_reserve_price": true,
                    "expose_user_id": true,
                    "expose_ip": true,
                    "expose_user_agent": true,
                    "expose_postal_code": true,
                    "expose_geo_lat_lon": true,
                    "expose_device_id": true,
                    "expose_querystring": true,
                    "expose_application_id": true,
                    "expose_site_id": true,
                    "name": "DisplayWords Bidder - member 9",
                    "custom_categories": null
                }
            ],
            "bidders": null,
            "custom_categories": null
        }
    }
}

Ajouter un profil de visibilité - Masquer les données d’inventaire de tous les acheteurs à l’exception du membre 9

Dans cet exemple, la POST demande crée un profil de visibilité qui empêche tous les membres de la plateforme Xandr et les soumissionnaires externes, à l’exception du membre 9, de voir les informations d’éditeur, de placement, d’âge, de sexe, de catégorie et d’URL dans vos demandes d’enchères.

$ cat visibility_profile

{
    "visibility-profile": {
        "name": "Test Visibility Profile",
        "expose_age_default": false,
        "expose_gender_default": false,
        "expose_custom_categories_default": "none",
        "url_exposure_default": "hidden",
        "expose_reserve_price_default": true,
        "expose_user_id_default": true,
        "expose_ip_default": true,
        "expose_user_agent_default": true,
        "expose_postal_code_default": true,
        "expose_geo_lat_lon_default": true,
        "expose_device_id_default": true,
        "expose_querystring_default": true,
        "expose_application_id_default": true,
        "expose_site_id_default": true,
        "buyer_members": [
            {
                "id": 9,
                "expose_age": true,
                "expose_gender": true,
                "expose_custom_categories": "all",
                "url_exposure": "full",
                "expose_bid_requests": true,
                "expose_reserve_price": true,
                "expose_user_id": true,
                "expose_ip": true,
                "expose_user_agent": true,
                "expose_postal_code": true,
                "expose_geo_lat_lon": true,
                "expose_device_id": true,
                "expose_querystring": true,
                "expose_application_id": true,
                "expose_site_id": true,
            }
        ]
    }

$ curl -b cookies -X POST -d @visibility_profile 'https://api.appnexus.com/visibility-profile'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 1819,
        "start_element": 0,
        "num_elements": 100,
        "visibility-profile": {
            "id": 1819,
            "member_id": 1066,
            "name": "Test Visibility Profile",
            "notes": null,
            "expose_age_default": false,
            "expose_gender_default": false,
            "expose_custom_categories_default": "none",
            "url_exposure_default": "hidden",
            "expose_reserve_price_default": true,
            "expose_user_id_default": true,
            "expose_ip_default": true,
            "expose_user_agent_default": true,
            "expose_postal_code_default": true,
            "expose_geo_lat_lon_default": true,
            "expose_device_id_default": true,
            "expose_querystring_default": true,
            "expose_application_id_default": true,
            "expose_site_id_default": true,
            "last_modified": "2015-08-31 21:57:13",
            "buyer_members": [
                {
                    "id": 9,
                    "expose_age": true,
                    "expose_gender": true,
                    "expose_custom_categories": "all",
                    "url_exposure": "full",
                    "expose_reserve_price": true,
                    "expose_user_id": true,
                    "expose_ip": true,
                    "expose_user_agent": true,
                    "expose_postal_code": true,
                    "expose_geo_lat_lon": true,
                    "expose_device_id": true,
                    "expose_querystring": true,
                    "expose_application_id": true,
                    "expose_site_id": true,
                    "name": "DisplayWords Bidder - member 9",
                    "custom_categories": null
                }
            ],
            "bidders": null,
            "custom_categories": null
        }
    }
}

Modifier le profil de visibilité 1818

Dans cet exemple, la demande met à jour le PUT profil de visibilité 1818 pour autoriser uniquement le passage de la catégorie de contenu personnalisé 24214 dans vos demandes d’enchères. Cela s’applique à tous les membres de la plateforme Xandr et aux soumissionnaires externes, à l’exception du membre de plateforme 9, dont la visibilité est définie séparément (voir {{buyer_members}} tableau dans la réponse).

$ cat visibility_profile_update

{
    "visibility-profile": {
        "expose_custom_categories_default": "list",
        "custom_categories": [
            {
                "id": 24214
            }
        ]
    }
}

$ curl -b cookies -X PUT -d @visibility_profile_update 'https://api.appnexus.com/visibility-profile?id=1818'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "1818",
        "start_element": 0,
        "num_elements": 100,
        "visibility-profile": {
            "id": 1818,
            "member_id": 1066,
            "name": "Test Visibility Profile",
            "notes": null,
            "expose_age_default": true,
            "expose_gender_default": true,
            "expose_custom_categories_default": "list",
            "url_exposure_default": "full",
            "expose_reserve_price_default": true,
            "expose_user_id_default": true,
            "expose_ip_default": true,
            "expose_user_agent_default": true,
            "expose_postal_code_default": true,
            "expose_geo_lat_lon_default": true,
            "expose_device_id_default": true,
            "expose_querystring_default": true,
            "expose_application_id_default": true,
            "expose_site_id_default": true,
            "last_modified": "2015-08-31 21:24:43",
            "buyer_members": [
                {
                    "id": 9,
                    "expose_age": false,
                    "expose_gender": false,
                    "expose_custom_categories": "none",
                    "url_exposure": "hidden",
                    "expose_reserve_price": true,
                    "expose_user_id": true,
                    "expose_ip": true,
                    "expose_user_agent": true,
                    "expose_postal_code": true,
                    "expose_geo_lat_lon": true,
                    "expose_device_id": true,
                    "expose_querystring": true,
                    "expose_application_id": true,
                    "expose_site_id": true,
                    "name": "DisplayWords Bidder - member 9",
                    "custom_categories": null
                }
            ],
            "bidders": null,
            "custom_categories": [
                {
                    "id": 24214,
                    "name": "TEST"
                }
            ]
        }
    }
}

Afficher tous vos profils de visibilité

$ curl -b cookies 'https://api.appnexus.com/visibility-profile'

{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": 0,
        "num_elements": 100,
        "visibility-profiles": [
            {
                "id": 1816,
                "member_id": 1066,
                "name": "Test Visibility Profile",
                "notes": null,
                "expose_age_default": true,
                "expose_gender_default": true,
                "expose_custom_categories_default": "list",
                "url_exposure_default": "full",
                "expose_reserve_price_default": true,
                "expose_user_id_default": true,
                "expose_ip_default": true,
                "expose_user_agent_default": true,
                "expose_postal_code_default": true,
                "expose_geo_lat_lon_default": true,
                "expose_device_id_default": true,
                "expose_querystring_default": true,
                "expose_application_id_default": true,
                "expose_site_id_default": true,
                "last_modified": "2015-08-31 18:14:45",
                "buyer_members": [
                    {
                        "id": 9,
                        "expose_age": true,
                        "expose_gender": true,
                        "expose_custom_categories": "none",
                        "url_exposure": "full",
                        "expose_reserve_price": true,
                        "expose_user_id": true,
                        "expose_ip": true,
                        "expose_user_agent": true,
                        "expose_postal_code": true,
                        "expose_geo_lat_lon": true,
                        "expose_device_id": true,
                        "expose_querystring": true,
                        "expose_application_id": true,
                        "expose_site_id": true,
                        "name": "DisplayWords Bidder - member 9",
                        "custom_categories": null
                    }
                ],
                "bidders": [
                    {
                        "id": 6,
                        "expose_age": true,
                        "expose_gender": true,
                        "expose_custom_categories": "none",
                        "url_exposure": "full",
                        "expose_reserve_price": true,
                        "expose_user_id": true,
                        "expose_ip": true,
                        "expose_user_agent": true,
                        "expose_postal_code": true,
                        "expose_geo_lat_lon": true,
                        "expose_device_id": true,
                        "expose_querystring": true,
                        "expose_application_id": true,
                        "expose_site_id": true,
                        "name": "Dilling HBF Test New",
                        "custom_categories": null
                    }
                ],
                "custom_categories": [
                    {
                        "id": 24214,
                        "name": "TEST"
                    }
                ]
            },
            {
                "id": 1818,
                "member_id": 1066,
                "name": "Test Visibility Profile",
                "notes": null,
                "expose_age_default": true,
                "expose_gender_default": true,
                "expose_custom_categories_default": "list",
                "url_exposure_default": "full",
                "expose_reserve_price_default": true,
                "expose_user_id_default": true,
                "expose_ip_default": true,
                "expose_user_agent_default": true,
                "expose_postal_code_default": true,
                "expose_geo_lat_lon_default": true,
                "expose_device_id_default": true,
                "expose_querystring_default": true,
                "expose_application_id_default": true,
                "expose_site_id_default": true,
                "last_modified": "2015-08-31 21:24:43",
                "buyer_members": [
                    {
                        "id": 9,
                        "expose_age": false,
                        "expose_gender": false,
                        "expose_custom_categories": "none",
                        "url_exposure": "hidden",
                        "expose_reserve_price": true,
                        "expose_user_id": true,
                        "expose_ip": true,
                        "expose_user_agent": true,
                        "expose_postal_code": true,
                        "expose_geo_lat_lon": true,
                        "expose_device_id": true,
                        "expose_querystring": true,
                        "expose_application_id": true,
                        "expose_site_id": true,
                        "name": "DisplayWords Bidder - member 9",
                        "custom_categories": null
                    }
                ],
                "bidders": null,
                "custom_categories": [
                    {
                        "id": 24214,
                        "name": "TEST"
                    }
                ]
            }
        ]
    }
}

Afficher le profil de visibilité 1818

$ curl -b cookies 'https://api.appnexus.com/visibility-profile?id=1818'

{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "visibility-profile": {
            "id": 1818,
            "member_id": 1066,
            "name": "Test Visibility Profile",
            "notes": null,
            "expose_age_default": true,
            "expose_gender_default": true,
            "expose_custom_categories_default": "list",
            "url_exposure_default": "full",
            "expose_reserve_price_default": true,
            "expose_user_id_default": true,
            "expose_ip_default": true,
            "expose_user_agent_default": true,
            "expose_postal_code_default": true,
            "expose_geo_lat_lon_default": true,
            "expose_device_id_default": true,
            "expose_querystring_default": true,
            "expose_application_id_default": true,
            "expose_site_id_default": true,
            "last_modified": "2015-08-31 21:24:43",
            "buyer_members": [
                {
                    "id": 9,
                    "expose_age": false,
                    "expose_gender": false,
                    "expose_custom_categories": "none",
                    "url_exposure": "hidden",
                    "name": "DisplayWords Bidder - member 9",
                    "custom_categories": null
                }
            ],
            "bidders": null,
            "custom_categories": [
                {
                    "id": 24214,
                    "name": "TEST"
                }
            ]
        }
    }
}
  • Last updated on