2024

Product	Description	Reported on	No longer available from

Image Removed

Partnerships

Platform

Status

title	DEPRECATED

IP Adress of Load Balancer

Ingenious is modernizing its infrastructure to improve reliability and scalability. As a part of this process, we will no longer be supporting the IP address 35.187.117.15 from 08.08.2022 (08 August 2022) on. This does not affect most customers, because the CNAME-DNS-Settings will be updated on our infrastructure automatically. That means that you most likely have to do nothing.

However, if you

hardcoded/limited any traffic in your infrastructure (proxies etc.),
product-data-download,
or any other system

to the deprecated IP-address 35.187.117.15, you need to remove this restriction.

27 Jun 2022

08 Aug 2022

Image Removed

Insights

Status

title	DEPRECATED

Conversion Model: Trail and Finance

Both conversion models are now combined by our new single conversion model.

New models:

i19s-insights.insights.insights_conversion (replaces i19s-insights.insights.finance_conversion and i19s-insights.insights.trail_conversion)

Renaming:

i19s-insights.insights.platform_performance -> i19s-insights.insights.insights_performance
i19s-insights.insights.platform_performance_billing -> i19s-insights.insights.insights_performance_billing
i19s-insights.insights.platform_performance_billing_vcas -> i19s-insights.insights.insights_performance_billing_vcas

Deletions:

These models are deprecated and will be removed from public access

i19s-insights.insights.finance_conversion
i19s-insights.insights.trail_conversion
i19s-insights.insights.finance_conversion_cnt
i19s-insights.insights.trail_conversion_cnt

We strongly recommend to migrate your reporting to the new model. In order to make it easier, we provided the documentation for the new conversion model in the Knowledge Base https://app.getresponse.com/click.html?x=a62b&lc=SO0xwa&mc=Jf&s=AwlN2F&u=GyCSr&z=EE0QwEh& as well as several example SQL queries Querying

Advantages:

Instead of two separate perspectives from Trail and Finance, you will now be able to consume one single conversion data structure, combining the best from both sides.

The complete customer journey including not attributed touch points

One list of positions which is used for eCommerce and simple conversions, containing all commercial data like revenue, quantity, discount, shipping, tax as well tracking categories and position status

Dedicated status for attribution and rating

Dedicated lists for free parameters on conversions and touch points

01 May 2022

22 May 2022

Image Removed

Creatives

Status
title DEPRECATED
Product Data Export endpoint and functionality deprecation

Uncompressed download of feeds will no longer be available.
The new default value for the parameter compression when no value is supplied is now GZIP.
The old endpoint export.xxx.xxx/{API_KEY}/productdataexport_{feed_id} will no longer be supported the new endpoint can be found in the API documentation.
The format JSON will no longer be available

What do I need to do?

API Endpoint change

Share the following description on how to change to the new API with your partners and let them know that the old endpoint will no longer be available after 30 Apr 2022

Parameter changes:

The API-Key is now a query parameter named apiKey not a path parameter
The feed ID is now a query parameter named feedId and not part of a path parameter
The Adspace parameter was renamed: pid → adspaceId
The parameter format now takes the values: CSV|XML
The parameter for csv separator was renamed: sep → csvSeparator and takes the values: SEMICOLON|COMMA|TAB
The parameter compression now takes the values: GZIP|ZIP
The parameter columns has not changed
The parameters smc1 to smc6 were renamed to subId1 to subId6

Old Link:

Info
https://export.{your_domain}/{api_key}/api/productdataexport_{feed_id}?pid={adspace_id}&format={csv\|xml}&sep={semicolon\|comma\|tab}&compression={gz\|zip\|none}&columns={your_columns}&smc1={subId1}&smc2={subId2}&smc3={subId3}&smc4={subId4}&smc5={subId5}&smc6={subId6}

New Link:

Info
https://api.{your_domain}/creatives/productdata/export?apiKey={api_key}&feedId={feed_id}&adspaceId={adspace_id}&format={CSV\|XML}&csvSeparator={SEMICOLON\|COMMA\|TAB}&compression={GZIP\|ZIP}&columns={your_columns}&subId1={subId1}&subId2={subId2}&subId3={subId3}&subId4={subId4}&subId5={subId5}&subId6={subId6}

Example:

Old Link:

Info
https://export.demo.i19s.com/21c683e1-7c3b-5884-9ce9-7c2db4da5419/api/productdataexport_1234?pid=9876&format=csv&sep=semicolon&compression=gz&columns=product_id,product_name,product_price&smc1=82zz11

Info
https://api.demo.i19s.com/creatives/productdata/export?apiKey=21c683e1-7c3b-5884-9ce9-7c2db4da5419&feedId=1234&adspaceId=9876&format=CSV&csvSeparator=SEMICOLON&compression=GZIP&columns=product_id,product_name,product_price&subId1=82zz11

