Upsert Google campaign

Create or update a full Google Ads campaign structure

PUT https://services.leadconnectorhq.com/ad-publishing/google/ads

Autorización

string

required

Bearer token generado desde el portal Leadway. Ver Autenticación.

string

default:"2021-07-28"

required

Versión de la API.

Body

string

Campaign identifier

string

default:"My Campaign"

required

Campaign name

string

default:"loc_abc123"

required

Account identifier

string

required

Advertising channel Posibles valores: ‘SEARCH’, ‘DISCOVERY’, ‘DISPLAY’, ‘HOTEL’, ‘LOCAL’, ‘MULTI_CHANNEL’, ‘PERFORMANCE_MAX’, ‘DEMAND_GEN’

string

Channel sub type Posibles valores: ‘DEMAND_GEN’

string

Goal type Posibles valores: ‘WEBSITE_TRAFFIC’, ‘LEAD’

object

Campaign budget

object

Campaign audience targeting

object

Network settings

object

Bidding strategy config

object

Campaign assets

boolean

default:"False"

EU political ads flag

object[]

Campaign ad groups

Show cada item

string

Ad group identifier

string

Google ad group identifier

string

default:"Ad Group 1"

Ad group name

string

Ad campaign identifier

object[]

Ad content items

Show cada item

string

Ad identifier

string

Ad name

string

Media type Posibles valores: ‘IMAGE’, ‘VIDEO’, ‘CAROUSEL’

string[]

Ad headlines

string[]

Long headlines

string[]

Ad descriptions

string

default:"https://example.com"

Final URL

string

default:"products"

Display path 1

string

default:"deals"

Display path 2

boolean

Whether the ad is soft-deleted

string

Ad-level error message from Google

string

Ad publishing status Posibles valores: ‘DRAFT’, ‘SCHEDULED’, ‘PUBLISHED’, ‘PUBLISHING’, ‘FAILED’, ‘IN_REVIEW’, ‘PAUSED’, ‘ARCHIVED’, ‘WITH_ISSUES’, ‘REJECTED’

string

Internal ad identifier

string

Ad campaign identifier

string

Ad group identifier

string

Google Ads ad resource ID

object[]

Ad media items

Show cada item

string

Media type Posibles valores: ‘IMAGE’

string

default:"https://example.com/image.jpg"

Media source URL

boolean

default:"False"

Is logo flag

string

Error message if media failed

string

Public URL of the media

string

Image type classification

string

Call to action label Posibles valores: ‘AUTOMATED’, ‘LEARN_MORE’, ‘GET_QUOTE’, ‘APPLY_NOW’, ‘SIGN_UP’, ‘CONTACT_US’, ‘SUBSCRIBE’, ‘DOWNLOAD’, ‘BOOK_NOW’, ‘SHOP_NOW’, ‘BUY_NOW’, ‘DONATE_NOW’, ‘ORDER_NOW’, ‘PLAY_NOW’, ‘SEE_MORE’

string

default:"Acme Corp"

Business name

object[]

YouTube video links

Show cada item

string

required

YouTube video ID

object[]

Carousel cards

Show cada item

string

default:"Shop Now"

Card headline

string

default:"https://example.com"

Card final URL

string

Call to action label

object[]

Card media items

Show cada item

string

Media type Posibles valores: ‘IMAGE’

string

default:"https://example.com/image.jpg"

Media source URL

boolean

default:"False"

Is logo flag

string

Error message if media failed

string

Public URL of the media

string

Image type classification

string[]

Channel placements

boolean

Custom channels flag

object

Keyword targeting

string

Ad group publishing status Posibles valores: ‘DRAFT’, ‘SCHEDULED’, ‘PUBLISHED’, ‘PUBLISHING’, ‘FAILED’, ‘IN_REVIEW’, ‘PAUSED’, ‘ARCHIVED’, ‘WITH_ISSUES’, ‘REJECTED’

string

Ad group-level error from Google

string

Google Ads ad group resource ID

boolean

Custom channels flag

string[]

Selected channel placements

string

Google audience resource ID

object

Ad group audience targeting

object

Campaign goal config

object[]

Ad schedule rules

Show cada item

string

required

Day of week Posibles valores: ‘FRIDAY’, ‘MONDAY’, ‘SATURDAY’, ‘SUNDAY’, ‘THURSDAY’, ‘TUESDAY’, ‘UNKNOWN’, ‘UNSPECIFIED’, ‘WEDNESDAY’, ‘ALL_DAYS’, ‘MONDAY_TO_FRIDAY’, ‘SATURDAY_AND_SUNDAY’

string

default:"09:00"

required

Start time (HH:MM)

string

default:"17:00"

required

End time (HH:MM)

string

Publishing status Posibles valores: ‘DRAFT’, ‘SCHEDULED’, ‘PUBLISHED’, ‘PUBLISHING’, ‘FAILED’, ‘IN_REVIEW’, ‘PAUSED’, ‘ARCHIVED’, ‘WITH_ISSUES’, ‘REJECTED’

string

Google Ad account identifier

boolean

Whether the campaign has unpublished changes

number

Maximum CPC bid in micros

string

Google Ads campaign resource ID

string

default:"WEBSITE"

Traffic source

object

Advanced options

