Vue d’ensemble du service de profil

Un profil est un ensemble de paramètres de ciblage, tels que le sexe, l’âge, la zone géographique et la fréquence. Il peut être appliqué à plusieurs objets du système, dont la plupart sont répertoriés ci-dessous. L’utilisation la plus courante du service de profil consiste à exécuter une campagne ; vous créez un profil, puis vous l’associez au service Campaign. L’objet de campagne inclut des champs tels que les dates de vol et les créations associées.

• À l’exception du ciblage de segment, les paramètres sont absolus. Par exemple, si la cible géographique est définie uniquement sur le États-Unis, SEULES les impressions basées aux États-Unis recevront des enchères.
• Le ciblage de segment utilise et/ou une logique booléenne.
• Les profils doivent être associés à un annonceur ou à un éditeur, afin d’être utilisés avec plusieurs autres objets du système, répertoriés ci-dessous.

Les profils peuvent être utilisés avec plusieurs autres objets dans le système (répertoriés ci-dessous). Tous les champs du profil qui ne s’appliquent pas à l’objet associé sont ignorés.

• Annonceur
• Élément de ligne
• Créatif
• Campagne
• Règle de paiement
• Règle de qualité des annonces

Il est également possible de faire référence à un profil au sein d’un objet de transaction, alors qu’il n’est pas nécessaire que le profil soit associé à un annonceur ou à un éditeur.

API REST

Champs JSON

Généralités

Frequency

Pour plus d’informations sur le ciblage de fréquence et de récence et les champs ci-dessous, consultez ici.

Ciblage

Lorsque plusieurs cibles sont définies, seul l’inventaire qui répond à tous les critères de ciblage est éligible. Par exemple, si vous ciblez l’audience general prévue et les sources d’inventaire x, y et z, le profil cible general uniquement l’inventaire d’audience à partir des sources d’inventaire x, y et z.

dma_targets Format

{
   "dma_targets":[
      {
         "dma":612
      },
      {
         "dma":622
      }
   ]
}

domain_targets Format

{
   "domain_targets":[
      {
         "profile_id":128350561,
         "domain":"telenet.be"
      },
      {
         "profile_id":99898705,
         "domain":"cnn.us"
      }
   ]
}

size_targets Exemple

{
   "size_targets":[
      {
         "width":190,
         "height":213
      },
      {
         "width":728,
         "height":90
      }
   ]
}

seller_member_group_targets Format

{
   "seller_member_group_targets":[
      {
         "id":1,
         "action_include":"true/false"
      }
   ]
}

deal_list_targets Exemple

{
   "profile":{
      "id":1367515,
      "deal_list_targets":[
         {
            "id":"0101"
         },
         {
            "id":"0102"
         }
      ]
   }
}

intended_audience_targets Exemple

{
   "intended_audience_targets":[
      "children",
      "general"
   ]
}

postal_code_targets Exemple

{
   "profile":{
      "id":1367515,
      "postal_code_targets":[
         {
            "id":"00135"
         },
         {
            "id":"00136"
         }
      ]
   }
}

postal_code_list_targets Exemple

{
   "profile":{
      "id":1367515,
      "postal_code_list_targets":[
         {
            "id":"0099"
         },
         {
            "id":"0100"
         }
      ]
   }
}

political_district_targets Exemple

{
   "profile":{
      "id":130465799,
      "political_district_targets":[
         {
            "id":"139897"
         }
      ]
   }
}

Ciblage des résultats pour deal_action_include les champs AND deal_targets

Les résultats de ciblage suivants se produisent pour ces valeurs des deal_action_include champs AND deal_targets :

Cibles de instance d’applications mobiles

Pour plus d’informations sur les instances d’application mobile, notamment des instructions sur leur ajout à votre profil, consultez Service d’instance d’application mobile.

L’application mobile instance lister les cibles

Pour plus d’informations sur les listes de instance d’applications mobiles, y compris des instructions sur leur ajout à votre profil, consultez service de liste d’instances d’application mobile.

Cibles daypart

Chaque objet du daypart_targets tableau inclut les champs suivants. Pour la mise en forme, consultez l’exemple Afficher un profil ci-dessous.

Cibles de segment

Vous définissez la logique booléenne entre les segments avec segment_boolean_operator un champ en dehors du tableau. Si segment_boolean_operator a la valeur AND, le profil cible uniquement les utilisateurs qui satisfont toutes les cibles de segment. Si a la segment_boolean_operator valeur OR, le profil cible les utilisateurs qui répondent à l’un des segments spécifiés. Pour obtenir des instructions détaillées sur la logique booléenne pour le ciblage de segments, consultez Ciblage de segments.

Dans le ciblage de segment, vous devez conserver les paramètres de la logique booléenne cohérents, sinon vous ne pourrez pas modifier les segments dans l’interface utilisateur Microsoft Invest. Pour des paramètres logiques booléens cohérents, vous devez vous assurer que :

• segment_boolean_operator le champ est défini sur «and » ou «or ».
• Le boolean_operator champ dans chaque objet du tableau segment_group_targets (voir Cibles de groupe de segments) est défini sur «and » ou «or ». Toutefois, cette valeur doit être l’opposé de ce qui est défini ci-dessus segment_boolean_operator . Par exemple, si la valeur définie dans segment_boolean_operator est «or », la valeur de boolean_operator pour les objets doit être «and ».
• La valeur du boolean_operator champ pour tous les objets du tableau segment_group_targets doit être identique. En bref, vous ne pouvez pas avoir boolean_operator d’un objet comme «and » et d’un autre comme «or » dans le même profil. Pour obtenir un exemple de JSONs cohérents et incohérents, consultez ci-dessous.

JSONs cohérents

