Pixel Helper - Meta Pixel - Documentation

The Pixel Helper is a Chrome Browser extension that runs in the background to automatically reviews websites for Meta Pixel code. When the extension is ... MetaPixelGetStartedGuidesSupportReferencePixelHelper ThisguideshowsyouhowtousetheMetaPixelHelpertooltoverifyyourPixelisworkingproperly,troubleshootcommonerrors,andimprovePixelperformance. Overview ThePixelHelperisaChromeBrowserextensionthatrunsinthebackgroundtoautomaticallyreviewswebsitesforMetaPixelcode.Whentheextensionisinstalleda>icon,thePixelHelpericon,willappearintheupperrightcornerofthebrowsernexttotheaddressbar.WhenawebsitehasaMetaPixelinstalled,thePixelHelpericonturnsblueandasmallbadgewillappearindicatingthenumberofPixelsfoundonthewebpage.Iftheicondoesnotturnblue,noMetaPixelsareinstalledonthiswebpage.ClickthePixelHelpericonandasmallpopupappearswithinformationyoucanusetoverify,troubleshoot,andimprovethePixel. InstallPixelHelper Requirements TousetheMetaPixelHelperyoumust: usetheChromewebbrowser installthePixelHelperextensionfromtheChromeStore VerifyPixelImplementation NavigatetoyourwebsiteintheChromebrowser,andclickonthePixelHelpericon.ThepopupwilltellwhatPixelswerefoundonthewebpage,andwhethertheyhaveloadedsuccessfully. Troubleshooting TheMetaPixelHelperreportserrorsandsuggestionstoimproveperformance. DataProcessingParametersSent ThissectionshowsifdataprocessingparametersarebeingsentwiththeLimitedDataUseflag. DPOSTandDPOCOwillshow1,1000ifitissentwithCalifornia/USAdata. PixelDidNotLoad ThePixelDidNotLoaderrormeansthatthePixelHelperfoundwhatlookslikeMetaPixelcodeonyoursite,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.