Service HTML créatif

Vous pouvez utiliser le service HTML créatif pour ajouter des éléments créatifs HTML5 à AppNexus. 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

AppNexus 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).
• AppNexus vérifie régulièrement media_urls. Si un fichier disparaît, le créatif est traité comme non audité.
• Une fois qu’un élément créatif a réussi l’audit AppNexus, certaines modifications apportées à la création 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é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

Catégories concurrentielles

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-html?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-html?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-html?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-html?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-html?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-html?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-html?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 AppNexus (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_asset

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 AppNexus.

Exemples

Charger une création HTML5

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

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

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

est media_asset_id 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": "AppNexus_30_1280_720_2500k.zip",
                "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.zip",
                        "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": "html",
                "mime_type": "zip" 
            }
        ]
    }

Étape 2 : Utilisez pour media_asset_id charger le créatif.

$ cat creative_html

{
    "creative-html": {
        "name": "upload_hosted_html5.zip",
        "template":{
            "id":8606
            },
        "media_assets": 
           [{
               "media_asset_id": 54621
            }
        ],
        "width":120
        "height":600
        "click_url": "https://appnexus.com",
        "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-html": {
            "name": "upload_hosted_html5.zip",
            "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": 8606,
                "name": "HTML Multi Asset - Standard",
            },
            ...
            "media_assets": [
                {
                    "media_asset_id": 54621
                }
            ],
            ...
            "currency": "USD",
            "type": "html"
        },
        ...
    }
    }

Voir aussi

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