{
   "segment_boolean_operator":"and",
   "segment_group_targets":[
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"1094797",
               "deleted":false,
               "expire_minutes":null,
               "id":19285936,
               "name":"Travel Intender",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"3119772",
               "deleted":false,
               "expire_minutes":null,
               "id":19378950,
               "name":"XAS - US HH Demographic - Online Shopping - Travel",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"6502105",
               "deleted":false,
               "expire_minutes":null,
               "id":19378951,
               "name":"XAS - US HH Demographic - Online Shopping - Electronics and Gadgets",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"3734388",
               "deleted":false,
               "expire_minutes":null,
               "id":19378952,
               "name":"XAS - US HH Demographic - Online Shopping - Apparel",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      },
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"2137013",
               "deleted":false,
               "expire_minutes":null,
               "id":19378954,
               "name":"XAS - US HH Demographic - Online Shopping - Buy Online",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"2272811",
               "deleted":false,
               "expire_minutes":null,
               "id":19378955,
               "name":"XAS - US HH Demographic - Online Shopping - Personal Health",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"8578372",
               "deleted":false,
               "expire_minutes":null,
               "id":19378957,
               "name":"XAS - US HH Demographic - Online Shopping - Shoes",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      },
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"8578372",
               "deleted":false,
               "expire_minutes":null,
               "id":19378957,
               "name":"XAS - US HH Demographic - Online Shopping - Shoes",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"4608982",
               "deleted":false,
               "expire_minutes":null,
               "id":21015599,
               "name":"Xandr Audiences - Demographic - Occupation - Detail - Attorneys",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"2420395",
               "deleted":false,
               "expire_minutes":null,
               "id":21015602,
               "name":"Xandr Audiences - Demographic - Occupation - Detail - Accountants/CPA",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      }
   ]
}

JSONs incohérents

{
   "segment_boolean_operator":"and",
   "segment_group_targets":[
      {
         "boolean_operator":[
            "and",
            "- - same as segment_boolean_operator + also all other boolean_operators in the rest of the object is set to",
            "or",
            "therefore this is inconsistent behavior"
         ],
         "segments":[
            {
               "action":"include",
               "code":"1094797",
               "deleted":false,
               "expire_minutes":null,
               "id":19285936,
               "name":"Travel Intender",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"3119772",
               "deleted":false,
               "expire_minutes":null,
               "id":19378950,
               "name":"XAS - US HH Demographic - Online Shopping - Travel",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"6502105",
               "deleted":false,
               "expire_minutes":null,
               "id":19378951,
               "name":"XAS - US HH Demographic - Online Shopping - Electronics and Gadgets",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"3734388",
               "deleted":false,
               "expire_minutes":null,
               "id":19378952,
               "name":"XAS - US HH Demographic - Online Shopping - Apparel",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      },
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"2137013",
               "deleted":false,
               "expire_minutes":null,
               "id":19378954,
               "name":"XAS - US HH Demographic - Online Shopping - Buy Online",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"2272811",
               "deleted":false,
               "expire_minutes":null,
               "id":19378955,
               "name":"XAS - US HH Demographic - Online Shopping - Personal Health",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"8578372",
               "deleted":false,
               "expire_minutes":null,
               "id":19378957,
               "name":"XAS - US HH Demographic - Online Shopping - Shoes",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      },
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"8578372",
               "deleted":false,
               "expire_minutes":null,
               "id":19378957,
               "name":"XAS - US HH Demographic - Online Shopping - Shoes",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"4608982",
               "deleted":false,
               "expire_minutes":null,
               "id":21015599,
               "name":"Xandr Audiences - Demographic - Occupation - Detail - Attorneys",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"2420395",
               "deleted":false,
               "expire_minutes":null,
               "id":21015602,
               "name":"Xandr Audiences - Demographic - Occupation - Detail - Accountants/CPA",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      }
   ]
}

Exemple de cibles de segment

Dans cet exemple, étant donné que est segment_boolean_operatorAND, le profil cible uniquement les utilisateurs qui tiennent dans le segment 86 et le segment 202.

{
   "profile":{
      "segment_boolean_operator":"and",
      "segment_targets":[
         {
            "id":86,
            "code":null,
            "name":"Network segment 1",
            "action":"include",
            "start_minutes":0,
            "expire_minutes":-1,
            "other_less":null,
            "other_greater":null,
            "other_equals":null
         },
         {
            "id":202,
            "code":null,
            "name":"Credit Score segment",
            "action":"include",
            "start_minutes":0,
            "expire_minutes":-1,
            "other_less":null,
            "other_greater":null,
            "other_equals":null
         }
      ]
   }
}

Cibles de groupe de segments

Chaque objet de groupe de segments contient les champs suivants.

Exemple de cibles de groupe de segments

Dans cet exemple, étant donné que est segment_boolean_operatorOR et que pour boolean_operator chaque groupe est AND, le profil cible uniquement les utilisateurs qui tiennent dans les segments 11 et 22 ou les deux segments 33 et 44.

{
   "profile":{
      "segment_boolean_operator":"or",
      "segment_group_targets":[
         {
            "boolean_operator":"and",
            "segments":[
               {
                  "id":11,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":null,
                  "other_less":null,
                  "other_greater":null
               },
               {
                  "id":22,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":null,
                  "other_less":null,
                  "other_greater":null
               }
            ]
         },
         {
            "boolean_operator":"and",
            "segments":[
               {
                  "id":33,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":null,
                  "other_less":null,
                  "other_greater":null
               },
               {
                  "id":44,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":null,
                  "other_less":null,
                  "other_greater":null
               }
            ]
         }
      ]
   }
}

Cibles d’âge

ages Objet

Exemple de cibles d’âge

{
   "profile":{
      "age_targets":{
         "allow_unknown":false,
         "ages":[
            {
               "low":20,
               "high":35
            }
         ]
      }
   }
}            
            

Objectifs de genre

L’objet gender_targets contient les champs suivants.

Cibles par pays

Chaque objet du country_targets tableau contient les champs suivants.

Exemple de cibles de pays

{
   "profile":{
      "country_action":"include",
      "country_targets":[
         {
            "id":233,
            "name":"United States",
            "code":"US"
         }
      ]
   }
}           
            

Cibles de région

Chaque objet du region_targets tableau contient les champs suivants.

Exemple de cibles de région

{
   "profile":{
      "region_action":"include",
      "region_targets":[
         {
            "id":3950,
            "name":"New York",
            "code":"NY",
            "country_name":"United States",
            "country_code":"US"
         }
      ]
   }
}            
            

Exiger la transparence et la chaîne de l’infrastructure de consentement

Exemple

{
   "profile":{
      "require_transparency_and_consent_framework_string":"false"
   }
}            
            

Objectifs de la ville

Chaque objet du city_targets tableau contient les champs suivants.

Exemple de cibles de ville

{
   "profile":{
      "city_action":"include",
      "city_targets":[
         {
            "id":200942,
            "name":"Portland",
            "region_name":"Oregon",
            "region_code":"OR",
            "country_code":"US",
            "country_name":"United States"
         }
      ]
   }
}            
            

Listes d’inventaire

