Entities

An entity is the actual thing being advertised (product, hotel, restaurant, etc.). Entities with bids are referred to bidders in the Delivery + Collections API reference.

To get a list of all entities in an ad group, use Reports with the appropriate query parameters.

POST advertisers/{advertiserId}/entities/report will get you all the entities assigned to an advertiser.

Endpoints

MethodPathDescription
POSTmember_groups/
{memberGroupId}
/entities/{entityId}
/bid_strength
This endpoint calculates a new bid strength with a given new bid for an entity.
POST/member_groups
/{memberGroupId}
/advertisers
/{advertiserId}
/entity_registrations
/initiate
This endpoint can be used to add bidders to an account.
POST/member_groups
/{memberGroupId}
/advertisers
/{advertiserId}
/entity_registrations
/failed
/report
This endpoint returns a report for failed instances of attempting to add bidders to an account.

Note: No body is necessary to run this endpoint.
DELETEmember_groups/{memberGroupId}
/advertisers/{advertiserId}
/entities
This endpoint deletes a list of entities from an advertiser