Compression

No action is required if your partners use zip or gzip compressed downloads.
If your partners use the default value for the query parameter compression (by not specifying it in the download-URL), your partner will receive compressed feeds after 30 Apr 2022. Your partners should be informed about this.

Rate Limiting

Inform your partner about the new, reduced rate-limits, but also about the new ways to Download feeds efficiently and with low latency using Conditional Downloading with ETag and Last-Modified header.

No more JSON format support

Inform your partner, that the format JSON is no longer available so they have to switch to one of the other available formats (CSV or XML)

15 Mar 2022

30 Apr 2022

Image Removed

Creatives

Product Data Export rate limit changes

Rate limiting will be more strict for uncompressed downloads to further emphasize on the additional bandwidth these downloads produce. Read the partner documentation for downloading feeds for more details.

07 Mar 2022

10 Mar 2022

Image Removed

I ntegrations

Status
title DEPRECATED
GoogleAds/AdWords Importer

The AdWords/GoogleAds Cost importer will be removed because of rare usage. We propose to use a full-fledged Cost importer tool like funnel.io, adverty, affluent.io.

01 Jan 2022

15 Feb 2022

Image Removed

Finance

Status
title DEPRECATED
Discount rating in Commission Model

The usage of a submitted Discount Value (dsv) does not need to be controlled by an additional flag. We will remove this flag from the Commission model. All submitted Discount Value (dsv) will be applied to the Commission and Fee calculation.

17 Nov 2021

17 Jan 2022

Image Removed

Trail

Status
title DEPRECATED
Discounted Order Value (discOrdValue)

This parameter is going to be removed from the Conversion Tag. The idea of having an additional parameter parallel to Discount Value (dsv) was misleading.

17 Nov 2021

17 Jan 2022

Image Removed

Insights

In the past, we have built a data warehouse (ingenious-169318). Due to continuous improvements, we will replace the old DWH with a new variant based on a modern and flexible technology (i19s-insights). Please migrate your dependencies to the new DWH. Please use the migration path provided and contact support or the Insights team if you have any problems.

15 Aug 2021

15 Dec 2021

Image Removed

Creatives

Status
title DEPRECATED
Legacy Ad-Media Management

The legacy Ad-Media Management is deprecated in favour to the new Creatives Manager and Creatives Explorer.

Some Admedia-Types are not yet supported in the new Creatives system. For these types we will continue supporting them in the legacy system:

HTML Ad-Media (with Link-Replacement logic)
Adjust Ad-Media

All other types (remote/hosted images, text, …) will not be shown or be editable in the Ad-Media Manager.

31 Jul 2021

25 Nov 2021

Image Removed

Partnerships

Status
title DEPRECATED
The Masterdata API and the Registration API have been deprecated.

Currently we do not have replacements for all endpoints in those APIs.

The mentioned APIs will be kept available until we have replacements for all endpoints, and a migration plan.

04 Mar 2021

15 Nov 2021

Image Removed

Partnerships

Status
title DEPRECATED
/v2 prefix in masterdata API calls

The /v2 Prefix in masterdata API calls is not available anymore. Please use the non-prefixed url. For example:

https://<YOUR-CUSTOM-API-URL>/masterdata/category/adspace?apiKey=<API-KEY>

28 Feb 2021

Image Removed

Partnerships

Status
title DEPRECATED
Partner ui program list

The Programs menu point in the Partner UI will be deleted in favour of the new Advertiser Explorer. Please switch to the new feature by the 1st of march 2021. If you don’t do it yourself it will be switched over automatically by this date.

01 Feb 2021

01 Mar 2021

The status param for relationship has been removed from /partnerships/partner/create command. Any new partner will be created with an relationship that is status activated.

Please remove the status param from your API request.

/partnerships/partner/create

Code Block

{
  "commandId": "73a922f2-556b-460c-9352-5a91e9994146",
  "comment": "string",
  "eventDateTime": "1970-01-01T00:00:00.000Z",
  "adspace": {
    "categoryId": "string",
    ...
  },
  "partner": {
    "address": "AAAAAA",
    "billingData": {},
    "city": "AAAAAA",
    ...
  },
  "relationship": {
    "adspaceId": "55632",
    "advertiserId": "8134",
    "commandId": "73a922f2-556b-460c-9352-5a91e9994146",
    "comment": "string",
    "commissionModelId": "12345",
    "commissionRuleId": "12345",
    "eventDateTime": "1970-01-01T00:00:00.000Z",
    "feeModelId": "12345",
    <<REMOVED FIELD status>>
    "type": "CreateRelationship"
  }
}

15th of January 2024

2023

Please see ⚡ Deprecations 2023

2022

Please see ⚡ Deprecations 2022

Versions Compared

Old Version 57

New Version Current

Key