Chaque objet du inventory_url_list_targets tableau inclut les champs suivants.

Exemple de listes d’inventaire

{
   "profile":{
      "id":145,
      "inventory_url_list_targets":[
         {
            "deleted":false,
            "id":51,
            "list_type":"blocklist",
            "name":"Blocklist to exclude medical sites",
            "exclude":true
         },
         {
            "deleted":false,
            "id":53,
            "list_type":"blocklist",
            "name":"Blocklist to exclude military sites",
            "exclude":true
         },
         {
            "deleted":false,
            "id":54,
            "list_type":"blocklist",
            "name":"Line Item - Blocklist - 2017-08-23T21:44:42Z",
            "exclude":true
         },
         {
            "deleted":false,
            "id":66,
            "list_type":"allowlist",
            "name":"Test Allowlist for Targeting",
            "exclude":false
         }
      ]
   }
}            
            

Cibles de catégorie de contenu

L’objet content_category_targets inclut le allow_unknown champ, qui est un booléen, et le content_category tableau. Chaque objet du content_category tableau contient les champs suivants.

Exemple de cibles de catégorie de contenu

{
   "profile":{
      "content_category_targets":{
         "allow_unknown":false,
         "content_categories":[
            {
               "id":3,
               "action":"include"
            }
         ]
      }
   }
}            
            

Cibles vidéo

L’objet contient les allow_unknown_playback_methodtableaux , allow_unknown_player_sizeallow_unknown_context, et , contextsplayer_sizesplayback_methodset .video_targets Pour Les transactions, il contient également le deal_creative_duration champ et les video_frameworks tableaux.

Contextes

La valeur par défaut est un tableau vide et cible n’importe quelle position de roll. Le contexts tableau contient des objets avec les champs suivants :

Méthodes de lecture

La valeur par défaut est un tableau vide et cible toute méthode de lecture. Le playback_methods tableau contient les champs suivants :

Tailles des joueurs

La valeur par défaut est un tableau vide et cible n’importe quelle taille de joueur. Le player_sizes tableau contient des objets avec les champs suivants :

Durée de création

Le deal_creative_duration paramètre est utilisé uniquement par les éléments de ligne de transaction vidéo. Il permet aux transactions de cibler des impressions qui autorisent au moins une durée de création donnée, de sorte que les créatifs de la longueur définie puissent servir avec succès une transaction sans erreurs. Il agrège uniquement les impressions avec le paramètre donné déjà en place.

Frameworks vidéo

Le video_frameworks tableau est utilisé uniquement par les éléments de ligne de transaction vidéo. Il permet aux transactions de cibler des impressions qui autorisent une infrastructure vidéo donnée (par exemple, VPAID) afin que les créatifs de ce type puissent servir avec succès via une transaction sans erreurs. Ce paramètre ne remplace pas les paramètres de placement existants ; il agrège uniquement les impressions avec le paramètre donné déjà en place.

Exemple d’infrastructure vidéo

{
   "profile":{
      "video_targets":{
         "allow_unknown_playback_method":true,
         "allow_unknown_context":true,
         "allow_unknown_player_size":true,
         "contexts":[
            {
               "id":1,
               "name":"pre-roll"
            },
            {
               "id":2,
               "name":"mid-roll"
            },
            {
               "id":4,
               "name":"outstream"
            }
         ],
         "playback_methods":[
            {
               "id":2,
               "name":"auto_play_sound_off"
            },
            {
               "id":3,
               "name":"click_to_play"
            }
         ],
         "player_sizes":[
            {
               "id":1,
               "name":"small",
               "min_width":0,
               "max_width":300
            }
         ],
         "deal_creative_duration":60,
         "video_frameworks":[
            {
               "id":1,
               "name":"vpaid_1_0"
            },
            {
               "id":2,
               "name":"vpaid_2_0"
            }
         ]
      }
   }
}            
            

Cibles de taux d’engagement

Le engagement_rate_targets tableau d’objets est utilisé pour cibler un inventaire spécifique et hautement performant en fonction des performances historiques. Vous pouvez utiliser des critères de ciblage pour acheter un inventaire vidéo avec un taux d’achèvement élevé ou un inventaire hautement visible, en spécifiant le taux de saisie semi-automatique ou le taux de visionnement souhaité.

Cibles de transaction

Chaque objet du deal_targets tableau contient les champs suivants.

Exemple de cibles de transaction

{
   "profile":{
      "deal_targets":[
         {
            "id":44,
            "name":"Deal with external supply partner",
            "code":"APN-1234-2200f"
         },
         {
            "id":45,
            "name":"Deal with UI seller",
            "code":null
         }
      ]
   }
}            
            

Positionner les cibles

L’objet position_targets contient les champs suivants.

Exemple de cibles de position

{
   "profile":{
      "position_targets":{
         "allow_unknown":false,
         "positions":[
            {
               "position":"above"
            }
         ]
      }
   }
}            
            

Cibles de modèle d’appareil

Chaque objet du device_model_targets tableau contient les champs suivants.

Exemple de cibles de modèle d’appareil

{
   "profile":{
      "device_model_action":"include",
      "device_model_targets":[
         {
            "id":1,
            "name":"Onetab XST2"
         },
         {
            "id":2,
            "name":"PAD7"
         },
         {
            "id":3,
            "name":"A101"
         }
      ]
   }
}            
            

Cibles de type d’appareil

Le device_type_targets tableau peut contenir une ou plusieurs des chaînes suivantes :

• phone
• tablet
• pc
• tv
• gameconsole
• stb
• mediaplayer

Exemple de cibles de type d’appareil

{
   "profile":{
      "device_type_action":"include",
      "device_type_targets":[
         "phone",
         "tablet"
      ]
   }
}            
            

Cibles de l’opérateur

Chaque objet du carrier_targets tableau contient les champs suivants.

Exemple de cibles d’opérateur

{
   "profile":{
      "carrier_action":"include",
      "carrier_targets":[
         {
            "id":14,
            "name":"Verizon - US",
            "country":"US"
         },
         {
            "id":26,
            "name":"Sprint - US",
            "country":"US"
         },
         {
            "id":32,
            "name":"Orange - US",
            "country":"US"
         }
      ]
   }
}            
            

Cibles de la liste des plages d’adresses IP

Pour plus d’informations sur les listes de plages d’adresses IP, consultez le service de liste de plages d’adresses IP.

