Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Product

Description

Reported on

No longer available from

Insights

Status
titleDEPRECATED
Conversion Model: Trail and Finance

Both conversion models are now combined by our new single conversion model. Because of that, no new conversions will be added to the dedicated trail and finance model. Both will be removed.


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

Creatives

Status
titleDEPRECATED
Product Data Export endpoint and functionality deprecation

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

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: pidadspaceId

  • The parameter format now takes the values: CSV|XML

  • The parameter for csv separator was renamed: sepcsvSeparator 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 . Your partners should be informed about this.

Rate Limiting

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)

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.

Integrations

Status
titleDEPRECATED
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.

Finance

Status
titleDEPRECATED
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.

Trail

Status
titleDEPRECATED
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.

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.

Creatives

Status
titleDEPRECATED
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.

Partnerships

Status
titleDEPRECATED
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.


Partnerships

Status
titleDEPRECATED
/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>

Partnerships

Status
titleDEPRECATED
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.

...