Facebook Conversion API on WordPress using PixelYourSite

Learn how to send pixel events to Facebook servers bypassing browsers' limitations and ad blockers using PixelYourSite WordPress plugin. Close Weuseinformationcollectedthroughcookiesandsimilartechnologiestoimproveyourexperienceonoursite,analysehowyouuseitandformarketingpurposes.PrivacyPolicy Allowall VerifiedbyConsentMagic Close Yourprivacysettings Weandourpartnersuseinformationcollectedthroughcookiesandsimilartechnologiestoimproveyourexperienceonoursite,analysehowyouuseitandformarketingpurposes.Becausewerespectyourrighttoprivacy,youcanchoosenottoallowsometypesofcookies.However,blockingsometypesofcookiesmayimpactyourexperienceofthesiteandtheservicesweareabletooffer.Insomecases,dataobtainedfromcookiesissharedwiththirdpartiesforanalyticsormarketingreasons.Youcanexerciseyourrighttoopt-outofthatsharingatanytimebydisablingcookies. PrivacyPolicy Allowall ManageConsentPreferences Necessary AlwaysON Thesecookiesandscriptsarenecessaryforthewebsitetofunctionandcannotbeswitchedoff.Theyareusuallyonlysetinresponsetoactionsmadebyyouwhichamounttoarequestforservices,suchassettingyourprivacypreferences,logginginorfillinginforms.Youcansetyourbrowsertoblockoralertyouaboutthesecookies,butsomepartsofthesitewillnotthenwork.Thesecookiesdonotstoreanypersonallyidentifiableinformation. Analytics Thesecookiesandscriptsallowustocountvisitsandtrafficsources,sowecanmeasureandimprovetheperformanceofoursite.Theyhelpusknowwhichpagesarethemostandleastpopularandseehowvisitorsmovearoundthesite.Allinformationthesecookiescollectisaggregatedandthereforeanonymous.Ifyoudonotallowthesecookiesandscripts,wewillnotknowwhenyouhavevisitedoursite. EmbeddedVideos ThesecookiesandscriptsmaybesetthroughoursitebyexternalvideohostingserviceslikeYouTubeorVimeo.Theymaybeusedtodelivervideocontentonourwebsite.It’spossibleforthevideoprovidertobuildaprofileofyourinterestsandshowyourelevantadvertsonthisorotherwebsites.Theydonotstoredirectlypersonalinformation,butarebasedonuniquelyidentifyingyourbrowserandinternetdevice.Ifyoudonotallowthesecookiesorscriptsitispossiblethatembeddedvideowillnotfunctionasexpected. Marketing Thesecookiesandscriptsmaybesetthroughoursitebyouradvertisingpartners.Theymaybeusedbythosecompaniestobuildaprofileofyourinterestsandshowyourelevantadvertsonothersites.Theydonotstoredirectlypersonalinformation,butarebasedonuniquelyidentifyingyourbrowserandinternetdevice.Ifyoudonotallowthesecookiesandscripts,youwillexperiencelesstargetedadvertising. Confirmmychoices Allowall VerifiedbyConsentMagic Home Strategies Videos Articles Contact Cart MyAccount Menu Home Strategies Videos Articles Contact Cart MyAccount PixelYourSiteProfessional Features FacebookPixel GoogleAnalytics GoogleAdsRemarketing ANYScript Changelog Add-ons PinterestTagAdd-On BingTagAdd-On TheSuperPack FacebookConversionAPI(CAPI) VerifyingyourDomainonFacebook HowtoaddthePinterestTag CartFlowsandPixelYourSite ProductCatalogs ProductCatalogFeedforWooCommerce VideoTutorials SmartOpenGraph EasyDigitalDownloadsProductCatalogFeed WordPressFeedforFacebookDynamicProductAds WooCommerceCostofGoods BundleDeal Menu PixelYourSiteProfessional Features FacebookPixel GoogleAnalytics GoogleAdsRemarketing ANYScript Changelog Add-ons PinterestTagAdd-On BingTagAdd-On TheSuperPack FacebookConversionAPI(CAPI) VerifyingyourDomainonFacebook HowtoaddthePinterestTag CartFlowsandPixelYourSite ProductCatalogs ProductCatalogFeedforWooCommerce VideoTutorials SmartOpenGraph EasyDigitalDownloadsProductCatalogFeed WordPressFeedforFacebookDynamicProductAds WooCommerceCostofGoods BundleDeal FacebookConversionAPI(CAPI) SendthepixeleventsdirectlytoFacebook’sservers,bypassingbrowserlimitationsoradblockers HowtosetupCAPIeventswithPixelYourSiteandhowtotestthem BuythePixelYourSiteProfessionalplugin or GettheBundle ConversionAPI(CAPI)ConversionAPIallowsyourwebsitetosendeventsdirectlytoFacebook’sservers.TheseeventsarelinkedtoyourpixelandareprocessedbyFacebooklikebrowserevents.ThemainadvantageofCAPIeventsisthattheywillbypassbrowsers’limitationsoradblockers. HowtoconfigureCAPIwithPixelYourSiteGetthetokenGotoEventsManagerSelectthepixelyouwanttoconfigureandclickonSettings. Scrolldownuntilyousee“ConversionAPI”andclickon“GenerateAccessToken”.Copythetokenbyclickingonit. AddthetokentoPixelYourSiteOpenyourPixelYourSitepluginandaddthetokeninthededicatedfieldunderthePixelID.ChecktheoptiontosendCAPIevents,scrollthepage,andSAVE. PixelYourSitewillstarttosendCAPIeventsalongwiththebrowserevents.Asafinalstep,youshoulddeleteanycachethatmightbepresentonthewebsite.Thiswillensurethatthelatestversionofthecodeisservedimmediatelytoyourusers. HowtotestCAPIeventsTotestCAPIevents,goinsideyourEventsManager.ClickonTestEventsandcopytheTestCode. OpenthePixelYourSitepluginandaddthetextcodeinthededicatedfieldbelowthepixelID.Scrollthepage,andsave.Ifyouhaveacacheplugin,deleteyourcache.  Startbrowsingyourwebsitetofireevents. Makesureyoudon’ttestwithanexcludedrole.Youhavethisoptionontheplugin’smainpage. GobacktoEventsManager,andyouwillseeeventsreportedunderTesting. You’llstarttoseepairsofbrowserandserverevents,withtheservereventsdeduplicated. ClickontheeventtoseeitsparametersoritsEventID.OnlybrowsereventsfiredinthebrowserwindowwheretheEventsManagerisopenarereportedundertesting.Ifyoubrowseyourwebsiteinanincognitowindoworinadifferentbrowser,browsereventsarerecorded,butnotreported.Inthiscase,youwillseeonlythededuplicatedserverevents.Toseeactiveserverevents,installanadblockerandbrowseyourwebsite.Facebookwillgetonlytheserverevents,soitwon’tdeduplicatethem.It’spossibletoseewarningsfromtimetotime.Someofthesewarningscanbefalsepositives.Wenoticedwarningsrelatedtomissingtravelparametersforeventsthathavenothingtodowithtravel.Whenyouaredonetesting,removethetestingcodefromPixelYourSite.  CAPIeventsareabackupforthebrowsereventsConversionAPIeventsdon’treplacebrowserevents,theyworkasabackup.Ifforsomereasonthebrowsereventsdon’twork,FacebookwillusetheCAPIevents.Itmeansthateveryeventisinfactsenttwice,onceusingthebrowser,onceusingConversionAPI.DeduplicatingeventsInordertokeepyoureventsreportingaccurate,Facebookisdeduplicatingservereventswhenabrowsereventissent.Deduplicationmeansthatwhenbothbrowserandservereventsarereceived,thebrowsereventisprocessed,andtheservereventisdropped.EventIDWhendeduplicatingevents,Facebookusestwoimportantsignals:theeventnameandtheEventID.WhenapairofserverandbrowsereventshavethesamenameandthesameID,theservereventisdeduplicated.PixelYourSitealwaysadsanuniqueEventIDforeverypairofbrowser-serverevents. DeduplicateeventsandcacheThekeyelementofeventdeduplicationistheEventID.thismustbeuniquetoeachpairofbrowser/serverevents. CacheproblemSometimescachepluginswillstorethefullcodeofapage,includingtheEventID.Itmeansthatwhenthepageisvisitedbydifferentusers,thesameeventIDswillbedeliveredagainandagain.ForFacebook,theseeventsmightlookconnected,anddisregardedassuch. ThesolutionToovercomethisproblemPixelYourSiteuseradmin-ajax,bypassingcachesthisway. Youcanenableordisabletheuseofadmin-ajaxfromtheplugin’smainpage.Ifyoudisableadmin-ajax,it’sbesttocheckiftheEventIDisindeeduniquetoeachpairofevents. TesttheEventIDYoucandoitusingthePixelHelperChromeextension,ortheEventsManagertestingtool Openapageinanincognitowindow.CheckaneventwithPixelHelperandlookforitsEventID.Refreshthepageandcheckthesameevent.IftheEventIDisdifferent,youarefine.ItmeansthattheEventIDisnotcachedanddeduplicationworkscorrectly.RememberthatPixelHelperonlyshowsthebrowserevents,butforthistest,thisisenough.Downonthispage,youwilllearnhowtotestservereventstoo. CAPIeventsdataParametersWhensendingCAPIevents,PixelYourSitetriestosendthesamesetofeventsparametersasforbrowserevents.Theonlyparameterswecan’tcollectarerelatedtothevisitor’sbrowsertime,sothesearesentforbrowsereventsonly.MatchKeyandUserDataKeysCAPIeventsalsosendadditionalinformationthathelpsFacebookmatchtheusertoaFacebookaccount.BrowserID,FacebookClikID(FBC),FacebookBrowserID(FBP)arecollectedusingFacebook’sownlibrary.ThesearecalledMatchKeys.Whenpossible,theeventsalsohavedataaboutyouruser,likeEmail,FirstName,IPAddress,LastName,Phone,CityState,ZIPcode.ThesearecalledUserDataKeys.TheplugincansendUserDataKeyswhenthevisitorisloggedonyourwebsite,andthereisdataassociatedwiththeWordPressaccount.WooCommerceandEasyDigitalDownloadsPurchaseeventcantakeitfromtheorder’sdetails.EventMatchQualityUsingMatchKeysandUserDataKeys,FacebooktriestomatcheventstoaFacebookaccount.BecausePurchaseeventshaveaccesstobetterUserDataKeys,youcanexpectabetterMatchingScoreforthem.Eventsfiredbynon-logged-invisitorscanhavealowerscore. DiagnosticsFromtimetotime,youwillseesomeerrorsrelatedtoCAPIeventsreportedundertheDiagnosticstab. Sometimestheseerrorsarefalsepositivesorcanbeignored.ServerSendingInvalidMatchKeyParametersforEventYourserverissendinganinvalidfbp,ip_address,user_agentparametersvalueforyourevent.Thismaybebecausetherewasanerrorintheparametervalue.Thismaycauseissueswiththeattributionanddeliveryoptimizationofadcampaignsthatareusingthisevent.We’veseenthiserrorfromtimetotime.It’sprobablycausedbybotstriggeringthepixel,wherethescriptcan’tcorrectlyidentifyfbp,ip_address,user_agentvalues.It’smarginal,andyoucanignoreit.SameEventIDReceivedforManyEventInstancesYou’resendingthesameeventIDformanyinstancesofyourevents.EventIDsareuniqueidentifiersthatareusedtodeduplicateidenticaleventsreceivedfromyourpixelandtheConversionsAPIsothey’renotcountedtwice.ToensureFacebookisaccuratelycountingyourevents,eachuniqueeventinstanceneedsitsownuniqueeventID.Thismaycauseissueswiththemeasurementofyoureventsandtheattributionofyouradcampaigns.Thiscanbeindeedrelatedtothecacheissueexplainedbefore.Testyoureventsandmakesureeachbrowser/servereventhasauniqueEventID.Anotherpossibleexplanationisthatthepagesourcewascopiedandservedbyotherwebsites.ThiscanbeGoogle’scache,GoogleTranslate,orsomethingelse.YoucanrestrictthepixeltofireonyourdomainonlyfromtheEventsManagerSettingspage.LookforTrafficPermissionsandcreateanAllowList.Itcanalsobejustafalsepositive.TestandconfirmthatEventIDisuniquetoeachpairofbrowser/servereventsandrestrictthepixeltoyourdomainonly.Onceyoudothese,youcanignoretheproblem. NewDomainsSendingDataYourpixelrecentlystartedsendingeventsfromthesedomainsThismightormightnotbeanerror.ThesolutionistocreateanAllowListwithdomainsthatcanusethepixel.GotoEventsManager,clickonSettings,lookforTrafficPermissions,andcreateanAllowList. iOS14privacyupdateandyourFacebookPixel​ Clickhere LearnaboutFacebookAggregatedEventMeasurement Clickhere LearnaboutPixelYourSiteV8 Clickhere VerifyingyourDomainonFacebookusingPixelYourSite Clickhere TheSignalevent&FacebookCustomAudiencesorCustomConversions Clickhere TheSignalevent&AggregatedEventMeasurement Clickhere FacebookConversionAPI(CAPI) Clickhere Ourplugins TheBundleDeal PixelYourSiteProfessional ProductCatalogFeedforWooCommerce SmartOpenGraph WordPressfeedforDPA WooCommerceCOG BingTagadd-on PinterestTagadd-on TheSuperPack iOS14 iOS14andyourFacebookPixel FacebookAggregatedEventMeasurement iOS14andPixelYourSiteV8 VerifyyourdomainonFacebook TheSignalevent SignalCustomConversion FacebookCAPI Helpsections PixelYourSiteProfessionalHelp ProductCatalogFeedforWooCommerceHelp WordPressFeedforFacebookDynamicProductAdsHelp WooCommerceCOGHelp Usefulpages: UpgradetotheBundleDeal Articles Contact&Support MyAccount Becomeanaffiliate Legal: Privacypolicy Termsofservice Softwarelicenseagreement Refundandcancelation ©PixelYourSite.com.ThissiteismanagedbyMinimalWorkSRL,RO35964491,J38/337/14.04.2016,Bujoreni,Olteni145,Valcea,Romania