Skip to main content
These tools use the Google Ads connection. See Google Ads. Reads that pick an existing audience or conversion action are search_google_audiences and get_google_conversion_actions.

​
Customer Match list

create_google_customer_match_user_list is the audience create this server runs locally. Required arguments are account_id and name. Optional arguments are description, upload_key_type, data_source_type, and membership_life_span. upload_key_type is CONTACT_INFO, CRM_ID, or MOBILE_ADVERTISING_ID. If you omit it, the adapter uses CONTACT_INFO. data_source_type is FIRST_PARTY. If you omit membership_life_span, the adapter uses 540. The list is created with membership status OPEN. A successful local call returns created and user_list_resource_name. Set execution_mode to approval_required when this create should wait. That mode stages any create_google_* call in Approvals and does not call Google in that request. Omitting the mode creates the list on this request.

​
Approved execution

These catalog tools have adapter methods. A plain tools call is not the local Customer Match branch above. They run when an approved action executes them. create_google_* names can be staged first by setting execution_mode to approval_required. Uploads, attaches, removals, and bidding updates do not use that prefix, so that mode does not stage them. TARGET_ROAS needs target_roas greater than 0. Otherwise the adapter returns no change. A click conversion row is kept only when it has conversion_action and conversion_date_time. Optional row fields are gclid, gbraid, wbraid, conversion_value, currency_code, order_id, user_identifiers, and consent. Member upload does not hash a raw email or phone. A member without one of the identifier fields above is dropped. If every member is dropped, the adapter returns no change.