📊 Campaign Quality Score
${campaignData.qa_score}/100
Status: ${campaignData.deployment_recommendation}
✍️ Generated Copy
📘 Facebook Ad
Headline: ${campaignData.copy.facebook.headline}
${campaignData.copy.facebook.primary_text}
📸 Instagram Ad
${campaignData.copy.instagram.caption}
${campaignData.copy.instagram.hashtags}
📧 Email Subject Lines
${campaignData.copy.email_sequence.map(e => `- ${e.subject}
`).join('')}
💡 Strategic Insights
Best Posting Times: ${campaignData.insights.best_times}
Recommended Hashtags:
${campaignData.insights.hashtags.join(' ')}
📅 Content Calendar
${JSON.stringify(campaignData.content_calendar, null, 2)}
`;
return {
json: {
html: htmlEmail,
subject: `🎉 ${campaignData.festival_name} Campaign Ready - Score: ${campaignData.qa_score}/100`,
to: campaignData.client_email
}
};
```
## Common Workflow Patterns
### Pattern 1: Campaign Trigger via Webhook
```javascript
// n8n Webhook Node - POST /generate-campaign
{
"festival_name": "Diwali",
"product_name": "Premium Smartphones",
"brand_name": "TechBrand",
"brand_colors": "blue and white",
"target_audience": "young professionals",
"budget_range": "mid-premium",
"client_email": "client@example.com",
"user_email": "agent@agency.com"
}
```
### Pattern 2: Campaign ID Generation
```javascript
// n8n Code Node - Generate Unique Campaign ID
const timestamp = Date.now();
const festivalCode = $json.festival_name.substring(0, 3).toUpperCase();
const productCode = $json.product_name.substring(0, 3).toUpperCase();
const campaignId = `${festivalCode}_${productCode}_${timestamp}`;
return {
json: {
...$json,
campaign_id: campaignId,
created_at: new Date().toISOString()
}
};
```
### Pattern 3: Gemini API Call Configuration
```javascript
// n8n HTTP Request Node - Gemini API
// Method: POST
// URL: https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent
const requestBody = {
contents: [{
parts: [{
text: $json.prompt
}]
}],
generationConfig: {
temperature: 0.7,
topK: 40,
topP: 0.95,
maxOutputTokens: 8192,
},
safetySettings: [
{
category: "HARM_CATEGORY_HARASSMENT",
threshold: "BLOCK_MEDIUM_AND_ABOVE"
}
]
};
return {
json: requestBody
};
```
### Pattern 4: Error Handling and Retry Logic
```javascript
// n8n Code Node - Error Handler
try {
const response = $json;
if (!response.candidates || response.candidates.length === 0) {
throw new Error('No content generated from Gemini API');
}
const generatedText = response.candidates[0].content.parts[0].text;
const parsedContent = JSON.parse(generatedText);
return {
json: {
success: true,
content: parsedContent,
campaign_id: $json.campaign_id
}
};
} catch (error) {
return {
json: {
success: false,
error: error.message,
campaign_id: $json.campaign_id,
retry_needed: true
}
};
}
```
### Pattern 5: Conditional Campaign Deployment
```javascript
// n8n Switch Node Logic
// Route based on QA score
const qaScore = $json.qa_score;
if (qaScore >= 85) {
return {
json: {
...$json,
deployment_path: 'auto_deploy',
send_email: true,
approval_needed: false
}
};
} else if (qaScore >= 70) {
return {
json: {
...$json,
deployment_path: 'human_review',
send_email: true,
approval_needed: true
}
};
} else {
return {
json: {
...$json,
deployment_path: 'revise',
send_email: false,
approval_needed: true,
revision_priority: 'high'
}
};
}
```
## Configuration Best Practices
### Google Drive Folder Structure
Create this folder structure in your Google Drive:
```
Festival Campaigns/
├── 2024/
│ ├── Diwali/
│ │ ├── CAMP_12345/
│ │ │ ├── visuals/
│ │ │ ├── copy/
│ │ │ └── reports/
```
### Google Sheets Campaign Log Schema
```javascript
// Recommended Sheets columns
const sheetColumns = [
'campaign_id',
'timestamp',
'festival_name',
'product_name',
'brand_name',
'target_audience',
'qa_score',
'deployment_status',
'drive_folder_url',
'email_sent_to',
'channels_covered',
'estimated_reach',
'created_by',
'approved_by',
'launch_date'
];
```
### Gemini Model Selection
```javascript
// Choose model based on task complexity
const modelMapping = {
festival_research: 'gemini-pro',
copy_generation: 'gemini-pro',
visual_prompts: 'gemini-pro',
qa_review: 'gemini-pro',
image_generation: 'gemini-pro-vision' // if using vision capabilities
};
```
## Troubleshooting
### Issue: Gemini API Rate Limits
```javascript
// n8n Code Node - Rate Limit Handler
const delay = (ms) => new Promise(resolve => setTimeout(resolve, ms));
async function callGeminiWithRetry(prompt, maxRetries = 3) {
for (let i = 0; i < maxRetries; i++) {
try {
// API call here
return response;
} catch (error) {
if (error.status === 429) {
await delay(2000 * (i + 1)); // Exponential backoff
continue;
}
throw error;
}
}
}
```
### Issue: Google Drive Upload Failures
```javascript
// Check binary data format
if (!$binary.data) {
throw new Error('No binary data found for upload');
}
// Verify file size
const maxSize = 10 * 1024 * 1024; // 10MB
if ($binary.data.fileSize > maxSize) {
throw new Error('File size exceeds limit');
}
```
### Issue: Malformed JSON from Gemini
```javascript
// n8n Code Node - JSON Parser with Fallback
function parseGeminiResponse(text) {
try {
return JSON.parse(text);
} catch (e) {
// Try to extract JSON from markdown code blocks
const jsonMatch = text.match(/```json\n([\s\S]*?)\n```/);
if (jsonMatch) {
return JSON.parse(jsonMatch[1]);
}
// Try to find JSON object in text
const objMatch = text.match(/\{[\s\S]*\}/);
if (objMatch) {
return JSON.parse(objMatch[0]);
}
throw new Error('Could not parse JSON from Gemini response');
}
}
```
### Issue: Email Delivery Failures
```javascript
// Gmail API error handling
if ($json.error) {
console.error('Gmail API Error:', $json.error);
// Log to Sheets for follow-up
return {
json: {
campaign_id: $json.campaign_id,
email_status: 'FAILED',
error_message: $json.error.message,
retry_at: new Date(Date.now() + 3600000).toISOString()
}
};
}
```
### Issue: Incomplete Campaign Data
```javascript
// n8n Code Node - Data Validation
function validateCampaignData(data) {
const required = ['festival_name', 'product_name', 'brand_name', 'client_email'];
const missing = required.filter(field => !data[field]);
if (missing.length > 0) {
throw new Error(`Missing required fields: ${missing.join(', ')}`);
}
// Validate email format
const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
if (!emailRegex.test(data.client_email)) {
throw new Error('Invalid client email format');
}
return true;
}
```
## Advanced Features
### Memory Integration (Future Enhancement)
```javascript
// Pattern for adding campaign memory
const campaignMemory = {
brand_guidelines: $('Get Brand Guidelines').all(),
past_campaigns: $('Query Past Campaigns').all(),
performance_data: $('Get Performance Metrics').all()
};
const enhancedPrompt = `
${basePrompt}
Historical Context:
- Brand Guidelines: ${JSON.stringify(campaignMemory.brand_guidelines)}
- Top Performing Campaigns: ${JSON.stringify(campaignMemory.past_campaigns.slice(0, 3))}
Generate copy consistent with brand voice and proven patterns.
`;
```
### Multi-Language Support
```javascript
// Language detection and translation
const supportedLanguages = ['en', 'hi', 'es', 'fr'];
const targetLanguage = $json.target_language || 'en';
if (supportedLanguages.includes(targetLanguage)) {
const translationPrompt = `
Translate the following campaign copy to ${targetLanguage}:
${JSON.stringify($json.campaign_copy)}
Maintain cultural relevance and marketing impact.
`;
}
```
### Analytics Integration
```javascript
// Track campaign performance
const analyticsPayload = {
campaign_id: $json.campaign_id,
event: 'campaign_created',
properties: {
festival: $json.festival_name,
channels: $json.channels_covered,
qa_score: $json.qa_score,
timestamp: new Date().toISOString()
}
};
// Send to analytics platform
return { json: analyticsPayload };
```
This skill provides comprehensive coverage of the AI Festival Campaign Generator workflow, enabling AI coding agents to help developers implement, customize, and troubleshoot multi-agent marketing automation systems.