Par profil, vous pouvez cibler jusqu’à 10 "include" listes de plages d’adresses IP (include définies true sur dans la liste des plages d’adresses IP) et pas plus de 1 "exclude" liste de plages d’adresses IP (include définie false sur dans la liste des plages d’adresses IP). Les plages d’adresses IP exclues doivent être un sous-ensemble des plages d’adresses IP incluses.

Cibles étendues du système d’exploitation

Le operating_system_extended_targets tableau spécifie les versions du système d’exploitation (par exemple, Android 3.x, Apple iOS 6, etc.) à inclure dans ou exclure de votre ciblage.

Chaque objet du operating_system_extended_targets tableau contient les champs suivants.

Exemple de cibles étendues du système d’exploitation

{
   "profile":{
      "use_operating_system_extended_targeting":true,
      "operating_system_extended_targets":[
         {
            "id":2,
            "name":"Android 2.1",
            "action":"exclude"
         },
         {
            "id":3,
            "name":"Android 2.2",
            "action":"include"
         }
      ]
   }
}
            

Cibles de la famille de systèmes d’exploitation

Le operating_system_family_targets tableau spécifie les systèmes d’exploitation dans leur ensemble (par exemple, Android, Apple iOS, Windows 7, Windows 11, etc.) à inclure dans ou exclure de votre ciblage, comme défini par le operating_system_family_action champ .

Chaque objet du operating_system_family_targets tableau contient les champs suivants.

Exemple de cibles de famille de systèmes d’exploitation

{
   "profile":{
      "operating_system_family_action":"exclude",
      "operating_system_family_targets":[
         {
            "id":2,
            "name":"Android"
         },
         {
            "id":3,
            "name":"Apple iOS"
         }
      ]
   }
}            
            

Cibles de valeur de clé

Le key_value_targets champ définit la combinaison de clés et de valeurs personnalisées qui sont ciblées dans ce profil. Le champ est une version analysée d’une expression logique.

Vous trouverez plus d’informations sur le fonctionnement du ciblage des valeurs de clé et des détails sur l’analyse des expressions pour le service de profil dans Ciblage de valeur de clé personnalisée.

key_value_targets Objet

header Objet

exp Objet

Exemple de cibles de valeur de clé

{
   "profile":{
      "key_value_targets":{
         "kv_expression":{
            "header":{
               "an_version":"1.0",
               "client_version":"1.0"
            },
            "exp":{
               "typ":"and",
               "sbe":[
                  {
                     "exp":{
                        "typ":"eq",
                        "key":"fruit",
                        "vtp":"str",
                        "vst":"apple"
                     }
                  },
                  {
                     "exp":{
                        "typ":"eq",
                        "key":"city",
                        "vtp":"str",
                        "vst":"NY"
                     }
                  }
               ]
            }
         }
      }
   }
}            
            

Paramètres de liste verte des URL d’inventaire

Les champs de cet objet sont utilisés pour définir la façon dont les listes d’autorisation attachées à un élément de ligne sont appliquées. Toutes les listes d’autorisation seront appliquées à l’achat RTB par défaut. Vous pouvez également choisir d’appliquer les listes d’autorisation aux achats gérés.

Exemple de paramètres de liste d’autorisation d’URL d’inventaire

{
   "inventory_url_allowlist_settings":{
      "apply_to_managed":true,
      "apply_to_rtb":true
   }
}            
            

Exemples

Afficher un profil

Il s’agit d’un exemple de service de profil.