Respuestas

200 - Response

400 - Bad Request

{}

401 - Unauthorized

{}

422 - Unprocessable Entity

{}

Ejemplo

curl -X PUT 'https://services.leadconnectorhq.com/ad-publishing/google/ads' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "string",
  "name": "My Campaign",
  "locationId": "loc_abc123",
  "advertisingChannelType": "SEARCH",
  "advertisingChannelSubType": "DEMAND_GEN",
  "goalType": "WEBSITE_TRAFFIC",
  "isEuPoliticalAds": false,
  "adGroups": [
    {
      "id": "string",
      "adGroupId": "string",
      "name": "Ad Group 1",
      "adCampaignId": "string",
      "adContent": [
        {}
      ],
      "publishingStatus": "DRAFT",
      "adGroupError": "string",
      "googleAdGroupId": "string",
      "customChannels": true,
      "selectedChannels": [
        "GMAIL"
      ],
      "googleAudienceId": "string"
    }
  ],
  "adSchedule": [
    {
      "dayOfWeek": "FRIDAY",
      "from": "09:00",
      "to": "17:00"
    }
  ],
  "publishingStatus": "DRAFT",
  "googleAdAccountId": "string",
  "unpublishedChanges": true,
  "maximumCpc": 0,
  "googleCampaignId": "string",
  "source": "WEBSITE",
  "advancedOptions": {}
}'

const response = await fetch('https://services.leadconnectorhq.com/ad-publishing/google/ads', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.LEADWAY_TOKEN}`,
    Version: '2021-07-28',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"id": "string", "name": "My Campaign", "locationId": "loc_abc123", "advertisingChannelType": "SEARCH", "advertisingChannelSubType": "DEMAND_GEN", "goalType": "WEBSITE_TRAFFIC", "isEuPoliticalAds": false, "adGroups": [{"id": "string", "adGroupId": "string", "name": "Ad Group 1", "adCampaignId": "string", "adContent": [{}], "publishingStatus": "DRAFT", "adGroupError": "string", "googleAdGroupId": "string", "customChannels": true, "selectedChannels": ["GMAIL"], "googleAudienceId": "string"}], "adSchedule": [{"dayOfWeek": "FRIDAY", "from": "09:00", "to": "17:00"}], "publishingStatus": "DRAFT", "googleAdAccountId": "string", "unpublishedChanges": true, "maximumCpc": 0, "googleCampaignId": "string", "source": "WEBSITE", "advancedOptions": {}}),
});
const data = await response.json();

import os, requests
response = requests.request(
    'PUT',
    'https://services.leadconnectorhq.com/ad-publishing/google/ads',
    headers={
        'Authorization': f"Bearer {os.environ['LEADWAY_TOKEN']}",
        'Version': '2021-07-28',
        'Content-Type': 'application/json',
    },
    json={"id": "string", "name": "My Campaign", "locationId": "loc_abc123", "advertisingChannelType": "SEARCH", "advertisingChannelSubType": "DEMAND_GEN", "goalType": "WEBSITE_TRAFFIC", "isEuPoliticalAds": false, "adGroups": [{"id": "string", "adGroupId": "string", "name": "Ad Group 1", "adCampaignId": "string", "adContent": [{}], "publishingStatus": "DRAFT", "adGroupError": "string", "googleAdGroupId": "string", "customChannels": true, "selectedChannels": ["GMAIL"], "googleAudienceId": "string"}], "adSchedule": [{"dayOfWeek": "FRIDAY", "from": "09:00", "to": "17:00"}], "publishingStatus": "DRAFT", "googleAdAccountId": "string", "unpublishedChanges": true, "maximumCpc": 0, "googleCampaignId": "string", "source": "WEBSITE", "advancedOptions": {}},
)
data = response.json()

<?php
$ch = curl_init('https://services.leadconnectorhq.com/ad-publishing/google/ads');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('LEADWAY_TOKEN'),
        'Version: 2021-07-28',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode({'id': 'string', 'name': 'My Campaign', 'locationId': 'loc_abc123', 'advertisingChannelType': 'SEARCH', 'advertisingChannelSubType': 'DEMAND_GEN', 'goalType': 'WEBSITE_TRAFFIC', 'isEuPoliticalAds': false, 'adGroups': [{'id': 'string', 'adGroupId': 'string', 'name': 'Ad Group 1', 'adCampaignId': 'string', 'adContent': [{}], 'publishingStatus': 'DRAFT', 'adGroupError': 'string', 'googleAdGroupId': 'string', 'customChannels': true, 'selectedChannels': ['GMAIL'], 'googleAudienceId': 'string'}], 'adSchedule': [{'dayOfWeek': 'FRIDAY', 'from': '09:00', 'to': '17:00'}], 'publishingStatus': 'DRAFT', 'googleAdAccountId': 'string', 'unpublishedChanges': true, 'maximumCpc': 0, 'googleCampaignId': 'string', 'source': 'WEBSITE', 'advancedOptions': {}}),
]);
$data = json_decode(curl_exec($ch), true);

Empezar

Scopes

Upsert Google campaign

Autorización

Body

Respuestas

Ejemplo

​Autorización

​Body

​Respuestas

​Ejemplo

Autorización

Body

Respuestas

Ejemplo