Introducing Dynamic Product Ads

use FacebookAds\Object\ProductCatalog;
use FacebookAds\Object\Fields\ProductCatalogFields;
use FacebookAds\Object\ProductFeed;
use FacebookAds\Object\Fields\ProductFeedFields;
use FacebookAds\Object\Fields\ProductFeedScheduleFields;
use FacebookAds\Object\ProductSet;
use FacebookAds\Object\Fields\ProductSetFields;

// Step 1:  Create a Product Catalog
$catalog = new ProductCatalog(null, '<BUSINESS_ID>');
$catalog->setData(array(
ProductCatalogFields::NAME => 'My Catalog',
));
$catalog->save();

// Step 2:  Schedule the Feed
$feed = new ProductFeed(null, $catalog->id);
$feed->setData(array(
ProductFeedFields::NAME => 'My Daily Feed',
ProductFeedFields::FILE_NAME => 'products.xml',
ProductFeedFields::SCHEDULE => array(
ProductFeedScheduleFields::INTERVAL => 'DAILY',
ProductFeedScheduleFields::URL =>
'http://www.jaspers-market.com/products.xml',
ProductFeedScheduleFields::HOUR => 22
)
));
$feed->save();

// Step 3:  Create a Product Set (a set of products to advertise)
$product_set = new ProductSet(null, $catalog->id);
$product_set->setData(array(
ProductSetFields::NAME => 'All Products',
ProductSetFields::FILTER => array()
));
$product_set->save();

// Step 4:  Associate the catalog with a Website Custom Audience Pixel
$catalog->setExternalEventSources(array('<PIXEL_ID>'));

use FacebookAds\Object\Fields\ProductAudienceFields;
use FacebookAds\Object\ProductAudience;

$audience = new ProductAudience(null, 'act_<ACCOUNT_ID>');
$audience->setData(array(
ProductAudienceFields::NAME => 'Product Audience',
ProductAudienceFields::PRODUCT_SET_ID => '<PRODUCT_SET_ID>',
ProductAudienceFields::PIXEL_ID => '<PIXEL_ID>',
ProductAudienceFields::INCLUSIONS => array(array(
ProductAudienceFields::RETENTION_SECONDS => 86400,
ProductAudienceFields::RULE => array(
'event'=>array('eq'=>'ViewContent')
)
)),
ProductAudienceFields::EXCLUSIONS => array(array(
ProductAudienceFields::RETENTION_SECONDS => 172800,
ProductAudienceFields::RULE => array(
'event' => array('eq'=>'Purchase')
)
))
));
$audience->save();

use FacebookAds\Object\AdCampaign;
use FacebookAds\Object\Fields\AdCampaignFields;
use FacebookAds\Object\AdSet;
use FacebookAds\Object\Fields\AdSetFields;
use FacebookAds\Object\Values\AdObjectives;
use FacebookAds\Object\Values\BidTypes;
use FacebookAds\Object\Fields\AdGroupBidInfoFields;
use FacebookAds\Object\TargetingSpecs;
use FacebookAds\Object\Fields\TargetingSpecsFields;

// Ad Campaign with the Product Catalog as the promoted object 
$campaign = new AdCampaign(null, 'act_<ACCOUNT_ID>');
$campaign->setData(array(
AdCampaignFields::NAME => 'DPA Campaign',
AdCampaignFields::OBJECTIVE => AdObjectives::PRODUCT_CATALOG_SALES,
AdCampaignFields::PROMOTED_OBJECT => 
array('product_catalog_id' => '<PRODUCT_CATALOG_ID>')
));
$campaign->save();

// Targeting Spec using our Dynamic Audience
$targeting = new TargetingSpecs();
$targeting->{TargetingSpecsFields::GEO_LOCATIONS} =
array('countries' => array('US'));
$targeting->{TargetingSpecsFields::DYNAMIC_AUDIENCE_IDS} =
array('<DYNAMIC_AUDIENCE_ID>');

// Ad Set with a Product Set as promoted object
$adset = new AdSet(null, 'act_<ACCOUNT_ID>');
$adset->setData(array(
AdSetFields::NAME => 'DPA Ad Set',
AdSetFields::BID_TYPE => BidTypes::BID_TYPE_CPC,
AdSetFields::BID_INFO => 
array(AdGroupBidInfoFields::CLICKS => 150),
AdSetFields::DAILY_BUDGET => 2000,
AdSetFields::CAMPAIGN_GROUP_ID => $campaign->id,
AdSetFields::TARGETING => $targeting,
AdsetFields::PROMOTED_OBJECT =>
array('product_set_id' => '<PRODUCT_SET_ID>')
));
$adset->save();

use FacebookAds\Object\AdCreative;
use FacebookAds\Object\ObjectStory\TemplateData;
use FacebookAds\Object\ObjectStorySpec;
use FacebookAds\Object\Values\CallToActionTypes;
use FacebookAds\Object\Fields\ObjectStory\TemplateDataFields;
use FacebookAds\Object\Fields\AdCreativeFields;
use FacebookAds\Object\Fields\ObjectStorySpecFields;
use FacebookAds\Object\AdGroup;
use FacebookAds\Object\Fields\AdGroupFields;
use FacebookAds\Object\Values\AdObjectives;

// Creative template to be dynamically rendered with product data
$template = new TemplateData();
$template->setData(array(
TemplateDataFields::DESCRIPTION => '{{product.description}}',
TemplateDataFields::LINK => 'http://jaspers-market.com/',
TemplateDataFields::MESSAGE => 'Jasper\'s is more than just groceries.  You can now find all of your cooking tools and utensils on our website',
TemplateDataFields::NAME => '{{product.name | titleize}}',
TemplateDataFields::MAX_PRODUCT_COUNT => 3, // enable Multi-Product Ads
TemplateDataFields::CALL_TO_ACTION => array(
'type' => CallToActionTypes::SHOP_NOW
)
));

$story = new ObjectStorySpec();
$story->setData(array(
ObjectStorySpecFields::PAGE_ID => '<PAGE_ID>',
ObjectStorySpecFields::TEMPLATE_DATA => $template,
));

// Ad creative is tied to a specific Product Set
$creative = new AdCreative(null, 'act_<ACCOUNT_ID>');
$creative->setData(array(
AdCreativeFields::NAME => 'DPA Creative 1',
AdCreativeFields::OBJECT_STORY_SPEC => $story,
AdCreativeFields::PRODUCT_SET_ID => '<PRODUCT_SET_ID>'
));
$creative->save();

// Ad Group using the PRODUCT_CATALOG_SALES objective
$adgroup = new AdGroup(null, 'act_<ACCOUNT_ID>');
$adgroup->setData(array(
AdGroupFields::NAME => 'DPA Ad 1',
AdGroupFields::CAMPAIGN_ID => '<AD_SET_ID>', // $adset->id from earlier
AdGroupFields::CREATIVE =>
array('creative_id' => $creative->id),
AdGroupFields::OBJECTIVE => AdObjectives::PRODUCT_CATALOG_SALES
));
$adgroup->save();