Servicio de perfil de miembro
El Servicio de perfil de miembros le permite establecer un único perfil global para limitar los países o regiones y dominios desde los que acepta impresiones de terceros. Tus campañas no pujarán por impresiones de terceros que no coincidan con los requisitos del perfil de miembro.
Alineación de perfiles de campaña con perfil de miembro
Asegúrate de alinear tus perfiles de campaña con tu perfil de miembro; De lo contrario, es posible que la segmentación de la campaña no sea efectiva.
- Ejemplo 1: su perfil de miembro está configurado para aceptar impresiones de terceros de Estados Unidos y Canadá. Se ha establecido una campaña para dirigirse a las impresiones de Estados Unidos, Canadá y México. En este caso, la campaña nunca tendrá la oportunidad de dirigirse a las impresiones de México porque el perfil de miembro impide que esas impresiones estén disponibles para la puja.
- Ejemplo 2: el perfil de miembro está establecido para bloquear las impresiones de terceros de la lista de dominios 1, que incluye apples.com, oranges.com y pears.com. Una campaña se establece en la lista de dominios de destino 3, que incluye plums.com, bananas.com y apples.com. Tenga en cuenta que apples.com se incluye en la lista de dominios 1 y en la lista de dominios 3. En este caso, la campaña nunca tendrá la oportunidad de dirigirse a las impresiones de apples com porque el perfil de miembro bloquea la lista de dominios 1.
API de REST
Http (método) | Endpoint | Description |
---|---|---|
POST |
https://api.appnexus.com/member-profile (JSON de perfil de miembro) |
Creación del perfil de miembro |
PUT |
https://api.appnexus.com/member-profile (JSON de perfil de miembro) |
Actualización del perfil de miembro |
GET |
https://api.appnexus.com/member-profile |
Visualización del perfil de miembro |
DELETE |
https://api.appnexus.com/member-profile |
Eliminar el perfil de miembro |
GET |
https://api.appnexus.com/member-profile/meta |
Averigüe por qué campos puede filtrar y ordenar |
Nota:
Puesto que solo tiene un perfil de miembro, no es necesario incluir el identificador de perfil en PUT
las solicitudes , GET
o DELETE
.
Campos JSON
Campo | Tipo | Descripción |
---|---|---|
id |
Entero | Identificador del perfil de miembro. |
domain_list_action |
enumeración | Acción que se va a realizar en domain_list_targets . Posibles valores: - "include" - Solo aceptará impresiones de terceros de los dominios de las listas de dominios especificadas. - "exclude" - Aceptará impresiones de terceros de todos los dominios excepto los de las listas de dominios especificadas.Valor predeterminado: "exclude" |
domain_list_targets |
matriz | Listas de dominios que se van a incluir o excluir. Consulte los ejemplos siguientes para obtener formato. |
country_targets |
matriz | Países o regiones desde los que aceptará impresiones de terceros. Solo aceptará impresiones de estos países o regiones. Tenga en cuenta que si no especifica ningún país o región, aceptará impresiones de terceros de todos los países o regiones. Consulte los ejemplos siguientes. |
last_modified |
date | Solo lectura. Fecha en la que se modificó por última vez el perfil de miembro. |
inventory_url_list_targets |
matriz de objetos | Contiene una lista de identificadores de lista de inventario (listas de permitidos o listas de bloqueo). Se usa para adjuntar una sola lista de permitidos o una o varias listas de bloqueo al perfil. - La lista de permitidos contiene una lista de dominios o aplicaciones a los que el elemento de línea debe dirigirse mediante el perfil. Si se incluye una lista de permitidos, los dominios y las aplicaciones que no están en la lista de permitidos no se dirigirán a ellos. - Cada lista de bloqueos contiene una lista de dominios o aplicaciones que se van a excluir de la selección de destino por elemento de línea que usa el perfil. Consulte Listas de inventario en Profile Service para obtener más detalles. |
require_transparency_and_consent_framework_string |
booleano | Si true es , solo permite que los objetos asociados compren inventario cuando haya una cadena TCF válidaSi false es , permita que los objetos asociados compren cualquier inventario que se encuentre dentro de las declaraciones de destino predefinidas.Nota: Este parámetro solo se aplica al tráfico procedente de territorios en los que se aplica el RGPD. Valor predeterminado: false |
Ejemplos
Creación del perfil de miembro
$ cat profile { "member-profile": { "domain_list_action": "include", "domain_list_targets": [ { "id": 23620 }, { "id": 23625 } ], "country_targets": [ { "id": 1 }, { "id": 2 } ] } } $ curl -b cookies -X POST -d @profile 'https://api.appnexus.com/member-profile' { "response": { "status": "OK", "id": 121740 } }
Actualización del perfil de miembro para aceptar impresiones de terceros de un país adicional
$ cat profile_update { "member-profile": { "country_targets": [ { "id": 233 }, { "id": 59 } ] } } $ curl -b cookies -X PUT -d @profile_update 'https://api.appnexus.com/member-profile' { "response": { "status": "OK", "id": 121740 } }
Visualización del perfil de miembro
$ curl -b cookies 'https://api.appnexus.com/member-profile' { "response": { "status": "OK", "member-profile": { "id": 121740, "domain_list_action": "include", "country_targets": [ { "id": 233, "name": "United States", "code": "US" }, { "id": 58, "name": "Czech Republic", "code": "CZ" }, { "id": 59, "name": "Germany", "code": "DE" } ], "domain_list_targets": [ { "id": "23620", "name": "Domain List 1", "description": "Include Domain List 1", "type": "white" }, { "id": "23625", "name": "Domain List 2", "description": "Include Domain List 2", "type": "white" } ], "last_modified": "2011-12-15 16:57:51" }, "count": 1, "start_element": 0, "num_elements": 100 } }
Requerir transparencia y cadena de marco de consentimiento
{
"profile": {
"require_transparency_and_consent_framework_string": "false",
}
}