Partager via


Service profil membre

Le service de profil membre vous permet d’établir un profil global unique pour limiter les pays et les domaines à partir desquels vous acceptez les impressions tierces. Vos campagnes ne feront pas d’enchères sur des impressions tierces qui ne correspondent pas aux exigences du profil de membre.

Aligner les profils de campagne avec le profil de membre

Veillez à aligner vos profils de campagne avec votre profil de membre . dans le cas contraire, le ciblage de votre campagne risque de ne pas être efficace.

  • Exemple 1 : Votre profil de membre est configuré pour accepter les impressions tierces des États-Unis et du Canada. Une campagne est prévue pour cibler les impressions des États-Unis, du Canada et du Mexique. Dans ce cas, la campagne n’aura jamais la chance de cibler les impressions du Mexique, car le profil de membre empêche ces impressions d’être disponibles pour les enchères.
  • Exemple 2 : Votre profil de membre est configuré pour bloquer les impressions tierces de la liste de domaines 1, qui inclut apples.com, oranges.com et pears.com. Une campagne est définie pour cibler la liste de domaines 3, qui inclut plums.com, bananas.com et apples.com. Notez que apples.com est inclus dans la liste de domaines 1 et dans la liste des domaines 3. Dans ce cas, la campagne n’aura jamais la chance de cibler les impressions de apples com, car le profil de membre bloque la liste des domaines 1.

API REST

HTTP, méthode Endpoint Description
POST https://api.appnexus.com/member-profile
(json de profil membre)
Create votre profil de membre
PUT https://api.appnexus.com/member-profile
(json de profil membre)
Mettre à jour votre profil de membre
GET https://api.appnexus.com/member-profile Afficher votre profil de membre
DELETE https://api.appnexus.com/member-profile Supprimer votre profil de membre
GET https://api.appnexus.com/member-profile/meta Découvrez les champs que vous pouvez filtrer et trier par

Remarque

Étant donné que vous n’avez qu’un seul profil de membre, vous n’avez pas besoin d’inclure l’ID de profil dans PUTles demandes , GETou DELETE .

Champs JSON

Champ Type Description
id int ID du profil de membre.
domain_list_action enum Action à effectuer sur domain_list_targets.

Valeurs possibles :
- "include" - Vous n’accepterez les impressions tierces que des domaines figurant dans les listes de domaines spécifiées.
- "exclude" - Vous acceptez les impressions tierces de tous les domaines, à l’exception de ceux figurant dans les listes de domaines spécifiées.

Par défaut : "exclude"
domain_list_targets tableau Listes de domaines à inclure ou exclure. Consultez les exemples ci-dessous pour la mise en forme.
country_targets tableau Pays à partir desquels vous accepterez des impressions tierces. Vous n’accepterez les impressions que de ces pays. Notez que si vous ne spécifiez aucun pays, vous acceptez les impressions tierces de tous les pays. Consultez les exemples ci-dessous.
last_modified date En lecture seule. Date de la dernière modification du profil de membre.
inventory_url_list_targets tableau d’objets Contient une liste d’ID de liste d’inventaire (listes d’autorisation et/ou listes de blocage). Permet d’attacher une seule liste verte et/ou une ou plusieurs listes de blocage au profil.

- La liste d’autorisation contient une liste de domaines ou d’applications à cibler par l’élément de ligne à l’aide du profil. Si une liste d’autorisation est incluse, les domaines et les applications qui ne figurent pas dans la liste d’autorisation ne seront pas ciblés.

- Chaque liste de blocage contient une liste de domaines ou d’applications qui doivent être exclus du ciblage par élément de ligne qui utilise le profil.

Pour plus d’informations, consultez Inventaire Listes dans Service de profil.
require_transparency_and_consent_framework_string valeur booléenne Si truela valeur est , autorisez uniquement les objets associés à acheter l’inventaire où une chaîne TCF valide est présente

Si la valeur est false, autorisez les objets associés à acheter tout inventaire qui se trouve dans des déclarations de ciblage prédéfinies.

Remarque : Ce paramètre s’applique uniquement au trafic provenant des territoires où le RGPD s’applique.

Par défaut : false

Exemples

Création de votre profil de membre

$ cat profile { "member-profile": { "domain_list_action": "include", "domain_list_targets": [ { "id": 23620 }, { "id": 23625 } ], "country_targets": [ { "id": 1 }, { "id": 2 } ] } } $ curl -b cookies -X POST -d @profile 'https://api.appnexus.com/member-profile' { "response": { "status": "OK", "id": 121740 } } 

Mise à jour de votre profil de membre pour accepter les impressions tierces d’un pays supplémentaire

$ cat profile_update { "member-profile": { "country_targets": [ { "id": 233 }, { "id": 59 } ] } } $ curl -b cookies -X PUT -d @profile_update 'https://api.appnexus.com/member-profile' { "response": { "status": "OK", "id": 121740 } } 

Affichage de votre profil de membre

$ curl -b cookies 'https://api.appnexus.com/member-profile' { "response": { "status": "OK", "member-profile": { "id": 121740, "domain_list_action": "include", "country_targets": [ { "id": 233, "name": "United States", "code": "US"  }, {  "id": 58, "name": "Czech Republic", "code": "CZ" }, { "id": 59, "name": "Germany", "code": "DE" } ], "domain_list_targets": [ { "id": "23620", "name": "Domain List 1", "description": "Include Domain List 1", "type": "white" }, { "id": "23625", "name": "Domain List 2", "description": "Include Domain List 2", "type": "white" } ], "last_modified": "2011-12-15 16:57:51" }, "count": 1, "start_element": 0, "num_elements": 100 } } 
{
    "profile": {
        "require_transparency_and_consent_framework_string": "false",
         
    }
}