Service CREATIVE VAST

Vous pouvez utiliser le service Creative Vast pour ajouter des éléments créatifs vidéo ou audio à Xandr. Toutes les créations doivent être attachées à un annonceur ou à un éditeur.

• Vous pouvez afficher votre ID d’annonceur en appelant le service annonceur.
• Vous pouvez afficher votre ID d’éditeur en appelant le service serveur de publication.
• Vous pouvez attacher un élément créatif à un éditeur pour l’utiliser en tant que création par défaut pour un placement. Vous devez ensuite attacher le créatif à un placement via son ID à l’aide du service de placement.

Audit

Xandr travaille avec des membres qui se soucient profondément de la marque et de la réputation. Pour cette raison, nous nous assurons que les publicités (créatives) qui passent par notre système sont acceptables par toutes les parties. Pour garantir la qualité, toutes les créations qui servent sur l’inventaire tiers doivent être préinscrites à l’aide du service Créatif.

• Les créatifs sont identifiés par leur media_url (soit une URL de serveur d’annonce tiers, soit une URL de réseau de distribution de contenu pour un fichier Flash ou vidéo).
• Xandr vérifie régulièrement media_urls. Si un fichier disparaît, le créatif est traité comme non audité.
• Une fois qu’un créatif a réussi l’audit Xandr, certaines modifications apportées au créatif entraînent son renvoi pour audit. Pour plus d’informations, consultez Modifications qui provoquent un ré audit ci-dessous .
• Pour plus d’informations sur l’audit, consultez Creative Standards and Auditing.

API REST

Champs JSON

segments Exemple

"segments":[
{"id":11111,
"action":"add_on_view"
},
{"id":22222,
"action":"add_on_click"
}
]

categories Exemple

"categories":[{"id":"13","name":"Online Games"}]

adservers Exemple

"adservers":[{"id":"1","use_type":"adserver","name":"24/7 Real Media"}]

technical_attributes Exemple

"technical_attributes":[{"id":"1","name":"Image"}]

language Exemple

"language":{"id":"1","name":"English"}

media_assets Exemple

"media_assets":[
{
"media_asset_id":22,
"creative_field":null
}
]

L’audio

Éléments de ligne

Chaque objet du line_items tableau inclut les champs suivants. Pour obtenir des informations pour "id" les champs ou "code" , vous pouvez utiliser le service d’élément de ligne - ALI.

Campagnes

Chaque objet du campaigns tableau inclut les champs suivants. Pour obtenir des informations sur "id" les champs ou "code" , vous pouvez utiliser le service Campaign.

État

Marques concurrentielles

Media-asset

media-asset l’objet inclut les champs suivants :

Media_asset_status

media_asset_status l’objet inclut les champs suivants :

Modèle

template l’objet inclut les champs suivants :

Catégories concurrentielles

Attribut vidéo

video_attribute est requis pour les créations audio et vidéo sur le point de creative-vast terminaison. Les ID de modèle sont les suivants :

• 6439 - Vidéo : Standard VAST
• 38745 - Audio : Standard VAST

L’objet video_attribute inclut les champs suivants :

Wrapper d’attributs vidéo

L’objet wrapper contient les champs suivants :

Élément Wrapper d’attribut vidéo

Le elements tableau contient les champs suivants :

Video Wrapper Event Tracker

Vous pouvez supprimer des pixels sur chaque événement que nous suivons dans les rapports (voir vast_event_type_id ci-dessous). Ajoutez le ou les pixels comme trackers sur le créatif. Le trackers tableau contient les champs suivants :

Fichiers multimédias du wrapper vidéo

Attribut vidéo inline

Objet linéaire inline

Suivis linéaires inline

Fichiers multimédias linéaires inline

Objet Inline Companion Ads

Segments

Ces champs seront inclus dans le tableau Segments :

Marque

L’objet brand contient les champs suivants.

Première exécution/dernière exécution

