Implementing Links

Overview

Once you have link suggestions, you can implement them manually or automatically using:

• Manual Implementation: Review and add links yourself
• REST API: Programmatically update content
• CMS Integrations: Automatic implementation with WordPress, Shopify, etc.
• SDK Methods: Use language-specific libraries

Manual Implementation

The simplest approach is to review suggestions in the dashboard and manually add links to your content management system.

Programmatic Implementation

Get Implementation Instructions

const instructions = await client.implementations.getInstructions(projectId, {
  suggestionIds: [suggestionId1, suggestionId2]
})

// Instructions include:
// - Step-by-step guide
// - Code snippets
// - API endpoints to update
// - Example transformations

Implement via API

For headless CMS or custom setups:

// 1. Get the suggestion details
const suggestion = await client.suggestions.get(projectId, suggestionId)

// 2. Update your content
const updatedContent = addLinkToContent(
  originalContent,
  suggestion.context,
  suggestion.anchorText,
  suggestion.targetPageUrl
)

// 3. Update via your CMS API
await updatePage(suggestion.sourcePageUrl, updatedContent)

// 4. Report implementation status
await client.implementations.reportStatus(projectId, implementationId, {
  status: 'completed',
  implementedAt: new Date().toISOString()
})

Using CMS Integrations

WordPress

WordPress integration automatically implements suggestions:

// Suggestions are automatically synced to WordPress
// Review and approve in the WordPress admin panel

See the WordPress Integration Guide for details.

Shopify

Shopify integration works with product pages and blog posts:

// Connect your Shopify store
// Suggestions appear in the Shopify admin
// Click to implement directly

See the Shopify Integration Guide for details.

Batch Implementation

Implement multiple suggestions at once:

const suggestions = await client.suggestions.list(projectId, {
  status: 'approved',
  limit: 50
})

for (const suggestion of suggestions) {
  // Implement each suggestion
  await implementSuggestion(suggestion)
  
  // Mark as implemented
  await client.suggestions.update(projectId, suggestion.id, {
    status: 'implemented'
  })
}

Implementation Strategies

Conservative Approach

Implement only high-confidence suggestions:

const highValueSuggestions = suggestions.filter(
  s => s.relevanceScore >= 0.85 && s.potentialImpact === 'high'
)

// Implement gradually
for (const suggestion of highValueSuggestions.slice(0, 10)) {
  await implementSuggestion(suggestion)
}

Aggressive Approach

Implement many suggestions quickly:

// Implement all approved suggestions
const approved = await client.suggestions.list(projectId, {
  status: 'approved'
})

await Promise.all(
  approved.map(s => implementSuggestion(s))
)

Tracking Implementation

Report Implementation Status

await client.implementations.reportStatus(projectId, implementationId, {
  status: 'completed',
  implementedAt: '2024-01-01T00:00:00Z',
  changes: {
    linksAdded: 1,
    anchorText: 'click here'
  }
})

View Implementation History

const implementations = await client.implementations.list(projectId, {
  limit: 50,
  status: 'completed'
})

for (const impl of implementations) {
  console.log(`Implemented: ${impl.suggestion.sourceTitle} → ${impl.suggestion.targetTitle}`)
  console.log(`Date: ${impl.implementedAt}`)
}

Rollback Implementation

If you need to undo an implementation:

await client.implementations.rollback(projectId, implementationId, {
  reason: 'Link broke content flow'
})

// This removes the link and marks the suggestion as rejected

Best Practices

1. Review first: Always review suggestions before implementing
2. Natural anchor text: Use suggested anchor text or make it natural
3. Maintain context: Ensure links fit naturally in content
4. Track results: Monitor analytics after implementation
5. Test links: Verify all links work correctly after implementation
6. Gradual rollout: Implement in batches over time