/
[External Custom Field] Map and transfer data into Google Ad Manager

[External Custom Field] Map and transfer data into Google Ad Manager

Step-by-step guide

  1. Navigate to your Google Ad Manager AdServer Login, edit the page layout, and display the related list "External Custom Fields" and save the layout.

  2. At the related list "AdServer Custom fields", click on the button "New".


      

  3. Enter the following information for the new record:

    a. Select the Custom Field Name as desired.

    b. The Custom Field ID can be grabbed from the URL (see next screenshot).

    c. Enter in Data Field Path the API field name as described in the fields Helptext, e.g. ADvendio__Campaign_Item__c.YourCustomField__c





Enter the field path for getting the data being set to the custom field in the Ad server.
The path must start with an object API name. Currently only "Media Campaign" (ADvendio__Media_Campaign__c) or "Campaign Item" (ADvendio__Campaign_Item__c) are supported as objects.
Example: ADvendio__Media_Campaign__c.ADvendio__Industry_category__c

  1. How to find the custom field ID in Google Ad Manager

    a. Click on Admin and Global Settings.

    b. Click on the Custom fields Tab and then create a new custom field or click on the name of an existing custom field.

    c. Copy/grab the ID of the custom field out of the URL.



Until version 2.108: only location = Order and location = Line Item are supported.

Version 2.109 and up: location = Proposal and location = Proposal Line Item are also supported.

To map the standard field PO Number please take a look here: 7.3.12.2 Transfer Offer number and Advertiser External ID to Google Ad Manager

 


Warning/Error handling cases

  1. In case a Custom Field in GAM does not exist, is inactive, or invalid (e.g. wrong ID) the submit process will continue without setting the field. A warning message would be shown, stating:
    'Warning : External Custom Field "name/ID" has not been found in the target platform. Submit has been done without the custom field.'

If the path is invalid or the field is not being set: Continue the submit process as usual. A warning message would be shown, stating:
‘Warning: No Value was set for Custom Field 'NAME/ID’

If the appendix __c is missing, an error of the whole relation of the object will appear with the corresponding Query. To fix this issue, make sure that all the objects in the path has the __c appendix.



🔐 Required Permissions: Updating Custom Fields

To successfully submit or update Custom Fields via the ADvendio, your Google Ad Manager (GAM) user account must have the appropriate permission levels. Without these, the Custom Field won't be successfully submitted/ updated.

In Google Ad Manager there is a specific permission for managing custom fields, but it’s not called “custom field permission” directly. It’s controlled through broader Admin permissions.

Permission required

To create or edit custom fields, a user typically needs:

  • Admin → Global settings → Edit

    • This permission allows managing Custom Fields and other global configurations.