LinkedIn Conversions API - Troubleshooting Guide

LinkedIn heeft de KORTSTE token expiry van alle advertising platforms!

Zet een reminder om elke 50-55 dagen je LinkedIn token te vernieuwen!

De LinkedIn Conversions API Check analyseert of je events correct worden doorgestuurd naar LinkedIn. Dit is essentieel voor:

• B2B conversie tracking voor LinkedIn Ads

• Lead generation attributie

• Campagne optimalisatie met accurate data

Dit is de #1 LinkedIn error! (~80% van alle LinkedIn errors)

HTTP Status: 401 Unauthorized

Response:

{
  "status": 401,
  "serviceErrorCode": 65602,
  "code": "EXPIRED_ACCESS_TOKEN",
  "message": "The token used in the request has expired"
}

Oorzaak: Je Access Token is verlopen na 60 dagen.

Oplossing:

1. Ga naar LinkedIn Campaign Manager

2. Account Assets → Conversions

3. API Access → Generate Token

4. Kopieer de nieuwe token

5. Update in TryTagging:

   • Tags → LinkedIn CAPI → Access Token

📅 Token gegenereerd: [datum]
⏰ Verloopt op: [datum + 60 dagen]
🔔 Vernieuw voor: [datum + 55 dagen]

Pro Tip: Zet een recurring calendar event voor elke 50 dagen!

HTTP Status: 401 Unauthorized

Response:

{
  "status": 401,
  "serviceErrorCode": 65600,
  "code": "INVALID_ACCESS_TOKEN",
  "message": "Invalid access token"
}

Mogelijke oorzaken:

1. Token verkeerd gekopieerd - missende karakters

2. Token van verkeerd account - andere LinkedIn account

3. Token handmatig ingetrokken - in Campaign Manager

Oplossing:

1. Ga naar LinkedIn Campaign Manager

2. Genereer een nieuwe Access Token

3. Kopieer exact - inclusief alle karakters

4. Test met een simpele API call

HTTP Status: 422 Unprocessable Entity

Response:

{
  "message": "ERROR :: /conversion :: Invalid Urn Format. Key long is in invalid format. Urn urn:lla:llaPartnerConversion:undefined.",
  "status": 422
}

Oorzaak: De Conversion ID (URN) is niet correct geformateerd.

LinkedIn URN Format:

urn:lla:llaPartnerConversion:[CONVERSION_ID]

Voorbeeld:

✅ Correct: urn:lla:llaPartnerConversion:12345678
❌ Fout: urn:lla:llaPartnerConversion:undefined
❌ Fout: 12345678
❌ Fout: urn:li:conversion:12345678

Oplossing:

1. Ga naar LinkedIn Campaign Manager

2. Account Assets → Conversions

3. Klik op je conversie → bekijk de URN

4. Kopieer de volledige URN inclusief prefix

5. Update in TryTagging

HTTP Status: 426 Upgrade Required

Response:

{
  "status": 426,
  "code": "NONEXISTENT_VERSION",
  "message": "Requested version 20240601 is not active"
}

Oorzaak: De gebruikte API versie is niet meer ondersteund.

LinkedIn API Versioning:

• LinkedIn gebruikt datum-gebaseerde versies: 202406, 202401, etc.

• Oude versies worden regelmatig deprecated

• Minimaal 12 maanden support na release

Oplossing:

1. Controleer de huidige API versie in TryTagging configuratie

2. Update naar een actieve versie (bijv. 202401 of nieuwer)

3. Test na de update

POST https://api.linkedin.com/rest/conversionEvents

Authorization: Bearer [ACCESS_TOKEN]
LinkedIn-Version: 202401
Content-Type: application/json

{
  "conversion": "urn:lla:llaPartnerConversion:12345678",
  "conversionHappenedAt": 1702656000000,
  "conversionValue": {
    "currencyCode": "EUR",
    "amount": "99.95"
  },
  "user": {
    "userIds": [
      {
        "idType": "SHA256_EMAIL",
        "idValue": "e3b0c44298fc1c149afbf4c8996fb924..."
      }
    ],
    "userInfo": {
      "firstName": "Jan",
      "lastName": "Jansen"
    }
  }
}

De li_fat_id cookie is essentieel voor LinkedIn attributie.

• First-party cookie gezet door LinkedIn Insight Tag

• Verbindt LinkedIn ad click met website bezoek

• Formaat: UUID

li_fat_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

1. LinkedIn Insight Tag moet op de site staan

2. Cookie wordt automatisch gezet bij LinkedIn ad click

3. Lees cookie uit en stuur mee als LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID

LinkedIn ondersteunt specifieke conversie types:

1. Ga naar Campaign Manager

2. Analyze → Conversion Tracking

3. Bekijk of events binnenkomen

4. Check de Event History

1. Container → Monitoring

2. Filter: platform = Linkedin

3. Bekijk request/response details

4. Check error codes en messages

curl -X GET 'https://api.linkedin.com/v2/me' \
  -H 'Authorization: Bearer [YOUR_TOKEN]'

Als dit faalt met 401 → token is verlopen/invalid.

Account: [Company Name]
Token gegenereerd: 2024-12-15
Token verloopt: 2025-02-13
Reminder gezet voor: 2025-02-01
Verantwoordelijke: [Naam]

1. Google Calendar: Recurring event elke 50 dagen

2. Slack reminder: /remind me to renew LinkedIn token in 50 days

3. Email: Kalender uitnodiging naar team

1. Dag 50: Ontvang reminder

2. Dag 51-55: Genereer nieuwe token

3. Test: Verifieer dat events binnenkomen

4. Update documentatie: Noteer nieuwe expiry date

• [ ] Access Token gegenereerd (verloopt over 60 dagen!)

• [ ] Conversion URN correct (urn:lla:llaPartnerConversion:...)

• [ ] API versie actueel (202401 of nieuwer)

• [ ] Token expiry datum genoteerd

• [ ] Email gehashed (SHA-256, lowercase)

• [ ] li_fat_id cookie (indien aanwezig)

• [ ] User info (firstName, lastName optioneel)

• [ ] Reminder gezet voor token vernieuwing

• [ ] Success rate monitoren

• [ ] Error alerts configureren

60 dagen. Dit is de kortste van alle major ad platforms.

Nee, LinkedIn staat maximaal 60 dagen toe. Er is geen "System User" equivalent zoals bij Meta.

Check het format: urn:lla:llaPartnerConversion:[ID].

• Niet urn:li:conversion:...

• Niet alleen de ID

• Niet undefined in de URN

1. Cache kan oud token bevatten - wacht 5-10 minuten

2. Controleer of je de volledige token hebt gekopieerd

3. Verifieer in TryTagging dat de update is opgeslagen