Fly-EC

  • Fly-EC is one of the tracking systems used by A8.net
  • When an end user clicks on an advertisement on an affiliate site, a request is first sent to A8's servers. A8's tracking system then redirects this request along with some parameters identifying the affiliate to the merchant's site.
  • The merchant must store this data until the end user completes the purchase / registration.
  • The data can be stored in a browser cookie, database or by some other means determined by the merchant.
  • The parameter may be more than 256 bytes in length
  • At the time of purchase / registration completion the merchant must send the identification information to A8's servers via HTTPS request.

Sending Results Data

Data is sent using one of the following formats of tags.

Without type specification:

https://px.a8.net/a8fly/earnings?a8={Identification Parameter}&pid=s00000000062001&so={Order Number}&si={Item Price}-{Item Count}-{Total Value}-{Item Code}&currency={Currency Code}

With type specification: https://px.a8.net/a8fly/earnings?a8={Identification Parameter}&pid=s00000000062001&so={Order Number}&si={Item Price}-{Item Count}-{Total Value}-{Item Code}&currency={Currency Code}&type={Response Type}

Parameters

  • a8={Identification Parameter}
    • A unique ID identifying the affiliate.
  • pid={Program ID}
    • A fixed program ID determined by a8.net.
    • Advertisers are notified of their Program IDs by A8.net support.
    • Example: “s00000000062001”
  • so={Order Number}
    • A unique order number generated by the merchant.
    • This number is reported on A8.net as the order number. As the order number is used when confirming or cancelling sales results it is very important that the number be unique.
    • The order number may include alphanumeric characters, hyphens and underscores. All other characters must be URL encoded.
    • The order number may be up to 50 bytes. When an order number is 51bytes or greater all information exceeding the initial 50 bytes is discarded.

  • si={Item Price}-{Item Count}-{Total Price}-{Item Code}
    • The value of the si parameter is actually four separate parameters separated by hyphens.
      • Item Price
        • The price of a single item.
        • The price may be up to 15 characters (8 characters left of the decimal point, 6 characters right of the decimal point and 1 decimal point).
        • Commas may not be used.
      • Item Count
        • The item count may be up to 4 characters.
        • The decimal point may not be used.
        • Commas may not be used.
      • Total Price
        • The total price should be set as {Item Count} * {Item Price}.
        • The price may be up to 15 characters (8 characters left of the decimal point, 6 characters right of the decimal point and 1 decimal point).
        • Commas may not be used.
      • Item Code
        • The item code must be a unique string that identifies the product.
        • The item code may include alphanumeric characters, hyphens and underscores. All other characters must be URL encoded.
        • The item code may be up to 50 bytes. When an item code is 51 bytes or greater all information exceeding the initial 50 bytes is discarded.

  • currency={Currency Code}
    • The currency code must be set as a three letter code (Example: JPY, USD).
    • Please set the currency code to the currency used at the time of purchase.
    • As of December 2016, the following currency codes are supported:
      • AUD
      • CNY
      • EUR
      • GBP
      • JPY
      • KRW
      • USD
    • When the currency parameter is omitted, the currency is automatically treated as JPY.

  • type={Response Format}
    • The type parameter is optional. There are two legal values for the type parameter:
      • type=image
      • type=text
    • When the type parameter is omitted, the response is automatically set to text/plain.
    • When type=text, the response is set to text/plain.
    • When type=image, the response is set to image/plain.

Sending Results Data

Using an img tag

  • The merchant embeds a specially formatted img tag on the order completion / registration completion page of their site.
  • When the type parameter is omitted, the response is automatically set to text/plain.
  • When type=text, the response is set to text/plain.
  • When type=image, the response is set to image/plain.

Example:

<img src="https://px.a8.net/a8fly/earnings?a8=t8cej8BDWwfbIwpO44o8CVpkQDnjkVZ0EwcQJnob3bgDWwcD9wS2oOKwROA0ClMxx&pid=s00000000062001&so=order-flyEc001&si=175.51-1-175.51-a001&si=92.89-2-185.78-a002&currency=USD" width="1" height="1" />

Sending Results Programmatically

While not required, it is also possible to implement a program / script that sends sales results to A8.net. All one needs to do is make an HTTP request to the correct URL.

  • When the type parameter is omitted, the response is automatically set to text/plain.
  • When type=text, the response is set to text/plain.
  • When type=image, the response is set to image/plain.

Example using curl:

curl http://px.a8.net/a8fly/earnings?a8=cETptEiKDY6gaZC8p.yFABCYRE.M_y0YaBw2AGS2_LI2_cyETp-&pid=s00000000062001&so=order-flyEc001&si=175.51-1-175.51-a001&si=92.89-2-185.78-a002&currency=USD&type=image

Responses

  • When the type parameter is omitted from the request, the response is automatically set to text/plain.

  • When the type parameter is specified in the request, the response is set to the corresponding type.

When Using an img Tag

A transparent 1x1 pixel gif image is returned.

When Making a Request From a Program / Script

A code representing the result of the request is returned:

  • 0: Results data was sent and received without error.
  • 1: The URL was incorrectly formatted or it was not possible to match the end user and program ID. Please check that there is no mistake when making the request.
  • 2: It was not possible to decode the parameter used to identify the end user. Please make sure that any parameter values used to identify the end user are correctly stored and submitted.
  • 3: Other Error. Please contact A8.net for details.