Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Remarque
Ce service est actuellement disponible pour un ensemble limité de clients et d’employés Microsoft uniquement.
Ce champ ou cette fonctionnalité fait partie de la fonctionnalité actuellement en phase Alpha ou Bêta. Il est donc susceptible d’être modifié.
Les administrateurs Xandr peuvent utiliser ce service pour créer l’élément de standard_v2 ligne.
API REST
| Méthodes HTTP | Endpoint | Description |
|---|---|---|
POST |
https://sor-api.adnxs.net/standard_v2(standard_v2 JSON) |
Ajoutez un nouvel élément de ligne de ciblage augmenté et le profil associé. |
PUT |
https://sor-api.adnxs.net/standard_v2(standard_v2 JSON) |
Modifier un élément de ligne de ciblage augmenté et le profil associé. |
Champs JSON
| Champ | Type | Description |
|---|---|---|
line_item |
tableau | Consultez Tableau d’éléments de ligne. |
campaigns |
tableau | Consultez Campaigns Array. |
Tableau d’éléments de ligne
Le tableau d’éléments de ligne fonctionne comme le service d’élément de ligne.
| Champ | Type | Description |
|---|---|---|
id |
int | ID de l’élément de ligne. Obligatoire On : PUT, dans la chaîne de requête. |
name |
string | Nom de l’élément de ligne. Obligatoire sur : POST |
line_item_type |
enum | Pour que le service de création de rapports d’éléments de ligne fonctionne correctement, sélectionnez standard_v2.Par défaut: standard_v1Obligatoire sur : POST |
revenue_type |
enum | La façon dont l’annonceur a accepté de vous payer. Les valeurs possibles pour line_item_type = standard_v2 sont répertoriées ci-dessous :- "cpm": Paiement forfaitaire par 1000 impressions. Nécessite un revenue_value.- "vcpm": valeur attendue pour chaque impression.Pour un type de revenu de "cpm" ou "vcpm", l’un des éléments suivants est requis :- goal_type:- cpa: utilisez le tableau De pixels d’objectif. - cpc: utilisez le tableau d’évaluation.Chacun peut également inclure : - max_avg_cpm dans le tableau Évaluation.Obligatoire sur : POST |
revenue_value |
double | Montant versé au réseau par l’annonceur. Obligatoire sur : POST |
budget_intervals |
tableau | Consultez Intervalles budgétaires. Remarque : - Définissez sur enable_pacingtrue.AND - Définissez lifetime_budget ou et lifetime_budget_implifetime_pacing.OR - Définissez lifetime_budget ou lifetime_budget_imps et daily_budget ou daily_budget_imps.Obligatoire sur : POST |
creative |
tableau | Éléments créatifs associés à l’élément de ligne. Vous devez d’abord ajouter le créatif par le biais du service créatif si vous n’avez pas encore de création à utiliser. Consultez Creative Array. |
profile |
tableau | Consultez Service de profil. |
Tableau créatif
| Champ | Type | Description |
|---|---|---|
id |
int | ID du créatif. ou idcode est requis lors de la mise à jour de l’association créative. |
code |
string | Code personnalisé pour le créatif. ou idcode est requis lors de la mise à jour de l’association créative. |
Tableau d’évaluation
| Champ | Type | Description |
|---|---|---|
goal_threshold |
decimal | Pour les éléments de ligne avec , goal_type"cpc"le seuil d’objectif de performance, qui détermine le seuil d’enchère/aucune enchère sur les campagnes optimisées.Par défaut: null |
goal_target |
decimal | Pour les éléments de ligne avec , goal_type"cpc"la cible d’objectif de performances, représentant le taux de clics ou de clics souhaité.Par défaut: null |
performance_mkt_managed |
valeur booléenne |
Par défaut: Définissez sur false. |
min_margin_pct |
decimal | Pour les éléments de ligne avec revenue_type"cpm", "cpa"ou "cpc" la marge minimale PCT.Par défaut: null |
min_avg_cpm |
decimal | Le chiffre d’affaires de l’élément de ligne ne peut pas être inférieur à cette moyenne eCPM minimale. Par défaut: null |
max_avg_cpm |
decimal | Le chiffre d’affaires de l’élément de ligne ne peut pas dépasser cette moyenne eCPM maximale. Par défaut: null |
Tableau de campagnes
Voici la campagne par défaut dont vous avez besoin pour alimenter le service de création de rapports d’éléments de ligne lorsque vous créez un élément de ligne. Vous devrez toujours construire une campagne avec les champs et valeurs suivants, et le service de création de rapports d’éléments de ligne créera et associera la campagne réelle pour vous. Le service de création de rapports d’éléments de ligne attend la campagne dans une liste, même si vous n’en placez qu’une seule.
| Champ | Type | Valeur |
|---|---|---|
name |
string | Nom de l’élément de ligne. |
state |
enum | État de l’élément de ligne. |
inventory_type |
enum | "both" |
cpm_bid_type |
enum | "bpp" |
require_cookie_for_tracking |
enum | "false" |
Exemple
Create un nouvel élément de ligne de trading augmenté
$ cat standard_v2.json
{
"standard_v2": {
"line_item": {
"line_item_type": "standard_v2",
"payout_margin": null,
"require_cookie_for_tracking": true,
"name": "Tst",
"code": null,
"state": "active",
"start_date": null,
"end_date": null,
"click_url": null,
"lifetime_budget": null,
"lifetime_budget_imps": null,
"lifetime_pacing": null,
"enable_pacing": null,
"daily_budget": null,
"daily_budget_imps": null,
"budget_intervals": [
{
"start_date": "2016-01-08 00:00:00",
"end_date": "2016-01-09 00:00:00",
"lifetime_budget": 1,
"lifetime_budget_imps": null,
"parent_interval_id": 7103,
"lifetime_pacing": false,
"enable_pacing": true,
"daily_budget": 1,
"daily_budget_imps": null
}
],
"insertion_orders": [
{
"id": 269592,
"name": "First Test",
"code": null,
"state": "active",
"advertiser_id": 764141,
"start_date": null,
"end_date": null,
"remaining_days": null,
"total_days": null,
"last_modified": "2016-01-08 21:57:18",
"timezone": "EST5EDT",
"currency": "JPY",
"comments": null,
"billing_code": null,
"line_items": [
{
"id": 2621282,
"name": "First LI",
"code": null,
"state": "active",
"start_date": null,
"end_date": null,
"timezone": "EST5EDT"
},
{
"id": 2621320,
"name": "TEst 2",
"code": null,
"state": "active",
"start_date": null,
"end_date": null,
"timezone": "EST5EDT"
},
{
"id": 2621351,
"name": "Test",
"code": null,
"state": "active",
"start_date": null,
"end_date": null,
"timezone": "EST5EDT"
}
],
"spend_protection_pixels": null,
"labels": null,
"broker_fees": null,
"budget_intervals": [
{
"id": 7103,
"object_id": 269592,
"object_type": "insertion_order",
"start_date": "2016-01-08 00:00:00",
"end_date": "2016-01-09 00:00:00",
"timezone": "EST5EDT",
"lifetime_budget": 1,
"lifetime_budget_imps": null,
"lifetime_pacing": false,
"enable_pacing": false,
"daily_budget_imps": null,
"daily_budget": null
}
],
"tpas_details": null,
"lifetime_pacing": null,
"lifetime_budget": null,
"lifetime_budget_imps": null,
"enable_pacing": null,
"lifetime_pacing_span": null,
"allow_safety_pacing": null,
"daily_budget": null,
"daily_budget_imps": null,
"lifetime_pacing_pct": null
}
],
"currency": "JPY",
"broker_fees": [],
"manage_creative": true,
"creative_distribution_type": "even",
"creatives": [],
"labels": [],
"revenue_type": "vcpm",
"revenue_value": null,
"track_revenue": "track",
"pixels": [],
"valuation": {
"goal_target": 1,
"goal_threshold": 1,
"performance_mkt_managed": false,
"min_margin_pct": 1,
"min_avg_cpm": 1,
"max_avg_cpm": 1
},
"goal_type": "cpc",
"goal_value": null,
"goal_pixels": null,
"comments": null,
"profile": {
"require_cookie_for_freq_cap": true,
"max_day_imps": null,
"max_lifetime_imps": null,
"min_minutes_per_imp": null,
"max_page_imps": null,
"device_type_action": "exclude",
"device_type_targets": null,
"supply_type_action": "exclude",
"supply_type_targets": null,
"city_targets": null,
"city_action": "exclude",
"country_action": "exclude",
"country_targets": null,
"region_targets": null,
"region_action": "exclude",
"dma_targets": null,
"dma_action": "exclude",
"location_target_latitude": null,
"location_target_longitude": null,
"location_target_radius": null,
"zip_targets": null,
"postal_code_targets": null,
"content_category_targets": null,
"domain_action": "exclude",
"domain_targets": null,
"domain_list_action": "exclude",
"domain_list_targets": null,
"inventory_action": "exclude",
"placement_targets": null,
"publisher_targets": null,
"site_targets": null,
"mobile_app_instance_action_include": false,
"mobile_app_instance_targets": null,
"mobile_app_instance_list_action_include": false,
"mobile_app_instance_list_targets": null,
"member_targets": null,
"platform_content_category_targets": null,
"platform_placement_targets": null,
"platform_publisher_targets": null,
"segment_boolean_operator": "or",
"segment_group_targets": [],
"daypart_targets": null,
"daypart_timezone": null,
"querystring_action": "exclude",
"querystring_boolean_operator": "and",
"querystring_targets": null,
"position_targets": {
"allow_unknown": true,
"positions": null
},
"gender_targets": null,
"age_targets": null,
"certified_supply": false,
"allow_unaudited": false,
"trust": "appnexus",
"video_targets": {
"contexts": null,
"playback_methods": null,
"player_sizes": null,
"allow_unknown_playback_method": false,
"allow_unknown_context": false,
"allow_unknown_player_size": false
},
"inventory_attribute_targets": [
{
"id": "2"
},
{
"id": "4"
},
{
"id": "6"
},
{
"id": "8"
},
{
"id": "10"
},
{
"id": "14"
},
{
"id": "16"
},
{
"id": "18"
}
],
"intended_audience_targets": [
"general",
"children",
"young_adult"
],
"use_inventory_attribute_targets": true,
"use_operating_system_extended_targeting": true,
"operating_system_extended_targets": null,
"operating_system_family_action": "exclude",
"operating_system_family_targets": null,
"operating_system_action": "exclude",
"operating_system_targets": null,
"language_action": "exclude",
"language_targets": null,
"browser_action": "exclude",
"browser_targets": null,
"carrier_action": "exclude",
"carrier_targets": null,
"device_model_action": "exclude",
"device_model_targets": null
},
"id": 0
},
"campaigns": [
{
"name": "Tst",
"state": "active",
"inventory_type": "both",
"cpm_bid_type": "bpp",
"require_cookie_for_tracking": false
}
]
}
}
$ curl -b cookies -c cookies -X POST -d @standard_v2.json "http://sor-api.adnxs.net/standard_v2"