Servicio de diseño nativo

Este servicio permite al vendedor especificar el diseño de una creatividad nativa. Una vez que el diseño está en nuestra base de datos, se puede recuperar mediante yrenderer_id, posteriormente, .layout_id

API de REST

Http (método)	Endpoint	Description
POST	https://api.appnexus.com/native-layout?member_id=456	Create un nuevo diseño.
PUT	https://api.appnexus.com/native-layout?id=16&member_id=456	Edite un diseño existente.
DELETE	https://api.appnexus.com/native-layout?id=123&member_id=456	Eliminar un diseño.

Campos JSON

Campo	Tipo	Descripción
data_assets	matriz de objetos	Atributos de la creatividad nativa. Consulte Recursos de datos a continuación para obtener más detalles.
image_assets	matriz de objetos	Especifique los atributos necesarios de cada imagen individual. Consulte Recursos de imagen para obtener más detalles.
renderer	object	Identificador del representador del vendedor. Escriba en id esta matriz. Ejemplo: "renderer":{"id":1}

Recursos de imagen

El image_assets objeto incluye los campos siguientes:

Campo	Tipo	Descripción
aspect_ratios	matriz de objetos	Defina las relaciones de aspecto necesarias para el tipo de icon imagen. Los valores necesarios son min_width, ratio_width y ratio_height. Vea Ejemplo.
image_type	string	Formato de la imagen. Los valores posibles son: - main_image - icon_image
required	Entero	Especifique si la imagen es necesaria. Valores posibles: - 1 Obligatorio
sizes	matriz de objetos	Tamaño de la imagen. Especifique y widthheight. Vea Ejemplo.

Ejemplo para aspect_ratios

"aspect_ratios": [
{
"min_width" : 100,
"ratio_width": 1,
"ratio_height": 2
}
]

Ejemplo para sizes

Example:
"sizes": [
{
"width": 300,
"height": 500
}
]

Recursos de datos

El data_assets objeto incluye los campos siguientes:

Campo	Tipo	Descripción
data_type	string	Tipo de recurso para la creatividad nativa. Posibles valores: - sponsored_by - title - description - rating - call_to_action - display_url - likes - downloads - price - sale_price - phone - address - additional_description
required	Entero	Si es necesario, el valor debe ser 1.
maximum_length	Entero	Longitud máxima del recurso de datos.

Ejemplos

Create un nuevo protocolo de diseño nativo

$ cat native_layout

{
    "native-layout": {
        "renderer": {
            "id": 1
        },
        "image_assets":[
            {
                "image_type": "main_image", //depends on api.native_asset_image_type.name
                "required": 1,
                "sizes": [
                    {
                        "width": 300,
                        "height": 500
                    }
                ]
            },
            {
                "image_type": "icon_image",
                "aspect_ratios": [
                    {
                        "minimum_width" : 100,
                        "ratio_width": 1,
                        "ratio_height": 2
                    }
                ]
            }
        ],
        "data_assets": [
            {
                "data_type": "title", //depends on api.native_asset_data_type.name
                "required": 1,
                "maximum_length": 100
            }
        ]
    }
} 

$ curl -b cookies -c cookies -X POST -d @native_layout 'https://api.appnexus.com/native-layout?member_id=456'

{
    "response": {
        "status": "OK",
        "start_element": 0,
        "num_elements": 100,
        "native-layout": {
            "id": 2,
            "member_id": 7,
            "renderer": {
                "id": 1
            },
            "data_assets": [
                {
                    "required": true,
                    "data_type": "title",
                    "maximum_length": 100
                }
            ],
            "image_assets": [
                {
                    "required": true,
                    "image_type": "main_image",
                    "sizes": [
                        {
                            "width": 300,
                            "height": 500
                        }
                    ],
                    "aspect_ratios": null
                },
                {
                    "required": false,
                    "image_type": "icon_image",
                    "sizes": null,
                    "aspect_ratios": [
                        {
                            "minimum_width": 100,
                            "ratio_width": 1,
                            "ratio_height": 2
                        }
                    ]
                }
            ]
        },
        ...
    }
}