$ curl -b cookies -c cookies 'https://api.appnexus.com/profile?id=439&advertiser_id=8&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "start_element":0,
      "num_elements":100,
      "profile":{
         "id":37291837,
         "code":null,
         "description":null,
         "country_action":"include",
         "region_action":"exclude",
         "city_action":"exclude",
         "browser_action":"exclude",
         "ads_txt_authorized_only":false,
         "use_inventory_attribute_targets":true,
         "last_modified":"2015-07-17 20:01:56",
         "daypart_timezone":null,
         "dma_action":"exclude",
         "domain_action":"exclude",
         "domain_list_action":"include",
         "inventory_action":"exclude",
         "language_action":"include",
         "segment_boolean_operator":"or",
         "min_session_imps":null,
         "session_freq_type":"platform",
         "carrier_action":"exclude",
         "supply_type_action":"exclude",
         "device_type_action":"exclude",
         "screen_size_action":"exclude",
         "device_model_action":"exclude",
         "location_target_radius":null,
         "location_target_latitude":null,
         "location_target_longitude":null,
         "querystring_action":"exclude",
         "querystring_boolean_operator":"and",
         "is_expired":false,
         "non_audited_url_action":"include",
         "daypart_bitmap":"000000000000000000000000111111111111111111111000111111111111111111111000111111111111111111111000111111111111111111111000111111111111111111111000000000000000000000000000",
         "optimization_zone_action":"exclude",
         "advertiser_id":16401,
         "publisher_id":null,
         "max_session_imps":null,
         "max_day_imps":null,
         "max_lifetime_imps":100,
         "max_page_imps":null,
         "min_minutes_per_imp":30,
         "venue_action":"exclude",
         "operating_system_action":"exclude",
         "require_cookie_for_freq_cap":true,
         "trust":"seller",
         "allow_unaudited":false,
         "is_template":false,
         "created_on":"2015-07-17 20:01:56",
         "operating_system_family_action":"exclude",
         "use_operating_system_extended_targeting":true,
         "mobile_app_instance_action_include":false,
         "mobile_app_instance_list_action_include":true,
         "user_group_targets":{
            "include_cookieless_users":false,
            "groups":[
               {
                  "low":0,
                  "high":49
               }
            ]
         },
         "country_targets":[
            {
               "id":233,
               "name":"United States",
               "code":"US"
            }
         ],
         "region_targets":[
            {
               "id":3950,
               "name":"New York",
               "code":"NY",
               "country_name":"United States",
               "country_code":"US"
            }
         ],
         "city_targets":null,
         "inv_class_targets":null,
         "inventory_attribute_targets":[
            {
               "id":2,
               "name":"Political",
               "deleted":false
            },
            {
               "id":4,
               "name":"Social media",
               "deleted":false
            },
            {
               "id":6,
               "name":"Photo and video sharing",
               "deleted":false
            },
            {
               "id":8,
               "name":"Forums (moderated)",
               "deleted":false
            },
            {
               "id":10,
               "name":"Forums (unmoderated)",
               "deleted":false
            },
            {
               "id":12,
               "name":"Incentivized clicks",
               "deleted":false
            },
            {
               "id":14,
               "name":"Non-english languages",
               "deleted":false
            },
            {
               "id":16,
               "name":"Streaming media",
               "deleted":false
            },
            {
               "id":17,
               "name":"Toolbars, plugins, or extensions",
               "deleted":false
            },
            {
               "id":29,
               "name":"Contextual Nudity",
               "deleted":false
            }
         ],
         "age_targets":{
            "allow_unknown":false,
            "ages":[
               {
                  "low":18,
                  "high":24
               },
               {
                  "low":25,
                  "high":34
               },
               {
                  "low":35,
                  "high":44
               }
            ]
         },
         "daypart_targets":[
            {
               "day":"monday",
               "start_hour":0,
               "end_hour":20
            },
            {
               "day":"tuesday",
               "start_hour":0,
               "end_hour":20
            },
            {
               "day":"wednesday",
               "start_hour":0,
               "end_hour":20
            },
            {
               "day":"thursday",
               "start_hour":0,
               "end_hour":20
            },
            {
               "day":"friday",
               "start_hour":0,
               "end_hour":20
            }
         ],
         "browser_targets":[
            {
               "id":4,
               "name":"Internet Explorer (other versions)",
               "deleted":false
            },
            {
               "id":11,
               "name":"Opera (all versions)",
               "deleted":false
            }
         ],
         "dma_targets":null,
         "domain_targets":[
            {
               "profile_id":37291837,
               "domain":"test.com"
            }
         ],
         "domain_list_targets":[
            {
               "id":3905,
               "name":"Test Domain List 1",
               "description":"",
               "type":"white",
               "deleted":false
            }
         ],
         "language_targets":[
            {
               "id":1,
               "name":"English",
               "code":"EN",
               "deleted":false
            }
         ],
         "size_targets":null,
         "zip_targets":null,
         "member_targets":[
            {
               "id":1185,
               "action":"include",
               "third_party_auditor_id":null,
               "billing_name":"AppNexus Demo"
            }
         ],
         "video_targets":null,
         "segment_group_targets":[
            {
               "boolean_operator":"and",
               "segments":[
                  {
                     "id":465381,
                     "action":"include",
                     "start_minutes":null,
                     "expire_minutes":null,
                     "other_less":null,
                     "other_greater":null,
                     "other_equals":null,
                     "code":null,
                     "name":null,
                     "deleted":false,
                     "other_in_list":null
                  },
                  {
                     "id":465382,
                     "action":"include",
                     "start_minutes":null,
                     "expire_minutes":null,
                     "other_less":null,
                     "other_greater":null,
                     "other_equals":null,
                     "code":null,
                     "name":null,
                     "deleted":false,
                     "other_in_list":null
                  }
               ]
            },
            {
               "boolean_operator":"and",
               "segments":[
                  {
                     "id":514839,
                     "action":"exclude",
                     "start_minutes":null,
                     "expire_minutes":null,
                     "other_less":null,
                     "other_greater":null,
                     "other_equals":null,
                     "code":null,
                     "name":null,
                     "deleted":false,
                     "other_in_list":null
                  },
                  {
                     "id":523129,
                     "action":"include",
                     "start_minutes":null,
                     "expire_minutes":null,
                     "other_less":null,
                     "other_greater":null,
                     "other_equals":null,
                     "code":null,
                     "name":null,
                     "deleted":false,
                     "other_in_list":null
                  }
               ]
            }
         ],
         "carrier_targets":null,
         "supply_type_targets":null,
         "device_type_targets":null,
         "screen_size_targets":null,
         "device_model_targets":null,
         "querystring_targets":null,
         "gender_targets":null,
         "intended_audience_targets":[
            "general",
            "children",
            "young_adult"
         ],
         "inventory_network_resold_targets":null,
         "operating_system_targets":null,
         "operating_system_family_targets":[
            {
               "id":6,
               "name":"BlackBerry OS"
            },
            {
               "id":8,
               "name":"Linux"
            }
         ],
         "position_targets":{
            "allow_unknown":true,
            "positions":null
         },
         "site_targets":null,
         "venue_targets":null,
         "operating_system_extended_targets":null,
         "mobile_app_instance_targets":null,
         "mobile_app_instance_list_targets":[
            {
               "id":3,
               "name":"Mopub iOS Apps 1-100",
               "description":"",
               "deleted":false
            }
         ],
         "optimization_zone_targets":null,
         "content_category_targets":{
            "allow_unknown":false,
            "content_categories":[
               {
                  "id":7,
                  "action":"exclude",
                  "name":"Beauty and Personal Care",
                  "is_system":true,
                  "deleted":false
               },
               {
                  "id":10,
                  "action":"include",
                  "name":"Arts and Entertainment",
                  "is_system":true,
                  "deleted":false
               },
               {
                  "id":20344,
                  "action":"exclude",
                  "name":"",
                  "is_system":false,
                  "deleted":false
               },
               {
                  "id":22224,
                  "action":"include",
                  "name":"",
                  "is_system":false,
                  "deleted":false
               }
            ]
         },
         "deal_targets":null,
         "placement_targets":null,
         "platform_content_category_targets":null,
         "platform_placement_targets":null,
         "platform_publisher_targets":[
            {
               "id":500070,
               "action":"exclude",
               "name":"Mediaset",
               "deleted":false
            }
         ],
         "publisher_targets":null,
         "segment_targets":null,
         "exelate_targets":null,
         "ip_range_list_targets":null
      }
   }
}

Cibler une plage de valeurs de chaîne de requête

Scénario : Deux éditeurs automatiques vous ont dit d’attendre "car year" des données dans les chaînes de requête de leurs placements. Le premier passe l’année avec le "car_year" paramètre , et le second passe l’année avec le "car_YYYY" paramètre . Pour cibler ces informations dans votre campagne, vous avez ajouté le "car_year" paramètre au segment 25 et le "car_YYYY" paramètre au segment 26. Vous souhaitez maintenant mettre à jour le profil de la campagne pour cibler les placements qui incluent l’un ou l’autre des paramètres lorsque le paramètre passe une année entre "car_year=2009" et "car_year=2012", afin de créer le code JSON suivant et d’effectuer un PUT appel pour mettre à jour le profil.

$ cat profile_update

