X-conversies, vanaf je server verstuurd
ROASaurus stuurt aankopen, toevoegingen aan de winkelwagen, checkouts en paginaweergaven naar het conversies-endpoint van de X Ads API. Er is in ROASaurus geen browserpixel voor X: het ontvangt alleen serverevents.
| X (Twitter) in één oogopslag | |
|---|---|
| Koppeling | X Ads API-webconversies, ondertekend met OAuth 1.0a |
| Events | Purchase (verplicht), add to cart, checkout initiated, page view, elk als event-id uit Events Manager |
| Identifiers | twclid, gehashte e-mail, gehasht telefoonnummer (E.164); IP en user agent alleen samen met een van deze |
| Inloggegevens | Pixel-ID, API-sleutel en secret, toegangstoken en secret |
| Browserpixel | Nee, alleen serverevents |
| Advertentiekosten synchroniseren | Ja: campagne-uitgaven, impressies en klikken per dag, zodra je het advertentieaccount koppelt onder Setup › Ad spend |
Wat ROASaurus naar X stuurt
X heeft geen standaard eventnamen. Elk eventtype is een event-id dat je zelf in X Events Manager aanmaakt, zoals tw-o1abc-o1def, en in ROASaurus plakt. Het event-id voor aankopen is verplicht. Add to cart, checkout initiated en page view zijn optioneel; een eventtype zonder id wordt niet verstuurd. Productweergaven worden niet naar X gestuurd.
Elke conversie vermeldt identifiers: het click-id twclid, het e-mailadres gehasht met SHA-256 en het telefoonnummer in E.164-formaat, gehasht. Het IP-adres en de user agent worden alleen naast een van die gegevens toegevoegd, omdat X ze alleen in combinatie telt. ROASaurus stuurt ook een conversie-id, waarde, valuta, aantal artikelen en de producten mee. Een conversie zonder twclid, e-mail of telefoon wordt overgeslagen.
ROASaurus beschouwt een levering pas als verstuurd wanneer X ten minste één verwerkte conversie meldt.
Zo koppel je
- Zorg voor een X-developerapp met toegang tot de Ads API.
- Genereer OAuth 1.0a-gebruikerstokens voor een gebruiker met Ad Manager-toegang tot het advertentieaccount: je hebt de API-sleutel en het secret nodig, plus het toegangstoken en het secret.
- Maak in X Events Manager een event aan voor elk type dat je wilt en kopieer de event-id's.
- Ga in ROASaurus naar Tracking & platforms, klik bij de X-kaart op Add pixel en voer het Pixel-ID, de event-id's en de vier sleutels in.
Beperkingen
- Geen browserpixel: X ontvangt alleen serverevents.
- De campagne-uitgaven van X worden gesynchroniseerd zodra je het advertentieaccount koppelt onder Setup › Ad spend.
- Een twclid alleen levert geen touchpoint voor attributie op. Voorzie je X-advertenties van UTM-parameters, zodat de bezoeken in attributie per bron en campagne verschijnen.
Gerelateerd
Vragen, beantwoord
Waarom heeft X vier sleutels nodig?
De X Ads API vereist OAuth 1.0a voor custom integraties. Elk verzoek wordt ondertekend met de API-sleutel en het secret van je app en het toegangstoken en secret van een gebruiker die het advertentieaccount kan beheren.
Laadt ROASaurus de X-pixel?
Nee. X ontvangt alleen serverevents. Conversies worden gematcht op het click-id twclid of op de gehashte e-mail of telefoon van de shopper.
Welke X-events kan ik versturen?
Purchase, add to cart, checkout initiated en page view. Maak ze stuk voor stuk aan in X Events Manager en plak het event-id. Alleen purchase is verplicht.
Elke verkoop herleid tot de advertentie die hem opleverde
Server-side tracking, winst en lifetime value in één app. 14 dagen gratis proberen, geen creditcard.
Start je gratis proefperiode →