CreateCtwaAdRequestPlacements.md

CreateCtwaAdRequestPlacements

Manual ad placements on the shared ad set. Omit for automatic placements. When set, restricts delivery to the chosen surfaces, mapped onto the ad set's targeting.{publisher_platforms, facebook_positions, instagram_positions, messenger_positions, audience_network_positions, threads_positions, whatsapp_positions, device_platforms}. Enum membership is validated here; Meta additionally enforces co-selection rules and restricts which placements are eligible for click-to-WhatsApp ads, returning an actionable error which we surface.

Properties

Name	Type	Description	Notes
publisherPlatforms	List<PublisherPlatformsEnum>	Top-level platforms to deliver on. A position field below is only honoured when its parent platform is included here.	[optional]
facebookPositions	List<FacebookPositionsEnum>		[optional]
instagramPositions	List<InstagramPositionsEnum>		[optional]
messengerPositions	List<MessengerPositionsEnum>		[optional]
audienceNetworkPositions	List<AudienceNetworkPositionsEnum>		[optional]
threadsPositions	List<ThreadsPositionsEnum>		[optional]
whatsappPositions	List<WhatsappPositionsEnum>		[optional]
devicePlatforms	List<DevicePlatformsEnum>	Restrict by device. Omit to deliver on both mobile and desktop.	[optional]

Enum: List<PublisherPlatformsEnum>

Name	Value
FACEBOOK	"facebook"
INSTAGRAM	"instagram"
THREADS	"threads"
MESSENGER	"messenger"
AUDIENCE_NETWORK	"audience_network"
WHATSAPP	"whatsapp"

Enum: List<FacebookPositionsEnum>

Name	Value
FEED	"feed"
RIGHT_HAND_COLUMN	"right_hand_column"
MARKETPLACE	"marketplace"
VIDEO_FEEDS	"video_feeds"
STORY	"story"
SEARCH	"search"
INSTREAM_VIDEO	"instream_video"
FACEBOOK_REELS	"facebook_reels"
FACEBOOK_REELS_OVERLAY	"facebook_reels_overlay"
PROFILE_FEED	"profile_feed"
NOTIFICATION	"notification"

Enum: List<InstagramPositionsEnum>

Name	Value
STREAM	"stream"
STORY	"story"
EXPLORE	"explore"
EXPLORE_HOME	"explore_home"
REELS	"reels"
PROFILE_FEED	"profile_feed"
IG_SEARCH	"ig_search"
PROFILE_REELS	"profile_reels"

Enum: List<MessengerPositionsEnum>

Name	Value
MESSENGER_HOME	"messenger_home"
SPONSORED_MESSAGES	"sponsored_messages"
STORY	"story"

Enum: List<AudienceNetworkPositionsEnum>

Name	Value
CLASSIC	"classic"
REWARDED_VIDEO	"rewarded_video"

Enum: List<ThreadsPositionsEnum>

Name	Value
THREADS_STREAM	"threads_stream"

Enum: List<WhatsappPositionsEnum>

Name	Value
STATUS	"status"

Enum: List<DevicePlatformsEnum>

Name	Value
MOBILE	"mobile"
DESKTOP	"desktop"