Compartir a través de

Servicio formulario de registro

  • Artículo

El Servicio de Formulario de Registro le permite cargar los formularios de registro requeridos por ciertos estados para la publicidad política adquirida por comités de gastos independientes. Los creativos no servirán en Nueva Jersey ni en el estado de Nueva York hasta que el formulario se cargue y se asocie con el orden de inserción adecuado.

Nota:

  • PUTy DELETEno se admiten para este servicio. En lugar de modificar un formulario existente, debe cargar un formulario nuevo y, a continuación, asociar el nuevo formulario con el orden de inserción.
  • Debe registrar el file-location especificado en la respuesta al formulario cargado para poder asociar el formulario con el orden de inserción adecuado. No hay ninguna manera de recuperar esta información más adelante. Si no registró la ubicación del archivo y aún necesita asociar el formulario a un pedido de inserción, deberá cargar un formulario nuevo.

API de REST

Http (método) Endpoint Description
POST https://api.appnexus.com/registration-form/upload-F uploadFile=@<local_path/local_file_name.pdf
donde local_path/local_file_name.pdf es la ruta de acceso y el nombre del archivo que se va a cargar.
Si no tiene acceso a la ruta de acceso del archivo local porque está llamando a la API desde un explorador, deberá crear un FormData objeto con el nombre uploadFile de la variable y cargarlo.
Si usa JavaScript para crear un objeto FormData, por ejemplo, el código debe tener un aspecto similar al siguiente.		 Cargue un nuevo formulario de registro.
GET https://api.appnexus.com/registration-form?member_id=MEMBER_ID Ver todos los formularios de registro de un miembro.
GET https://api.appnexus.com/registration-form?file_path=FILE_PATH/FILE_NAME.PDF Ver un formulario de registro.
Para ver un formulario de registro, debe conocer la ubicación en la que se cargó el archivo. Simplemente escriba la dirección URL en un explorador o realice una GET en la dirección URL.

FormData objeto

savePoliticalFormFile: async (uploadFile) => {
const formData = new FormData();
formData.append('uploadFile', uploadFile);
const response = await
httpPostMultiPart(`${API_URL}/registration-forms/upload`, formData);
return response['location'];
},

Campos JSON

Campo Tipo Descripción
member_id Entero Identificador del miembro.
Obligatorio activado:POST
file_path Entero Ubicación en la que se carga el archivo. Esto se devuelve en la respuesta y no se puede especificar al cargar el archivo.

Ejemplos

Carga de un formulario de registro y asociación del formulario a un pedido de inserción

Carga de un formulario de registro

En este ejemplo, NYS_Registration_Form_My_Favorite_Candidate.pdf es el formulario de divulgación del Estado de Nueva York para la compra de anuncios por parte del comité de gastos independiente.

curl -b cookies -X POST https://api.appnexus.com/registration-form/upload -F uploadFile=@/users/myname/NYS_Registration_Form_My_Favorite_Candidate.pdf>

La respuesta incluye lo siguiente:

{
    "file-path": "https://cleversafe03.appnexus.net/s3/political-ads-forms/p/958/20191010/fd241b14-1620-4e16-99d7-d57b19078649/A01055Registration20180907111141.PDF"
}

Asociar el formulario con un orden de inserción

En este ejemplo, el orden de inserción utilizado para los anuncios políticos es 5432.

cat io-registration-form.json
{
 
  "insertion-order": {
    "registration-forms": [
      {
        "file-path": "https://cleversafe03.appnexus.net/s3/political-ads-forms/p/958/20191010/fd241b14-1620-4e16-99d7-d57b19078649/A01055Registration20180907111141.PDF"
      }
    ]
  }
}
 
curl -b cookies -X PUT https://api.appnexus.com/insertion-order?id=5432

Visualización de un formulario cargado

GET https://api.appnexus.com/registration-form?file_path=https://cleversafe03.appnexus.net/s3/political-ads-
forms/p/958/20191010/fd241b14-1620-4e16-99d7-d57b19078649/A01055Registration20180907111141.PDF

Servicio de pedido de inserción