{
   "profile":{
      "segment_group_targets":[
         {
            "boolean_operator":"or",
            "segments":[
               {
                  "id":25,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_less":2012,
                  "other_greater":2009
               },
               {
                  "id":26,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_less":2012,
                  "other_greater":2009
               }
            ]
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api.appnexus.com/profile?id=9&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":9
   }
}

Cibler une liste de valeurs de chaîne de requête

Scénario : un éditeur automatique vous a dit d’attendre l’une des valeurs clés-valeurs suivantes dans les chaînes de requête de ses placements : "car_make=ford", "car_make=honda"ou "car_make=toyota". Pour cibler ces informations, vous avez ajouté le paramètre et les valeurs au segment 12. Maintenant, vous souhaitez mettre à jour le profil de la campagne pour cibler ces valeurs. Vous devez donc créer le code JSON suivant et effectuer un PUT appel pour mettre à jour le profil.

$ cat profile_update

{
   "profile":{
      "segment_group_targets":[
         {
            "segments":[
               {
                  "id":12,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_in_list":[
                     "ford",
                     "honda",
                     "toyota"
                  ]
               }
            ]
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api..com/profile?id=10&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":10
   }
}

Cibler une valeur de chaîne de requête exacte

Scénario : un éditeur automatique vous a dit de vous attendre aux valeurs clés-valeurs suivantes dans les chaînes de requête de ses placements : car_color=red, car_color=blueou car_color=black. Pour cibler ces informations, vous avez ajouté le paramètre et les valeurs au segment 15. Maintenant, vous souhaitez mettre à jour le profil de la campagne pour cibler une valeur de chaîne de requête spécifique, black, afin de créer le code JSON suivant et d’effectuer un PUT appel pour mettre à jour le profil.

$ cat profile_update

{
   "profile":{
      "segment_group_targets":[
         {
            "segments":[
               {
                  "id":15,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":"black"
               }
            ]
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api..com/profile?id=10&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":10
   }
}

Cibler des pays spécifiques

Scénario : Vous souhaitez cibler votre profil vers le États-Unis et le Canada. Cela nécessite la définition country_action de include et country_targets de US et CA, de sorte que vous créez le code JSON suivant et effectuez un PUT appel pour mettre à jour le profil.

$ cat profile_update

{
   "profile":{
      "country_action":"include",
      "country_targets":[
         {
            "id":233
         },
         {
            "id":39
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api..com/profile?id=10&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":10
   }
}

Cibler un état spécifique, mais exclure un DMA

Scénario : Vous souhaitez cibler votre profil vers l’État de New York, à l’exclusion de la région de New York. Pour cela, vous devez définir region_actionincludesur , region_targetsUS:NYsur dma_actionexclude, sur et dma_targets501sur , qui est le code DMA pour La ville de New York. Par conséquent, vous créez le code JSON suivant et effectuez un PUT appel pour mettre à jour le profil.

$ cat profile_update

{
   "profile":{
      "region_action":"include",
      "region_targets":[
         {
            "id":1
         }
      ],
      "dma_action":"exclude",
      "dma_targets":[
         {
            "dma":501
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api..com/profile?id=10&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":10
   }
}

Cibler une transaction

Scénario : Vous avez négocié une transaction avec un vendeur qui vous accorde l’accès à un inventaire qui n’est pas disponible pour d’autres acheteurs (par exemple, une vente aux enchères privée). Pour tirer parti de cette offre, vous devez utiliser le service d’accès de l’acheteur de transaction pour rechercher l’ID de la transaction, puis mettre à jour le deal_targets tableau de votre profil pour cibler cet ID.

1. Pour trouver l’ID de votre transaction, vous passez un GET appel au service d’accès à l’acheteur de transaction et identifiez la bonne offre. Si vous connaissez l’ID de membre du vendeur, vous pouvez également le transmettre dans la chaîne de requête pour récupérer uniquement les transactions que vous avez avec ce vendeur, comme indiqué ci-dessous.

   $ curl -b cookies -c cookies 'https://api.appnexus.com/deal-buyer-access?seller_member_id=814'
   
   {
      "response":{
         "status":"OK",
         "count":1,
         "start_element":0,
         "num_elements":100,
         "deals":[
            {
               "id":65,
               "code":null,
               "name":"Private deal for buyer 1085 with floor of 2.5",
               "description":null,
               "active":true,
               "seller_member_id":814,
               "start_date":"2013-12-01 00:00:00",
               "end_date":"2013-12-31 23:59:59",
               "profile_id":null,
               "floor_price":2.5,
               "currency":"USD",
               "use_deal_floor":true,
               "last_modified":"2013-12-04 22:37:49",
               "buyer":{
                  "id":1085,
                  "bidder_id":2
               },
               "type":{
                  "id":2,
                  "name":"Private Auction"
               },
               "brands":[
                  {
                     "id":1
                  }
               ]
            }
         ]
      }
   }
   

2. Vous créez ensuite le fichier JSON avec deal_targets défini sur l’ID de la transaction.

   $ cat profile_update
   
   {
      "profile":{
         "deal_targets":[
            {
               "id":65
            }
         ]
      }
   }
   

3. Enfin, vous effectuez un PUT appel pour mettre à jour le profil.

   $ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api.appnexus.com/profile?id=22&advertiser_id=210&member_id=123'
   
   {
      "response":{
         "status":"OK",
         "count":1,
         "id":22
      }
   }
   

Utiliser des cibles de famille de systèmes d’exploitation et des cibles étendues du système d’exploitation ensemble

Les cibles étendues du système d’exploitation et de la famille de systèmes d’exploitation fonctionnent en tandem pour permettre différents scénarios de ciblage pour des familles de systèmes d’exploitation spécifiques. Cette fonctionnalité est mieux représentée par des exemples d’utilisation. Cette section contient les exemples suivants (faites défiler vers le bas ou recherchez-les pour les afficher).

• Cibler des appareils iOS 7.0 ; toutes les autres familles de systèmes d’exploitation et les autres versions d’iOS ne seront pas prises en charge.
• Cibler tous les appareils iOS, quelle que soit la version ; toutes les autres familles de systèmes d’exploitation ne serviront pas.
• Ciblez tous les systèmes d’exploitation qui ne sont pas Inconnu, Linux ou Symbian.
• Ciblez tous les appareils Android, ainsi que iOS 7.0.
• Ciblez tous les appareils Android, iOS et Windows Mobile.
• Ciblez Mac OS 10.8 (Mountain Lion) et MS Windows 8.0.
• Ciblez Mac OS X 10.8 (Mountain Lion) et tous les ordinateurs de bureau Windows à l’exception de XP et 2000.
• Ciblez tous les systèmes d’exploitation iOS à l’exception des versions 2.0 et 2.1.
• Configuration non valide : impossible d’inclure une famille de systèmes d’exploitation et d’exclure ses membres.
• Configuration non valide : impossible d’inclure et d’exclure des membres de la même famille de systèmes d’exploitation.
• Configuration non valide : impossible d’inclure les membres d’une famille de systèmes d’exploitation exclue.

Cibler des appareils iOS 7.0 ; toutes les autres familles de systèmes d’exploitation et autres versions iOS ne seront pas prises en charge

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         
      },
      "operating_system_extended_targets":{
         "id":80,
         "name":"iOS 7.0",
         "action":"include"
      }
   }
}            
            

Cibler tous les appareils iOS, quelle que soit la version ; toutes les autres familles de systèmes d’exploitation ne serviront pas

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         "id":3,
         "name":"Apple iOS"
      }
   },
   "operating_system_extended_targets":{
      
   }
}            
            

Cibler tous les systèmes d’exploitation qui ne sont pas Inconnu, Linux ou Symbian

En d’autres termes, servez sur n’importe quel appareil Android, iOS, MacOS, Windows, Blackberry ou Windows Mobile.

{
   "profile":{
      "operating_system_family_action":"exclude",
      "operating_system_family_targets":[
         {
            "id":0,
            "name":"Unknown"
         },
         {
            "id":8,
            "name":"Linux"
         },
         {
            "id":9,
            "name":"Symbian OS"
         }
      ]
   }
}            
            

Cibler tous les appareils Android, ainsi que iOS 7.0

Toutes les autres versions d’iOS ne seront pas prises en charge, et tous les appareils non Android ne serviront pas.

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         "id":2,
         "name":"Android"
      }
   },
   "operating_system_extended_targets":[
      {
         "id":80,
         "name":"iOS 7.0",
         "action":"include"
      }
   ]
}            
            

