Skip to end of metadata
Go to start of metadata

October 30, 2019 - Insertion Order Service - Breaking Change Notice - Xandr API

As part of our continued efforts to offer an intuitive and easy-to-use platform, we are pleased to announce a new verification workflow to support political advertising. Political advertising is defined as advertising relating to elections, ballot initiatives, or political candidates in the United States.

The verification workflow, available October 30, 2019, is accompanied by an update to our Political Advertising Policy, effective November 7, 2019. In short, Xandr requires that all political advertising initiatives comply with applicable law. To encourage and promote transparency in political advertising in the United States, we now also require that you certify certain information about the ads and the political organization that purchased them. To ensure collection of this information, when you have specified that an advertiser conducts political advertising, new fields are required in the Insertion Order Service. The policy update and verification workflow do not affect political advertising initiatives outside of the United States; when advertising outside of the United States, buyers are still required to comply with our Policies for Buying.

Because this is a breaking change for the Xandr API, we will support two versions of the API for the next 60 days, as stated in our Breaking Changes policy. The new political advertising workflow, including changes to the Advertiser Service and the Insertion Order Service and the implementation of the new Registration Form Service, is available starting today, October 30, 2019. The final changeover date is January 2, 2020

Breaking Change Timeline

Changes will occur in the following phases:

Breaking Change Period  (October 30, 2019 - January 2, 2020)

 You can use the verification workflow to conduct political advertising. This involves the following new fields and service:

However, validation rules for creating insertion orders with the required political_content fields will not yet be enforced.

For more information on the new workflow, see Introduction to Political Advertising.

General Release (January 2, 2020)

If is_running_political_ads is true on the Advertiser object, the required fields in the political_content array are mandatory while creating or updating insertion orders.

Updated Services

Advertiser Service

The Advertiser Service now contains a new boolean field, is_running_political_ads, which specifies whether or not this advertiser conducts political advertising (advertising related to an election, ballot initiative, or political candidate) in the United States. If true, the political_content array on the Insertion Order Service is required.

Insertion Order Service

The Insertion Order Service contains a new array, political_content, which contains information about political advertising conducted with this insertion order. Political advertising must be enabled on the Advertiser Service for this array to be editable. If political advertising is enabled on the Advertiser object, this field is required. 

Political Content Array

This array will only be editable if is_running_political_ads is true on the Advertiser Service. These fields must be filled out if you are using this insertion order for advertising related to an election, ballot initiative, or political candidate in the United States.

Field

Type

Description

billing_name

 stringRead-only. The name of the person or organization that is purchasing ads on Xandr. This will be automatically filled out with the name of the Xandr member.
billing_address_1 string(255)Required. The street address for the person or organization that is purchasing ads on Xandr.
Default value: member billing address
Enter the contact details for the person or team who can best answer any questions about political advertising on this insertion order.
billing_address_2 string(255)

Optional additional line for the billing address for the person or organization that is purchasing ads on Xandr.

billing_city string(100)

Required. City of the billing address for the person or organization that is purchasing ads on Xandr.

Default value: member city

billing_region string(50)

Required. State or region of the billing address for the person or organization that is purchasing ads on Xandr.

Default value: member region

billing_postal_code string(50)

Required. ZIP or postal code of the billing address for the person or organization that is purchasing ads on Xandr.

Default value: member postal code

billing_country string(50)

Required. Country of the billing address for the person or organization that is purchasing ads on Xandr. Country code must be specified with the 3-letter country code. See Country Service for more information.

Default value: member country

billing_phone_code string(10)

Required. Country code for the phone number for the person or organization that is purchasing ads on Xandr.

Default value: member phone code

billing_phone string(50)

Required. Contact phone number for the person or organization that is purchasing ads on Xandr.

Default value: member phone

us_fecid string(50)Required. ID number assigned by the U.S. Federal Election Committee.
organization_name string(100)Required. Name of the person, group, organization, or business that is advertising (the client that is paying you). For example, a candidate, an agency, or a political consultant.
organization_address_1 string(255)Required. Address of the person, group, organization, or business that is advertising. For example, a candidate, an agency, or a political consultant.
organization_address_2 string(255)Optional second line for the address of the person, group, organization, or business that is advertising.  
organization_citystring(100)Required. City in the address of the person, group, organization, or business that is advertising.  
organization_regionstring(50)Required. State or region in the address of the person, group, organization, or business that is advertising.  
organization_postal_codestring(50)Required.  ZIP or postal code of the person, group, organization, or business that is advertising.  
organization_countrystring(50)Required. Country of the person, group, organization, or business that is advertising.  
organization_phone_codestring(10)Required. Country code for the phone number of the person, group, organization, or business that is advertising.
organization_phonestring(50)Required. Phone number of the person, group, organization, or business that is advertising.
treasurer_name string(100)Required. Treasurer for the committee purchasing the ads. 
payment_method_type enum(1)

Required. How the political organization pays you. Options are:

  • "Direct Debit"
  • "Check"
  • "Credit Card"
  • "Other". If this is selected, payment_method_other is required.

political_objective

 string(255)Required. The candidate or ballot initiative that is supported or opposed.
payment_method_other string(50)Required if "4" (Other) is selected for payment_method_type. Details of how you are being paid for political advertising. 
is_independent_expenditure_committee Boolean

Required. Specifies whether any ads are being paid for by an independent expenditure committee: That is, a third party that spends money on political communications that expressly advocate the election or defeat of a clearly identified candidate and does not coordinate with a candidate, a candidate’s authorized committee, or an agent of the candidate.

registration_form array

Required for NY and NJ. New York State and New Jersey require copies of state registration forms from independent expenditure committees making purchases. Creatives won’t serve in New York State or New Jersey until the form is uploaded. Forms must be uploaded with the Registration Form Service before their location can be specified in this array.

The array must be in the format:


is_accuracy_acknowledgedBooleanRequired. Specifies that the Xandr member has certified that the political_content information provided is accurate and up-to-date and that Xandr is relying on the accuracy of the information provided. This is null by default and may be set to 0 or 1. If set to 0, creatives will not be allowed to serve.

Registration Form Service

You use the Registration Form Service to upload the registration forms required by New York State and New Jersey from independent expenditure committees making purchases. Creatives won’t serve in New York State or New Jersey until the form is uploaded. Once the form is uploaded, you must update the insertion order with the location of the uploaded form. 

Field

Type

Description

member_id

int

The ID of the member.

file_pathintThe location to which the file is uploaded. This is returned in the response and cannot be specified when uploading the file.
 

Related UI Documentation

  • No labels