Branded Sign-up Service

Parameter Name

Req?

Description

preferredLanguage

Yes

This parameter defines the language in which the sign-up page displays. You may obtain the currently accepted languages by calling one of the Support Services.

Note: Provide this parameter value as lowercase letters.

country

Yes

The two-letter ISO-3166 code for the country from which the publisher originates. You may obtain the currently accepted countries by calling one of the Support Services.

Note: Provide this parameter value as all capital letters.

funcCurrency

Yes

The publisher’s functional currency. Specify one of the following values.

Note: Provide this parameter value as all capital letters.

• CAD &endash; Canadian Dollar

• EUR &endash; Euro

• GBP &endash; British Pound Sterling

• USD &endash; United States Dollar

redirect

No

The URL to which you wish to send the publisher after sign-up.

Note: Any valid URL is a valid redirect value. Attempting to pass an invalid redirect value or omitting this parameter redirects to the default result pages. These pages are basic (i.e., no branding) in functionality.

Commission Junction appends the action= parameter to the end of this URL when redirecting the user, indicating the result of the sign-up request. Depending on the particular scenario, this parameter may have any of the following values.

Failure Before Sign-up

The action= parameter has one of the following values if an error occurs before the user views the sign-up form.

• FAIL_SIGNUP_ACTION: Commission Junction Server configuration error.

• NO_ACCESS: Commission Junction Server configuration error.

• INVALID_LOCALIZATION_PARAMS: Invalid localization parameters (either preferredLanguage, country or funcCurrency).                       

• FAIL_SIGNUPFORM: Error during XSL transformation.

Failure After Sign-up

The action= parameter has one of the following values if an error occurs after the user submits the sign-up form.

• FAIL_EMAIL: Sign-up successful. Error emailing password.

• FAIL_JOIN: Sign-up successful. Email successful. Error joining default advertiser program.

Successful Sign-up

The action= parameter has the following value if no error occurs before, during or after sign-up.

• SUCCESS: Sign-up, email and program join successful.

air_refmerchantid

Yes

The Commission Junction account ID of the advertiser with whom the publisher is establishing a relationship.

Example: 57108

xslt

Yes

The URL of the XSLT file for the Sign-up page. Typically, the advertiser must host the XLST file on their own server.

Note: If you do not provide an XSLT file, the system uses a simple default transform that provides no branding.

xsltEmail

Yes

The URL of the XSLT file for the Confirmation Email. Typically, the advertiser must host the XLST file on their own server.

Note: If you do not provide an XSLT file, the system uses a simple default transform that provides no branding.

subjectEmail

Yes

The text which appears in the subject line of the Confirmation Email.

Example: <Congratulations! You are accepted to the Commission Junction joined publisher program.>

signature

Yes

The signature parameter enables the advertiser to digitally sign their sign-up requests. The value of the signature parameter is an encoded string created with the following formula.  

$x = value of parameter x.

signature = hex-encode(MD5 hash of ($preferredLanguage + $country + $funcCurrency + $air_refmerchantid + $redirect + $xslt + $xsltEmail + $subjectEmail + $advertiser_key))

The &advertiser_key variable in the formula above represents the developer key obtained from the Web Services Developer Site (webservices.cj.com).