Pour inclure les first_run champs et last_run dans une GET réponse, transmettez flight_info=true la chaîne de requête. Vous pouvez également filtrer les éléments créatifs en fonction du moment où ils ont été servis pour la première et la dernière fois, comme suit :

Récupérer uniquement les créations qui n’ont jamais été servies

Transmettez never_run=true la chaîne de requête.

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&never_run=true'

Récupérer uniquement les créations qui ont été servies pour la première fois à ou après une date spécifique

Transmettez min_first_run=YYYY-MM-DD HH:MM:SS la chaîne de requête.

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&min_first_run=2012-01-01 00:00:00'

Récupérer uniquement les créations qui ont été servies pour la première fois à ou avant une date spécifique

Transmettez max_first_run=YYYY-MM-DD HH:MM:SS la chaîne de requête.

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&max_first_run=2012-08-01 00:00:00'

Récupérer uniquement les créations d’abord servies dans une plage de dates spécifique

Transmettez min_first_run=YYYY-MM-DD HH:MM:SS&max_first_run=YYYY-MM-DD HH:MM:SS la chaîne de requête.

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&min_first_run=2012-01-01 00:00:00&max_first_run=2012-08-01 00:00:00'

Récupérer uniquement les créations qui ont été servies pour la dernière fois à ou après une date spécifique

Transmettez min_last_run=YYYY-MM-DD HH:MM:SS la chaîne de requête.

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&min_last_run=2012-01-01 00:00:00'

Récupérer uniquement les créations qui ont été servies pour la dernière fois ou avant une date spécifique

Transmettez max_last_run=YYYY-MM-DD HH:MM:SS la chaîne de requête.

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&max_last_run=2012-08-01 00:00:00'

Récupérer uniquement les créations qui ont été servies pour la dernière fois dans une plage de dates spécifique

Transmettez min_last_run=YYYY-MM-DD HH:MM:SS&max_last_run=YYYY-MM-DD HH:MM:SS la chaîne de requête.

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&min_last_run=2012-01-01 00:00:00&max_last_run=2012-08-01 00:00:00'

Modifications qui provoquent un audit de nouveau

Une fois qu’un créatif a réussi l’audit Xandr (audit_status est "audited"), la modification de l’un des champs suivants entraîne la soumission du créatif pour l’audit (allow_audit est défini sur "pending").

• media_url
• click_url
• language
• categories
• technical_attributes
• brand_id
• pixel_url
• video_attribute
• media_assets

En outre, si a la audit_status valeur "no_audit", le passage allow_audit de "false" à "true" entraîne la soumission de la création pour l’audit Xandr.

Exemples

Charger une vidéo ou une création audio

Lors du chargement d’un élément créatif pour l’hébergement avec Xandr :

Étape 1 : Charger la ressource dans le service de chargement créatif.

curl -X POST -H "Authorization: hbapi:139072:5761726637ada:nym2" --form "type=video" --form "file=@./Xandr_30_1280_720_2500k.mp4" "https://api.appnexus.com/creative-upload?member_id=123"

Le media_asset_id est retourné.

{
    "response": 
        "status": "OK",
        "count": 0,
        "start_element": 0,
        "num_elements": 0,
        "media-asset": [
            {
                "id": 54621,
                "parent_media_asset_id": null,
                "member_id": 123,
                "advertiser_id": null,
                "publisher_id": null,
                "file_name": "Xandr_30_1280_720_2500k.mp4",
                "size_in_bytes": 8358845,
                "cdn_uploaded_on": null,
                "cdn_url": null,
                "cdn_secure_url": null,
                "created_on": "2016-06-15 15:33:17",
                "last_modified": "2016-06-15 15:33:17",
                "deleted": false,
                "media_asset_status": [
                    {
                        "id": 54621,
                        "media_asset_id": 54621,
                        "error_message": null,
                        "local_path": "03/36/2e/66/03362e66-674a-41b3-9477-fcd979cdbf0b/03362e66-674a-41b3-9477-fcd979cdbf0b.mp4",
                        "cdn_upload_attempt_count": 0,
                        "created_on": "2016-06-15 15:33:17",
                        "last_modified": "2016-06-15 15:33:17",
                        "deleted": false,
                        "status": "on_shared_storage"
                    }
                ],
                "media_asset_video": null,
                "media_asset_html5": null,
                "asset_type": "video",
                "mime_type": "video/mp4",
                "duration": "32000"
            }
        ]
    }