Cibler tous les appareils Android, iOS et Windows Mobile

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":[
         {
            "id":2,
            "name":"Android"
         },
         {
            "id":3,
            "name":"Apple iOS"
         },
         {
            "id":7,
            "name":"Microsoft Mobile"
         }
      ],
      "operating_system_extended_targets":{
         
      }
   }
}            
            

Cibler Mac OS 10.8 (Mountain Lion) et MS Windows 8.0

Cet exemple combine des cibles étendues du système d’exploitation de différentes familles de systèmes d’exploitation.

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         
      },
      "operating_system_extended_targets":[
         {
            "id":81,
            "name":"10.8 Mountain Lion",
            "action":"include"
         },
         {
            "id":93,
            "name":"Windows 8",
            "action":"include"
         }
      ]
   }
}            
            

Ciblez Mac OS X 10.8 (Mountain Lion) et tous les ordinateurs de bureau Windows à l’exception de XP et 2000

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         
      },
      "operating_system_extended_targets":[
         {
            "id":80,
            "name":"10.8 Mountain Lion",
            "action":"include"
         },
         {
            "id":89,
            "name":"Windows 2000",
            "action":"exclude"
         },
         {
            "id":90,
            "name":"Windows XP",
            "action":"exclude"
         }
      ]
   }
}            
            

Cibler tous les systèmes d’exploitation iOS à l’exception des versions 2.0 et 2.1

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":[
         {
            "id":3,
            "name":"Apple iOS"
         }
      ],
      "operating_system_extended_targets":[
         {
            "id":47,
            "action":"include",
            "name":"iOS 2.0"
         },
         {
            "id":48,
            "action":"include",
            "name":"iOS 2.1"
         }
      ]
   }
}            
            

Les configurations de ciblage de profil suivantes ne sont pas valides et peuvent entraîner un comportement inattendu.

Configuration non valide : impossible d’inclure une famille de systèmes d’exploitation et d’exclure ses membres

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":[
         {
            "id":3,
            "name":"Apple iOS"
         }
      ],
      "operating_system_extended_targets":[
         {
            "id":47,
            "action":"include",
            "name":"iOS 2.0"
         },
         {
            "id":48,
            "action":"include",
            "name":"iOS 2.1"
         }
      ]
   }
}            
            

Configuration non valide : impossible d’inclure et d’exclure des membres de la même famille de systèmes d’exploitation

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         
      },
      "operating_system_extended_targets":[
         {
            "id":47,
            "name":"iOS 2.0",
            "action":"include"
         },
         {
            "id":48,
            "name":"iOS 2.1",
            "action":"exclude"
         }
      ]
   }
}            
            

Configuration non valide : impossible d’inclure les membres d’une famille de systèmes d’exploitation exclue

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":[
         {
            "id":3,
            "name":"Apple iOS"
         }
      ],
      "operating_system_extended_targets":[
         {
            "id":47,
            "action":"include",
            "name":"iOS 2.0"
         },
         {
            "id":48,
            "action":"include",
            "name":"iOS 2.1"
         }
      ]
   }
}            
            

Positions des pods publicitaires cibles

Cibler des emplacements publicitaires spécifiques (dernier, premier, troisième)

{
   "profile":{
      "ad_slot_intro_bumper_action_include":false,
      "ad_slot_outro_bumper_action_include":false,
      "ad_slot_position_action_include":true,
      "ad_slot_position_targets":[
         -1,
         0,
         2
      ]
   }
}            
            

Positions de pare-chocs cibles uniquement (intro et outro)

{
   "profile":{
      "ad_slot_position_action_include":true,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":true,
      "ad_slot_outro_bumper_action_include":true
   }
}            
            

Cibler n’importe quel emplacement de pod publicitaire

{
   "profile":{
      "ad_slot_position_action_include":false,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":false,
      "ad_slot_outro_bumper_action_include":false
   }
}            
            

Exclure tous les emplacements et les pare-chocs des pods publicitaires

Ce comportement n’est pas quelque chose que vous souhaiterez répliquer . vous ne servirez à rien.

{
   "profile":{
      "ad_slot_position_action_include":true,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":false,
      "ad_slot_outro_bumper_action_include":false
   }
}            
            

Cibler uniquement le pare-chocs d’introduction

{
   "profile":{
      "ad_slot_position_action_include":true,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":true,
      "ad_slot_outro_bumper_action_include":false
   }
}            
            

Les configurations de ciblage de profil suivantes ne sont pas valides et peuvent entraîner un comportement inattendu.

