Este ponto de extremidade só deve ser utilizado ao enviar Dados de Receitas ao Nível de Impressão (ILRD) diretamente através de S2S para um fornecedor de mediação que ainda não esteja oficialmente integrado com a Tenjin.
Autenticação #
Autentificamos todos os pedidos enviados ao servidor Tenjin utilizando a chave API como nome de utilizador na autenticação básica ou como parâmetro «api_key».
Ponto final genérico #
Caminho: https://track.tenjin.com/v0/ad_impressions/
Método: POST
Content-Type: application/x-www-form-urlencoded
Parâmetros de informação do dispositivo #
Os parâmetros assinalados com * são obrigatórios
| Parâmetros | Exemplo | Descrição |
bundle_id* | com.tenjin.wordfinder | ID do pacote da aplicação. |
advertising_id* | be277924-d076-456d-9a20-3c8dee5663d3 | The raw advertising ID of the device. Please note that the request will only be accepted with a valid device id (any of advertising_id, developer_device_id, and analytics_installation_id). It’s important to stay consistent in sending the device id types. For iOS, it should be IDFA. In the case of no user consent, advertising_id can be empty or all zeros, and IDFV needs to be provided in developer_device_id along with analytics_installation_id For Android, either advertising_id or analytics_installation_id should be provided. |
developer_device_id* | 5f4dcc3b-5aa5-40e1-8914-7a9c5d5ebf31 | Campo alternativo para o identificador único do dispositivo, utilizado quando não existe um ID de publicidade. No caso do iOS, deve ser o IDFV. |
analytics_installation_id* | 91d1c313-dd94-4bd3-bbbb-16c8b7afa054 | Identificador específico para a instalação da aplicação gerado pela Tenjin. Disponível através do callback do cliente ou do SDK.SDK AndroidSDK iOSSDK Unity |
platform* | iOS | Plataforma da aplicação. ios,android (com a Google Play Store), android_other (sem a Google Play Store, por exemplo, dispositivos com lojas de aplicações chinesas), amazon (com a aplicação Amazon da App Store) |
app_version* | 1.5 | The version of your app For Android: String app_version = context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionName + “.” + context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionCode) For iOS: [[[NSBundle mainBundle] infoDictionary] objectForKey:@”CFBundleShortVersionString”] |
app_version_code | 2 | Apenas Android Versão da aplicação Android: https://developer.android.com/studio/publish/versioning |
build_id | RQ3A.211001.001 | Para Android: String build = String.valueOf(Build.ID) Para iOS: @import Darwin.sys.sysctl; NSString *build(void) { size_t bufferSize = 64; NSMutableData *buffer = [[NSMutableData alloc] initWithLength:bufferSize]; int status = sysctlbyname(“kern.osversion”, buffer.mutableBytes, &bufferSize, NULL, 0); if (status != 0) { return nil; } return [[NSString alloc] initWithCString:buffer.mutableBytes encoding:NSUTF8StringEncoding];} |
carrier | T-2 | Operadora de telemóvel (Fornecedor de serviços de Internet) |
connection_type | Wi-Fi | móvel/Wi-Fi |
country | EUA | A norma ISO relativa aos códigos de país das configurações regionais (ver, por exemplo, documentação da Apple). |
device | blueline | Android: android.os.Build.DEVICE (referência)iOS: systemInfo.machine (referência) |
device_brand | ||
device_manufacturer | ||
device_model | Pixel 3 | Para Android: String device = Build.MODEL; Para iOS: @import Darwin.sys.sysctl; NSString *device(void) { size_t bufferSize = 64; NSMutableData *buffer = [[NSMutableData alloc] initWithLength:bufferSize]; int status = sysctlbyname(“hw.machine”, buffer.mutableBytes, &bufferSize, NULL, 0); if (status != 0) { return nil; } return [[NSString alloc] initWithCString:buffer.mutableBytes encoding:NSUTF8StringEncoding];} |
device_product | blueline | Apenas Android: build.PRODUCT |
language | en | Código ISO 639-1 de duas letras |
limit_ad_tracking | FALSO | O dispositivo limita o rastreio de anúncios? (verdadeiro, falso) |
opt_in | VERDADEIRO | Consentimento de aceitação no dispositivo para conformidade com o RGPD: Implementação do SDK do Tenjin |
locale | en_US | Para Android:String locale = Locale.getDefault().toString() Para iOS:[[NSLocale currentLocale] localeIdentifier] |
os_version | 14 | Para Android: String.valueOf(Build.VERSION.SDK_INT) Para iOS: [[UIDevice currentDevice] systemVersion] |
os_version_release | 14.3.1 | Apenas para o Android: versão de lançamento do sistema operativo completo |
timezone | Europa/Liubliana | |
user_agent | Linux; U; Android 11; SM-A505FN Build/RP1A.200720.012 | Agente de utilizador do dispositivo do utilizador |
screen_height | 2028 | |
screen_width | 1080 | |
sent_at | 1693581566830 | Tempo de época em milissegundos |
session_id | f4239af1-cd6f-49e8-8b97-f61a9e81a7e0 | |
source_app_store | googleplay | Apenas Android: unspecified, googleplay, amazon, other |
ip_address* (Obrigatório para determinar o país do dispositivo) | 87.123.246.9 | O endereço IP do utilizador. Este é utilizado para identificar os países, no âmbito dos parâmetros de consentimento do utilizador da Google DMA. |
ad_user_data (Exigido pelo Google) | 1 | Parâmetro «Google User Consent Signal»: consentimento para a transmissão por terceiros de dados ao nível do utilizador para anúncios — 1 para consentimento concedido, 0 para consentimento recusado. Remova completamente o parâmetro da solicitação (não deixe em branco) quando não houver dados relativos ao consentimento do utilizador. |
ad_personalization (Exigido pelo Google) | 1 | Parâmetro «Google User Consent Signal»: «consent» para anúncios personalizados¹; «0» para consentimento concedido; «0» para consentimento recusado. Remova completamente o parâmetro da solicitação (não deixe em branco) quando não houver dados relativos ao consentimento do utilizador |
Parâmetros de informação sobre receitas #
Os parâmetros assinalados com * são obrigatórios
| Parâmetros | Exemplo | Descrição |
ad_revenue_mediation* | máx. | Nome da plataforma de mediação; utilize os valores abaixo:max,ironsource,admob,topon,cas,tradplusPara outros tipos de mediação, utilize custom. |
network_name* | minintegral | Nome da rede que exibe o anúncio, normalmente fornecido pelo prestador de serviços de mediação |
currency* | USD | Os códigos de moeda da ISO, por exemplo, USD, JPY |
revenue_decimal* | 0.001 | A receita em formato decimal para UMA impressão requer apenas revenue_decimal ou revenue_cpm. Quando forem recebidos ambos, será dada prioridade a revenue_decimal |
revenue_cpm | 1.0 | Receita em CPM, igual a receita_decimal * 1 000 |
mediation_country | EUA | País do prestador de serviços de mediação, nos códigos ISO de dois caracteres que identificam os países, por exemplo, US |
ad_unit_id | 09807a44b2f855cc | ID do bloco de anúncios comunicada pela rede vencedora |
ad_format | banner | Formato do bloco de anúncios: banner, mrec, xpromo, native, leaderboard/leader, interstitial/inter, rewarded/reward, rewarded_inter/rewarded_interstitial |
precision | BID | O valor transmitido por intermédio de um intermediário indica a origem da receita, como BID, CPM, RATE |
creative_id | 9299584 | Valor transmitido por mediação, |
placement | Banner123 | Valor transmitido por mediação para o nome da posição publicitária definida pelo editor |
network_placement | Nome do banner | Nome do espaço publicitário da rede de publicidade externa |
auction_id | 27d38ef0-847c-11ec-8b8d-3fe5d30476ca_765960010 | Valor transmitido por mediação |
Exemplo de pedido #
JSON
curl -X POST https://track.tenjin.com/v0/ad_impressions/ -H "Content-Type: application/x-www-form-urlencoded" -d 'api_key=api_key&advertising_id=123&ad_revenue_mediation=max&network_name=google&mediation_country=US¤cy=USD&ad_unit_id=1&ad_format=banner&revenue_decimal=0.01&precision=BID&creative_id=2&placement=banner_1&auction_id=3&bundle_id=com.tenjin.test&platform=ios&ad_user_data=1&ad_personalization=1'