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».
Nota: A integração servidor a servidor não é uma funcionalidade padrão para todos os clientes da Tenjin. Se pretender ser incluído na lista de autorizações para esta funcionalidade, contacte o seu gestor de conta da Tenjin.
Ponto final genérico #
Caminho: https://track.tenjin.io/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 | O ID de publicidade bruto do dispositivo. Tenha em atenção que o pedido só será aceite se for apresentado um ID de dispositivo válido (pode ser o advertising_id, o developer_device_id ou o analytics_installation_id). É importante manter a consistência na utilização dos tipos de ID de dispositivo. Para iOS, deve ser o IDFA. Caso não haja consentimento do utilizador, o «advertising_id» pode estar vazio ou conter apenas zeros, e o IDFV deve ser fornecido no «developer_device_id», juntamente com o «analytics_installation_id» Para o Android, deve ser fornecido o «advertising_id» ou o «analytics_installation_id». |
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 | A versão da sua aplicação Para Android: String app_version = context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionName + “.” + context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionCode) Para 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'