メインコンテンツへスキップ
POST
1回のリクエストで Google Ads の検索キャンペーンを作成します。Ayrshare は予算、キャンペーン、1つの広告グループ、キーワード、1つのレスポンシブ検索広告、地域ターゲティングをまとめて作成します。Google がいずれかの部分を拒否した場合は、何も作成されません。 リクエストは共通の広告キャンペーンの形式を使用します。このページでは Google 固有の内容を説明します。
  • Google 広告はアカウントごとに有効化されます。有効化するには、お問い合わせください。
  • まず “Social Accounts” ページから Google Ads を連携してください。accountId は10桁の Google Ads お客様 ID で、ハイフンの有無は問いません(123-456-7890)。
  • 連携する Google ユーザーは、広告アカウントに直接アクセスできる必要があります。マネージャー アカウント経由でのみアクセスできるアカウントは一覧に表示されず、現時点では使用できません。そのユーザーを広告アカウント自体に追加してください。マネージャー アカウントも一覧に表示されません。マネージャー アカウントはキャンペーンを保持できないためです。
  • status: "active" を送信しない限り、新しいキャンペーンは paused の状態で開始されます。
  • 予算は1日あたりの金額で、広告アカウントの通貨で指定します。budget.currency は送信しないでください。送信すると code: 101 が返されます。
  • 他の通貨での支出は、Open Exchange Rates のその日の為替レートで USD に換算されて請求されます。換算できない通貨のアカウントでは、何も作成される前に code: 101 が返されます。
  • 広告は Google 検索にのみ表示され、検索パートナーやディスプレイ ネットワークには表示されません。
コンバージョン トラッキング。 maximizeConversions は、Google Ads アカウントでコンバージョン トラッキングが設定されている場合にのみ機能します。Ayrshare が代わりに設定することはありません。設定していない場合は、maximizeClicks または manualCpc を使用してください。

ヘッダーパラメータ

string
必須
新しいキャンペーンごとに、UUID などの新しい一意の値を指定します。同じキーでリクエストを繰り返すと、最初のレスポンスが返され、新たに何も作成されません。Ayrshare がキャンペーンを Google に送信する前に作成が失敗した場合はキーが解放されるため、リクエストを修正して同じキーで再試行できます。これには、Ayrshare が受け付けない値(サポートされていない入札戦略など)、USD に換算できない通貨のアカウント、および Ayrshare が最初に行うアカウント確認の失敗(Google による拒否を含む)が該当します。キャンペーンが Google に送信された後に失敗した作成は、その応答が保持されます。新しいキーで再試行してください。

ボディパラメータ

共通フィールドは広告キャンペーンに記載のとおりに機能します。Google では次のとおりです:
string
必須
search。
string
必須
maximizeClicks、manualCpc、または maximizeConversions。それ以外を指定すると code: 101 が返されます。
boolean
必須
Google はすべてのキャンペーンでこの申告を必須としています。アカウント内に未申告のキャンペーンが1つでもある間は、Google はそのアカウントのキャンペーンに対するすべての変更を拒否します。
object
Google は広告アカウントのタイムゾーンで日単位のスケジュールを設定します。start はその日の 00:00:00 に開始し、end はその日の 23:59:59 に停止します。送信した時刻は日付の指定にのみ使われます。start には当日を指定できますが、それより前の日は指定できません。1日だけのキャンペーンにするには、start と end に同じ日付を送信してください。end が start より前の日の場合は code: 101 が返されます。
object
Google は広告テキストの言語に基づいて検索広告をユーザーと照合するため、言語の設定はありません。targeting.languages を送信すると code: 101 が返されます。
object
必須

エラー