Pixel Helper - Facebook for Developers

The Pixel Helper is a Chrome Browser extension that runs in the background to automatically review websites for Facebook Pixel code. When the extension is ... FacebookPixelGetStartedGuidesSupportReferencePixelHelper ThisguideshowsyouhowtousetheFacebookPixelHelpertooltoverifyyourpixelisworkingproperly,troubleshootcommonerrors,andimprovepixelperformance. Overview ThePixelHelperisaChromeBrowserextensionthatrunsinthebackgroundtoautomaticallyreviewwebsitesforFacebookPixelcode.Whentheextensionisinstalleda>icon,thePixelHelpericon,willappearintheupperrightcornerofthebrowsernexttotheaddressbar.WhenawebsitehasaFacebookPixelinstalledthePixelHelpericonturnsblueandasmallbadgewillappearindicatingthenumberofpixelsfoundonthewebpage.Iftheicondoesnotturnblue,noFacebookpixelsareinstalledonthiswebpage.ClickthePixelHelpericonandasmallpopupappearswithinformationyoucanusetoverify,troubleshoot,andimproveourpixel. InstallPixelHelper Requirements TousetheFacebookPixelHelperyoumust: usetheChromewebbrowser installthePixelHelperextensionfromtheChromeStore VerifyPixelImplementation NavigatetoyourwebsiteintheChromebrowser,andclickonthePixelHelpericon.Thepopupwilltellwhatpixelswerefoundonthewebpage,andwhethertheyhaveloadedsuccessfully. Troubleshooting TheFacebookPixelHelperreportserrorsandsuggestionstoimproveperformance. DataProcessingParametersSent ThissectionshowsifdataprocessingparametersarebeingsentwiththeLimitedDataUseflag. DPOSTandDPOCOwillshow1,1000ifitissentwithCalifornia/USAdata. PixelDidNotLoad ThePixelDidNotLoaderrormeansthatthePixelHelperfoundwhatlookslikeFacebookpixelcodeonyoursite,buttheactualHTTPcallwasnevermade.Possiblecausesinclude: Anerrorinthecode. Ifthepixelfiresonadynamicevent,suchasabuttonclick.Theerrorwilldisappearuponclickingonthebutton. EncodedCharacters TheEncodedCharacterserrormeansthatthePixelHelperfoundwhatlookstobedouble-encodedcharacters.Possiblecausesinclude: atagorCMSsystemencodingalreadyencodedthisinformation.Forexample,encoding&into&.Makesurethatcharactersarenotbeingencodedtwice,forexample,trychanging&to&. NotaStandardEvent TheNotaStandardEventwarningmeansthatthePixelHelperfoundaneventthatisnotoneoftheStandardEvents.Forexample,theeventisnamedPurchasedinsteadofPurchase. PixelActivatedMultipleTimes ThePixelActivatedMultipleTimeserrormeansthatapixelwiththesameIDandeventnamewassentmultipletimestoFacebook.Thesameeventshouldonlyoccuronceuponpageloading.Iftheeventissentwithdifferentcustomdataparameters,thoseparametersshouldbeaggregatedintoasinglepixelevent. InvalidPixelID TheInvalidPixelIDerrormeansthatthesentIDforthepixeldidnotmatchaknownpixelIDinoursystem.YoucanfindyourpixelIDintheEventsManager. CanNotFindProductCatalog TheCanNotFindProductCatalogerrormeansthattheProductCatalogIDwhichwaspassedinthefieldproduct_catalog_idinthepixelfirecouldnotbefoundonoursystem.YoucanfindyourProductCatalogIDinBusinessManagerunderSettings>ProductCatalogs. MakesureyourProductCatalogisassociatedwithyourpixel. YouHaveOptedOutofTracking TheYouHaveOptedOutofTrackingwarningmeansthatyouhaveoptedoutoftrackingfromFacebookandthepixelfiresdetectedwerenotloggedonourservers.ThispreventsanyserversidevalidationfortheCustomAudiencePixelpotentiallyleavingpixelproblemsundiagnosed. YoucanlearnmoreaboutouroffsitetrackinginyourFacebookAdsPreferencesincludinghowto turntrackingbackon. Facebookrespectsmobiledevicesettingsregardingadtrackingsoyoumayneedtoupdateyourdevicessettingstooptbackin.Ifoneormoredevicehasoptedouteachdevicewillhavetooptbackinbeforetrackingisenabled. Pixelisnotpairedwithaproductcatalog TheProductCatalogNotPairedwarningsuggeststhatthepixelisnotpairedwithanyproductcatalog.Thispairingisrequiredtospecifyrelationshipbetweenpixelsandproductcatalogs.Therearetwowaystopairacatalogwithapixel,theCommerceManagerortheProductCatalogPreferencesAPI. DataProcessingParametersSent TheDataProcessingParametersSentsectiondisplaysanydataprocessingparameterssentwiththeLimitedDataUse(LDU)flagforaspecificevent.TheDataProcessingOptionisshownatthestate(DPOST)andcountry(DPOCO)level.Forexample,adpostvalueof1representsCaliforniaandadpocovalueof1000representstheUnitedStates.Ifthevaluesare0,Facebookwillgeolocatetheevent.Ifyousetacountry,youmustsetastateorFacebookwillautomaticallygeolocatetheevent. PixelTookTooLongtoLoad ThePixelTookTooLongtoLoadwarningsuggeststhatittookalongtimebeforethepixelwasactivated.Thismaybeduetowherethepixelislocatedonthewebpage.Itisrecommendedtoplacethepixelcodeearlyinthewebpage,preferablyjustbeforetheclosingtagintheHTML. Ifawebpagevisitorclosesthewebpage,clicksonalink,ornavigatesawaybeforethepixeleventactivates,theactionwillnotbetracked.Asignificantpercentageofactionsandconversionscanbelostduetotheseactions. PixelisNottheOnlyConversion Itisrecommendedthatyouuseasingleconversionpixelacrossalladstrackingoroptimizationforeacheventtoavoidinefficientoptimizationandtrackingoftheseconversionevents. Inthecasethatasecondaryconversioneventoccursbasedonperson'sinteractionwiththewebpage,suchasabuttonclick,thenthiswarningcanbeignored. PixelAdvancedMatching ThePixelAdvancedMatchingwarningsuggeststhatthevaluesentfortheadvancedmatchingparameterisinvalidornotformattedcorrectly.Examplesarewhenyouaresendingstaticvaluesfromexamplecodesuchas{{email}}fortheemfield,wherethe{{email}}shouldhavebeenreplacedbytherealemailaddress.PleaseverifythatthevaluesareformattedandreplacedcorrectlybeforepassingittotheFacebookPixel.