Configuration non valide : impossible de cibler tous les emplacements publicitaires et toutes les positions de pare-chocs

{
   "profile":{
      "ad_slot_position_action_include":false,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":true,
      "ad_slot_outro_bumper_action_include":true
   }
}            
            

Cibler une transaction par programmation garantie

Scénario : vous avez négocié une offre programmatique garantie (PG) avec un vendeur et souhaitez cibler cette transaction avec un article de ligne d’achat PG. Vous devez créer un profil de transaction PG à l’aide de l’ID de transaction PG. Vous devez ensuite associer ce profil à un article de ligne d’achat PG pour cibler l’offre (voir l’exemple Create un article de ligne d’achat PG dans Line Item ALI Service).

1. Create un json de profil de transaction PG qui inclut l’ID de la cible de transaction.

   Remarque

   Pour les articles de ligne d’achat PG, vous ne pouvez avoir qu’une seule cible de transaction dans le deal_targets tableau.

   $ cat pg_deal_profile
   
   {
      "profile":{
         "deal_targets":[
            {
               "id":456
            }
         ],
         "allow_unaudited":true
      }
   }
   

2. Effectuez une POST demande au point de https://api.appnexus.com/profile terminaison avec ce json de profil de transaction PG et un approprié advertiser_id.

   $ curl -b cookies -c cookies -X POST -d @pg_deal_profile 'https://api.appnexus.com/profile?advertiser_id=123'
   
   {
      "response":{
         "status":"OK",
         "count":1,
         "id":123456,
         "start_element":0,
         "num_elements":100,
         "profile":{
            "id":123456,
            "code":null,
            "description":null,
            "country_action":"exclude",
            "region_action":"exclude",
            "city_action":"exclude",
            "browser_action":"exclude",
            "use_inventory_attribute_targets":false,
            "last_modified":"2019-08-07 19:43:12",
            "daypart_timezone":null,
            "dma_action":"exclude",
            "domain_action":"exclude",
            "domain_list_action":"exclude",
            "inventory_action":"exclude",
            "language_action":"exclude",
            "segment_boolean_operator":"and",
            "min_session_imps":null,
            "session_freq_type":"platform",
            "carrier_action":"exclude",
            "supply_type_action":"exclude",
            "device_type_action":"exclude",
            "screen_size_action":"exclude",
            "device_model_action":"exclude",
            "location_target_radius":null,
            "location_target_latitude":null,
            "location_target_longitude":null,
            "querystring_action":"exclude",
            "querystring_boolean_operator":"and",
            "is_expired":false,
            "non_audited_url_action":"include",
            "daypart_bitmap":null,
            "is_archived":false,
            "archived_on":null,
            "advertiser_id":123,
            "publisher_id":null,
            "max_session_imps":null,
            "max_day_imps":null,
            "max_lifetime_imps":null,
            "max_page_imps":null,
            "min_minutes_per_imp":null,
            "venue_action":"exclude",
            "operating_system_action":"exclude",
            "require_cookie_for_freq_cap":true,
            "trust":"seller",
            "allow_unaudited":true,
            "is_template":false,
            "created_on":"2019-08-07 19:43:12",
            "operating_system_family_action":"exclude",
            "use_operating_system_extended_targeting":true,
            "mobile_app_instance_action_include":false,
            "mobile_app_instance_list_action_include":false,
            "inventory_prefer_direct":false,
            "deal_action_include":true,
            "exclude_unknown_seller_member_group":false,
            "ad_slot_position_action_include":false,
            "ad_slot_intro_bumper_action_include":true,
            "ad_slot_outro_bumper_action_include":true,
            "graph_id":null,
            "media_subtype_action_include":false,
            "ads_txt_authorized_only":false,
            "inventory_url_allowlist_settings":{
               "apply_to_rtb":true,
               "apply_to_managed":true
            },
            "user_group_targets":null,
            "country_targets":null,
            "region_targets":null,
            "city_targets":null,
            "inventory_attribute_targets":null,
            "placement_type_targets":null,
            "age_targets":null,
            "daypart_targets":null,
            "browser_targets":null,
            "dma_targets":null,
            "domain_targets":null,
            "domain_list_targets":null,
            "language_targets":null,
            "size_targets":null,
            "zip_targets":null,
            "member_targets":null,
            "video_targets":{
               "allow_unknown_playback_method":false,
               "allow_unknown_context":false,
               "allow_unknown_player_size":false
            },
            "engagement_rate_targets":null,
            "segment_group_targets":null,
            "carrier_targets":null,
            "supply_type_targets":null,
            "device_type_targets":null,
            "screen_size_targets":null,
            "device_model_targets":null,
            "querystring_targets":null,
            "gender_targets":null,
            "intended_audience_targets":null,
            "inventory_network_resold_targets":null,
            "operating_system_targets":null,
            "operating_system_family_targets":null,
            "position_targets":null,
            "site_targets":null,
            "venue_targets":null,
            "operating_system_extended_targets":null,
            "postal_code_targets":null,
            "seller_member_group_targets":null,
            "cross_device":null,
            "key_value_targets":null,
            "media_subtype_targets":null,
            "content_category_targets":null,
            "deal_targets":[
               {
                  "id":456,
                  "name":"PG Deal 123",
                  "code":"PGD_123",
                  "deleted":false
               }
            ],
            "placement_targets":null,
            "platform_content_category_targets":null,
            "platform_placement_targets":null,
            "platform_publisher_targets":null,
            "publisher_targets":null,
            "ip_range_list_targets":null,
            "mobile_app_instance_targets":null,
            "mobile_app_instance_list_targets":null,
            "ad_slot_position_targets":null,
            "inventory_url_list_targets":null,
            "max_hour_imps":null,
            "max_week_imps":null,
            "max_month_imps":null
         },
         "dbg_info":{
            "warnings":[
   
            ],
            "version":"1.18.1247",
            "output_term":"profile"
         }
      }
   }
   

3. Create un article de ligne d’achat PG et l’associer à l’ID du profil de transaction PG nouvellement créé (consultez l’exemple Create un article de ligne d’achat PG dans Service ALI d’élément de ligne).

   Cibler un district politique spécifique

   {
      "profile":{
         "political_district_targets":[
            {
               "id":"139897"
            }
         ]
      }
   }                        
   
   

Voir aussi

• Bonnes pratiques relatives aux API
• Sémantique d’API
• Service de district politique