Étape 2 :Utilisez pourmedia_asset_idcharger le créatif.

$ cat creative_video

{
    "creative-vast": {
        "name": "upload hosted video",
        "media_assets": [
            {
               "media_asset_id": 54621
            }
        ],
        "click_url": "https://appnexus.com",
        "video_attribute": {
            "inline": {
                "ad_title": "hosting test",
                "linear": {
                    "trackers": []
                }
            },
            "is_skippable": true,
            "duration_ms": "57000"
        },
        "template": {
            "id": 6439
        },
        "advertiser_id": 164979,
        "segments": null,
        "allow_audit": true,
        "is_self_audited": false,
        "sla": 0
    }
}

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 12345678,
        "start_element": 0,
        "num_elements": 100,
        "creative-vast": {
            "name": "hosted creative video",
            "brand_id": 1,
            "media_url": "http://appnexus.com",
            "id": 12345678,
            ...
            "track_clicks": true,
            "audit_status": "pending",
            ...
            "media_url_secure": "https://appnexus.com",
            ...
            "is_hosted": true,
            ...
            "language": {
                "id": 1,
                "name": "English"
            },
            ...
            },
            "template": {
                "id": 6439,
                "name": "Standard",
                "media_subtype_id": 64,
                "format_id": 10
            },
            ...
            "video_attribute": {
               "is_skippable": true,
                "duration_ms": 57000,
                "inline": {
                    "ad_title": "hosted video creative",
                    "ad_description": null,
                    "linear": {
                        "trackers": null,
                        "media_files": null
                    }
                },
                "video_frameworks": null
            },
            "media_assets": [
                {
                    "media_asset_id": 54621
                }
            ],
            ...
            "currency": "USD",
            "type": "video"
        },
        ...
    }
}

Exemple d’objet video_attribute avec wrapper

{
    "creative-vast": {
        "id": 145,
        ...
        "template_id": 6439,
        "video_attribute": {
            "is_skippable": true,
            "duration_ms": 21000,
            "wrapper": {
                "url": "http://www.doubleclick.net/...",
                "secure_url": "https://www.doubleclick.net/...",
                "elements": [
                    {
                        "vast_element_type_id": 1,
                        "name": "linear",
                        "trackers": [
                            {
                                "name": "startTracker",
                                "vast_event_type": "impression",
                                "url": "http://tracker.com/...",
                                "secure_url": "https://tracker.com/...",
                            }
                            {
                                "name": "completionTracker",
                                "vast_event_type_id": 8,
                                "url": "http://tracker.com/...",
                                "secure_url": "https://tracker.com/...",
                                "event_type": "completion"
                            }
                        ]
                    }
                ]
            }
        }
    }
    }

Un video_attribute objet avec un exemple VAST inline

{
    "creative-vast": {
        "name": "John-Doe test",
        "member_id": 1111,
        "advertiser_id": 2474202,
        "template": {
            "id": 6439
        },
        "video_attribute": {
            "duration_ms": 10000,
            "inline": {
                "ad_title": "John-Doe test",
                "linear": {
                    "trackers": []
                }
            }
        },
        "media_assets": [
            {
                "media_asset_id": 5375731,
                "creative_field": null
            }
        ]
    }
    }

Voir aussi

• Creative Upload Service - Format de fichier
• Bonnes pratiques relatives aux API
• Sémantique d’API