FREEFIRE.
CSEGUIMIENTO0 A LA CARA OM
[Link]
auth=500edfed8f0490cbc478fa533f8a56114bea214c&ua={UA_of_the_user}&ip={IP_of_the_us
er}&var={Request_variable[Link]
auth=500edfed8f0490cbc478fa533f8a56114bea214c&ua={UA_of_the_user}&ip={IP_of_the_us
er}&var={Request_variable}[Link]
%2F5.0%20%28Macintosh%3B%20Intel%20Mac%20OS%20X
%2010_13_4%29%20AppleWebKit%2F537.36%20%28KHTML%2C%20like%20Gecko
%29%20Chrome%2F67.0.3396.87%20Safari%2F537.36&ip=[Link]&lang=fr-CH%2C
%20fr%3Bq%3D0.9%2C%20en%3Bq%3D0.8%2C%20de%3Bq%3D0.7%2C%20%2A%3Bq
%3D0.5&os=Android%20&os_version=10.0.3&model=Pixel
%202XL&mobile=true&var=1337&auth=100curl -X 'GET' \
'[Link]
%20Intel%20Mac%20OS%20X%2010_13_4%29%20AppleWebKit%2F537.36%20%28KHTML
%2C%20like%20Gecko%29%20Chrome%2F67.0.3396.87%20Safari
%2F537.36&ip=[Link]&lang=fr-CH%2C%20fr%3Bq%3D0.9%2C%20en%3Bq
%3D0.8%2C%20de%3Bq%3D0.7%2C%20%2A%3Bq%3D0.5&os=Android
%20&os_version=10.0.3&model=Pixel%202XL&mobile=true&var=1337&auth=100' \
-H 'accept:
application/json’13374361000136019223912321340123[Link]
API abierta: 3.0.0
servidores:
- descripción: PropellerAds OfferApi (producción)
URL: [Link]
información:
Descripción: |
OfferApi proporciona acceso al feed PropellerAds.
---
# Preguntas frecuentes
### P: ¿Por qué recibimos algunas respuestas **204**?
R: Cuando nuestra plataforma no encuentra un banner adecuado para el usuario
determinado, responderá con 204.
### P: Tenemos una **alta latencia** con su API, ¡ayuda!
R: Asegúrate de utilizar la versión de API HTTP, no HTTPS. Esto reduce significativamente
el tiempo de respuesta de nuestro servicio. Además, tus ofertas serán más rápidas.
### P: ¿Ejemplo mínimo de **enlace API**?
A: Simplemente pegue sus parámetros aquí:
```
[Link]
auth={auth_token}&ua={user_agent}&ip={user_ip}
```
### P: ¿Qué es el parámetro var?
A: El ID de su fuente de tráfico. Por ejemplo, puede ser el ID de un editor o de un sitio, NO
el ID de la solicitud. Tenga cuidado y preste atención a las restricciones de los parámetros.
### P: ¿Cómo podemos obtener sugerencias de cliente en JavaScript?
A: Utilice un código como este
```
exportar const promiseHints = (() => {
si ([Link] === indefinido) {
devuelve [Link](null)
}
si ([Link] === indefinido) {
devuelve [Link](null)
}
si ([Link] === indefinido) {
devuelve [Link](null)
}
devolver [Link]([
'modelo',
'plataforma',
'versión de plataforma',
'móvil',
]).catch(() => {
devuelve nulo
})
})()
```
---
Para otras preguntas, comuníquese con su gerente personal.
*Equipo Propellerads*
versión: "1.0.1"
Título: OfferApi
etiquetas:
- nombre: anuncios
Descripción: Feed de anuncios
caminos:
/anuncios/{feed}/:
conseguir:
etiquetas:
- anuncios
Resumen: obtener anuncios
operaciónId: getAds
Descripción: |
Pasando las opciones adecuadas, podrás recibir anuncios
Disponible en el sistema
seguridad:
- ApiKeyAuth: []
parámetros:
- en: ruta
nombre: feed
Descripción: Tu feedId
requerido: verdadero
esquema:
tipo: entero
formato: int32
Ejemplo: 123
- en: consulta
nombre: ua
Descripción: Cadena de agente de usuario completa del usuario al que se le mostrará la
publicidad.
requerido: verdadero
esquema:
tipo: cadena
Ejemplo: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_4) AppleWebKit/537.36
(KHTML, como Gecko) Chrome/67.0.3396.87 Safari/537.36"
- en: consulta
nombre: ip
Descripción: Dirección IPv4 del usuario
requerido: verdadero
esquema:
tipo: cadena
formato: ip
Ejemplo: "[Link]"
- en: consulta
nombre: lang
Descripción: Encabezado Accept-Language del usuario
requerido: falso
esquema:
tipo: cadena
formato: cadena
Ejemplo: "fr-CH, fr;q=0,9, en;q=0,8, de;q=0,7, *;q=0,5"
- en: consulta
nombre: os
Descripción: >
Sistema operativo a partir de sugerencias para el cliente (¡solamente!)
<b>Si no puede obtenerlo en Sugerencias para clientes, no lo envíe</b><br>
Puedes obtenerlo de dos maneras:<br>
1) Utilice el valor del encabezado HTTP <b>Sec-Ch-Ua-Platform</b>,
[Link]
2) Utilice el valor de <b>plataforma</b> de
[Link]
>
Debe enviarse sin comillas.
requerido: falso
esquema:
tipo: cadena
formato: cadena
Ejemplo: Windows
- en: consulta
nombre: os_version
Descripción: >
Versión del sistema operativo de Client Hints (¡solamente!)<br>
<b>Si no puede obtenerlo en Sugerencias para clientes, no lo envíe</b><br>
Puedes obtenerlo de dos maneras:<br>
1) utilice el valor del encabezado HTTP <b>Sec-Ch-Ua-Platform-Version</b>,
[Link]
Version<br>
2) use el valor de <b>platformVersion</b> de
[Link]
>
Debe enviarse sin comillas.
requerido: falso
esquema:
tipo: cadena
formato: cadena
Ejemplo: "10.0.3"
- en: consulta
nombre: modelo
Descripción: >
Modelo a partir de sugerencias de clientes (¡solamente!)
<b>Si no puede obtenerlo en Sugerencias para clientes, no lo envíe</b><br>
Puedes obtenerlo de dos maneras:<br>
1) Utilice el valor del encabezado HTTP <b>Sec-Ch-Ua-Model</b>,
[Link]
2) use el valor del <b>modelo</b> de
[Link]
>
Debe enviarse sin comillas.
requerido: falso
esquema:
tipo: cadena
formato: cadena
Ejemplo: Pixel 2XL
- en: consulta
nombre: móvil
Descripción: >
Propiedad móvil de Consejos para clientes (¡solo!)<br>
<b>Si no puede obtenerlo en Sugerencias para clientes, no lo envíe</b><br>
Puedes obtenerlo de dos maneras:<br>
1) Utilice el valor del encabezado HTTP <b>Sec-CH-UA-Mobile</b>,
[Link]
2) Utilice el valor de <b>móvil</b> de
[Link]
requerido: falso
esquema:
tipo: booleano
formato: booleano
ejemplo: verdadero
- en: consulta
nombre:var
Descripción: >
Inserte aquí su SUBID. Var es la variable de origen que se nos pasa cuando se lo
solicitamos.<br>
Asegúrese de pasar el ID de la fuente (también puede ser el ID de los editores en su
sistema), no el ID de la solicitud ni nada más.<br>
En caso de pasar datos adicionales en el parámetro var, es posible que se pierdan
datos y no se reflejen en los informes de extracción de estadísticas.
Var no debe tener más de 40 caracteres con la siguiente lista de símbolos
aceptables:<br>
* ``az``
* ``AZ``
* `0-9`
* `+!:/ ,?()$=.%[]_-`
requerido: falso
esquema:
tipo: cadena
formato: cadena
Ejemplo: "1337"
respuestas:
'200':
$ref: "#/componentes/respuestas/Anuncios"
'204':
Descripción: Faltan feeds vacíos o anuncios según la orientación del usuario en este
momento
'400':
$ref: "#/componentes/respuestas/Error de solicitud incorrecta"
'401':
$ref: "#/componentes/respuestas/Error no autorizado"
'404':
$ref: "#/componentes/respuestas/FeedNotFoundError"
'500':
$ref: "#/componentes/respuestas/InternalServerError"
'503':
$ref: "#/componentes/respuestas/ServiceUnavailableError"
/categorias/:
conseguir:
etiquetas:
- categorías
Resumen: lista de las categorías de anuncios conocidas
operaciónId: obtenerCategorias
respuestas:
'200':
$ref: "#/componentes/respuestas/Categorías"
seguridad:
- ApiKeyAuth: []
Componentes:
Esquemas de seguridad:
Clave de autenticación de API:
tipo: apiKey
en: consulta
nombre: auth
esquemas:
Anuncio:
tipo: objeto
requerido:
- título
- texto
- icono
- tasa de cpc
- id del banner
- id_de_campaña
- haga clic en url
propiedades:
id del banner:
tipo: entero
formato: int64
Ejemplo: 123213
Descripción: "Identificación del banner"
id_de_campaña:
tipo: entero
formato: int64
Ejemplo: 239
Descripción: "Identificación de la campaña"
título:
tipo: cadena
Ejemplo: "¡FELICIDADES A LOS GANADORES!"
texto:
tipo: cadena
Ejemplo: "¡Toca ahora para ver si ganaste $1,909,349!"
icono:
tipo: cadena
formato: url
Ejemplo: "[Link]
Descripción: "Imagen con tamaño 192 x 192. Puede ser jpg, jpeg, png, etc. Es posible
que la propiedad no exista".
imagen:
tipo: cadena
formato: url
Ejemplo: "[Link]
Descripción: "Imagen con tamaño 360 x 240. Puede ser jpg, jpeg, png, etc. La propiedad
puede no existir."
haga clic en url:
tipo: cadena
formato: url
Ejemplo: "[Link]
Descripción: URL para rastrear un clic
URL de impresión:
tipo: cadena
formato: url
Ejemplo: "[Link]
Descripción: URL para rastrear una impresión
tasa de cpc:
obsoleto: verdadero
tipo: numero
formato: flotante
Ejemplo: 0,018
Descripción: "Precio por clic. OBSOLETO. Utilice Rate y RateModel para comparar".
tasa:
tipo: numero
formato: flotante
Ejemplo: 0,018
Descripción: >
Precio por clic/conversión.<br>
Significado de las tarifas:<br>
* CPC - precio por 1 clic;
* CPA - precio por 1 conversión;
* CPM, SCPM - precio por 1000 impresiones;
* SCPA - precio por 1 impresión;
modelo_de_tasa:
tipo: cadena
enumeración:
- "cpm"
- "cpa"
- "cpc"
- "scpa"
- "scpm"
Ejemplo: "cpc"
Descripción: "Modelo de precios."
Categoría:
tipo: objeto
requerido:
- identificación
- nombre
propiedades:
identificación:
tipo: entero
formato: int64
Ejemplo: 436
Descripción: "Identificación de la categoría"
nombre:
tipo: cadena
Ejemplo: "adulto"
Descripción: "Nombre de la categoría/alias"
Error:
tipo: objeto
requerido:
- código
- mensaje
propiedades:
código:
tipo: numero
Descripción: Código del error
Ejemplo: 1337
mensaje:
tipo: cadena
Descripción: Descripción detallada del error.
Ejemplo: ocurrió algún error
respuestas:
Anuncios:
Descripción: Respuesta de anuncios. URL para hacer un seguimiento de una impresión,
puede que no exista. Si no existe, la impresión se registrará automáticamente.
contenido:
aplicación/json:
esquema:
tipo: objeto
propiedades:
anuncios:
tipo: matriz
elementos:
$ref: '#/componentes/esquemas/Anuncio'
Categorías:
Descripción: Lista de categorías de anuncios conocidas
contenido:
aplicación/json:
esquema:
tipo: objeto
propiedades:
Categorías:
tipo: matriz
elementos:
$ref: '#/componentes/esquemas/Categoría'
Error de solicitud incorrecta:
Descripción: Los parámetros pasados eran incorrectos.
contenido:
aplicación/json:
esquema:
$ref: '#/componentes/esquemas/Error'
Error de feed no encontrado:
Descripción: Feed no encontrado, contacta con soporte
contenido:
aplicación/json:
esquema:
$ref: '#/componentes/esquemas/Error'
Error no autorizado:
Descripción: Error de autenticación
contenido:
aplicación/json:
esquema:
$ref: '#/componentes/esquemas/Error'
Error de servicio no disponible:
Descripción: Servicio no disponible temporalmente
contenido:
aplicación/json:
esquema:
$ref: '#/componentes/esquemas/Error'
Error Interno del Servidor:
Descripción: Error interno del servidor
contenido:
aplicación/json:
esquema:
$ref: '#/componentes/esquemas/Error’
