ePrivacy and GPDR Cookie Consent by Cookie Consent Skip to main content

Loader Google Ads Customer Match Audience

The Google Ads Customer Match Audience Loader extracts data from a supplied CSV table to create a custom anonymous audience within Google Ads Audiences.

Requirements

To use the loader client_id and client_secret should be set in the OAuth repo. 

Learn more: about client_id and client_secret here.

Data In/ Data Out

Data In

The loader requires a CSV file in the directory /data/in/tables/imports.import.csv


File structure:

first_name,last_name,country_code,postal_code,phone_number,email
John,Doe,US,10011,+1 234 5678910,test@meiro.io

If the list_upload_key_type is not defined or is set to CONTACT_INFO, you must provide at least one of the following identifiers:

  • Email

  • Phone_number

  • Address identifier - if an address is provided, then all of its fields are required:

    • First_name
    • Last_name
    • Country_code
    • Postal_code

If the list_upload_key_type parameter is set to CRM_ID, then a field third_party_user_id is required.

If the list_upload_key_type parameter is set to MOBILE_ADVERTISING_ID, then the CSV file must contain a field mobile_id.


If there are any unknown columns, they will be ignored. An exception is raised if any of the following is true for: 

  • the table schema (i.e. CSV file header);

  • the data (i.e. values in a particular record): if there are no usable fields or an incomplete number of address identifier fields.

Data Out

N/A

Learn more: about the folder structure here.

Parameters

Developer token

(required)

A unique identifier assigned to an application by Google that grants access to the Google Ads API and controls the API usage limits and environment.


Learn more: about how to obtain a developer token

Customer ID

(required)

The Google Ads client account customer ID. Both 123-456-7890 and 1234567890 formats are accepted.


Learn more: about how to find your Google Ads customer ID

Login Customer ID

(optional)

The Manager account ID.

List Membership Life Span

(optional)

The number of days a user's cookie stays on your list since its most recent addition to the list. This parameter can be set to any value between 0 and 540, and the default value is 30. However, for CRM-based user lists, this parameter can be set to 10000, which means no expiration.


Learn more: about mobile advertising IDs and list membership life span parameter here.

List upload key type

(optional)

The matching key type of the list. Mixed data types are not allowed on the same list. Possible values:

  • CONTACT_INFO (default)

  • CRM_ID

  • MOBILE_ADVERTISING_ID

Remember: using this parameter limits the fields available for matching.


Learn more: about Customer Match Upload Key Type and List upload key type parameter.

Learn more: about how to set Google Ads Customer Match Audience in Meiro Business Explorer; how to export segments with Google Ads Customer Match Audience.


Back to top